linkfox-ruiguan-detection-patent-design

Ruiguan 外观设计专利检测

此技能将指导你如何使用 Ruiguan 引擎检测外观设计专利侵权，帮助电商卖家和知识产权专业人士在上架产品前识别潜在的外观设计专利风险。

核心概念

外观设计专利检测使用视觉相似度算法，将产品图片与全球外观设计专利数据库进行比对。系统会返回按相似度评分排序的专利，以及 TRO（临时限制令）诉讼历史，帮助用户评估侵权风险。

相似度评分：介于 0 到 1 之间的数值。数值越高，表示与专利图样的视觉相似度越高。similarity >= 0.7 的专利，或标记有 TRO 执法历史的专利，值得特别关注，应仔细审查。

雷达分析：启用雷达后，每条专利结果都会包含一个 radarResult，其中有一个 same 标记（疑似侵权：true/false）和一个 exp 字段（说明）。这会在原始相似度之外，提供 AI 驱动的判断。

LOC 分类：洛迦诺分类（LOC）是一套用于对工业品外观设计进行分类的国际体系。你可以选择指定 LOC 代码以缩小搜索范围，也可以不设置，让模型自动预测适用的类别。

参数指南

参数	必填	默认值	描述
imageUrl	是	-	用于与专利数据库比对的产品图片 URL
queryMode	是	hybrid	搜索模式：physical（真实产品照片）、line（线稿）、hybrid（组合模式）
topNumber	是	100	返回的专利结果数量（最多 100 条）
regions	否	US	国家/地区代码，多个代码以逗号分隔（例如，US,EU,CN）
productTitle	否	-	用于补充背景信息的产品标题
productDescription	否	-	用于补充背景信息的产品描述
patentStatus	否	1	专利有效状态：1（有效）、0（已过期）、1,0（全部）
enableRadar	否	true	启用 AI 雷达分析，判断是否疑似侵权
topLoc	否	-	用于限制搜索范围的 LOC 一级代码（例如，06,07）。省略则使用自动预测
sourceLanguage	否	-	用于翻译的源语言代码（例如，zh-CN）。如果文本已是英文，则留空

支持的地区

US（美国）、EU（欧盟）、CN（中国）、JP（日本）、KR（韩国）、DE（德国）、GB（英国）、FR（法国）、IT（意大利）、AU（澳大利亚）、CA（加拿大）、BR（巴西）、MX（墨西哥）、IN（印度）、TH（泰国）、SE（瑞典）、CH（瑞士）、IE（爱尔兰）、IL（以色列）、DK（丹麦）、NZ（新西兰）、AT（奥地利）、BX（玻利维亚）、FI（芬兰）、WO（WIPO）

默认地区为 US。用户未指定地区时，请使用 US。

LOC 一级类别

代码	类别
01	食品
02	服装、服饰用品和缝纫配件
03	旅行用品、箱包、阳伞及其他个人用品
04	刷子
05	纺织品、人造及天然片材
06	家具和家居用品
07	其他家居用品
08	工具和五金制品
09	用于运输或搬运货物的包装和容器
10	时钟、手表、测量／检验／信号仪器
11	装饰物品
12	运输或起重工具
13	电力生产、分配或转换设备
14	录制、通信或数据处理设备
15	其他机器
16	摄影、电影和光学仪器
17	乐器
18	印刷和办公机器
19	文具、办公设备、艺术材料、教学材料
20	销售和广告设备、标志
21	游戏、玩具、帐篷和体育用品
22	武器、烟火制品、狩猎／捕鱼／灭虫用品
23	流体分配、卫生、供暖、通风、空调设备及固体燃料
24	医疗和实验室设备
25	建筑单元和施工构件
26	照明设备
27	烟草和吸烟用品
28	药品／化妆品、盥洗用品和器具
29	防火、事故预防和救援设备及器材
30	动物护理和处理用品
31	其他食品或饮料制备机器和器具
32	图形符号、标志、表面图案、装饰、室内／室外布局
ALL	所有类别

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-detection-patent-design-<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. 产品图片专利基础查询（美国市场）

{
  "imageUrl": "https://example.com/product.jpg",
  "queryMode": "hybrid",
  "topNumber": 50,
  "regions": "US"
}

