PatSeek 专利检索

技能文档

---
name: patseek-patent-search
description: 使用 PatSeek API 进行专利号/申请人/关键词 Bool 检索、国际专利检索、语义检索、专利详情核对，并为可专利性查新、FTO/侵权风险、专利无效证据检索和技术调研生成可复核报告。用户提到专利检索、查新、新颖性、创造性、FTO、避雷、侵权风险、专利无效、稳定性挑战、在先技术、企业研发、竞品或行业分析、技术路线、专利布局、技术经理、高校研究团队或成果转化、制药/化学/生物技术、通信标准/标准必要专利SEP、国际/PCT/美国/欧洲/日本/韩国专利时使用。普通外观设计图像检索不适用。
title: PatSeek 专利检索
category: 法律合规
---

# PatSeek 专利检索

## 核心原则

1. 先确定任务类型，再选择流程；不得用可专利性查新替代 FTO。
2. 把 PatSeek 作为专利文献召回工具，不把相似度、命中数或模型结论直接当作法律结论。
3. 报告所有数据库、市场、检索式、日期、限制和未覆盖来源，保证可复核。
4. 对未公开技术先提示保密：完整方案会发送到 PatSeek；使用 `--no-call-log` 可禁用本地调用统计，缓存仍可能保存 API 响应。
5. 费用以 API 返回的 `credits_charged` 为准，不用文档估算替代实际返回。
6. **API Key 失效时（401/402/403）必须停止检索并询问用户**，禁止自行转向 Google 或其他互联网引擎检索专利。引导用户到 patseek.cn 官网更新 Key 或充值积分。详见"API Key 失效处理协议"。

## 技能工作流总览（快速参考）

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

| 我要… | 看哪里 |
|---|---|
| 查新/能否申请 | 任务路由 → `novelty_search_workflow.md` |
| FTO/侵权风险 | 任务路由 → `fto_workflow.md` |
| 专利无效/找在先技术 | 任务路由 → `invalidity_search_workflow.md` |
| 技术调研/竞品分析 | 任务路由 → `technology_research_workflow.md` |
| 开始系统检索前 | 先确认检索模式（快速摸底/完整深度），见"检索模式选择" |
| 搜中国专利 | `bool "检索式"`（默认 cn，无需 `--market`） |
| 搜国际专利 | `bool "检索式" --market world`（语法差异见 `world_search_reference.md`） |
| 获取 API Key | 访问 patseek.cn 官网 →「个人中心 → API Key 管理」 |
| 命中太多（10000） | 加 IPC/日期/CC 限定，或换特征组合（见"Bool 检索式质量闸门"） |
| 命中 0 条 | 检查 IPC 格式/申请人名称/关键词（见文末 FAQ） |
| 不知道怎么开始 | 先做 2-3 次试验性检索掌握整体情况，再逐步精确（见"试验性检索策略"） |
| 时间紧，想快速摸底 | 走"快速查新模式"（约 3-5 次 Bool，出初步印象+深入检索建议，见"快速查新模式"） |
| 在报告中展示附图 | `patent <id> --figures-dir <目录>` 下载，优先展示 X/Y/目标专利（见"重点专利的附图展示"） |
| Key 过期/积分不足 | 见"API Key 失效处理协议" |

## 任务路由

| 用户目的 | 路由 | 必读参考 |
|---|---|---|
| 查新、能否申请、新颖性、创造性 | 可专利性检索 | `references/novelty_search_workflow.md` |
| FTO、侵权风险、上市避雷、能否实施 | FTO 检索 | `references/fto_workflow.md` |
| 行业、竞品、技术路线、技术趋势、研发机会 | 技术调研 | `references/technology_research_workflow.md` |
| 已知公开号/申请号、简单关键词 | 直接检索 | 本文件"命令"章节 |
| 涉及非中国专利（US/EP/JP/KR/WO 等） | 国际检索 | `references/world_search_reference.md`（**必读**） |
| 专利无效、稳定性挑战、找在先技术 | 无效检索 | `references/invalidity_search_workflow.md` |

