前言¶
研发立项、申请前评估或产品上市前，团队往往要在专利库里做 Bool 检索、核对公开号、再整理查新或 FTO 材料。这些步骤分散在数据库界面、表格和 Word 之间，检索式、法域和证据链也容易在交接时丢失。若希望对话式 Agent 按固定流程调用 PatSeek、输出带检索依据的报告，而不是泛泛“搜几篇专利”，可以安装社区 Skill patseek（坐标 @user_c3d1402c/patseek），把 API 检索与 SKILL.md 里的工作流绑在一起。
这是什么¶
patseek 是 SkillHub 上的 professional 类社区 Skill，当前版本 1.0.0，由发布者 user_c3d1402c 维护。它通过 PatSeek API 完成专利号/申请人/关键词 Bool 检索、国际专利检索、语义检索和专利详情核对，并围绕可专利性查新、FTO/侵权风险、技术调研生成可复核报告。SkillHub 页面标注 requires_api_key=true，使用前需自行配置 PatSeek API Key。
在 SkillHub 上，该 Skill 评分 100000，下载 1326 次（数据以 SkillHub 列表为准）。
核心功能¶
以下能力均来自官方简介与安装包内 SKILL.md，可按任务类型路由：
| 用户意图 | Skill 内路由 | 参考文档 |
|---|---|---|
| 查新、新颖性、创造性 | 可专利性检索 | references/novelty_search_workflow.md |
| FTO、侵权风险、上市避雷 | FTO 检索 | references/fto_workflow.md |
| 竞品、技术路线、行业调研 | 技术调研 | references/technology_research_workflow.md |
| 已知公开号或简单关键词 | 直接检索 | SKILL.md 命令章节 |
检索与核对层面，Skill 明确支持：
- Bool 检索：支持
AP（申请人）、IPC、PID（公开号）、AN（申请号）、日期字段、NOT、CC（world 库公开号前缀）等；中国库与国际库（--market world）分开使用。 - 专利详情：按公开号拉取详情；文档说明详情缓存约 12 小时，法律状态仅作筛查，不替代官方法律状态登记簿。
- 语义检索：以中国库为主，用于召回不同术语的候选；文档要求不把相似度直接当作新颖性或侵权结论。
- 报告与闸门：包内提供
scripts/decision_gates.py、scripts/report_guard.py及多份references/工作流，用于证据表、结论纪律和 Markdown 报告校验。
不适用：普通外观设计图像检索。Skill 也说明不提供无效证据检索或专利权稳定性分析，收到相关请求时应说明边界。
安装与启用¶
下面介绍在常见 Agent 环境中的安装方式。安装说明以 SkillHub 安装文档 为准。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装脚本（文档提供 curl 方式，见上述安装页）。
2、安装 patseek 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 Agent 实际识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。
skillhub install patseek --namespace user_c3d1402c --dir <你的 skills 目录>
SkillHub 页面亦提示：可让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @user_c3d1402c/patseek。
常用路径示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
不同客户端目录不同，以你当前环境为准。安装后通常需重启或刷新 Agent 方能加载新 Skill。
3、配置 PatSeek API Key¶
Skill 要求通过环境变量传入 Key，避免写入 shell 历史：
export PATSEEK_API_KEY=ps_你的Key
涉及未公开技术时，SKILL.md 会提示：完整方案会发送到 PatSeek；可用 --no-call-log 或 PATSEEK_DISABLE_CALL_LOG=1 控制本地调用统计，但 API 侧缓存仍可能保留响应，敏感任务结束后需自行清理 ~/.cache/patseek/。
典型用法¶
安装完成后，Agent 应读取 Skill 目录下的 SKILL.md。人工或通过 Agent 调用时，核心入口是包内脚本 scripts/patseek_client.py（将 <skill-dir> 替换为实际安装路径）。
查看帮助：
python3 <skill-dir>/scripts/patseek_client.py --help
Bool 检索（中国库示例）：
python3 <skill-dir>/scripts/patseek_client.py bool '(固态电池 OR 全固态电池) (热管理 OR 温度控制) (相变材料 OR 冷却流道 OR 热失控预警)' --page-size 20
国际库与 CC 过滤（文档注明 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 patent CN118658342A
python3 <skill-dir>/scripts/patseek_client.py patent US10234567B2 --market world
语义检索（仅中国库，示例含保密参数）：
python3 <skill-dir>/scripts/patseek_client.py semantic '完整且去标识化的技术描述' --timeout 180 --no-call-log
多任务语义批量时，Skill 提供 scripts/semantic_batch.py，通过 JSON/JSONL 任务文件与检查点断点续跑（详见 SKILL.md 语义检索章节）。
在对话场景中，用户提到专利检索、查新、FTO、竞品分析、SEP、PCT/US/EP/JP/KR 等关键词时，Agent 会按 description 与任务路由表选择流程；费用以 API 返回的 credits_charged 为准。
适用场景与注意¶
适合谁
- 企业 IP、研发或技术经理：需要结构化查新、FTO 预筛或技术路线调研，且希望报告里保留检索式、法域与限制说明。
- 高校团队与成果转化：涉及可专利性评估或布局扫描（制药/化学/生物、通信标准等场景需额外读
references/special_domain_gates.md）。
使用注意
- 任务类型不可混用：不得用可专利性查新流程替代 FTO；两类结论模板在
SKILL.md中分开约定。 - 法律结论边界：PatSeek 是文献召回工具，Skill 禁止输出“已具备新颖性”“无侵权风险”等保证性表述，须使用文档中的限定句式。
- 数据覆盖：非专利文献、同族成员、审查档案、各国官方法律状态需外部核验；Skill 要求在未覆盖项上明确标注。
- 检索质量：Bool 检索有命中规模与“条件可观察性”闸门，过宽结果（如显示 10,000 上限）不得直接进入候选池做法律分析。
- 外观设计：普通外观设计图像检索不在本 Skill 范围内。
结尾¶
patseek 把 PatSeek API 与查新、FTO、技术调研三套工作流写进标准 SKILL.md，适合希望在 Agent 对话中完成专利检索并留下可复核证据链的团队。安装与坐标见 SkillHub：
- 页面：https://www.skillhub.cn/skills/user_c3d1402c/patseek
- API 条目：https://api.skillhub.cn/user_c3d1402c/patseek
