PatSeek 专利检索（v1.9.2）

首次调用：选定环境和读取路径

能直接运行CLI时，首次先用仅依赖标准库的环境检查选定解释器；可通过重复 --python <已知解释器> 指定候选，不扫描机器、不自动安装依赖、不调用API。读取 selected_python，后续本轮所有CLI用同一解释器；环境未变不逐命令检查。再离线执行 capabilities --json 核对 cli_revision 与 client_sha256，不只按1.9.2版本号判断。旧包没有助手时先核对相应子命令的 --help。

宿主仅提供结构化工具时，使用工具原生JSON，不要求额外Shell或本地文件权限。CLI具备文件读写时优先用文件与简洁回执，避免重复输出长正文：

python3 <skill-dir>/scripts/check_environment.py
# 后续 <python> 替换为上一步 selected_python 的实际路径
<python> <skill-dir>/scripts/patseek_client.py capabilities --json
<python> <skill-dir>/scripts/patseek_client.py bool '(液冷 OR 冷却液) (接头 OR 连接器)' --page-size 10 --output ./results/q1.json --quiet
<python> <skill-dir>/scripts/read_search_result.py ./results/q1.json --command bool

--output 隐含 --json，每个新操作用本任务的新文件名；已有结果仅在确认同一查询/目标/任务后复用，不能因同名就当作新结果；--quiet 必须配合 --output，仅返回文件路径、数量、费用与源状态，output_saved=true 只表示文件保存成功。失败/中断可能留下 ok=false/status=incomplete 占位，不能当空结果。先核对检索工具退出码，再读取结果文件。不要解析宿主合并后的终端文本，不用 raw_decode 或花括号顺序猜结果。旧文本及完整JSON输出不变，简洁模式是可选项。

统一读取助手只读文件、不请求API，默认给前10个候选的PID、标题、日期、摘要预览与可读字段；这是索引，不是已核验原文。本地用 --offset/--limit 翻页，无需重检。读取原文必须指定目标PID，避免错误地取第一篇；下例公开号需替换为本次候选的真实PID：

<python> <skill-dir>/scripts/patseek_client.py patent CN123456789B --output ./results/d1.json --quiet
<python> <skill-dir>/scripts/read_search_result.py ./results/d1.json --command patent --pid CN123456789B --field claims --full
# 说明书默认2000字符窗口，按next_start续读；正式全文核对可用 --full
<python> <skill-dir>/scripts/read_search_result.py ./results/d1.json --command patent --pid CN123456789B --field description
# 有异步需求时读取完整成功结果；不按“第几个花括号”解析
<python> <skill-dir>/scripts/read_search_result.py ./results/s1.json --command semantic

PID缺失、重复或不匹配、缺字段、非JSON及未完成语义任务会明确报错，不能用 get('total', 0) 或空数组掩盖失败；窗口的 read_complete 只说明本次返回字段已读完，不保证官方原文完整。多式付费前若Key状态未知，可做一次 key-info 并复用本轮结果，勿并行用两条检索探测同一个Key。key-info 的web_wallet余额null是未知，不是0；本地0需结合免费路由，不能当Key失效。有明确402时停止新增付费请求，保留已取得证据；不反复探测余额或自动遍历其他Key。

解析故障先查结果文件、缓存、原task_id和费用日志，不整批重跑，不用force/no-cache修复格式，尤其不盲目重发付费语义。已提交语义的等待期间可核读已有文件，遵守原串行提交与节流，不新增并发付费提交。首次Bool先校准对象×机制，再叠加区别特征；CN某式0不代表无相关专利，World25个候选也不等于25篇适格证据。细节见 命令与统一读取。

核心原则

1. 先确定任务类型，再选择流程；不得用可专利性查新替代 FTO。
2. 把 PatSeek 作为专利文献召回工具，不把相似度、命中数或模型结论直接当作法律结论。
3. 报告所有数据库、市场、检索式、日期、限制和未覆盖来源，保证可复核。
4. 对未公开技术先提示保密：完整方案会发送到 PatSeek；使用 --no-call-log 可禁用本地调用统计，缓存仍可能保存 API 响应。
5. 费用以 API 返回的 credits_charged 为准，不用文档估算替代实际返回。
6. API Key 失效时（401/402/403）必须停止检索并询问用户，禁止自行转向 Google 或其他互联网引擎检索专利。引导用户到 https://patseek.cn 更新 Key 或充值积分。详见"API Key 失效处理协议"。
7. 撰写报告时读取 报告相关性与引用准入。候选池与正文证据集合分开；按技术分支区分主路线、组件参考、替代路线和待核/排除。核心技术陈述核读原文并记录能力边界，不能把局部功能、跨对象组件或多篇文献拼成单篇完整披露。使用report_admission与technical_claims绑定引用；导读事实用summary_claims，行动/追问用summary_plan（见dual_summary.md）；单篇未核验时降级至附录，继续交付已有证据支持的分析，不逐篇等待用户确认。

快速参考

> 时间有限时，先看这里：

任务路由

若任务信息不足，先做不收费的方案拆解并展示检索范围。开始付费前说明范围、深度和预计费用；已有明确任务、授权和预算时直接执行，不重复要求确认。仅缺少必要信息、超出已授权预算或扩大未授权范围时询问。