若任务信息不足，先做不收费的方案拆解并展示检索范围。**开始任何付费检索前，必须完成"检索模式选择"（见下节）**：方案拆解、检索范围、检索深度选择与费用/耗时预估合并为一次确认，避免多次打扰；只在即将扩大法域或增加付费/耗时操作时再次请求确认。

无效证据检索和专利权稳定性分析使用 `references/invalidity_search_workflow.md`；该流程的核心策略是"关键日约束的分层 Bool 为主，语义检索为补，专利详情和特征比对为最终核验"。该流程由 **Goal Loop 持续驱动机制**承载——用 `scripts/invalidity_goal.py` 持久化目标、动作队列与每轮增益，强制走完 QX / QY-Base / world / 语义 / 详情五条必经通道，并由饱和门（连续零增益轮次 + 通道覆盖 + 特征证据或缺口）决定何时才允许收口，避免"看起来差不多了"就提前停止检索。详见 `references/invalidity_goal_loop.md`。**检索式构造须遵守"对象块上位概念 + IPC 通用工艺双路径"硬规则**（§3.5，金标回放实测：对象词仅用目标领域词会漏检决定性证据）；检索封存后若有已知决定书/金标对比文件，必须做金标回放核对 recall。

## 检索模式选择（必做）

确定任务类型后、开始任何付费检索前，**必须向用户呈现检索深度选项**；不得跳过分步直接按标准流程运行，也不得默认走快速模式。与"方案拆解"合并为一次确认，输出：

```
本次检索范围：[技术对象 × 核心机制 × 关键区别特征；库=cn/world；法域=...]
请选择检索深度：
  1. 快速摸底 —— 约 3-5 次 Bool + 详情 ≤2，3-6 分钟，**3-5 积分**
     适用：交底前摸底、初步筛查、时间紧、非正式了解
     产出：初步印象 + 候选列表 + 深入检索建议（不构成新颖性/创造性结论）
  2. 完整深度 —— 约 8-10 次 Bool + 详情核对 + 语义先行 1 次（+补漏 0-2 按需），15-35 分钟，**14-25 积分**
     适用：正式查新报告、申请前决策（方向已明确，想一次到位）
     产出：饱和检索 + 分层 X/Y 证据 + 可复核报告

  > **费用已优化（2026-09-05）**：详情核对默认走 `--no-enrichment`（每日免费额度 50-100次/日，取决于用户级别
  > **0 积分**）。查新所需的 `claims` / `description` / `appdate` / `pubdate` / `figures`
  > **都在主源字段里**，enrichment 那 13 个字段（法律状态、同族数量、引文数）对查新无实质作用。
  > 仅对**最终进入报告的 X/Y 核心候选**改用默认模式（1 积分/篇）补 `pdf_url` / `priority_date`。
  > 详见「详情调用的省钱策略」。**FTO 检索不省**——法律状态是侵权判断核心，必须保留 enrichment。
```

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

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

**默认规则**：用户未明确选择时默认完整流程；但必须已呈现选择，不能跳过分步。

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

### 语义先行（完整深度 · 用户已给详细方案时必做）

用户已提供完整方案描述（对象×机制×区别特征齐全）且选择**完整深度**时，进入 Bool 检索前**先执行 1 次语义检索**（+5 积分）：

1. 执行：`semantic "方案描述（去标识化）"` → 取结果集前 20 + **IPC 分布摘要**；
2. 用途：
   - **IPC 分布确认分类方向**——可纠正 Bool 预检的方向偏差（实测：固态电池热管理语义直接给 H01M 10/613/659/6568，Bool 预检却指向化学类 10/0525）；
   - **关键词扩展**——提取真实术语/同义词（如"角度可偏移""浮动块"），纳入 Bool 检索式；
   - **新候选人发现**——语义与 Bool 召回互补（实测互相漏掉对方 H 级），语义候选并入候选池；
3. 边界：
   - **不可只信 top-1**：新兴领域 top-1 可能是噪声（实测低空管控 top-1 为课桌 sim=10%），一律以整体结果集与 IPC 分布为准；
   - **不可替代 Bool**：语义先行后仍须跑完整 Bool 流程；
   - 语义相似度普遍偏低或 top-1 明显不相关（新兴领域）时，以 Bool 关键词为主，语义仅作 IPC 参考；