2. 带产品背景信息的多地区查询

{
  "imageUrl": "https://example.com/product.jpg",
  "queryMode": "physical",
  "topNumber": 100,
  "regions": "US,EU,CN",
  "productTitle": "Portable Wireless Charger Stand",
  "productDescription": "A foldable wireless charging stand for smartphones",
  "enableRadar": true
}

3. 使用 LOC 分类缩小搜索范围（家具）

{
  "imageUrl": "https://example.com/chair.jpg",
  "queryMode": "hybrid",
  "topNumber": 80,
  "regions": "US,DE",
  "topLoc": "06",
  "patentStatus": "1"
}

4. 基于草图搜索的线稿模式

{
  "imageUrl": "https://example.com/sketch.png",
  "queryMode": "line",
  "topNumber": 50,
  "regions": "CN,JP,KR"
}

5. 同时查询有效和已过期专利

{
  "imageUrl": "https://example.com/product.jpg",
  "queryMode": "hybrid",
  "topNumber": 100,
  "regions": "US",
  "patentStatus": "1,0"
}

展示规则

1. 高风险专利重点展示：生成摘要或报告时，完整展示所有 similarity >= 0.7 或 troCase = true 的专利详情。对于每项此类专利，须包含：申请号、专利标题（中文）、发明人、TRO 执法历史、最相似的专利图纸、专利图片列表中的每张图片、专利摘要、专利说明书、LOC 信息、雷达分析结果和说明书文本。此类详细展示至关重要——不得缩写或省略这些字段。
2. 免责声明：始终在结尾附上友好提醒：“此检测结果由 LinkfoxAgent 生成。建议咨询专业的知识产权律师以获取法律建议。”
3. 相似度解读：明确说明，相似度评分越高，表示视觉相似度越高，侵权风险也越高。
4. 雷达结果展示：当 radarResult.same 为 true 时，醒目地标记该专利为疑似侵权匹配项，并展示 exp 说明。
5. TRO 警告：对于 troCase = true 或 troHolder = true 的专利，须以警告形式重点标出，因为这表明专利权人曾通过临时限制令积极维权。
6. 图片展示：同时展示 patentImageUrl（最相似的专利图纸）和完整的 images 列表，以便用户将其产品与所有专利图纸进行视觉比较。
7. 错误处理：请求失败时，说明问题并提出纠正建议（例如，检查图片 URL 是否可访问、确认地区代码）。
8. 忠实呈现数据：按原样展示查询结果，不得添加超出工具自身分析范围的主观法律结论。

用户表达与场景速查

适用——外观设计专利风险评估：

用户说	场景
“检查这款产品是否侵犯任何外观设计专利”	基本专利检测
“检查这张图片的专利风险”	基于图片的专利搜索
“这款产品是否有 TRO 风险”	TRO 执法历史查询
“搜索美国和欧盟的外观设计专利”	多地区专利检测
“检查这件家具的外观设计专利”	特定类别专利搜索
“这款产品设计是否可以安全销售”	上架前专利排查
“查找相似的外观设计专利”	基于相似度的专利发现
“专利侵权分析”	全面的专利风险报告

不适用——需求超出外观设计专利检测范围：

• 实用专利或发明专利搜索
• 商标侵权检查
• 版权／DMCA 问题
• 法律案件管理或诉讼策略
• 专利申请或提交协助
• 商品刊登优化或定价

边界判断：如果用户提到“专利检查”或“知识产权风险”，且关注的是产品外观／设计与现有专利的相似性，则适用本技能。如果用户咨询的是实用专利、商标、版权，或需要实际法律咨询，则不适用本技能。

算力消耗规则

开启雷达检测消耗 92 算力，未开启消耗 61 算力。

重要：本技能消耗大量算力，如果调用次数超过 5 次，必须使用 AskUserQuestion 与用户进行二次确认，并明确告知用户已消耗的算力以及继续调用预计消耗的算力，由用户自行决定是否继续。

反馈：

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

1. 本技能所述功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户表达对本技能的不满或赞赏
4. 你认为有任何可以改进之处

按 references/api.md 中的说明调用反馈 API。不要打断用户的流程。

如需获取更多优质、专业的跨境电商技能，请访问 LinkFox Skills。