无效证据检索和专利权稳定性分析使用 references/invalidity_search_workflow.md，先读 references/invalidity_scheme_review.md 建立目标原文、引用闭包、必要子限定和关系模型，再逐文献核对披露。使用普通Markdown/JSON记录即可执行，不要求Agent系统支持Goal指令；现有持续执行脚本可按环境选择。保持QX / QY-Base / world / 深度语义 / 详情路径，依据候选核读、残余关系与检索增益续作；不以固定次数或通道已执行代替证据充分。检索式仍遵守“对象块上位概念 + IPC通用工艺双路径”（§3.5），封存后已知答案回放另记，不混入盲测。

无效/World原文核读另读 references/invalidity_evidence_review.md；日期矛盾、正文缺失和未处理候选分别记录。引文存在、语义支持、最终法律资格和专家复核分开；历史候选与旧命令保留，不能自动视为已读或完整披露。

检索模式选择（必做）

确定任务类型后说明适合的检索深度。用户已授权任务时按任务所需深度执行；只对尚未确定的选择提供以下选项，不为展示选项而停顿：

本次检索范围：[技术对象 × 核心机制 × 关键区别特征；库=cn/world；法域=...]
请选择检索深度：
  1. 快速摸底 —— 技术描述通常2次fast探路、第3次按缺口 + 2–3次Bool + 基础详情≤2；
     已明确检索式时保留3–5次纯Bool路径，不自动追加fast
     费用：Bool 次数×1 + fast 次数×1 + 详情预留；auto按付费上限预留，free_only可按0预留
     适用：交底前摸底、初步筛查、非正式了解
     产出：初步印象、候选列表、深入建议，不构成新颖性/创造性结论
  2. 完整深度 —— 约8–10次 Bool + 全文核对 + 深度语义至少1次（补漏按需）
     可先用2次fast探路、第3次按增益；已走旧semantic先行则不机械追加fast，深度补漏仍保留
     费用：Bool 次数×1 + fast 次数×1 + 深度语义次数×5 + 各详情预留
     产出：分层 X/Y 证据与可复核报告

  收到结果即可继续分析；HTTP返回、客户端节流、全文核验和报告耗时分别计算，
  不为凑固定分钟数等待。详情免额以服务器 entitlement 为准，未知资格预留1分/次。
  默认 CLI 详情仍含增强，且也返回主源说明书；--no-enrichment 仅关闭增强。
  FTO 保留法律状态等增强核验；法律结论须回到目标法域官方登记簿。

怎么选：
- 方向已明、要一次到位 → 完整深度：少一次交互、更快
- 时间紧/想先摸底 → 快速摸底：跑完会给出「深入检索建议」（未覆盖项+值得深入的方向+成本提示），由你决定是否继续
- 快速摸底只出初步印象（技术描述用fast探路后衔接Bool，检索式明确时约3–5次纯Bool），不构成新颖性/创造性结论

边界（不提供快速选项）：FTO/侵权、无效检索、正式申请决策 → 不提供"快速摸底"，直接走完整深度流程，并告知用户原因。

默认规则：用户未明确选择时默认完整流程；说明所选路径和预估，已有授权时继续执行。

不触发场景：简单直接检索（已知公开号/申请号、单一申请人盘点）、宏观态势统计；同一任务的后续轮次不重复询问。

语义校准与深度补漏

技术描述类CN初步摸底通常先做2次 semantic-fast 探路：第一条保留对象与核心机制，第二条针对结果中未覆盖的机制或实现方向。第3次只在缺口明确、能构造新切角且预算允许时执行；线索够用可提前转Bool。执行多方向探路时读取 references/semantic_probe_workflow.md，按实际候选提炼术语、IPC和结构关系，构造2–3条Bool试式。

已知号码、申请人、宏观统计或用户已明确的检索式沿用原路径。用户明确要求旧 semantic 先行时照做，不自动追加fast费用。正式查新、FTO、无效检索保留异步语义补漏和原文核验；fast不代替深度或World通道。

• fast为同步单源，2026-10-04三场景九次结果全部CN；异步另有外国和CN独有候选。不能据此声称全部fast永远仅CN，也不能用多次fast证明全球覆盖；国际任务另走World。
• fast的 similarity=0 表示未提供分值，保留上游顺序，不显示0%、按0分筛除或与异步模型评分合成统一百分比。
• 每次抽查前5–10篇，评价新增有效候选、机制、IPC和可验证Bool路径，不以新增PID数量单独评价收益。散热/保温、监测/给药等方向须核对。
• 按完整PID合并Bool、fast和deep候选，保留每次来源、query_id和排名。异步可能返回重复PID且非分数递减；去重后再选阅读样本，公开阶段和同族另核验。
• 分支文献不能拼成完整组合披露；自然语言日期、国家或否定条件不能当硬过滤。报告所需候选读取基础详情，再核关键日和原文完整性。
• semantic_fast日志与Goal lane保持独立。空结果不证明无现有技术；失败或超时不自动收费重发或升级异步。

积分预算协议（必做）

用户反馈过"某些任务扣分过快"。实测根因（2026-09-06，~/.cache/patseek/calls.log 752 次计费调用 / 659 积分）：没有执行前预估、没有预算上限、没有中途检查点，单次会话实测最高 189 积分且全程无停止点。

scripts/cost_guard.py 提供三层保护，零侵入——它增量读取现有 calls.log 记账，现有 5 个脚本无需改动即被覆盖。