4. **快速摸底不做语义**（保持 3-5 Bool、**3-5 积分**）；简单直接检索/宏观统计不做。

## 积分预算协议（必做）

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

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

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

| 预估 | 行为 |
|---|---|
| ≤ 20 积分 | **静默执行**，结束时报账一次 |
| 21–50 积分 | 打印预估表后继续，**不阻断**；靠阶段检查点兜底 |
| > 50 积分 | **必须取得用户同意**才能开始（硬阈值） |

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

### 执行流程

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

# 1) 开始前：设定预算 + 预估（>预算 或 >50 分 会拦下要求确认）
$PY $G begin --task invalidity --budget 50
#    --task 取值：quick / novelty / fto / invalidity / research / citation_drill / custom
#    可用 --bool-n / --semantic-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`，其消耗不会被自动记账**。必须：

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

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

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

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

1. **详情默认 `--no-enrichment`**（0 积分，每日 50 次免额）。查新所需的 `claims`/`description`/`appdate`/`pubdate`/`figures` 全在主源字段里。**仅对最终进入报告的核心候选**才用 enrichment 模式（1 积分）补 `pdf_url`/`priority_date`/法律状态/同族。FTO 例外——法律状态是侵权判断核心，必须保留 enrichment。
2. **语义检索按需，不默认**。5 积分/次，是单点最贵的调用。
3. **复用缓存**。Bool 缓存 15 分钟、详情 12 小时、语义 1 小时；重复查同一号/同一式命中缓存 0 积分。--no-cache 会强制付费，非必要不加。
4. **批量任务先 `begin` 后跑**。`semantic_batch.py` 无内置上限，N 个任务 = 5N 积分。

### 记账口径

- 实际消耗一律以 API 回包的 `credits_charged` 为准，**不用文档估算替代实际返回**。
- 任务消耗 = 任务期间 `calls.log` 增量 + 手动上报。因此 **`begin` 必须在任何付费调用之前**执行，否则基线取不到。
- 报错（401/402/403/422/429/5xx）不扣费；缓存命中不扣费。

## 运行与保密

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

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

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

```bash
export PATSEEK_API_KEY=ps_你的Key
```

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

保密选项：

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

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

脚本的调用日志只保存 Key 指纹、技术词摘要、页码和积分，不保存查询原文。结果缓存默认位于 `~/.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 — 访问 patseek.cn 官网登录后，在「个人中心 → API Key 管理」
   创建或查看 Key，然后告诉我新的 Key（我会更新环境变量并重试检索）
2. 使用互联网引擎检索 — 我将改用 Google Patents / Espacenet 等公开来源，
   但数据完整性、字段结构和可复核性可能不如 PatSeek，报告会显著标注数据来源差异
3. 暂停任务 — 先处理 Key 问题，稍后再继续

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

### 用户选择后的处理

| 用户选择 | 执行动作 |
|---|---|
| 1. 更新 Key | 引导用户到 patseek.cn 官网获取新 Key；用户提供后更新 `PATSEEK_API_KEY` 环境变量并重试原检索；重试仍失败时再次询问 |
| 2. 互联网引擎 | 明确告知用户互联网检索的局限性（引文表可能缺失、法律状态不可靠、字段不完整等）；在报告显著位置标注"因 PatSeek API 不可用，改用互联网公开来源，可复核性降低"；不得将互联网结果伪装为 PatSeek 结果 |
| 3. 暂停 | 保留已完成的部分结果，记录中断原因和待恢复的检索步骤 |

### 缓存命中不算失效

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

### 预防性检查

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

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

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

## 执行前检查

| 检查项 | 必须确认的内容 |
|---|---|
| 任务 | 可专利性、FTO、调研或直接检索 |
| 使用者与决策 | 企业管理/市场/IP/研发、发明人、技术经理或高校团队；报告要支持什么决定 |
| 对象 | 产品/方法、必要技术特征、部件关系、参数和效果 |
| 日期 | 可专利性：目标申请日及最早优先权日；FTO：计划实施时间；技术调研：分析时间范围与数据截止日 |
| 地域 | CN 或 world；FTO 必须列明具体实施国家，`WO/EP` 不能直接代表可执行国家权利。涉及非中国专利时**必须先读** `references/world_search_reference.md` |
| 文献 | 专利文献是否足够；是否需要论文、标准、手册、网页或官方登记簿 |
| 保密 | 是否包含未申请的关键参数、配方、源代码或商业秘密 |
| 检索模式 | 已向用户呈现 快速摸底/完整深度 选择并确认（FTO/无效/正式决策除外） |

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

## 命令

### Bool 检索

```bash
# 中国库
python3 <skill-dir>/scripts/patseek_client.py bool '(固态电池 OR 全固态电池) (热管理 OR 温度控制) (相变材料 OR 冷却流道 OR 热失控预警)' --page-size 20

