通过图片检索智慧芽外观设计专利以排查侵权风险

当需要以产品图片检索相似外观设计专利、评估外观侵权风险时使用。

适用场景

解决思路

1. 调用 POST /zhihuiya/patentImageSearch 接口，或运行 python scripts/zhihuiya_patent_image_search.py '<JSON 参数>' [--inline] 脚本。
2. 必填参数：url（图片URL）、patentType 固定为 D（外观设计）、model 选 1（智能关联，推荐默认）或 2（以图搜图精确匹配）。
3. 若用户提供的是本地图片路径，先运行 python scripts/upload_image.py /path/to/local/image.png 上传，获取有效期24小时的公网URL再用于检索。
4. 按需添加可选参数：country（国家代码逗号分隔，如 CN,US,JP）、loc（洛迦诺分类号，可用 AND/OR/NOT 连接）、legalStatus、simpleLegalStatus（0过期/1有效/2审中）、assignees、applyStartTime/applyEndTime、publicStartTime/publicEndTime（格式 yyyyMMdd）、limit（1-100，默认10）、offset（0-1000）、field（SCORE/APD/PBD/ISD）、order（desc/asc）、lang（original/cn/en）、preFilter（默认1）、stemming（默认0）、mainField、includeMachineTranslation、scoreExpansion、isHttps、returnImgId。
5. 结果始终按 score 降序排列，分数越高表示视觉相似度越高。
6. 展示结果时完整列出每项专利的：申请号 apno、中文标题（用 lang: cn 或提供翻译）、发明人 inventor、匹配的专利附图 url、图片列表中的每一张专利图片、摘要、说明书、LOC 分类信息 loc、radarResult（若有）及专利说明书全文，不得省略或简写。
7. 在结果末尾附上免责声明：本检索结果由 LinkfoxAgent 生成，建议咨询专业专利律师获取法律意见。
8. 提醒用户 score 仅代表视觉相似度，不构成法律上的侵权判定。
9. 当匹配总数超过返回结果数时，告知用户总数并引导使用 offset 与 limit 翻页。
10. 查询失败时说明原因并建议调整（如确认图片URL可公开访问、检查国家代码、调整日期格式）。
11. 遵守成本约束：同一会话同一参数组合默认只调用一次，脚本带24小时本地缓存；失败或空结果不得自动换关键词、翻页或改邮编连续试探，需继续检索时先向用户说明会产生额外消耗。
12. 输出始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-image-search-<timestamp>.json（禁止写入 /tmp）；响应体 ≤8KB 时落盘后打印完整 JSON，>8KB 时只输出摘要（顶层字段、total/costToken 等计数、最大列表字段长度+前3条样本），加 --inline 可强制全量打印。
13. 读取数据时先看摘要判断是否足够，需要具体字段时用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
14. 遇到未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 缺失）、响应401/402、或提示算力/余额不足时，按 references/onboarding.md 引导解决。
15. 当功能异常、结果不符用户意图、用户表达不满或赞赏、或有可改进之处时，按 references/api.md 调用 Feedback API 上报，不打断用户流程。
16. 高频调用或用户对算力消耗预期不足时，提醒用户本技能消耗81算力，由用户决定是否继续。

适用边界 · 注意事项

• 仅支持外观设计专利（D），实用新型专利检索需改用 linkfox-zhihuiya-utility-patent-image-search。
• 不适用于文本检索专利（关键词/摘要/权利要求）、法律状态监控与年费管理、专利估值与许可谈判、FTO 法律意见、专利族或引用分析。
• 需要公网可访问的图片URL，本地图片必须先上传；且依赖智慧芽/LinkFox 服务与 API Key，非通用能力。