三档策略（按预估金额，避免无谓打扰）

与"检索模式选择"合并为一次确认——不要问完深度再问预算，两次打断用户体验很差。在同一次确认里同时给出深度选项和预估金额。

执行流程

PY=/path/to/python; G=scripts/cost_guard.py

# 1) 开始前：设定预算 + 预估（>预算 或 >50 分 会拦下要求确认）
$PY $G begin --task invalidity --budget 50
#    --task 取值：probe / quick / novelty / fto / invalidity / research / citation_drill / custom
#    可用 --bool-n / --semantic-n / --fast-n / --enriched-n / --plain-n 覆盖模板次数

# 2) 每个检索阶段结束：检查点
$PY $G check --stage "CN Bool 第1轮" --planned-cost 6
#    exit 0 继续 | exit 2 需请示用户（超预算/超预估 1.5×）| exit 3 硬熔断

# 3) 追加预算后继续（已完成部分有缓存，不重复扣费）
$PY $G extend --set 80

# 4) 结束时归档（会记录预估偏差，用于校准下次预估）
$PY $G done

check 返回 2 或 3 时停止新增付费调用，先保存和交付阶段材料，再询问预算选择，并给出 A/B/C 选项：A 追加预算 / B 缩减范围收尾 / C 就此结束。不得自行决定继续。

直连脚本必须手动上报

citation_drill.py 等直连 API 的脚本不经过 patseek_client.py，其消耗不会被自动记账。必须：

# 方式一：给脚本本身设上限（推荐，能中途刹住）
$PY scripts/citation_drill.py --pid CN106596619A --max-credits 12

# 方式二：跑完后上报（脚本输出里会给出这条命令）
$PY $G record --credits 12 --note "citation_drill"

省钱的默认动作（比拦截更重要）

按收益排序，每次任务都应默认执行：

1. 全文核验推荐 --no-enrichment --json（确认免额和余量时0积分，未知资格预留1分）。CLI 默认增强行为保持兼容，两种模式都请求说明书。查新所需的 claims/description/appdate/pubdate/figures 全在主源字段里。仅对最终进入报告的核心候选才用 enrichment 模式（1 积分）补 pdf_url/priority_date/法律状态/同族。FTO 例外——法律状态是侵权判断核心，必须保留 enrichment。
2. 快速语义与深度语义分别预算。fast当前1分/次；deep沿用5分估算。新 --task probe --budget 8 预留最多3次fast、3次Bool、2次基础详情（资格未知单价1），实际通常先2次fast。旧quick等预算模板不变；明确free_only才可设 --plain-unit-cost 0。正式流程保留深度补漏。
3. 复用缓存。Bool 缓存 15 分钟、详情 12 小时、语义 1 小时；重复查同一号/同一式命中缓存 0 积分。--no-cache 会强制付费，非必要不加。
4. 批量任务先 begin 后跑。semantic_batch.py 无内置上限，N 个任务 = 5N 积分。

记账口径

• 深度语义在提交成功后立即记账；后续任务失败/超时也保留已收费用，不重复记账。
• 实际消耗一律以 API 回包的 credits_charged 为准，不用文档估算替代实际返回。
• 任务消耗 = 任务期间 calls.log 增量 + 手动上报。因此 begin 必须在任何付费调用之前执行，否则基线取不到。
• 明确返回的鉴权/校验/上游失败按接口规则不扣费；缓存命中本次不扣费。网络超时或异常响应不能证明未扣费，勿盲目重发。fast 不持久化响应缓存。

运行与保密

使用当前 Skill 目录中的脚本：

python3 <skill-dir>/scripts/patseek_client.py --help

通过环境变量传 Key，避免把 Key 写进命令历史：

export PATSEEK_API_KEY=ps_你的Key

> 还没有 API Key？ 访问 https://patseek.cn 注册/登录 →「个人中心 → API Key 管理」→ 创建新 Key。Key 过期或积分不足时也到该网站更新或充值。

保密选项：

# 不写本地调用统计日志；公共参数可写在子命令之前或之后
python3 <skill-dir>/scripts/patseek_client.py bool "检索式" --no-call-log

# 完全禁用调用统计
export PATSEEK_DISABLE_CALL_LOG=1

脚本的调用日志只保存 Key 指纹、技术词与约束摘要、页码和积分，不保存查询原文。近似去重不跨申请人、编号、IPC、国家、日期或布尔结构变化；旧日志只能凭精确查询摘要拦截。Bool/详情的JSON保留API字段并新增local_cache_hit；缓存调用的credits_charged为0，历史值单列cached_response_credits_charged，缺收费字段时为null，不能当作免费。结果缓存默认位于 ~/.cache/patseek/；高度敏感任务结束后提醒用户自行清理缓存。不要在报告、终端输出或日志中回显 API Key。

API Key 失效处理协议

当 API 调用返回 401（Key 缺失/无效）、402（积分不足）或 403（Key 已禁用）时，必须立即停止检索流程，向用户报告并等待用户选择，不得自行决定替代方案。

禁止行为

• 禁止在 API Key 失效后自行转向 Google Patents、Espacenet、WIPO Patentscope 等互联网专利检索引擎
• 禁止将互联网检索结果当作 PatSeek 检索结果直接写入报告，不标注数据来源差异
• 禁止静默跳过专利检索步骤，只在报告中标注"未检索"
• 禁止在未告知用户的情况下，用通用网页搜索替代专业专利数据库检索