# 国际库与公开机构代码；CC 只过滤公开号前缀，不代表 FTO 法域有效性
python3 <skill-dir>/scripts/patseek_client.py bool '(solid-state battery) (thermal management) (phase-change material OR cooling channel) CC=(US OR EP)' --market world --page-size 20

# 正常翻页，不触发近似检索拦截
python3 <skill-dir>/scripts/patseek_client.py bool '(solid-state battery) (thermal management)' --market world --page 2
```

字段：`AP` 申请人、`IPC` 分类、`PID` 公开号、`AN` 申请号、`AD` 申请日、`PD` 公开日、`NOT` 排除、`CC` world 公开号前缀。`AN` 在 world 库无数据。

### 国际专利检索（market=world）

任务涉及 US/EP/JP/KR/WO 等非中国专利时，**必须先读 `references/world_search_reference.md`**。world 库与 CN 库表面语法相同，但字段行为存在实质差异：`AN=` 无数据、IPC 偏好紧凑写法（与 CN 相反）、申请人和关键词均支持多语言匹配、`CC=` 仅 world 库支持。**world 库检索优先使用英文关键词**（实测 title/abstract/description 100% 英文存储，覆盖所有国家；claims 保持当地语言，需核对权利要求时补充当地语言）。
```bash
# 英文关键词 + 国家限定
python3 <skill-dir>/scripts/patseek_client.py bool "solid-state battery CC=(US OR EP)" --market world --page-size 20

# 申请人多语言检索（中文可命中日文申请人，英文可命中英文存储的申请人）
python3 <skill-dir>/scripts/patseek_client.py bool "AP=(丰田 OR Toyota OR トヨタ) battery" --market world --page-size 20

# IPC + 国家（world 库 IPC 用紧凑写法，如 H01M10/0525）
python3 <skill-dir>/scripts/patseek_client.py bool "IPC=(H01M) solid-state battery CC=(US OR JP)" --market world --page-size 20

# 三块组合 + 国家 + 日期
python3 <skill-dir>/scripts/patseek_client.py bool "(solid-state battery) (thermal management) (phase-change material OR cooling channel) CC=(US OR EP) AD>=2022" --market world --page-size 20

# 多语言关键词组合（中/英/日均有效）
python3 <skill-dir>/scripts/patseek_client.py bool "(固态电池 OR solid-state battery OR 全固体電池) CC=(US OR JP)" --market world --page-size 20

# 精确公开号查国际专利
python3 <skill-dir>/scripts/patseek_client.py bool "PID=(US10234567B2)" --market world --page-size 5
```

world 复合式返回 0 条时，不得直接判定无专利；必须执行四层探针（对象+CC / 机制+CC / IPC子类+CC / 准确IPC主组+CC），详见 `references/world_search_reference.md` 第 8 节。

### 附图展示

`patent` 命令支持 `--show-figures`（显示附图 URL 列表）和 `--figures-dir <目录>`（下载附图到本地目录）：

```bash
# 查看附图 URL（不下载）
python3 <skill-dir>/scripts/patseek_client.py patent US10234567B2 --market world --show-figures

