linkfox-ruiguan-trademark-graphic-detection

睿观图形商标检测

本技能指导你如何检测商品图片中的图形商标，帮助电商卖家和品牌所有者在上架商品前识别潜在的商标侵权风险。

核心概念

图形商标检测会分析商品图片，在多个国家和地区查找视觉上相似的注册商标。该工具使用基于 YOLO 的目标检测技术定位图片中类似徽标的区域，然后将其与全球商标数据库进行比对。

相似度分数：similarity 值越高，检测到的图形与注册商标在视觉上越相似。数值越接近 1.0，表示匹配程度越高，侵权风险也越高。

商标状态含义：

状态	含义
registered	商标已有效注册
act	商标处于有效状态
pend	商标申请正在处理中
filed	商标申请已提交
ended	商标已过期
DEL	商标已删除／取消

参数指南

参数	必填	说明	默认值
imageUrl	是	可公开访问的 HTTP(S) 商品图片 URL（最长 1000 个字符）。服务会下载图片并将其转换为 Base64；请勿直接传入 Base64。	-
topNumber	是	返回的检测结果数量上限（1-100）	5
productTitle	否	商品标题，有助于提高检测准确度	-
trademarkName	否	疑似徽标名称，有助于缩小结果范围	-
regions	否	要查询的国家／地区代码，以逗号分隔。省略时将搜索所有国家	全部
enableLocalizing	否	是否启用对检测区域的图片裁剪	false
enableRadar	否	是否启用雷达监控	true

支持的地区

US（美国）、WO（WIPO）、ES（西班牙）、GB（英国）、DE（德国）、IT（意大利）、CA（加拿大）、MX（墨西哥）、EM（欧盟）、AU（澳大利亚）、FR（法国）、JP（日本）、TR（土耳其）、BX（比荷卢）、CN（中国）

用户未指定地区时，请省略 regions 参数，默认搜索所有国家。

本地图片上传

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

运行上传脚本：

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

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

使用示例

1. 基本图片商标检查 检测商品图片中所有地区的商标，最多返回 10 条结果：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 10

2. 指定地区的商标检查 仅将商品图片与美国和欧盟商标数据库进行比对：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 5
regions: "US,EM"

3. 提供商品背景信息的详细检查 提供商品标题和疑似徽标名称，以获得更准确的检测结果：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 10
productTitle: "Wireless Bluetooth Headphones with Noise Cancellation"
trademarkName: "SonicWave"
regions: "US,GB,DE"

4. 启用图片裁剪的完整检测 启用定位功能，获取检测到的徽标区域的裁剪图片：

imageUrl: "https://example.com/product-image.jpg"
topNumber: 20
enableLocalizing: true
regions: "US"

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-trademark-graphic-detection-<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／套餐到期／需充值／请充值”或类似含义的内容。

显示规则

1. 清晰展示结果：使用结构清晰的表格展示检测结果，包括商标图片、相似度分数、商标名称、状态、注册局、尼斯分类、申请人名称和关键日期。
2. 突出高风险匹配：相似度高于 0.8 时，明确提醒用户存在较高的侵权风险。
3. 说明商标状态：展示结果时，说明每种商标状态对用户风险评估的意义。
4. 雷达结果：如果响应中包含 radarResult，请醒目展示，因为其中包含汇总风险评估。
5. 子雷达结果：如果单条结果中包含 subRadarResult，请在对应的匹配项旁展示此信息。
6. 地区背景：始终注明搜索所覆盖的地区，让用户了解检查范围。
7. 错误处理：检测失败时，根据响应说明原因，并建议调整方式（例如使用更清晰的图片、指定地区、调整 topNumber）。

重要限制

• 图片要求：必须提供 imageUrl 参数；没有图片时，工具无法执行检测。
• 结果上限：topNumber 参数将每次请求的结果数限制为最多 100 条。
• 图片质量：检测准确度取决于图片分辨率和清晰度；图片质量越高，结果越准确。
• 地区覆盖范围：并非覆盖所有国家；支持列表包含 15 个主要商标局。

用户表达与场景速查

适用——图形商标检测任务：

用户说法	场景
“检查这张图片是否存在商标问题”	基础商标检测
“这个 Logo 是否在任何地区注册过”	多地区商标搜索
“我的商品图片存在商标风险吗”	商品刊登风险评估
“查找与这张图形相似的商标”	相似度搜索
“检查这张图片是否与美国商标冲突”	指定地区检测
“这个设计是否侵犯任何商标”	侵权风险检查
“扫描我的商品照片中的 Logo”	商品图片中的 Logo 检测

不适用——超出图形商标检测范围的需求：

• 文字／词语商标搜索（不涉及图片）
• 商标注册或申请
• 专利或版权检查
• 商标纠纷法律建议
• 商品刊登优化

边界判断：当用户说“检查我的商品”或“这样销售安全吗”时，如果其关注的是商品图片中的图形元素或 Logo 可能侵犯已注册商标，则适用此技能。如果用户询问的是文字商标、专利问题或一般法律合规，则不适用。

算力消耗规则

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

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

反馈：

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

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

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

---

如需获取更多高质量、专业的跨境电商技能，请设置 LinkFox Skills。