PatSeek 与互联网引擎在数据覆盖、字段结构、检索精度和法律可复核性上存在实质差异。自行替换会导致检索质量下降、结论不可复核，严重影响 FTO、查新等任务的可靠性。

必须执行的流程

检测到 401/402/403 错误后，向用户输出以下信息并等待选择：

PatSeek API 调用失败：[错误码] [错误说明]

可能原因：
- 401：API Key 缺失、格式错误或已过期
- 402：积分余额不足
- 403：API Key 已被禁用

请选择如何继续：
1. 更新 API Key — 访问 https://patseek.cn 登录后，在「个人中心 → API Key 管理」
   创建或查看 Key，然后告诉我新的 Key（我会更新环境变量并重试检索）
2. 使用互联网引擎检索 — 我将改用 Google Patents / Espacenet 等公开来源，
   但数据完整性、字段结构和可复核性可能不如 PatSeek，报告会显著标注数据来源差异
3. 暂停任务 — 先处理 Key 问题，稍后再继续

请回复 1 / 2 / 3 或告诉我你的选择。

用户选择后的处理

缓存命中不算失效

若 API Key 失效但本地缓存仍有有效结果（Bool 15 分钟、详情 12 小时、语义 60 分钟内），可使用缓存结果并标注"来自缓存，未实时验证"。但不得用缓存结果替代需要新检索的任务，也不得隐瞒 Key 已失效的事实——仍须告知用户 Key 状态并询问是否更新。

预防性检查

对长会话或多轮检索任务，首次调用前建议先执行 key-info 命令确认 Key 状态：

python3 <skill-dir>/scripts/patseek_client.py key-info

若返回 active: false、expires_at 已过或即将过期，提前告知用户并询问是否更新，避免检索中途失败。

执行前检查

制药/化学/生物、通信标准或高校成果转化任务还必须读取references/special_domain_gates.md，执行结构/序列、参数、标准必要性和商业化边界检查。

关键词与分类构造

读取 references/keyword_expansion.md。对每个概念标注术语关系，禁止把相关概念伪装成同义词：

不要使用固定"最多8词"或未定义的"语义距离"。扩展多少由概念边界、结果抽样和验证集表现决定。记录每个扩展词的关系与来源。

申请人检索注意：企业/机构检索必须优先使用全称（如 AP=(华为技术有限公司)），简称（如 AP=(华为)）会产生大量个人申请人噪声（"张华为"等）。技术调研时优先用"全称+IPC"组合，精度最高。详见 references/technology_research_workflow.md"申请人检索策略"。

IPC 不一律截断到4位：先用准确下位组查准，再用上位组补召回。当前 CN/World API 均兼容紧凑与带空格 IPC；CN 客户端对明确合法 IPC 字段规范化，保护其他字段和引号。两种 IPC 输入复用同一缓存，World 历史 IPC 缓存隔离。复合检索前先单独预检IPC；若为0条，先修复格式或回退上位组，不得把错误分类与关键词叠加后的0条解释为无现有技术。不同市场需分别验证。完整语法见 references/query_syntax.md。

试验性检索策略

撰写报告或开始系统检索前，建议先做 1-2 次试验性检索掌握整体情况，再逐步使用精确检索式。适当增加 Bool 检索次数是正常的——一次完整查新或无效检索通常需要 8-10 次 Bool 检索（分 2-3 轮，每轮之间须执行"轮次引导"用户校准）。

试验性检索的目的

1. 确认术语有效性：验证关键词在目标库中是否有命中，避免正式检索时因术语错误浪费时间
2. 评估结果规模：了解宽检索的命中量，判断是否需要 IPC/CC/日期限定
3. 发现术语变体：从试验性检索的前排结果中提取真实术语、IPC 分类和申请人名称
4. 确认申请人名称格式：企业/机构检索前，先用简称试检索核对 applicant 字段的完整格式

推荐流程（完整深度：Bool 预算 8-10 次，分 2-3 轮）

第 1 轮（2-3 次 Bool）：
  → 试验性/QX 一式（对象×机制×关键特征，兼作术语与规模校准）
  → IPC 预检 1 次（按需；若已做语义先行，以其 IPC 分布为预检方向，避免方向偏差）
  → QY-Base 一式（对象×机制×技术问题/效果）
  → 抽查前 10 篇标强相关/弱相关/不相关（内部过程指标，只进报告附录），识别不相关结果类型与强相关候选
  → 交给用户校准（见"轮次引导"）

第 2 轮（2-4 次 Bool，按第 1 轮结果与用户调整点构造）：
  → QY-Comp 一式（Y-Base 存在缺失区别特征时必做）
  → 收窄/扩展（按噪声收窄，按新术语/分类扩展）
  → 加 PD<关键日 / CC / 日期限定；CN + World 分库
  → 抽样核对，交给用户校准

第 3 轮（0-3 次 Bool，按需）：
  → 补充切角/多语言/换库验证，或针对残余缺失特征
  → 连续两轮无新线索即中止（预算内跑不满不算失败）

异步语义（正式任务至少1次；已先行执行可复用，后续补漏0-2次按需）：
  → 对完整组合或残余机制补漏，计入积分，不计入Bool预算；fast不能替代