# 下载附图到本地目录
python3 <skill-dir>/scripts/patseek_client.py patent CN217874688U --figures-dir ./figures/CN217874688U
```

附图来源于 Google Patents，**可靠性已实测验证**（US/CN 均可成功下载且清晰可读）。重点专利在报告中应尽量展示附图以辅助读者理解技术方案。展示规范与来源可靠性详见"候选池与证据核对"中的附图展示规范。

### 专利详情

```bash
# 查新/比对核对用（推荐：0 积分，走每日免费额度 50-100 次/日）
python3 <skill-dir>/scripts/patseek_client.py patent CN118658342A --no-enrichment

# 需要 pdf_url / 优先权日 / 法律状态 / 同族时（1 积分/次）
python3 <skill-dir>/scripts/patseek_client.py patent CN118658342A
python3 <skill-dir>/scripts/patseek_client.py patent US10234567B2 --market world
```

详情缓存12小时（两种模式的缓存互相独立）。增强字段可能缺失或来自聚合源；法律状态用于筛查，不代替目标法域官方登记簿复核。

### 详情调用的省钱策略（2026-09-05 实测）

`--no-enrichment` 走**每日免费额度（50-100 次/日，北京零点重置）**，**`credits_charged=0`**；
默认模式（`include_enrichment=true`）扣 **1 积分/次**。两者主源字段完全一致。

| | `--no-enrichment`（0 分） | 默认（1 分） |
|---|---|---|
| **始终返回** | `pid / appnum / title / ipcs / appdate / pubdate / applicant / abstract / claims / description / figures / aggregation` | 同左（完全相同） |
| **额外增强 13 项** | ❌ 无 | `inventors / priority_date / prior_art_date / legal_status / latest_legal_event / legal_event_count / family_count / citation_count / cited_by_count / similar_count / keywords / pdf_url / canonical_url` |

**怎么选**：

| 场景 | 建议 | 理由 |
|---|---|---|
| 查新/X-Y 比对核对 | ✅ `--no-enrichment` | 判断只靠 claims、description、appdate、pubdate，**全在主源**；连抵触申请（在先申请+在后公开）也只需 `appdate`+`pubdate` |
| 进入报告的 X/Y **核心候选**（1-3 篇） | 默认模式 | 补 `pdf_url`（报告原文链接）与 `priority_date` |
| **FTO / 侵权风险** | **必须默认模式** | `legal_status` 是侵权判断核心，不能省 |
| 无效检索 | 默认模式 | 需 `priority_date` 定关键日、`family_count` 找同族 |

⚠️ **额度耗尽会返回 429 `DETAIL_DAILY_QUOTA_EXHAUSTED`**（客户端会直接提示、不做无效重试）：
改用默认模式付费，或等北京零点重置。批量查新（详情 >50 篇/日）需预留 fallback。

> ⚠️ `family_count` **只有数量、没有成员清单**——即使付费也完不成同族去重，
> 按「候选池与证据核对」要求标注"无法完成同族去重"即可，**不必为它付费**。

### 语义检索

```bash
python3 <skill-dir>/scripts/patseek_client.py semantic '完整且去标识化的技术描述' --timeout 180 --no-call-log
```

语义检索面向中文技术描述（**语义先行**用法见"检索模式选择→语义先行"：完整深度且用户已给详细方案时，先做 1 次用于 IPC/术语确认）。**实测语义结果含国际公开号（US/WO/JP/EP/KR，约占 20-25%）**——"仅支持中国库"指查询须用中文描述，不表示结果仅 CN 公开号。只把它用于召回不同术语的候选，不把相似度当作新颖性、创造性或侵权判断。失败、取消或超时必须报告为失败，不能解释为0条结果。

语义任务不限总次数，但默认串行提交，相邻两次提交至少间隔60秒；不要并发批量提交。每次使用不同的技术角度，并记录新增术语、分类和高覆盖候选；连续两轮无新增时停止该角度。

批量语义检索逐任务流式保存结果，不要等整批结束后一次性写出。单个任务失败或服务端超时时，记录任务ID、失败状态和已接收数量，保留此前已完成结果并继续后续独立角度；失败任务不能当作0条，也不能让整批证据丢失。需要重试时使用更窄或不同机制的描述，并继续遵守60秒提交间隔。

两个以上语义角度优先使用断点脚本。任务文件为JSON数组或JSONL，每项包含`id`和`query`；检查点不保存查询原文和Key，完整结果逐任务原子写入输出目录：

```bash
python3 <skill-dir>/scripts/semantic_batch.py semantic_tasks.json \
  --checkpoint semantic_checkpoint.jsonl --output-dir semantic_results
