用途
本技能用于检测产品图片中的图形商标，帮助电商卖家和品牌方在上架产品前识别潜在的商标侵权风险。它分析产品图片，在多个国家和地区查找视觉上相似的已注册商标。
主要能力
- 图形商标检测：使用基于 YOLO 的目标检测定位图片中类似 Logo 的区域，再与全球商标数据库比对。
- 相似度分数：数值越高表示检测到的图形与注册商标视觉上越相似，接近 1.0 表示近乎一致，侵权风险更高。
- 商标状态说明：registered（已注册）、act（有效）、pend（申请待审）、filed（已提交申请）、ended（已过期）、DEL（已删除/撤销）。
- 支持区域：US（美国）、WO（WIPO）、ES（西班牙）、GB（英国）、DE（德国）、IT（意大利）、CA（加拿大）、MX（墨西哥）、EM（欧盟）、AU（澳大利亚）、FR（法国）、JP（日本）、TR（土耳其）、BX（比荷卢）、CN（中国）。未指定区域时默认搜索所有国家。
- 雷达监控：可返回聚合风险评估结果（radarResult）及子雷达结果（subRadarResult）。
参数说明
- imageUrl（必填）：可公开访问的 HTTP(S) 产品图片 URL，最长 1000 字符。服务会下载并转为 Base64，请勿直接传 Base64。
- topNumber（必填）：返回检测结果的最大数量（1-100），默认 5。
- productTitle（可选）：产品标题，有助于提高检测准确度。
- trademarkName（可选）：疑似 Logo 名称，有助于缩小结果范围。
- regions（可选）：要检查的国家/地区代码，逗号分隔。省略则搜索所有国家。
- enableLocalizing（可选）：是否对检测到的区域启用图片裁剪，默认 false。
- enableRadar（可选）：是否启用雷达监控，默认 true。
使用方式
- API 端点：POST /ruiguan/trademarkGraphicDetection（完整参数/响应/错误码见 references/api.md）。
- Python 脚本：python scripts/ruiguan_trademark_graphic_detection.py '<JSON 参数>' [--inline]。
- 本地图片上传：若用户提供本地图片路径，需先运行 python scripts/upload_image.py /path/to/local/image.png 获取公开 URL（有效期 24 小时）。
使用示例：
- 基础图片商标检查（所有区域，最多 10 条）：imageUrl、topNumber: 10。
- 指定区域检查（仅美国和欧盟）：imageUrl、topNumber: 5、regions: "US,EM"。
- 带产品上下文的详细检查：imageUrl、topNumber: 10、productTitle、trademarkName、regions: "US,GB,DE"。
- 启用图片裁剪的完整检测：imageUrl、topNumber: 20、enableLocalizing: true、regions: "US"。
输出策略
脚本默认行为：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-trademark-graphic-detection-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。
- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout。
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
- 加 --inline 强制全量打印到 stdout（同样落盘）。
- 读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取。
适用场景
- 检查图片是否存在商标问题（基础商标检测）。
- 查询某 Logo 是否在任何地方注册（多区域商标搜索）。
- 产品图片的商标风险评估（上架风险评估）。
- 查找与该图形相似的商标（相似度搜索）。
- 针对美国商标检查图片（指定区域检测）。
- 判断某设计是否侵犯商标（侵权风险检查）。
- 扫描产品照片中的 Logo（产品图片 Logo 检测）。
限制
- 图片要求：imageUrl 参数为必填，无图片无法检测。
- 结果上限：topNumber 每次请求最多 100 条。
- 图片质量：检测准确度取决于图片分辨率和清晰度，质量越高结果越好。
- 区域覆盖：并非覆盖所有国家，支持列表包含 15 个主要商标局。
- 不适用场景：文字/文字商标搜索（不涉及图片）、商标注册或申请、专利或版权检查、商标纠纷法律建议、产品上架优化。
成本与算力
- 雷达检测开启消耗 92 算力，未开启消耗 61 算力。
- 本技能消耗大量算力，如果调用次数超过 5 次，必须用 AskUserQuestion 和用户进行二次确认，明确告知已消耗算力和继续调用预计消耗的算力，让用户自行决定是否继续。
- 同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
认证与算力问题
发生以下异常情况时，采用 references/onboarding.md 引导解决：
- 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
- 响应 401 或 402 状态码。
- 响应提示算力或余额不足：消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"或类似含义的内容。
展示规则
- 清晰呈现结果：以结构化表格展示检测结果，包括商标图片、相似度分数、商标名称、状态、注册机构、尼斯分类、申请人名称和关键日期。
- 高亮高风险匹配：相似度高于 0.8 时，明确警告用户存在高侵权风险。
- 解释商标状态：展示结果时说明各商标状态对用户风险评估的含义。
- 雷达结果：若响应中存在 radarResult，应显著展示，因其包含聚合风险评估。
- 子雷达结果：若单项包含 subRadarResult，应随每条匹配一并展示。
- 区域上下文：始终标明搜索了哪些区域，让用户了解检查范围。
- 错误处理：检测失败时，根据响应解释原因并建议调整（如使用更清晰的图片、指定区域、调整 topNumber）。
反馈
在以下情况通过 Feedback API 自动检测并报告反馈：技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户表达不满或赞扬；任何可改进之处。按 references/api.md 调用反馈 API，不要打断用户流程。