试验性命中不自动成为正式证据；候选经过身份、日期和原文核验后可进入候选池，语义候选不必先被Bool复现。

轮次引导（用户校准，完整深度必做）

完整深度分轮执行；每轮抽查并说明相关性、增益和下一步。在已授权范围和预算内自主续作，用户可随时调整或喊停。以下选项仅在需要用户决策时呈现，不作为每轮强制等待点：

本轮结果：强相关候选 N 篇（列出公开号）/ 主要不相关结果类型 / 新术语·新 IPC·新申请人线索
下一步：
  A. 调整检索重点 —— 换特征组合/换切角/收窄法域/改日期/换库或语言（用户给出重点，或确认我方建议）
  B. 继续当前方向 —— 进入下一轮（预算内）
  C. 提前收尾 —— 已满足决策需要，生成报告

• 下一轮按已观察到的缺口及用户调整点构造新检索式，不得机械重复上一轮相同式；
• 预算：完整深度 Bool 总预算 8-10 次；用户明确要求追加时，报告标注"超出预算 X 次"；
• 中止条件仍以"连续两轮/两页不再出现新关键分类、申请人、特征或引证线索"为准（见"候选池与证据核对"），预算内跑不满不算失败。

快速查新模式（由"检索模式选择"触发）

用户经"检索模式选择"选择快速摸底，或明确要求快速结果时，走快速查新分支，不执行完整流程。快速模式已包含试验性检索和 IPC 预检，不需要先跑"试验性检索策略"的完整 5 步。未选择快速时默认完整流程；任务将用于正式申请决策时仍必须走完整流程。

适用场景与禁止场景

最小检索集（探路路径与纯Bool路径）

技术描述类CN摸底优先采用 2次fast、第3次按缺口 + 2–3次Bool + 详情≤2，详见 references/semantic_probe_workflow.md。Bool次数包含必要IPC预检；需要增加预检或补检时重新列预算，不为凑次数省略验证。探路已有校准结果不再机械追加整套纯Bool次数。

用户已明确术语/检索式或选择纯Bool时，保留以下约3–5次Bool路径。快速模式不默认运行异步深度、不执行QY-Comp、不做扩展轮：

1. QX 一式（含试验性校准）：对象×机制×1-2 个高区分特征（加 PD<关键日 或 CC= 限定）；前排结果同时用于校准术语与规模，不再单列试验性检索；
2. IPC 预检 1 次（按需 0-1）：需用 IPC 限定时才单独验证（格式见"关键词与分类构造"），0 条先修格式；
3. QY-Base 一式：对象×机制×技术问题/效果；
4. 收窄/换切角 0-1 次（按需）：QX/QY 不相关结果明显时，从强相关/弱相关文献提取新术语换一个切角重检；
5. 详情核对 ≤2 篇：只核对强相关/弱相关前排候选，用 --no-enrichment（确认免额和余量时0积分）。

每式仍须满足"Bool 检索式质量闸门"的三块结构；抽查前 10 篇标强相关/弱相关/不相关并记录（内部指标，只进报告附录）。

结论降级（强制）

快速模式只输出"初步印象 + 候选列表"，必须明确标注：

• "本结果来自快速查新模式，未做饱和检索，不构成新颖性/创造性结论"；
• 未覆盖项照常列出（仅按需收窄/换切角 0-1 次，未做扩展轮、未做异步语义补漏、未做 QY-Comp）；
• 候选列表中的每篇专利仍须提供附图与快速链接（见"重点专利的附图展示"与"专利快速链接"）。

禁止将快速模式结果套用完整流程的三种结论口径（如"发现可能破坏新颖性的文献"或"未发现单篇文献公开全部必要特征"）。快速模式的输出是筛查结果，不是法律结论。

深入检索建议（快速摸底收尾必给）

快速模式输出初步印象 + 候选列表后，必须附"深入检索建议"，供用户决定是否继续，但不自动转入深度检索：

• 指出未覆盖项：未做扩展轮/语义补漏/QY-Comp、world 英文未覆盖切角等；
• 建议最值得深入的方向：如已验证 IPC 增加限定条件、参数专项、补 world 英文、语义补漏，或对前排强相关/弱相关候选做全文比对；
• 提示成本：转入完整深度按剩余 Bool、深度语义与详情次数列出追加预算（快速轮已跑检索式可复用）；
• 由用户决定是否继续；若继续，进入完整深度流程（含轮次引导），快速轮的候选集/已验证 IPC 作为起点。

快速模式的补检与升级

强相关候选是探路成果：在快速预算内优先核读，并交付限定的初步结果；不因“覆盖70%”自动升级。用户要求正式决策依据时说明所需完整流程，按已有授权推进；追加预算或扩大未授权范围前询问。

命中少于20条或两式为0均不能单独证明检索失效。先核验字段、语法、日期和范围；结合前排相关性及不同方向探针判断。过宽或前排无关时，在原预算内收窄/换切角或做fast探路。已获可用相关候选时，不机械追加异步语义。

排除格式问题后，多方向仍无可用线索：交付“当前检索路径尚未形成可用证据”，列明缺口。剩余已授权预算支持时补语义，否则说明追加建议；不强制追加5积分，不写“该领域没有专利”或“方案全新”。正式无效/查新任务仍遵循其必经通道与法律证据核验要求。