```

重跑相同命令会跳过已成功保存的任务；失败项会再次执行。不要把检查点或结果目录放入公开仓库，高度敏感方案仍先去标识化。

### 缓存与重复调用

- 相同查询优先命中缓存：Bool 15分钟、详情12小时、语义60分钟。
- `--no-cache` 表示明确要求最新数据，并跳过近似拦截；它仍会更新缓存。
- `--force` 只跳过近似拦截；不要用于翻页。
- 公共参数可以放在子命令前或后。

### 无效检索 Goal Loop 控制器

`scripts/invalidity_goal.py`（不调用 API、不消耗积分），用于驱动无效检索的持续循环，全部子命令的 `case_dir` 为**位置参数**：

```bash
PY=/path/to/python; G=scripts/invalidity_goal.py
$PY $G init <case_dir> --target-patent CN1234567A --critical-date 2019-06-11 ...
$PY $G enqueue  <case_dir> actions/A01_qx_cn.json     # 入队一个动作
$PY $G next     <case_dir> --limit 3 --claim          # 按优先级认领待办
$PY $G record   <case_dir> A0001 results/A0001.result.json
$PY $G checkpoint <case_dir> --note "本轮结论"         # 结算增益、给出 recommendation
$PY $G status   <case_dir>
$PY $G complete <case_dir> --reason evidence_ready|saturated --note "..."
$PY $G suggest-diversity <case_dir> [--threshold 2]   # 未覆盖特征经≥2 Bool通道→建议语义B/C骨架
$PY $G export <case_dir> [--output evidence_skeleton.json]  # 导出 evidence.json 骨架
```

要点：

- `record` 会把结果里的 `followups` 自动入队并分配新动作号，无需手工 enqueue；检测到封顶（`total>=10000` 或 `truncated`）时输出 `narrowing_suggestions` 收窄建议（不自动入队）。
- `result.json` 的 `feature_coverage_delta` 必须是**数值**（float），填字典会抛 `TypeError`。
- `result.json` 新增结构化覆盖字段：`covered_features`（本动作确证覆盖的特征 ID 列表）和 `feature_gaps`（`[{"feature_id":"F7","reason":"..."}]` 缺口记录）。`checkpoint` 据此计算 `real_coverage_delta` 并强制饱和门第 4 条件（`all_features_covered_or_gapped`）。
- `result.json` 可选填 `credits_charged`/`credits_remaining`（从 API 回包取），`record` 累加进 `state.cost`，`status` 报累计消耗。
- 动作 JSON 可选填 `features`（特征 ID 列表），`suggest-diversity` 据此判断哪些特征已尝试过哪些 Bool 通道。
- `checkpoint` 维护**两级零增益计数**：`zero_gain_cycles`（宽松，任一正增益归零）和 `zero_decisive_cycles`（严格，仅决定性证据/高覆盖/真实覆盖增量归零）。饱和门用 `zero_decisive_cycles >= 3` 且 `all_features_covered_or_gapped` 才进 `saturation_review`；仍有特征未覆盖时即使 decisive 零增益也走 `plan_new_diverse_actions`（保护多样性续作）。
- `complete --reason evidence_ready` 在门未推荐 `saturation_review` 时**必须附 `--note`** 说明覆盖理由，否则拒绝执行；事件日志记 `override_gate=true`。
- `export` 从 goal_state 自动生成 evidence.json 骨架（searches/details/gate stub），`gate.status`/`limitations`/`conclusion` 需人工填写再交 `report_guard.py` 校验。
- `checkpoint` 的 `recommendation` 取值：`continue_required_lanes` / `continue_high_value_frontier` / `saturation_review` / `continue_frontier` / `plan_new_diverse_actions`。收到 `plan_new_diverse_actions` 意味着**必须换多样性轴**（语种、库、语义视角 A/B/C、相邻领域），而不是重跑同类检索。
- 目标专利若为授权 B 号且 PatSeek 未收录，改用同族 A 公开号做 `--target-patent`。

### 引证下钻（两层 · 硬约束）

找到高质量 Y 文件后，沿「同族 → 引证 → 引证的引证」下钻，是获取优质对比文件、分类号和英文关键词性价比最高的路径之一。实测 1 篇起始 → **49 篇 / 11 次详情调用 = 4.5 篇每积分**，第二层外文占比 42%（第一层仅 10%）。

```bash
$PY scripts/citation_drill.py --pid <Y文件公开号> --depth 2 --out drill.json
```

**起点**：✅ 从已确认的强相关候选 / Y 文件下钻。❌ **不得从目标专利本身下钻**（近年申请的目标专利 `citations` 通常为空；实测 CN209310489U 下钻产出 0 篇）。

**四条硬约束（违反会致错误结论，详见 `references/invalidity_search_workflow.md` §4.3）**：

1. 🔴 **`relationships` 里的 `publication_date` 不是公开日**——9/9 样本等于申请日或优先权日，0 个等于公开日。只能排序粗筛；判日期适格性前**必须**逐篇取详情用 `pubdate`（现有技术）/ `appdate`（抵触申请）。误用会把抵触申请错判为现有技术。
2. 🟠 **截断只对 `cited_by` 可自判**——`coverage=="partial"` ⟺ `returned_count < reported_family_cited_count`。`citations` 块无 reported 计数，`coverage` 恒 `unknown`，**禁止**表述为「已穷尽」。
3. 🟡 **国别覆盖不均**——JP 旧年号 `JPS*`/`JPH*` 与 `TW*` 不可查；**US A1 仅 60% 可查且无号段规律**。失败均为 HTTP 200 + 空列表的**静默失败**，必须记入未跟进清单，不得静默丢弃。
4. 🟡 **同族 `document_id` 需降级**——`patent/CN108733178B/en` → 去种类码 → CN 号强制换 `A`。`application_number` 不可直接查。

**同族合并是可选增益**：实测增量 0% ~ +60%。同族 ≤ 2 件可跳过；成员 `relationships` 为空时写「同族引证覆盖不完整」，**禁止写「增量 0」**。

**禁区**：本接口无 IPC、无申请人、无权利要求全文、**无 X/Y/A 引证类别**。判证据等级须走 `register.epo.org/smartSearch` 或 CN 授权公告 PDF (56) 栏。

## 外部核验与限制

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 还必须补充：

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

## 参考

- 检索式构造、试验性检索策略、质量闸门与候选池核对 → [retrieval-playbook.md](references/retrieval-playbook.md)

- `references/query_syntax.md`：Bool 语法与市场差异
- `references/api_reference.md`：API 和实际返回字段
- `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_goal_loop.md`：**无效检索 Goal Loop 持续驱动机制（动作队列、增益结算、饱和门）**
- `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 失效等）

## 常见问题

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

使用说明

# PatSeek 专利检索

基于 PatSeek API 的专利检索与分析技能，支持 Bool 检索、语义检索、国际专利检索与专利详情核对。

## 功能

- 四大任务流程：可专利性查新、FTO/侵权风险、专利无效证据检索、技术调研/竞品分析
- 中国库（cn）与国际库（world）双检索，支持申请人多语言、IPC 分类、日期限定
- 检索全程预算控制与费用熔断，输出可复核的检索报告

## 使用示例

1. 对 Agent 说：「帮我做一个关于浮动盲插连接器的查新检索」
2. 按提示确认检索范围与深度（快速摸底 / 完整深度）
3. 获得候选专利池、特征比对表与检索报告

## 依赖

- 需要配置 PatSeek API Key（环境变量 `PATSEEK_API_KEY`），Key 在 patseek.cn 官网获取
- Python 3（脚本见 scripts/）

## 注意

- API 为付费服务，费用以 API 实际返回为准；报告为检索参考，不构成法律结论

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。