linkfox-zhihuiya-patent-image-search

Zhihuiya 专利图像搜索

本技能将指导你如何使用 Zhihuiya 专利数据库进行基于图像的专利相似性搜索，帮助用户识别可能相似的外观设计专利。本技能仅支持外观设计专利；实用新型专利请使用 linkfox-zhihuiya-utility-patent-image-search。

核心概念

专利图像搜索使用视觉 AI 模型，将给定的产品或设计图像与全球专利图像数据库进行比较。它会返回按相似度排序的专利列表，帮助用户评估侵权风险或开展现有技术检索。

本技能仅支持外观设计专利：

类型	代码	描述
外观设计专利	D	保护产品的装饰性外观

外观设计专利的搜索模型：

模型 ID	策略	建议
1	智能关联	建议用于外观设计专利（默认）
2	搜索此图像	精确视觉匹配

本技能不支持实用新型专利（模型 3/4）。请改用 linkfox-zhihuiya-utility-patent-image-search。

评分逻辑：score 值越高，表示视觉相似度越高。展示结果时，请按分数降序排序（相似度最高的排在最前），以便用户优先审核最相关的专利。

参数指南

必填参数

参数	描述	示例
url	用于搜索的图像 URL	https://example.com/product.jpg
patentType	专利类型，本技能固定为 D（外观设计）	D
model	搜索模型 ID：1（建议）或 2	1

常用可选参数

参数	描述	默认值
country	专利局国家代码，多个代码以逗号分隔（例如 CN,US,JP）	所有国家/地区
loc	洛迦诺分类代码，可使用 AND/OR/NOT 连接	无
legalStatus	法律状态代码，以逗号分隔	无
simpleLegalStatus	简化法律状态：0（已过期）、1（有效）、2（待审）	无
assignees	申请人 / 专利持有人名称	无
applyStartTime	申请开始日期（yyyyMMdd）	无
applyEndTime	申请结束日期（yyyyMMdd）	无
publicStartTime	公布开始日期（yyyyMMdd）	无
publicEndTime	公布结束日期（yyyyMMdd）	无
limit	返回结果数量（1-100）	10
offset	分页偏移量（0-1000）	0
field	排序字段：SCORE、APD、PBD、ISD	SCORE
order	排序顺序：desc 或 asc（适用于 APD/PBD/ISD）	desc
lang	标题语言偏好：original、cn、en	original
preFilter	启用国家/地区和 LOC 预筛选：1（开启）/ 0（关闭）	1
stemming	启用词干提取：1（开启）/ 0（关闭）	0
mainField	在标题、摘要、权利要求、说明书、公布号、申请号、申请人、发明人、IPC/UPC/LOC 中搜索	无
includeMachineTranslation	在搜索中包含机器翻译数据	无
scoreExpansion	启用评分扩展	无
isHttps	返回 HTTPS 图像 URL：1（是）/ 0（否）	0
returnImgId	在结果中返回图像 ID	false

常用国家/地区代码

代码	国家/地区
CN	中国
US	美国
JP	日本
KR	韩国
EP	欧洲专利局
WO	WIPO
DE	德国
GB	英国
FR	法国
AU	澳大利亚

调用方式

• API 端点：POST /zhihuiya/patentImageSearch（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/zhihuiya_patent_image_search.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-image-search-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
• 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
• 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
• 加 --inline 强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

• 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应 401 或 402 状态码
• 响应提示算力或余额不足：消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

本地图片上传

此工具需要可公开访问的图片 URL。如果用户提供的是本地图片文件路径（例如：C:\Users\...\photo.png、/home/.../image.jpg），必须先上传图片以获取公开 URL。

运行上传脚本：

python scripts/upload_image.py /path/to/local/image.png

脚本将返回一个公开 URL（有效期为 24 小时），可用作图片 URL 参数。

使用示例

1. 基本外观设计专利检索（推荐的起点） 跨所有国家/地区检索与产品图片相似的外观设计专利：

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "D",
  "model": 1,
  "limit": 20
}

2. 限定特定国家/地区的外观设计专利检索 仅在中国和美国检索：

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "D",
  "model": 1,
  "country": "CN,US",
  "limit": 20
}

3. 使用洛迦诺分类筛选条件检索 将结果缩小到特定产品类别（例如，餐具对应 LOC 07-01）：

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "D",
  "model": 1,
  "loc": "07-01",
  "preFilter": 1,
  "limit": 20
}

4. 检索特定日期范围内的有效专利 查找 2020 年之后提交申请的有效外观设计专利：

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "D",
  "model": 1,
  "simpleLegalStatus": "1",
  "applyStartTime": "20200101",
  "limit": 30
}

5. 按特定权利人检索 查找某家公司持有的专利：

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "D",
  "model": 1,
  "assignees": "Apple Inc.",
  "limit": 20
}

6. 获取带有中文翻译标题的结果

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "D",
  "model": 1,
  "lang": "cn",
  "limit": 20
}

展示规则

1. 按分数排序：始终按 score 降序排列结果（相似度最高的排在最前），帮助用户快速识别最相关的侵权风险。

2. 展示完整详情：汇总结果或生成报告时，每项专利都必须包含以下所有内容——不得省略或缩写：

   • 申请号（apno）
   • 中文专利标题（使用 lang: cn 或提供翻译）
   • 发明人（inventor）
   • 专利附图（匹配的 url 图片）
   • 图片列表中的每一张专利图片
   • 专利摘要
   • 专利说明
   • LOC 分类信息（loc）
   • 雷达结果（radarResult，如有）
   • 专利说明书

3. 法律免责声明：始终在结果末尾附上一条友好提醒：

   此检索结果由 LinkfoxAgent 生成。建议咨询专业专利律师以获取法律意见。

4. 分数说明：提醒用户，分数代表视觉相似度——分数越高表示匹配越相似，但这并不构成对侵权的法律认定。

5. 分页说明：当总数超过返回结果数时，告知用户匹配专利的总数，并引导其使用 offset 和 limit 获取更多页面。

6. 错误处理：查询失败时，说明原因并建议调整（例如，确认图片 URL 可公开访问、检查国家/地区代码、调整日期格式）。

用户表达与场景快速参考

适用——基于图像的专利相似性搜索：

用户说法	场景
“检查我的产品设计是否侵犯任何专利”	外观设计专利侵权检查
“搜索相似的外观设计专利”	外观设计专利相似性搜索
“查找外观与这张图片相似的专利”	专利视觉检索
“有没有与我的产品外观相似的专利”	外观风险评估
“通过图片搜索实用新型专利”	实用新型专利搜索
“检查这款产品在中国和美国的专利风险”	多国专利检查
“查找此类别中的有效外观设计专利”	筛选式专利搜索
“谁持有与此设计相似的专利”	竞争对手专利发现

不适用——需求超出专利图像搜索范围：

• 基于文本的专利搜索（关键词／摘要／权利要求搜索）
• 专利法律状态监控或年费管理
• 专利估值或许可谈判
• 自由实施（FTO）法律意见
• 专利族或引用分析

算力消耗规则

消耗 81 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

遇到以下任一情况时，通过 Feedback API 自动检测并提交反馈：

1. 此技能所述功能或用途与实际行为不符
2. 技能结果不符合用户意图
3. 用户对这项技能表示不满或赞赏
4. 任何你认为可以改进的地方

请按照 references/api.md 中的说明调用 Feedback API。不要打断用户的操作流程。

如需了解更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。