Bool 检索式质量闸门

除专利号精确查询、单一申请人盘点或用户明确要求的宏观态势统计外，不得只用技术对象+宽泛功能词执行 Bool 检索。技术检索式通常必须包含三个相互独立的 AND 块：

1. 技术对象：产品、部件、材料或方法场景；
2. 核心机制/技术问题：方案如何工作或具体解决什么问题；
3. 关键区别特征：结构关系、步骤关系、控制逻辑、特定部件、参数范围或特殊技术效果中的至少一项。

信息不足以构造三个块时，使用两个高置信概念块并增加已验证的准确 IPC 或关系词组，不要用“系统、装置、方法、设备、处理、控制”等通用词凑数。CN普通关键词不保证短语匹配，中文可能按单字分析；引号不能替代结果抽样和详情核对。优先加入能排除同领域噪声的特征，顺序通常为：关键关系/机制 > 特定结构或步骤 > 参数 > 特殊效果 > 通用场景词。

执行前用下表自检：

命中后执行强制收窄规则：

三块组合仍达 10000 上限时的收窄操作（按优先级）：
1. 加字段限定：CC=(目标国)（world）、AD>=年份、已验证准确 IPC 下位组
2. 更换特征组合：从 H/M 文献提取真实术语，换一个特征组合，而非在原式末尾继续叠加
3. 切换库/语言：CN 切 world 英文，或 world 切 CN 中文；不同库前排结果不同
4. 分拆检索：把宽检索拆成多个窄检索（如按 IPC 分拆、按申请人分拆），分批核对

收窄时先查看前5-10篇的噪声类型，一次性选择最有区分力的新增条件；不要机械堆叠多个低置信词。CN关键词块连续两轮仍显示上限或对象块未在前排原文出现时，不再追加中文词，改用已单独验证的IPC、关键日前公开日期、world/英文或语义召回。除宏观态势任务外，高精度块以可核对规模和前排质量为目标；显示10,000可能是计数上限，不能仅凭总量判断策略成败。

条件可观察性闸门

Bool请求成功或命中量下降，不证明新增AND块真正生效。每轮抽样前10篇，为每个对象、机制、区别特征及字段限定建立“条件—原文/字段证据”矩阵：

1. 只把题名、摘要、权利要求、说明书或对应结构化字段中可定位的原词、确认同义词或等价技术表达记为“可观察”；单字散落、模型联想和仅同领域不算命中该条件。
2. 任一必需条件在某篇中不可观察，该篇不得标为QX的H或FTO高覆盖候选；多篇结果不能拼成单篇覆盖。
3. 新增条件在前10中前排符合比例低于50%，或找到的数量下降但强相关占比、强相关+弱相关占比均未提高，判定该条件“检索约束无效”；不要继续沿同式加词，改用已验证IPC、字段过滤、英文/world、语义或另一特征组合。
4. AP=、CC=、日期和IPC等字段条件必须用返回的申请人、公开号、日期和分类字段逐篇反查。申请人统计同时要求“申请人命中”和“技术相关”两道门，不能因申请人正确就把无关专利计入竞品布局。
5. 高精度块即使找到的数量少于5,000条，若前排必需条件的前排符合比例或强相关占比不合格，仍不得进入待核查清单或统计。反之，宏观调研的宽池必须拆成未截断分区并跨页分层抽样，不能只凭前10质量宣称可统计。

快速语义命令

python3 <skill-dir>/scripts/patseek_client.py semantic-fast "一种提高电池散热效率的结构" --max-results 100 --json

max_results 为1–200，省略时使用服务器默认（当前100）；返回可少于上限。JSON保留 results/meta/实际计费，文本显示排名与“未提供分值”。成功空结果也扣默认1分。函数 semantic_search_fast(api_key, query, max_results=None) 返回完整字典；旧 semantic_search_async 返回列表的契约保持。

显式发送 Accept: application/json；不带时服务器为SSE兼容输出。客户端不新增SSE解析，也不轮询fast。默认无 fast 持久化响应缓存（服务端 no-store）；15分钟内相同query与相同max_results拦截重复付费，可 --force 重跑；改变上限允许执行。fast 的 --no-cache 不绕过此闸门；--no-call-log 禁用日志后无法跨进程查重和节流。fast初始串行间隔6.5秒为保守保护，不是生产限流承诺。

命令

命令、参数、申请号、详情全文、语义轮询、缓存和输出说明见 命令手册。旧命令及参数保持兼容。使用前先读取对应命令章节。

持久化、恢复与记账

详见 运行状态与报告闸门。每个独立任务推荐设置唯一 PATSEEK_TASK_ID，所有相关进程保持相同值；缓存共享，预算隔离。未设置时保留旧全局预算模式。

相邻两次提交至少间隔60秒；逐任务流式保存结果，失败任务不能当作0条，失败不清空已完成结果。异步超时先恢复已提交的任务，不得直接重新提交。semantic_batch.py 通过检查点恢复；单次 semantic 命令通过本地持久化日志恢复。未知扣费不等于零，以“已确认费用 + 未知预留”检查预算，并在报告中分别列示。

报告渲染时重新绑定当前 scope 和 searches，旧的定量/适格性标签不能直接放行；证据不足时继续输出定性报告及待核项。宽检索和语义样本不妨碍保留已核实的正面证据，但不能推出总体密度、排名、空白或检索穷尽。

候选池与证据核对

查新时先读取 references/adaptive_xy_search.md，再读取 references/evaluation_and_reporting.md。执行以下硬约束：

1. 语义分只决定是否进入待核查清单；最终相关度以特征包含情况、关系、日期、证据位置和是否适用本次任务为准。
2. 优先按同族聚合；若 API 只有同族数量而无成员清单，标注"无法完成同族去重"，不得假装已经完成。
3. 不固定只看 Top 20-30。至少覆盖各检索块结果并以"连续两轮/两页不再出现新关键分类、申请人、特征或引证线索"作为可解释的初步中止条件。
4. 每个要素记录：文献原文位置、权项/段落/附图、明确记载或隐含记载、日期、可信度。
5. 对新颖性，披露在权利要求、实施例或附图中并不形成机械强弱等级；判断是否由同一适格文献公开全部必要特征。
6. 对创造性，评价权利要求整体：最接近现有技术→区别特征及技术效果→实际技术问题→是否存在技术启示；禁止只给孤立特征评级。
7. 分别执行 QX、QY-Base；QY-Comp 在 Y-Base 存在缺失区别特征时必须执行，无缺失时记录"Y-Base 已覆盖全部必要特征"后跳过。不能用一条越来越窄的检索链同时替代 X 与 Y 文献检索。
8. 每轮抽查前 10 篇，记录强相关/弱相关/不相关、日期不符合、同族重复及 X/Y 新增情况；下一式必须针对已观察到的不相关结果类型或缺失特征。
9. 报告术语硬规则：术语以 references/report_terminology.md 为唯一事实源。报告正文禁止出现内部操作词（QX/QY-Base/QY-Comp、语义 A/B/C、H/M/N/D、动作编号、sim 数值等），它们只进附录；专业术语保留但首次出现带白话括注；每份报告开头放 3–5 行术语卡；数值须说明含义与局限；每一档结论都要绑定"这表示什么"和"你该做什么"，不单独丢一个字母或等级给用户。

重点专利的附图展示

报告应尽量展示重点专利的附图，以辅助读者理解技术方案——附图比文字描述更直观，特别是涉及部件结构、方法步骤、电路连接时。

何时展示附图：
- 必须展示：X 文献/Y 文献核心候选、目标专利（查新/FTO/无效场景）、技术路线代表专利
- 建议展示：高被引专利、典型实施例相关专利
- 不必展示：仅作背景参考的专利、低相关候选

展示方法：
1. 用 patent <id> --figures-dir <目录> 下载附图到本地（命令用法见"附图展示"章节）
2. 报告中插入图片：![](figures/CN217874688U/01.png)
3. 每张附图配简短说明（什么图、对应什么技术特征、为什么引用）
4. 优先展示剖视图/结构图（展示部件关系）和流程图（展示方法步骤），其次电路图

附图来源可靠性（已实测验证）：来源 Google Patents，US/EP/JP/KR/WO 等主要专利局均覆盖，URL 长期有效。少数专利（较老或非主要国家）可能没有附图或不完整。详见 evaluation_and_reporting.md 第 6 节。

重点专利快速链接（必须）：所有进入候选池的重点专利必须提供快速阅读链接（格式与写法见"专利快速链接"章节），与附图配合使用——附图展示技术方案细节，快速链接提供全文阅读入口。报告交付前逐篇核对候选池每篇文献都有链接，缺链接视为报告不完整。走 report_guard.py 渲染的报告，其准入证据表与候选附录会自动生成链接列（pid → xinxin.chat），无需手工填写。

路线比较、低密度机会、申请前查新、FTO预筛或合作对象筛选形成结构化证据后，使用scripts/decision_gates.py evidence.json执行结论闸门。world证据还必须输入逐件CC前缀核验率与IPC/语言预检状态。脚本只判断证据是否足以支持相应标签，不替代专利代理人、市场或合作尽调判断。

⚠️ 语义检索结果一律标 truncated=true（硬规则，2026-09-05 实测新增）

语义端点返回的是"相关性排序后的封顶样本"（实测每次约 45–51 条），不是总体计数。 新版闸门依据 source/command/sources 自动识别语义样本，即使遗漏或错误填写 truncated 也不放行定量判断。

实测对照（AI 服务器散热三条技术路线，R1=51 / R2=45 / R3=47 篇）：

规则：

1. 凡以语义检索作为候选来源的路线/分支，同时记录 source=semantic 或 semantic_fast，并设 truncated=true，无论返回条数多少；
2. 只有布尔检索且总数 < 5,000 且未触达系统上限时，才可能标 false；
3. 判定为 not_comparable 时，只输出定性路线卡片，不得生成路线份额、成熟度排名或增长率对比（见 technology_research_workflow.md 第 233 行）。

交付Markdown报告前，用scripts/report_guard.py evidence.json --output report.md检查范围、检索式、样本、闸门和限制是否齐全。缺少字段、未解释的0条结果、FTO非候选筛查闸门或保证性结论会拒绝渲染；详情没有权项/段落位置时自动标为文本或字段代理，不得伪装为权项映射。

每份检索报告须含「双导读 + 双建议」（顺序固定为先发明人后代理人）：前置·双导读（给发明人的导读 + 给代理人的导读，放在标题信息表之后、正文之前）与结尾·双建议（给发明人的建议 + 给代理人的建议，放在报告最后）。两段共享同一组证据、不重复检索、不额外耗积分；用词少新名词、结论纪律不软化。模板、各任务类型变体与 evidence.json 字段对应见 references/dual_summary.md；推荐使用 summary_plan 生成四段导读/建议；旧四字段仍兼容，其自由文本必须绑定准入引用，未核内容降为待核。详见 references/dual_summary.md。

外部核验与限制

PatSeek 不能覆盖全部非专利公开、同族成员、审查档案和各国官方法律状态。任务需要时：

• 用可用浏览/检索工具查询官方专利登记簿、WIPO、CNIPA、EPO、USPTO 等；
• 按领域补论文、标准、产品手册、会议资料、网页和序列/化学数据库；
• pdf_url 为空时，可对已知公开号尝试外源 PDF 兜底（如 freepatentsonline：详情页解析 iframe 的 S3 签名 URL 两步下载；实测 EP/WO 稳定可用、US 部分覆盖，CN/JP/FR/DE/GB 等不可用（无 iframe 即判不可用）；PDF 为扫描件无文本层。操作细节见 api_reference.md §2）。CN 专利：pdf_url 有值即 Google Patents 直链可直接下载（实测 5/5）；空值率约 50%，且 freepatentsonline 不覆盖 CN——空值时无自动化兜底，提示用户经 Google Patents 页面/CNIPA 人工获取。外源仅用于 PDF 文件获取，不得替代 PatSeek 检索；
• 在报告中逐项列明"已检索/未检索/无法访问"，并提供来源链接和检索日期。

没有外部工具或权限时继续完成 PatSeek 范围内工作，但必须显著保留：“未检索非专利文献/未核验官方法律状态/未完成同族成员分析”。

结论纪律

禁止输出“已经具备新颖性”“不存在侵权风险”“全球无人申请”等保证性结论。使用：

> 截至[日期]，在[数据库、国家、语言和文献类型]及所列检索式范围内，未发现一篇在关键日期前公开并披露全部必要技术特征的文献。本结果不排除未公开申请、数据库缺口、非专利公开或术语差异造成的漏检。

FTO 还必须补充：

> 本次结果仅为候选权利筛查。是否影响实施须结合目标国家、计划时间、有效授权权利要求、官方法律状态及具体实施方案作专项法律分析。

参考

• references/query_syntax.md：Bool 语法与市场差异
• references/api_reference.md：API 和实际返回字段
• references/semantic_probe_workflow.md：多方向快速语义探路、第三次触发、Bool交接及来源合并（执行技术描述探路时读取）
• references/world_search_reference.md：国际专利检索统一参考（world 库语法、字段对照、示例、探针流程）
• references/keyword_expansion.md：术语关系与扩展方法
• references/novelty_search_workflow.md：可专利性查新
• references/adaptive_xy_search.md：X/Y标准与结果驱动调式
• references/fto_workflow.md：FTO/侵权风险
• references/invalidity_search_workflow.md：专利无效证据检索（分层 Bool + 语义补漏 + 特征比对）
• references/invalidity_scheme_review.md：无效目标理解、关系/子限定比对与创造性路线检查（无需Goal工具）
• references/invalidity_goal_loop.md：可选持久执行脚本说明（支持的环境按需读取）
• references/technology_research_workflow.md：企业/发明人技术调研
• references/evaluation_and_reporting.md：候选评分、证据表和报告模板
• references/report_terminology.md：报告术语规范（唯一事实源——A 类保留词白话括注 / B 类内部操作词替换 / C 类改写、三层结构与术语卡）。出报告前必读。
• references/special_domain_gates.md：制药/化学/生物、通信标准和成果转化专用质量门
• references/dual_summary.md：报告前置双导读 + 结尾双建议（先发明人后代理人）的模板、用词规则与各任务变体
• references/faq.md：常见问题速查（命中 0/10000 条、IPC 写法、world 关键词、description 缺失、积分、无效检索收口、API Key 失效等）
• CHANGELOG.md：版本历史（精简版，仅最近 5 个版本要点；更早历史可从 ~/.workbuddy/skills/ 下的 zip 快照恢复）

常见问题

遇到异常或疑问（命中 0 条/10000 条、IPC 写法、world 关键词、description 缺失、积分消耗、无效检索何时收口、API Key 失效等）时，读取 references/faq.md 速查。正常执行流程无需读取。

World报告可用 scripts/world_evidence.py 对完整JSON响应生成逐字段原文观察，将结果放入报告的可选 world_audits；人工技术解释放入 technical_analysis。词命中不等于权项覆盖，缺失字段不等于没有公开。外文编号详情若忘记 --market world，客户端在请求前拦截；CN数字申请号与ZL旧前缀仍按原流程处理。

P0 报告补充约束

报告准入逐篇以主源 pubdate 核验截止日（含当日）；普通现有技术必须早于关键日。缺失、冲突或晚公开的文献降为待核线索，抵触申请另走专项核验。双导读与建议中的专利事实通过 summary_claims 绑定已准入的 technical_claims 索引；旧自由文本仅保留在草稿附录。X候选不等于已核验X证据，后者须重新读取来源、覆盖全部当前必要特征并有同一实施方式的组合关系判断。