{"id":"7dee325f-6de3-4db4-95f0-90c253db90c7","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection","name":"Linkfox 电商合规检测","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection","generatedAt":"2026-10-12T13:21:45.439Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-12T02:22:08.533Z","emptyReason":null},"description":"电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。 Skill: Linkfox 电商合规检测 Owner: linkfox-ai Summary: 电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。 Tags: latest:1.2.3 Version history: v1.2.3 | 2026-08-14T14:50:49.644Z | user Update from 1.2.2 to 1.2.3 v1.2.2 | 2026-08-07T10:49:03.701Z | user Update from 1.2.1 to 1.2.2 v1.2.1 | 2026-08-05T09:00:06.975Z | user Update from 1.2.0 to 1.2.1 v1.2.0 | 2026-07-16T04:00:55.636Z | user Update from 1.0.1 to 1.2.0 v1.0.1 | 2026","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 955 downloads reported by the source. Last updated 10/12/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-ecommerce-compliance-detection","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-ecommerce-compliance-detection","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-ecommerce-compliance-detection","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-ecommerce-compliance-detection","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-ecommerce-compliance-detection","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。 Skill: Linkfox 电商合规检测 Owner: linkfox-ai Summary: 电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。 Tags: lates"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:22:08.533Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:22:08.533Z","emptyReason":null},"stars":null,"forks":null,"downloads":955,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.2.3","tractionLabel":"955 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-12T02:22:08.519Z","emptyReason":null},"lastUpdatedAt":"2026-10-12T02:22:08.533Z","lastCrawledAt":"2026-10-12T02:22:08.519Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-13T02:22:08.519Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.3","createdAt":"2026-08-14T14:50:49.644Z","changelog":"Update from 1.2.2 to 1.2.3","fileCount":50,"zipByteSize":240023},{"version":"1.2.2","createdAt":"2026-08-07T10:49:03.701Z","changelog":"Update from 1.2.1 to 1.2.2","fileCount":50,"zipByteSize":239992},{"version":"1.2.1","createdAt":"2026-08-05T09:00:06.975Z","changelog":"Update from 1.2.0 to 1.2.1","fileCount":50,"zipByteSize":239958},{"version":"1.2.0","createdAt":"2026-07-16T04:00:55.636Z","changelog":"Update from 1.0.1 to 1.2.0","fileCount":48,"zipByteSize":230569},{"version":"1.0.1","createdAt":"2026-07-16T03:34:52.879Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":48,"zipByteSize":230752},{"version":"1.0.0","createdAt":"2026-07-15T01:37:42.455Z","changelog":"Initial release","fileCount":48,"zipByteSize":230710}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-ecommerce-compliance-detection","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-12T13:21:45.436Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ecommerce-compliance-detection/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-12T02:22:08.533Z","emptyReason":null},"readme":"Skill: Linkfox 电商合规检测\n\nOwner: linkfox-ai\n\nSummary: 电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。\n\nTags: latest:1.2.3\n\nVersion history:\n\nv1.2.3 | 2026-08-14T14:50:49.644Z | user\n\nUpdate from 1.2.2 to 1.2.3\n\nv1.2.2 | 2026-08-07T10:49:03.701Z | user\n\nUpdate from 1.2.1 to 1.2.2\n\nv1.2.1 | 2026-08-05T09:00:06.975Z | user\n\nUpdate from 1.2.0 to 1.2.1\n\nv1.2.0 | 2026-07-16T04:00:55.636Z | user\n\nUpdate from 1.0.1 to 1.2.0\n\nv1.0.1 | 2026-07-16T03:34:52.879Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nv1.0.0 | 2026-07-15T01:37:42.455Z | user\n\nInitial release\n\nArchive index:\n\nArchive v1.2.3: 50 files, 240023 bytes\n\nFiles: references/linkfox-ruiguan-copyright-detection.md (10186b), references/linkfox-ruiguan-detection-patent-design.md (14266b), references/linkfox-ruiguan-gun-parts-search.md (8523b), references/linkfox-ruiguan-text-trademark-detection.md (11766b), references/linkfox-ruiguan-trademark-graphic-detection.md (11252b), references/linkfox-ruiguan-utility-patent-detection.md (11187b), references/linkfox-zhihuiya-abstract-data-translated.md (9390b), references/linkfox-zhihuiya-abstract-image.md (8236b), references/linkfox-zhihuiya-bibliography.md (11085b), references/linkfox-zhihuiya-claim-data-translated.md (9720b), references/linkfox-zhihuiya-claim-data.md (9523b), references/linkfox-zhihuiya-description-data-translated.md (9151b), references/linkfox-zhihuiya-description-data.md (9372b), references/linkfox-zhihuiya-fulltext-image.md (8060b), references/linkfox-zhihuiya-legal-status.md (11334b), references/linkfox-zhihuiya-patent-cited.md (9593b), references/linkfox-zhihuiya-patent-family.md (9987b), references/linkfox-zhihuiya-patent-forward-citation.md (9175b), references/linkfox-zhihuiya-patent-image-search.md (17504b), references/linkfox-zhihuiya-pdf-data.md (9130b), references/linkfox-zhihuiya-simple-bibliography.md (10906b), references/linkfox-zhihuiya-utility-patent-image-search.md (17850b), references/onboarding.md (2068b), scripts/onboarding.py (24089b), scripts/ruiguan_copyright_detection.py (12750b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/ruiguan_image_compliance_search.py (12762b), scripts/ruiguan_text_trademark_detection.py (13145b), scripts/ruiguan_trademark_graphic_detection.py (12812b), scripts/ruiguan_utility_patent_detection.py (13145b), scripts/upload_image.py (4592b), scripts/zhihuiya_abstract_image.py (13082b), scripts/zhihuiya_abstract_translated.py (13142b), scripts/zhihuiya_bibliography.py (13068b), scripts/zhihuiya_cited_by.py (13060b), scripts/zhihuiya_cited_references.py (13124b), scripts/zhihuiya_claim_data.py (13051b), scripts/zhihuiya_claim_translated.py (13119b), scripts/zhihuiya_description_data.py (13098b), scripts/zhihuiya_description_translated.py (13166b), scripts/zhihuiya_fulltext_image.py (13082b), scripts/zhihuiya_legal_status.py (13066b), scripts/zhihuiya_patent_family.py (13076b), scripts/zhihuiya_patent_image_search.py (13506b), scripts/zhihuiya_pdf_data.py (13040b), scripts/zhihuiya_simple_bibliography.py (13122b), scripts/zhihuiya_utility_patent_image_search.py (13526b), skill-card.md (4775b), SKILL.md (25632b), _meta.json (157b)\n\nFile v1.2.3:SKILL.md\n\n---\nname: linkfox-ecommerce-compliance-detection\ndisplay_name: Linkfox 电商合规检测\ndisplay_name_en: LinkFox E-commerce Compliance Detection\ndescription: 电商知识产权与合规检测一站式 AI 工具集，整合睿观知产合规检测（版权/商标/外观专利/实用新型专利/图片政策）与智慧芽专利数据查询（著录/权利要求/说明书/附图/法律状态/家族/引用/以图搜图/PDF）共 2 类底层工具、22 项子能力。\ndescription_zh: 电商知产与合规检测工具集，整合睿观（ruiguan_ip_detection）与智慧芽（zhihuiya_patent）2 类底层工具、22 项子能力。睿观覆盖图片版权、图形/文字商标、外观专利、实用新型专利、图片政策合规检测，返回相似度、权利人、TRO 与雷达侵权判定，支持 25+ 国家/地区。智慧芽覆盖专利核心/详细著录、标题摘要/权利要求/说明书及翻译、附图、法律状态、专利家族、引用分析、PDF 下载及外观/实用新型以图搜图。当用户需上架前版权/商标/专利侵权排查、TRO 风险评估、图片合规审查、专利查询翻译或以图搜专利时触发。参数见 references/，脚本见 scripts/。\ndescription_en: One-stop e-commerce IP & compliance detection AI toolkit integrating 22 sub-capabilities across 2 tool families — Ruiguan (ruiguan_ip_detection: image copyright, graphic & text trademark, design & utility-model patent, and policy/compliance detection with similarity, rights owner, TRO litigation history and radar infringement verdicts across 25+ countries) and PatSnap/Zhihuiya (zhihuiya_patent: patent core/detailed bibliography, title-abstract translation, claims & translation, description & translation, abstract/fulltext drawings, legal status & event history, patent family, forward & back citations, PDF download, and design/utility-model patent image search). Triggered when the user needs pre-launch copyright/trademark/patent infringement checks, TRO risk assessment, product image compliance review, patent detail lookup & translation, or image-based patent search. Full params per sub-capability are in references/, executable scripts in scripts/.\ncategory: e-commerce\nversion: 1.0.0\nauthor: LinkFox\n---\n\n# Linkfox 电商合规检测（E-commerce Compliance Detection）\n\n电商知识产权与合规检测一站式 AI 工具集，整合 **2 类底层工具、22 项子能力**：睿观（`ruiguan_ip_detection`）负责图片/文本类知产侵权与合规风险检测，智慧芽（`zhihuiya_patent`）负责专利数据查询与以图搜图。各子能力完整参数、响应字段与错误码见 `references/` 下对应文件，可执行脚本见 `scripts/`。\n\n## 能力边界\n\n### ✅ 能力范围\n- **图片版权侵权检测**（`ruiguan_ip_detection`）：对图片 URL 与已登记版权作品库比对，返回相似度、权利人、版权标识码、TRO 维权史与雷达侵权判定（linkfox-ruiguan-copyright-detection）。\n- **图形商标 / Logo 检测**（`ruiguan_ip_detection`）：产品图片与全球 15 国已注册图形商标库视觉相似度比对，含商标名、注册状态、尼斯分类、申请人、雷达判定（linkfox-ruiguan-trademark-graphic-detection）。\n- **文字商标检测**（`ruiguan_ip_detection`）：产品 Listing 标题/描述文本与 15 国注册商标库比对，返回整体风险等级、黑白名单与逐条命中（linkfox-ruiguan-text-trademark-detection）。\n- **外观设计专利检测**（`ruiguan_ip_detection`）：产品图片检索 25+ 国家/地区外观专利，含 AI 雷达侵权判定、TRO 风险与专利法律状态（linkfox-ruiguan-detection-patent-design）。\n- **实用新型 / 发明专利检测**（`ruiguan_ip_detection`）：基于产品标题与描述检索相似实用新型/发明专利，含 TRO 风险与预估到期日（linkfox-ruiguan-utility-patent-detection，当前仅支持 US）。\n- **图片政策合规检测**（`ruiguan_ip_detection`）：在已知违规/禁售商品库中按视觉相似度检索潜在违规商品（linkfox-ruiguan-gun-parts-search）。\n- **专利以图搜图**（`zhihuiya_patent`）：通过图片 URL 检索相似外观设计（`D`）与实用新型（`U`）专利，按视觉相似度排序，支持按受理局、洛迦诺分类、法律状态、申请人、日期多维筛选（linkfox-zhihuiya-patent-image-search、linkfox-zhihuiya-utility-patent-image-search）。\n- **专利著录查询**（`zhihuiya_patent`）：核心著录（标题/摘要/发明人/申请人/IPC·CPC 主分类）与详细著录（完整分类号/引用/优先权/预估到期日）（linkfox-zhihuiya-simple-bibliography、linkfox-zhihuiya-bibliography）。\n- **专利全文与翻译**（`zhihuiya_patent`）：权利要求及翻译、说明书及翻译、标题摘要翻译，支持中/英/日（linkfox-zhihuiya-claim-data、linkfox-zhihuiya-claim-data-translated、linkfox-zhihuiya-description-data、linkfox-zhihuiya-description-data-translated、linkfox-zhihuiya-abstract-data-translated）。\n- **专利附图**（`zhihuiya_patent`）：摘要附图与全文附图（图纸/示意图/图表）下载路径（linkfox-zhihuiya-abstract-image、linkfox-zhihuiya-fulltext-image）。\n- **专利法律状态与家族**（`zhihuiya_patent`）：法律状态及事件历史（转让/许可/质押/诉讼/复审）、简单同族/INPADOC 同族跨国等同专利（linkfox-zhihuiya-legal-status、linkfox-zhihuiya-patent-family）。\n- **专利引用分析**（`zhihuiya_patent`）：被引用次数（3/5 年）及引用专利列表、参考文献（在先技术，含专利与非专利文献）（linkfox-zhihuiya-patent-cited、linkfox-zhihuiya-patent-forward-citation）。\n- **专利 PDF 下载**（`zhihuiya_patent`）：单篇/批量（上限 100）专利 PDF 全文下载链接（linkfox-zhihuiya-pdf-data）。\n- 覆盖睿观 25+ 国家/地区（外观专利）与 15 国（商标）、智慧芽全球专利库；本地图片可经 `upload_image.py` 转公开 URL 后检测/检索。\n\n### ❌ 边界与限制\n- **API Key 必需**：所有工具均需环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）；各工具独立计费、独立限频，数据时效与站点覆盖随数据源而异。\n- **计费约束**：同一会话同一参数组合默认只调用一次（脚本带 24h 本地缓存）；失败或空结果不得自动换图、换关键词、翻页或改参数连续试探；需继续检索时先向用户说明会产生额外消耗（各工具计费规则见 `skills-version.json` 对应条目与 references 内 api.md 的 `costToken` 字段；睿观雷达检测开启时计费翻倍，智慧芽多数按返回条数计费）。\n- **图片 URL 必需**：睿观图片类检测与智慧芽以图搜图仅接受可公开访问的图片 URL，不直接接收本地文件；本地图片须先用 `scripts/upload_image.py` 转为公开 URL（有效期 24 小时）。\n- **非法律意见**：所有检测结果仅呈现数据（相似度、风险指标、专利信息），不提供侵权法律结论、FTO 自由实施意见或诉讼策略；法律结论须咨询专业律师。\n- **不在范围内**：商标/专利/版权的注册申请与登记办理；店铺运营（Listing 刊登/订单/库存）、广告投放、物流与供应链；音乐/视频版权检测；基于文本的专利检索（关键词/摘要检索，本工具仅支持以图搜图）；专利年费管理与监控、专利估值或许可谈判；与平台或权利人的直接沟通；非电商任务。\n- **数据时效**：睿观检测为实时/准实时抓取；智慧芽专利数据为其数据库更新周期，`costToken`/`lastUpdate` 等字段标识消耗与刷新。\n\n## 工具选择指南\n\n按需求在下表定到子能力，再跳到【业务需求路由速查】查端点/脚本/references 取参执行。\n\n| 需求 / 用户说 | 默认推荐（子能力） | 何时换用其他 |\n|---|---|---|\n| 图片版权侵权 / TRO 风险（\"这张图有没有版权问题\"） | `linkfox-ruiguan-copyright-detection` | 查图形商标/Logo 用 `linkfox-ruiguan-trademark-graphic-detection`；查外观专利用 `linkfox-ruiguan-detection-patent-design` |\n| 图形商标 / Logo 侵权（\"图片有没有商标问题\"） | `linkfox-ruiguan-trademark-graphic-detection` | 查文字商标（标题/描述文本）用 `linkfox-ruiguan-text-trademark-detection` |\n| 文字商标 / 标题品牌侵权（\"标题有没有商标问题\"） | `linkfox-ruiguan-text-trademark-detection` | 查图形商标用 `linkfox-ruiguan-trademark-graphic-detection` |\n| 外观专利侵权 / TRO（\"产品外观有没有专利风险\"） | `linkfox-ruiguan-detection-patent-design`（睿观，25+ 国，含雷达判定与 TRO） | 仅需视觉相似专利列表（不要 TRO/侵权判定）用 `linkfox-zhihuiya-patent-image-search`（patentType=`D`） |\n| 实用新型/发明专利风险（\"产品结构有没有专利风险\"） | `linkfox-ruiguan-utility-patent-detection`（基于标题描述，仅 US） | 有产品图片想以图搜实用新型专利用 `linkfox-zhihuiya-utility-patent-image-search` |\n| 图片政策合规 / 禁售商品（\"这图有没有违规/禁售风险\"） | `linkfox-ruiguan-gun-parts-search` | — |\n| 以图搜外观专利（\"用图找相似外观专利\"） | `linkfox-zhihuiya-patent-image-search`（仅 `D`，强制 model 1/2） | 要实用新型以图搜图用 `linkfox-zhihuiya-utility-patent-image-search`；要 TRO/侵权判定用 `linkfox-ruiguan-detection-patent-design` |\n| 以图搜实用新型专利（\"用图找相似实用新型专利\"） | `linkfox-zhihuiya-utility-patent-image-search`（仅 `U`，强制 model 3/4） | 要外观专利以图搜图用 `linkfox-zhihuiya-patent-image-search`；要基于标题描述的实用新型侵权检测用 `linkfox-ruiguan-utility-patent-detection` |\n| 专利基本信息 / 发明人申请人（\"这专利是谁的\"） | `linkfox-zhihuiya-simple-bibliography`（核心著录，轻量） | 要完整分类号/引用/优先权/预估到期日用 `linkfox-zhihuiya-bibliography` |\n| 专利详细著录 / 分类号 / 优先权（\"专利完整信息\"） | `linkfox-zhihuiya-bibliography` | 只要标题/摘要/发明人用 `linkfox-zhihuiya-simple-bibliography` |\n| 专利标题/摘要翻译（\"翻译专利摘要\"） | `linkfox-zhihuiya-abstract-data-translated`（中/英/日） | 要权利要求翻译用 `linkfox-zhihuiya-claim-data-translated`；要说明书翻译用 `linkfox-zhihuiya-description-data-translated` |\n| 专利权利要求（\"看权利要求\"） | `linkfox-zhihuiya-claim-data` | 要翻译用 `linkfox-zhihuiya-claim-data-translated` |\n| 专利说明书（\"看说明书/全文\"） | `linkfox-zhihuiya-description-data` | 要翻译用 `linkfox-zhihuiya-description-data-translated`；要 PDF 用 `linkfox-zhihuiya-pdf-data` |\n| 专利附图 / 图纸（\"看专利图\"） | `linkfox-zhihuiya-abstract-image`（摘要附图，单张） | 要全部图纸用 `linkfox-zhihuiya-fulltext-image` |\n| 专利法律状态 / 是否有效（\"这专利还有效吗\"） | `linkfox-zhihuiya-legal-status` | — |\n| 专利家族 / 跨国等同（\"这专利的家族/等同专利\"） | `linkfox-zhihuiya-patent-family` | — |\n| 专利被引用次数 / 影响力（\"被引用多少次\"） | `linkfox-zhihuiya-patent-cited`（被引用，看谁引用了本专利） | 要本专利引用了哪些文献用 `linkfox-zhihuiya-patent-forward-citation` |\n| 专利参考文献 / 在先技术（\"引用了哪些专利\"） | `linkfox-zhihuiya-patent-forward-citation`（参考文献，看本专利引用了谁） | 要被引用次数用 `linkfox-zhihuiya-patent-cited` |\n| 专利 PDF 下载（\"下载专利 PDF\"） | `linkfox-zhihuiya-pdf-data` | — |\n\n### 工具选择思路\n- **重要**：多个子能力满足需求时，要依据需求深入分析子能力的功能、用途、出入参，从中调研出最合适的子能力，并推荐用户，让用户自己决定。\n- 满足程度同等的前提下，向用户推荐\"默认推荐子能力\"。\n\n## 业务需求路由速查\n\n按【工具选择指南】定到子能力 后，下表查端点、脚本与 references 文件取参执行：\n\n### 子能力 ↔ references 文件 ↔ 端点 ↔ 脚本（22 项）\n\n**ruiguan_ip_detection**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-ruiguan-copyright-detection | references/linkfox-ruiguan-copyright-detection.md | POST /ruiguan/copyrightDetection | ruiguan_copyright_detection.py |\n| linkfox-ruiguan-trademark-graphic-detection | references/linkfox-ruiguan-trademark-graphic-detection.md | POST /ruiguan/trademarkGraphicDetection | ruiguan_trademark_graphic_detection.py |\n| linkfox-ruiguan-text-trademark-detection | references/linkfox-ruiguan-text-trademark-detection.md | POST /ruiguan/textTrademarkDetection | ruiguan_text_trademark_detection.py |\n| linkfox-ruiguan-detection-patent-design | references/linkfox-ruiguan-detection-patent-design.md | POST /ruiguan/detectionPatentDesign | ruiguan_detection_patent_design.py |\n| linkfox-ruiguan-utility-patent-detection | references/linkfox-ruiguan-utility-patent-detection.md | POST /ruiguan/utilityPatentDetection | ruiguan_utility_patent_detection.py |\n| linkfox-ruiguan-gun-parts-search | references/linkfox-ruiguan-gun-parts-search.md | POST /ruiguan/gunPartsSearch | ruiguan_image_compliance_search.py |\n\n**zhihuiya_patent**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-zhihuiya-patent-image-search | references/linkfox-zhihuiya-patent-image-search.md | POST /zhihuiya/patentImageSearch | zhihuiya_patent_image_search.py |\n| linkfox-zhihuiya-utility-patent-image-search | references/linkfox-zhihuiya-utility-patent-image-search.md | POST /zhihuiya/patentImageSearch | zhihuiya_utility_patent_image_search.py ¹ |\n| linkfox-zhihuiya-simple-bibliography | references/linkfox-zhihuiya-simple-bibliography.md | POST /zhihuiya/simpleBibliography | zhihuiya_simple_bibliography.py |\n| linkfox-zhihuiya-bibliography | references/linkfox-zhihuiya-bibliography.md | POST /zhihuiya/bibliography | zhihuiya_bibliography.py |\n| linkfox-zhihuiya-abstract-data-translated | references/linkfox-zhihuiya-abstract-data-translated.md | POST /zhihuiya/abstractDataTranslated | zhihuiya_abstract_translated.py |\n| linkfox-zhihuiya-claim-data | references/linkfox-zhihuiya-claim-data.md | POST /zhihuiya/claimData | zhihuiya_claim_data.py |\n| linkfox-zhihuiya-claim-data-translated | references/linkfox-zhihuiya-claim-data-translated.md | POST /zhihuiya/claimDataTranslated | zhihuiya_claim_translated.py |\n| linkfox-zhihuiya-description-data | references/linkfox-zhihuiya-description-data.md | POST /zhihuiya/descriptionData | zhihuiya_description_data.py |\n| linkfox-zhihuiya-description-data-translated | references/linkfox-zhihuiya-description-data-translated.md | POST /zhihuiya/descriptionDataTranslated | zhihuiya_description_translated.py |\n| linkfox-zhihuiya-abstract-image | references/linkfox-zhihuiya-abstract-image.md | POST /zhihuiya/abstractImage | zhihuiya_abstract_image.py |\n| linkfox-zhihuiya-fulltext-image | references/linkfox-zhihuiya-fulltext-image.md | POST /zhihuiya/fulltextImage | zhihuiya_fulltext_image.py |\n| linkfox-zhihuiya-legal-status | references/linkfox-zhihuiya-legal-status.md | POST /zhihuiya/legalStatus | zhihuiya_legal_status.py |\n| linkfox-zhihuiya-patent-family | references/linkfox-zhihuiya-patent-family.md | POST /zhihuiya/patentFamily | zhihuiya_patent_family.py |\n| linkfox-zhihuiya-patent-cited | references/linkfox-zhihuiya-patent-cited.md | POST /zhihuiya/patentCited | zhihuiya_cited_by.py |\n| linkfox-zhihuiya-patent-forward-citation | references/linkfox-zhihuiya-patent-forward-citation.md | POST /zhihuiya/patentForwardCitation | zhihuiya_cited_references.py |\n| linkfox-zhihuiya-pdf-data | references/linkfox-zhihuiya-pdf-data.md | POST /zhihuiya/pdfData | zhihuiya_pdf_data.py |\n\n> ¹ `linkfox-zhihuiya-patent-image-search` 与 `linkfox-zhihuiya-utility-patent-image-search` 共用同一端点 `/zhihuiya/patentImageSearch`，均源自 `skills/` 下已拆分的同名 skill（外观版仅 `D`/model 1-2、实用新型版仅 `U`/model 3-4，互为镜像）。源脚本同名（`zhihuiya_patent_image_search.py`），为避免文件冲突，实用新型版在 `scripts/` 中更名为 `zhihuiya_utility_patent_image_search.py`；两者内容逐字保留、各强制对应专利类型。其 references 归档正文仍按源文件逐字保留原脚本名。\n\n## 调用方式\n\n- **网关**：`${LINKFOX_TOOL_GATEWAY}/<端点>`，请求方式 POST、Content-Type `application/json`，认证 Header `Authorization: <api_key>`（api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取；未配置按下方【解决认证和积分问题】处理）。各端点路径见上方【业务需求路由速查】与对应 references 文件。\n- **Python 脚本**：每项子能力对应 `scripts/<脚本名>.py '<JSON 参数>' [--inline]`（脚本名与端点见路由速查表）。图片类工具需先 `scripts/upload_image.py <本地图片路径>` 获取公开 URL。脚本内部完成网关调用、鉴权与落盘。\n- **输出策略（脚本默认行为）**：始终将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill>-<timestamp>.json`（`<cwd>` 为脚本执行时工作目录；`<session>` 取自环境变量 `SESSION_ID`；禁止写入 /tmp，当前目录不可写则报错）；响应体 ≤ 8 KB 落盘后完整打印到 stdout，> 8 KB 仅打印摘要（顶层字段、常见计数、最大列表长度 + 前 3 条样本）；加 `--inline` 强制全量打印（同样落盘）。\n- **读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 PowerShell `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n- **完整参数**：每个子能力的请求参数、响应字段、错误码、curl 示例见 `references/<子能力>.md`（文件内含该子能力 SKILL.md 正文与 api.md 全文）。\n\n## 使用示例\n\n以下按数据层给出代表性子能力的出入参示例；其余子能力参数见对应 references 文件。睿观图片类工具的 `imageUrl`、智慧芽以图搜图的 `url` 均须为可公开访问的图片 URL（本地图片先经 `upload_image.py` 转换）；智慧芽查询类统一用 `patentId` 或 `patentNumber`（公开号，二选一）。\n\n### 知产合规检测层（睿观 ruiguan_ip_detection）\n\n**1. 图片版权检测（copyrightDetection → ruiguan_copyright_detection.py）**\n```json\n{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 100, \"enableRadar\": true}\n```\n出参：`data[]`（similarity/rightsOwner/copyrightCode/subRadarResult/troCase/troHolder/path/pathThumb）、`total`、`costToken`。`enableRadar` 开启时计费翻倍但含雷达侵权判定。\n\n**2. 图形商标检测（trademarkGraphicDetection → ruiguan_trademark_graphic_detection.py）**\n```json\n{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 10, \"regions\": \"US,EM\", \"enableRadar\": true}\n```\n出参：`data[]`（similarity/trademarkName/tradeMarkStatus/registrationOfficeCode/niceClassName/applicantName/subRadarResult/image）、`total`、`boundingBoxCount`、`radarResult`、`costToken`。\n\n**3. 文字商标检测（textTrademarkDetection → ruiguan_text_trademark_detection.py）**\n```json\n{\"productTitle\": \"Wireless Bluetooth Headphones Noise Cancelling Over Ear\", \"regions\": \"US\", \"limit\": 100}\n```\n出参：`data[]`（trademarkName/region/score/highestModeScore/holder/isFamous/isActiveHolder）、`total`、`textTrademarkRadar`、`blacklistTrademarks`、`whitelistTrademarks`、`costToken`。基于文本（标题/描述），无需图片。\n\n**4. 外观专利检测（detectionPatentDesign → ruiguan_detection_patent_design.py）**\n```json\n{\"imageUrl\": \"https://example.com/product.jpg\", \"queryMode\": \"hybrid\", \"topNumber\": 50, \"regions\": \"US\", \"enableRadar\": true}\n```\n出参：`data[]`（similarity/patentProdCn/applicationNumber/patentLoc/patentValidity/troCase/troHolder/radarResult{same,exp}/patentImageUrl/images）、`total`、`costToken`。覆盖 25+ 国家/地区，`queryMode` 可选 `hybrid`/`image`/`text`。\n\n**5. 实用新型/发明专利检测（utilityPatentDetection → ruiguan_utility_patent_detection.py）**\n```json\n{\"productTitle\": \"便携式USB-C 65W氮化镓快充充电器\", \"productDescription\": \"紧凑型65W氮化镓USB-C快充充电器，可折叠插脚，支持PD3.0/QC4.0，双USB-C+USB-A\", \"region\": \"US\", \"topNumber\": 100}\n```\n出参：`data[]`（similarity/title/titleCn/patentValidity/applicationNumber/publicationDate/estimatedDueDate/troCase/troHolder/patentImageUrl/images）、`total`、`costToken`。基于标题+描述检索，当前仅支持 US。\n\n**6. 图片政策合规检测（gunPartsSearch → ruiguan_image_compliance_search.py）**\n```json\n{\"imageUrl\": \"https://example.com/product-image.jpg\"}\n```\n出参：`data[]`（cosine/pdImgOssUrl/pdTitle/pdTitleCHNCensored）、`total`、`costToken`。在违规/禁售商品库中按视觉相似度检索。\n\n### 专利数据查询层（智慧芽 zhihuiya_patent）\n\n**7. 专利以图搜图-外观（patentImageSearch → zhihuiya_patent_image_search.py）**\n```json\n{\"url\": \"https://example.com/my-product.jpg\", \"patentType\": \"D\", \"model\": 1, \"limit\": 20}\n```\n出参：`data[]`（patentPn/title/score/url/loc）、`allRecordsCount`、`costToken`。本脚本仅支持外观设计专利（强制 `patentType=D`、`model∈{1,2}`）；实用新型以图搜图用 `zhihuiya_utility_patent_image_search.py`（见示例 8）。\n\n**8. 专利以图搜图-实用新型（patentImageSearch → zhihuiya_utility_patent_image_search.py）**\n```json\n{\"url\": \"https://example.com/my-product.jpg\", \"patentType\": \"U\", \"model\": 4, \"country\": \"CN\", \"limit\": 20}\n```\n出参：同上；脚本强制 `patentType=U`、`model∈{3,4}`，外观专利检索请用 `zhihuiya_patent_image_search.py`。\n\n**9. 专利核心著录（simpleBibliography → zhihuiya_simple_bibliography.py）**\n```json\n{\"patentNumber\": \"US11234567B2\"}\n```\n出参：`data[]`（pn/title/abstractContent/applicants/inventors/assignees/ipcMain/cpcMain/citedPatents）、`costToken`。\n\n**10. 专利详细著录（bibliography → zhihuiya_bibliography.py）**\n```json\n{\"patentNumber\": \"US10123456B2\"}\n```\n出参：`data[]`（pn/patentType/applicants/assignees/inventors/classificationIpcr/classificationCpc/priorityClaims/referenceCitedPatents/exdt）、`costToken`。比核心著录更全（含完整分类号/引用/优先权/预估到期日）。\n\n**11. 专利权利要求（claimData → zhihuiya_claim_data.py）**\n```json\n{\"patentNumber\": \"CN115000000A\"}\n```\n出参：`data[]`（pn/claims/claimCount/pnRelated）、`total`、`costToken`。翻译版加 `lang`（`cn`/`en`/`jp`）用 `zhihuiya_claim_translated.py`。\n\n**12. 专利法律状态（legalStatus → zhihuiya_legal_status.py）**\n```json\n{\"patentNumber\": \"CN115000000A\"}\n```\n出参：`data[]`（pn/simpleLegalStatus/legalStatus/eventStatus/legalDate）、`costToken`。`simpleLegalStatus`：`0`失效/`1`有效/`2`审中。\n\n**13. 专利被引用（patentCited → zhihuiya_cited_by.py）**\n```json\n{\"patentNumber\": \"US10123456B2\"}\n```\n出参：`data[]`（pn/citedBy3y/citedBy5y/citedBySimpleFamily/citedByInpadocFamily/citedByPatents）、`costToken`。看\"谁引用了本专利\"。\n\n**14. 专利 PDF 下载（pdfData → zhihuiya_pdf_data.py）**\n```json\n{\"patentNumber\": \"US20230012345A1\"}\n```\n出参：`data[]`（pn/pdfPath/pnRelated）、`total`、`costToken`。支持单篇/批量（上限 100），`replaceByRelated` 可同族替代。\n\n## 展示规则\n\n1. **客观呈现数据**：以清晰表格展示检测结果/专利信息，不做主观法律结论（除非用户主动要求）；标注数据来自睿观还是智慧芽。\n2. **来源标注**：展示数据时说明来自哪个工具/数据源（睿观版权/商标/外观专利/实用新型专利/政策合规，或智慧芽著录/权利要求/说明书/附图/法律状态/家族/引用/PDF/以图搜图）。\n3. **高风险高亮**：睿观检测中相似度较高（如 ≥ 0.80）或雷达判定侵权（`subRadarResult`/`radarResult` = 1）或存在 TRO 维权史（`troCase`/`troHolder` = true）时，明确标注为高风险条目并醒目提示。\n4. **不可用数据**：值为 `0` 或 `-1` 的字段表示数据不可用，标注\"N/A\"或省略，不作实际值展示。\n5. **法律声明**：以图搜图与侵权检测结果末尾附加提示：结果基于视觉相似度/数据比对，不构成侵权法律判定，建议咨询专业律师。\n6. **错误处理与协同**：查询失败时根据响应 `errcode`/`errmsg` 说明原因并建议修正（图片 URL 不可公开访问、ASIN/专利号格式、站点/国家代码、参数越界等）；连续使用多工具时将各工具发现汇总为连贯分析，标注数据来源与时间窗。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n**注意**：你是workbuddy，并且渠道是workbuddy，使用 onboarding 引导登录注册时 channel **必须**为 workbuddy。这非常重要！\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\nFile v1.2.3:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ecommerce-compliance-detection\",\n  \"version\": \"1.2.3\",\n  \"publishedAt\": 1786719049644\n}\n\nFile v1.2.3:references/linkfox-ruiguan-copyright-detection.md\n\n---\nname: linkfox-ruiguan-copyright-detection\ndescription: 基于睿观的图片版权侵权检测与风险分析工具，用于排查已登记作品的侵权与 TRO 风险。\n---\n\n# 睿观版权检测（Ruiguan Copyright Detection）\n\n本技能用于执行图片版权检测，帮助电商卖家和设计师在使用图片前识别潜在的版权侵权风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 对给定的图片 URL 进行版权检测，与已登记版权作品库比对，返回视觉相似的版权作品及风险指标。\n- 提供相似度、权利人、版权标识码、TRO 维权史、雷达侵权判定等多维风险信息。\n- 支持本地图片上传获取公开 URL 后再检测。\n\n### ❌ 边界与限制\n\n- **图片 URL 必需**：仅接受可公开访问的图片 URL，不直接接收本地上传；本地文件需先用上传脚本转为公开 URL。\n- **URL 长度**：图片 URL 不超过 1000 字符。\n- **结果上限**：单次查询最多返回 200 条结果。\n- **检测范围**：仅限检测服务维护的已登记版权作品库。\n- **非法律意见**：仅呈现检测数据，不提供法律结论。\n- **不在范围内**：商标或专利检索；文字或音乐版权检测；图片编辑修改；非版权目的的反向图片搜索；法律咨询或诉讼策略。\n\n## 核心概念\n\n版权检测通过将给定图片与已登记版权作品库进行比对来工作。系统返回视觉相似的版权作品及关键风险指标，如相似度、权利人信息、TRO（临时限制令）维权史、雷达侵权判定。\n\n**相似度（similarity）**：字符串小数（如 `\"0.85\"`），表示输入图片与版权作品的匹配程度，值越高风险越大。\n\n**雷达检测（enableRadar）**：额外的分析层，提供二元侵权判定（`1` = 侵权，`0` = 不侵权）。开启时每条结果包含此二次评估。\n\n**TRO 维权史**：TRO（Temporary Restraining Order，临时限制令）是版权维权中常用的法律手段。结果中标记 TRO 史表示权利人曾发起法律行动，风险较高。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/copyrightDetection`（完整参数/响应/错误码见 [references/api.md](references/api.md)）\n- **Python 脚本**：`python scripts/ruiguan_copyright_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-copyright-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 本地图片上传\n\n本工具要求**可公开访问的图片 URL**。若用户提供的是本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公开 URL。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本返回一个公开 URL（有效期 24 小时），可作为 imageUrl 参数使用。\n\n## 使用示例\n\n**1. 单张图片基础版权检测**\n> \"帮我查一下这张图片有没有版权问题：https://example.com/my-image.jpg\"\n动作：设置 `imageUrl` 为提供的 URL，其余参数用默认值。\n\n**2. 快速扫描少量结果**\n> \"对这张产品图做个快速版权扫描，只要最匹配的几条：https://example.com/product.png\"\n动作：设置 `topNumber` 为 10，更快返回。\n\n**3. 最大结果全面审计**\n> \"我要对这张设计图做一次完整的版权审计：https://example.com/design.jpg\"\n动作：设置 `topNumber` 为 200，最全面扫描。\n\n**4. 仅相似度检测（关闭雷达）**\n> \"只查这张图和版权作品的相似度，不需要详细侵权分析：https://example.com/photo.jpg\"\n动作：设置 `enableRadar` 为 `false`。\n\n**5. 批量检测多张图片**\n> \"帮我检测这三张图片的版权：url1、url2、url3\"\n动作：对每个图片 URL 调用一次 API，汇总结果。\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格展示检测结果，关键列包括相似度、权利人、版权标识码、雷达结果、TRO 史、版权来源链接。\n2. **高亮高风险**：相似度较高（如 ≥ 0.80）或雷达检测判定侵权（`subRadarResult` = 1）时，明确标注为高风险条目。\n3. **TRO 警告**：当 `troCase` 或 `troHolder` 为 `true` 时，醒目提示用户该权利人存在 TRO 维权史。\n4. **图片预览**：`path` 或 `pathThumb` 可用时，提示用户可在该 URL 查看版权作品缩略图。\n5. **结果数量提示**：告知用户匹配的 `total` 总数；结果较多时优先展示相似度最高的条目。\n6. **错误处理**：请求失败时说明原因，建议检查图片 URL 是否可公开访问、格式是否正确。\n7. **不做法律建议**：如实呈现检测数据，不提供法律结论；建议用户咨询法律人士获取权威版权评估。\n\n## 用户表达与场景速查\n\n**适用** —— 图片版权风险评估：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查这张图有没有版权问题\" | 基础版权检测 |\n| \"这张图用着安全吗\" | 侵权风险检测 |\n| \"找相似的版权图片\" | 版权相似度搜索 |\n| \"这张图有 TRO 风险吗\" | TRO 维权风险分析 |\n| \"这张图的版权归谁\" | 权利人查询 |\n| \"产品图版权审计\" | 批量版权合规检查 |\n| \"这设计是原创还是抄袭\" | 原创性验证 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-版权检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/copyrightDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| imageUrl | string | 是 | 检测的版权图片URL（最大长度1000字符） |\n| topNumber | integer | 是 | 召回数量（默认100，最小10，最大200） |\n| enableRadar | boolean | 是 | 是否开启雷达检测（默认 `true`） |\n\n- `imageUrl` 必须为可公开访问的图片URL\n- `topNumber` 控制返回匹配版权作品的数量，默认100，范围10-200\n- `enableRadar` 开启后将进行额外的侵权雷达判定，建议设为 `true` 以获得更全面的分析\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| data | array | 检测结果列表（详见下方） |\n| detectId | string | 检测id |\n| columns | array | 渲染的列 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### 检测结果对象（`data` 数组中的元素）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| path | string | 版权画图片路径 |\n| pathThumb | string | 版权画缩略图路径 |\n| similarity | string | 相似度 |\n| subRadarResult | integer | 1-侵权 0-不侵权，null 没有进行雷达检测 |\n| copyrightUrl | string | 来源 |\n| copyrightCode | string | 版权标识码 |\n| rightsOwner | string | 权利人 |\n| link | string | 版权官网链接 |\n| troCase | boolean | 是否有TRO维权史 |\n| troHolder | boolean | 是否是TRO权利人的版权 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/copyrightDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"imageUrl\": \"https://example.com/test-image.jpg\",\n    \"topNumber\": 100,\n    \"enableRadar\": true\n  }'\n```\n\nFile v1.2.3:references/linkfox-ruiguan-detection-patent-design.md\n\n---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的跨国/地区外观设计专利侵权检测工具，用于排查产品图片的外观专利与 TRO 诉讼风险。\n---\n\n# 睿观-外观专利检测（Ruiguan Design Patent Detection）\n\n本技能基于睿观引擎进行外观设计专利侵权检测，帮助电商卖家与知识产权从业者在产品上架前识别潜在的外观专利风险。完整参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 以产品图片为输入，对比全球外观设计专利数据库，返回按相似度排序的专利结果。\n- 支持 25+ 国家/地区的外观专利检索（US、EU、CN、JP、KR、DE、GB、FR 等）。\n- 提供 TRO（临时禁令）维权史查询，识别有主动维权记录的专利权人。\n- 可选启用 AI 雷达分析，给出疑似侵权的判定与说明。\n- 支持按 LOC（洛迦诺）分类限定检索范围，或交由模型自动预测分类。\n\n### ❌ 边界与限制\n\n- **图片要求**：需提供公开可访问的图片 URL；本地图片须先上传获取 URL（见下方【本地图片上传】）。\n- **检测范围**：仅覆盖外观设计专利，不包含发明专利、实用新型专利。\n- **相似度口径**：相似度分数为视觉 resemblance 参考值，不构成法律结论。\n- **成本约束**：每次调用消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词或连续试探。\n- **不在范围内**：发明专利/实用新型检索；商标侵权检测；版权/DMCA 问题；法律案件管理与诉讼策略；专利申请与申报；Listing 优化与定价。\n\n## 核心概念\n\n外观专利检测通过视觉相似度算法将产品图片与全球外观设计专利数据库进行比对，返回按相似度排序的专利结果，并附带 TRO 维权诉讼史，帮助评估侵权风险。\n\n**相似度分数**：取值 0-1，数值越高表示与专利附图的视觉相似度越高。`similarity >= 0.7` 或有 TRO 维权史的专利需重点关注并仔细审查。\n\n**雷达分析**：启用雷达后，每个专利结果包含 `radarResult`，其中 `same` 标记是否疑似侵权（true/false），`exp` 给出判定说明，提供超越原始相似度的 AI 判定。\n\n**LOC 分类**：洛迦诺分类（LOC）是工业品外观设计的国际分类体系。可指定 LOC 代码缩小检索范围，或不指定由模型自动预测合适类目。\n\n参数详情见 [references/api.md](references/api.md)。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/detectionPatentDesign`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_detection_patent_design.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-detection-patent-design-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 本地图片上传\n\n本工具要求**公开可访问的图片 URL**。若用户提供的是本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公开 URL。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公开 URL（有效期 24 小时），可作为 imageUrl 参数使用。\n\n## 使用示例\n\n**1. 基础专利检测（美国市场）**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}\n```\n\n**2. 多地区检测并补充产品上下文**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"physical\",\n  \"topNumber\": 100,\n  \"regions\": \"US,EU,CN\",\n  \"productTitle\": \"Portable Wireless Charger Stand\",\n  \"productDescription\": \"A foldable wireless charging stand for smartphones\",\n  \"enableRadar\": true\n}\n```\n\n**3. 使用 LOC 分类缩小范围（家具）**\n```json\n{\n  \"imageUrl\": \"https://example.com/chair.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 80,\n  \"regions\": \"US,DE\",\n  \"topLoc\": \"06\",\n  \"patentStatus\": \"1\"\n}\n```\n\n**4. 线条图模式检索**\n```json\n{\n  \"imageUrl\": \"https://example.com/sketch.png\",\n  \"queryMode\": \"line\",\n  \"topNumber\": 50,\n  \"regions\": \"CN,JP,KR\"\n}\n```\n\n**5. 同时检索有效与失效专利**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 100,\n  \"regions\": \"US\",\n  \"patentStatus\": \"1,0\"\n}\n```\n\n## 展示规则\n\n1. **高风险专利突出展示**：生成摘要或报告时，对所有 `similarity >= 0.7` 或 `troCase = true` 的专利**完整**展示详情，包括：申请号、专利标题（中文）、发明人、TRO 维权史、最相似专利附图、专利图片列表中的每张图片、专利摘要、专利说明书、LOC 信息、雷达分析结果与说明书文本。此详细呈现至关重要，**不得省略或缩写**这些字段。\n2. **免责声明**：结尾始终附上友好提醒：“本检测结果由 LinkfoxAgent 生成。建议咨询专业知识产权律师获取法律意见。”\n3. **相似度解读**：明确说明相似度分数越高，视觉相似度越大、侵权风险越高。\n4. **雷达结果展示**：当 `radarResult.same` 为 true 时，显著标记该专利为疑似侵权匹配，并展示 `exp` 说明。\n5. **TRO 警告**：`troCase = true` 或 `troHolder = true` 的专利应加警告标识，表明专利权人有通过临时禁令主动维权的历史。\n6. **图片展示**：同时展示 `patentImageUrl`（最相似专利附图）与完整 `images` 列表，便于用户将产品与所有专利附图直观对比。\n7. **错误处理**：请求失败时说明原因并建议纠正措施（如检查图片 URL 可访问性、核实地区代码）。\n8. **如实呈现数据**：按查询结果原样展示，不添加超出工具自身分析的主观法律结论。\n\n## 用户表达与场景速查\n\n**适用** —— 外观设计专利风险评估：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"检查这个产品是否侵犯外观专利\" | 基础专利检测 |\n| \"这张图片的专利风险排查\" | 基于图片的专利检索 |\n| \"这个产品有 TRO 风险吗\" | TRO 维权史查询 |\n| \"美国和欧盟的外观专利检索\" | 多地区专利检测 |\n| \"检查这件家具的外观专利\" | 按类目专利检索 |\n| \"这个产品设计卖起来安全吗\" | 上架前专利排查 |\n| \"查找相似的外观专利\" | 基于相似度的专利发现 |\n| \"专利侵权分析\" | 综合专利风险报告 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：当用户提及“专利检查”或“IP 风险”时，若关注点是产品外观/设计与已有专利的相似度，则适用本技能；若涉及发明专利、商标、版权，或需要实际法律咨询，则不适用。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-外观专利检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/detectionPatentDesign`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 是 | - | 产品图片文件URL，用于与专利数据库进行比对（最大1000字符） |\n| queryMode | string | 是 | hybrid | 检索模式：`physical`（实物图检索）、`line`（线条图检索）、`hybrid`（混合检索）。最大1000字符 |\n| topNumber | integer | 是 | 100 | 召回专利数量（最大100） |\n| regions | string | 否 | US | 商品所售卖国家/地区代码，多选时用逗号隔开（如 `US,EU,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。最大1000字符 |\n| productTitle | string | 否 | - | 产品标题，用于补充检索上下文（最大1000字符） |\n| productDescription | string | 否 | - | 产品描述，用于补充检索上下文（最大1000字符） |\n| patentStatus | string | 否 | 1 | 专利有效性筛选：`1`（有效专利）、`0`（失效专利）、`1,0`（全部）。最大1000字符 |\n| enableRadar | boolean | 否 | true | 是否启用雷达图（AI侵权判定分析） |\n| topLoc | string | 否 | - | 指定检索的一级LOC范围（如 `06,07`）。格式：`^(0[1-9]\\|1[0-9]\\|2[0-9]\\|3[0-2]\\|ALL)(,(0[1-9]\\|1[0-9]\\|2[0-9]\\|3[0-2]\\|ALL))*$`。不指定时使用模型LOC预测服务的结果 |\n| sourceLanguage | string | 否 | - | 原语言代码，需要标记以便统一翻译成英文（如 `zh-CN`）。文本为英语时传空即可。最大1000字符 |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 返回的专利记录总数 |\n| data | array | 专利列表（详见下方专利对象） |\n| columns | array | 渲染的列定义 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### 专利对象（`data` 数组中的每个元素）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| applicationNumber | string | 专利申请号 |\n| publicationNumber | string | 专利公开号 |\n| patentProd | string | 专利标题（英文） |\n| patentProdCn | string | 专利标题（中文） |\n| similarity | string | 专利与产品图片的相似度（0-1） |\n| patentImageUrl | string | 与产品图片相似度最高的专利附图URL |\n| images | array | 专利图片列表 |\n| abstracts | string | 专利摘要 |\n| specification | string | 专利说明书 |\n| inventors | array | 发明人列表 |\n| applicants | array | 申请人列表 |\n| applicantAddresses | array | 申请人地址 |\n| troCase | boolean | 是否有TRO维权史 |\n| troHolder | boolean | 是否是TRO权利人的专利 |\n| radarResult | object | AI雷达分析结果 |\n| radarResult.same | boolean | 是否疑似侵权 |\n| radarResult.exp | string | 预期描述（雷达判定说明） |\n| patentLoc | string | 该专利的LOC分类（多个用逗号隔开） |\n| locOneInfo | string | LOC一级详情 |\n| locTwoInfo | string | LOC二级详情 |\n| patentValidity | string | 专利有效性 |\n| applicationDate | string | 专利申请日 |\n| publicationDate | string | 专利公开日 |\n| grantDate | string | 专利授权日 |\n| estimatedDueDate | string | 预估到期日 |\n| registrationOfficeCode | string | 专利注册受理局 |\n| patentFamily | array | 同族专利列表 |\n| globalPatentId | string | 全球专利ID |\n| globalImageId | string | 专利图片的ID |\n| isSketchText | string | 是否线稿图 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/detectionPatentDesign \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"imageUrl\": \"https://example.com/product.jpg\",\n    \"queryMode\": \"hybrid\",\n    \"topNumber\": 50,\n    \"regions\": \"US\",\n    \"enableRadar\": true\n  }'\n```\n\n## 多地区检索示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/detectionPatentDesign \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"imageUrl\": \"https://example.com/product.jpg\",\n    \"queryMode\": \"physical\",\n    \"topNumber\": 100,\n    \"regions\": \"US,EU,CN\",\n    \"productTitle\": \"便携式无线充电支架\",\n    \"productDescription\": \"一款可折叠的智能手机无线充电支架\",\n    \"patentStatus\": \"1\",\n    \"enableRadar\": true\n  }'\n```\n\nFile v1.2.3:references/linkfox-ruiguan-gun-parts-search.md\n\n---\nname: linkfox-ruiguan-gun-parts-search\ndescription: 基于睿观的图片政策合规性检测工具，通过视觉相似度比对识别潜在的违规及禁售风险商品。\n---\n\n# 睿观-图片政策合规监测（Ruiguan Gun Parts Search）\n\n本技能基于睿观对产品图片进行政策合规检测，通过视觉相似度比对，在已知违规商品库中检索视觉相似商品，识别潜在的违规及禁售风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 根据产品图片 URL，在违规商品库中进行基于视觉相似度的检索，返回匹配的违规商品列表。\n- 返回每条匹配的相似度分数（cosine，0~1）、违规商品图片、中英文标题等信息。\n- 支持本地图片：用户提供本地文件路径时，先上传获取公开 URL，再发起检测。\n\n### ❌ 边界与限制\n\n- **仅基于图片**：本工具只分析图片 URL，不分析文本描述或商品元数据。\n- **URL 可访问性**：图片 URL 必须可被检测服务公开访问；本地文件须先上传。\n- **URL 长度上限**：图片 URL 不得超过 1000 字符。\n- **相似度≠定论**：结果基于视觉相似度，不构成确定性的政策裁定。\n- **不在范围内**：文本类合规分析；商品类目分类；知识产权/商标侵权；专利或版权检测（使用其他睿观技能）。\n\n## 核心概念\n\n睿观图片政策合规检测是一项基于图片的合规筛查服务。给定产品图片 URL，在已知违规商品库中检索视觉相似商品，并按相似度排序返回。\n\n**相似度分数（cosine）**：取值 0~1，值越高表示与已知违规商品视觉越相似；接近 1.0 表示几乎与已标记的违规商品完全一致。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/gunPartsSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_image_compliance_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词或翻页连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**本地图片上传**：本工具要求**公开可访问的图片 URL**。若用户提供本地文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传获取公开 URL：\n\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公开 URL（24 小时有效），用作图片 URL 参数。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-gun-parts-search-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 单张产品图片合规检测**\n```\n检测这张产品图片是否有合规风险：https://example.com/images/product-123.jpg\n```\n\n**2. 批量检测多张产品图片**\n```\n请扫描这些产品图片，看是否存在潜在违规：\n- https://example.com/images/item-a.jpg\n- https://example.com/images/item-b.jpg\n```\n\n**3. 上架前合规预检**\n```\n上架这个产品前，帮我检查图片是否会触发政策风险：\n图片：https://example.com/new-product.png\n```\n\n## 展示规则\n\n1. **清晰表格呈现**：以结构化表格展示每条匹配的违规商品图片、相似度分数、中英文标题。\n2. **高亮高相似匹配**：当 cosine 分数超过 0.8 时，明确标记为强匹配，提示需重点关注。\n3. **展示违规图片**：返回结果含 `pdImgOssUrl` 时，展示匹配的违规商品图片，便于用户直观对比。\n4. **解释分数含义**：始终说明相似度分数的含义——值越高表示与已知违规商品越相似。\n5. **错误处理**：查询失败时说明原因，并建议检查图片 URL 是否有效且公开可访问。\n6. **不做法律建议**：客观呈现检测结果，不提供法律结论；提醒用户以平台政策为准进行核实。\n\n## 用户表达与场景速查\n\n**适用** —— 基于图片的产品政策合规检测：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"检测这张产品图片是否有合规风险\" | 单图合规检测 |\n| \"扫描我的产品图片是否有违规\" | 批量合规筛查 |\n| \"这张图片是否被标记为禁售商品\" | 特定违规查询 |\n| \"上架前帮我筛查一下图片的政策风险\" | 上架前合规预检 |\n| \"找一下这张产品图片的相似违规\" | 相似度违规检索 |\n| \"这个产品能安全上架吗\" | 合规风险预检 |\n| \"帮我检测一下这个图片是否违规\" | 单图合规检测 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 睿观-图片合规检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/gunPartsSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| imageUrl | string | 是 | 待检测的产品图片URL（最大长度 1000 字符） |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| data | array | 检测出的政策违规产品列表（详见下方） |\n| detectId | string | 检测记录 id |\n| columns | array | 渲染的列 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### data 数组元素字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| pdImgOssUrl | string | 匹配到的违规产品图片 URL |\n| cosine | number | 检测产品与违规产品相似度 |\n| pdTitle | string | 匹配到的违规产品标题 |\n| pdTitleCHNCensored | string | 匹配到的违规产品中文标题 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/gunPartsSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"imageUrl\": \"https://example.com/product-image.jpg\"}'\n```\n\nFile v1.2.3:references/linkfox-ruiguan-text-trademark-detection.md\n\n---\nname: linkfox-ruiguan-text-trademark-detection\ndescription: 电商产品Listing文字商标检测与侵权风险分析，支持标题、描述等文本的违规品牌筛查。\n---\n\n# 睿观-文字商标检测（Ruiguan Text Trademark Detection）\n\n本技能用于对电商产品标题及其他产品文本进行文字商标检测，帮助卖家在发布 Listing 前识别潜在的商标侵权风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 对产品文本（标题、描述、五点描述）进行文字商标检测，覆盖 15 个国家/地区的注册商标数据库。\n- 返回匹配商标及其风险分数、注册详情、权利人信息，并给出整体产品风险等级。\n- 识别黑名单商标（高危，需始终规避）与白名单商标（安全，可忽略），帮助卖家规避知识产权侵权。\n\n### ❌ 边界与限制\n\n- **仅文本检测**：只检测文本中的商标，不分析 Logo、图片或外观设计商标。\n- **结果上限**：单次请求最多 500 条结果。\n- **字符限制**：`productTitle` 与 `productText` 各限 1000 字符。\n- **数据库覆盖**：覆盖 15 个国家/地区，其他司法辖区的注册商标可能无法检测。\n- **非法律意见**：结果仅供参考，不构成法律建议；如需确定性的商标清权结论请咨询知识产权律师。\n- **不在范围内**：Logo/图片商标分析、专利侵权检测、版权检测、法律意见或诉讼策略、商标注册/申请协助。\n\n## 核心概念\n\n文字商标检测将产品文本（标题、描述、五点描述）与 15 个国家/地区的注册商标数据库进行比对，返回匹配商标及其风险分数、注册详情、权利人信息，帮助卖家规避知识产权侵权。\n\n**风险分数逻辑**：`highestModeScore` 字段取值 0-5，数值越高侵权风险越大。`textTrademarkRadar` 字段将产品整体风险分为三级：0（低风险）、1（待人工核查）、2（高风险）。\n\n**黑名单与白名单**：响应可能包含 `blacklistTrademarks`（已知高危商标，需始终规避）与 `whitelistTrademarks`（安全商标，可忽略）。黑名单匹配需重点提示用户。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/textTrademarkDetection`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_text_trademark_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-text-trademark-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n> 请求构建原则：始终传入完整产品标题（`productTitle`）；按销售市场选择目标地区；有五点描述/描述/后台关键词时填入 `productText` 做更全面扫描；常规检测用默认 `limit: 100`，潜在匹配多时可提高到 500。用户未指定地区时默认 **US**。\n\n**1. 基础美国商标检测（产品标题）**\n```\nproductTitle: \"Wireless Bluetooth Headphones Noise Cancelling Over Ear\"\nregions: \"US\"\nlimit: 100\n```\n\n**2. 多区域检测（美国 + 欧盟 + 英国）**\n```\nproductTitle: \"Portable USB-C Charger Fast Charging Power Bank\"\nregions: \"US,EM,GB\"\nlimit: 100\n```\n\n**3. 含附加文本的完整 Listing 扫描**\n```\nproductTitle: \"Stainless Steel Vacuum Insulated Water Bottle\"\nproductText: \"BPA-free, double-wall insulation, keeps drinks cold 24 hours, fits standard cup holders\"\nregions: \"US,JP\"\nlimit: 200\n```\n\n**4. 全球大范围检测**\n```\nproductTitle: \"LED Ring Light with Tripod Stand for Streaming\"\nregions: \"US,EM,GB,DE,FR,IT,ES,AU,CA,MX,JP,CN\"\nlimit: 500\n```\n\n**5. 中国国内市场检测**\n```\nproductTitle: \"智能蓝牙耳机降噪头戴式\"\nregions: \"CN\"\nlimit: 100\n```\n\n## 展示规则\n\n1. **风险优先呈现**：始终在结果顶部突出整体风险等级（`textTrademarkRadar`），使用明确表述：\"低风险\"、\"待人工核查\"、\"高风险\"。\n2. **黑名单突出**：若 `blacklistTrademarks` 非空，优先展示并给出明确警示。\n3. **表格格式**：以表格展示商标匹配，列包含：商标名称、地区、风险分数、状态、权利人、申请号、是否著名、是否亚马逊品牌、是否活跃维权人。\n4. **分数说明**：提醒用户 `highestModeScore` 取值 0（安全）至 5（最高风险）。\n5. **白名单说明**：若 `whitelistTrademarks` 有记录，标注为安全/豁免商标。\n6. **错误处理**：请求失败时说明原因，建议用户检查产品标题或调整地区。\n7. **非法律建议**：始终提醒结果仅供参考，不构成法律建议；如需确定性商标清权请咨询知识产权律师。\n\n## 用户表达与场景速查\n\n**适用** —— 产品文本商标风险分析：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"检查我的标题有没有商标问题\" | 基础商标扫描 |\n| \"这个产品名能用吗\" | 侵权风险检查 |\n| \"扫描我的 Listing 有无品牌违规\" | 完整 Listing 扫描 |\n| \"这个标题有商标风险吗\" | 风险评估 |\n| \"查美国和欧盟的商标\" | 多区域检测 |\n| \"XX 是不是注册商标\" | 特定词查询 |\n| \"我的 Listing 会不会因知识产权被下架\" | 合规筛查 |\n| \"这个关键词会不会侵权某个品牌\" | 关键词安全检查 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 睿观-文本商标检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/textTrademarkDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| productTitle | string | 是 | 产品标题，用于商标检测（最大1000字符） |\n| regions | string | 否 | 国家/地区代码，多个用逗号分隔。支持值：US、EM、GB、DE、FR、IT、ES、AU、CA、MX、JP、CN、WO、TR、BX |\n| limit | integer | 是 | 返回结果数量限制（默认100，最大500） |\n| productText | string | 否 | 产品的其他文本信息，如五点描述或产品描述（最大1000字符） |\n\n### 支持的地区代码\n\n| 代码 | 地区 |\n|------|------|\n| US | 美国 |\n| EM | 欧盟 |\n| GB | 英国 |\n| DE | 德国 |\n| FR | 法国 |\n| IT | 意大利 |\n| ES | 西班牙 |\n| AU | 澳大利亚 |\n| CA | 加拿大 |\n| MX | 墨西哥 |\n| JP | 日本 |\n| CN | 中国 |\n| WO | WIPO（世界知识产权组织） |\n| TR | 土耳其 |\n| BX | 玻利维亚 |\n\n用户未指定地区时默认 **US**。\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 匹配到的商标记录数 |\n| data | array | 商标列表（扁平化），每个元素包含以下字段 |\n| detectId | string | 接口调用 ID |\n| columns | array | 渲染的列定义 |\n| blacklistTrademarks | array | 文本中检测到的黑名单商标 |\n| whitelistTrademarks | array | 文本中检测到的白名单（安全）商标 |\n| textTrademarkRadar | string | 产品风险等级：\"0\" = 低风险，\"1\" = 待人工核查，\"2\" = 高风险 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### data[] 元素字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| trademarkName | string | 商标词 |\n| region | string | 国家/地区代码 |\n| score | integer | 风险分数 |\n| highestModeScore | integer | 最高风险分数（范围0-5） |\n| trademarksStatus | string | 最高分商标词状态 |\n| regionStatus | string | 商标在匹配地区的状态 |\n| holder | string | 权利人 |\n| applicationNumber | string | 申请号 |\n| registrationNumber | string | 注册号 |\n| isFamous | boolean | 是否著名商标 |\n| isAmazonBrand | boolean | 是否亚马逊热搜品牌 |\n| isActiveHolder | boolean | 是否活跃维权人 |\n| isCompatibility | boolean | 是否兼容性 |\n| isCommonSense | boolean | 是否常用词 |\n| niceClass | array | 尼斯分类 |\n| originalTextMatches | array | 触发匹配的原词 |\n\n### blacklistTrademarks[] 和 whitelistTrademarks[] 元素字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| trademark | string | 商标名称 |\n| region | string | 国家/地区代码 |\n| note | string | 备注 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/textTrademarkDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"productTitle\": \"Wireless Bluetooth Headphones Noise Cancelling Over Ear\",\n    \"regions\": \"US\",\n    \"limit\": 100\n  }'\n```\n\n### 附带产品文本的示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/textTrademarkDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"productTitle\": \"Portable USB-C Charger Fast Charging Power Bank\",\n    \"productText\": \"Compatible with iPhone, Samsung Galaxy, supports QC 3.0\",\n    \"regions\": \"US,EM,GB\",\n    \"limit\": 200\n  }'\n```\n\nFile v1.2.3:references/linkfox-ruiguan-trademark-graphic-detection.md\n\n---\nname: linkfox-ruiguan-trademark-graphic-detection\ndescription: 基于睿观的产品图片图形商标与 Logo 侵权检测及相似度比对工具。\n---\n\n# 睿观-图形商标检测（Ruiguan Graphic Trademark Detection）\n\n本技能用于对产品图片进行图形商标检测与相似度搜索，帮助电商卖家与品牌方在商品上架前识别潜在的商标侵权风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 基于产品图片检测图形商标，将图片中的图形/Logo 与全球多国已注册商标数据库进行视觉相似度比对。\n- 支持按国家/地区筛选检测范围，返回商标图片、相似度、商标名称、状态、受理局、尼斯分类、申请人及关键日期等信息。\n- 支持开启切图（局部定位）与雷达监测，提供聚合风险评估。\n\n### ❌ 边界与限制\n\n- **图片必填**：`imageUrl` 为必填，无图片无法检测。\n- **结果上限**：`topNumber` 单次最多 100 条，实际返回数量可能少于传参。\n- **图片质量**：检测精度依赖图片分辨率与清晰度，图片越清晰结果越准。\n- **地区覆盖**：并非所有国家都覆盖，支持 15 个主要商标受理局（US、WO、ES、GB、DE、IT、CA、MX、EM、AU、FR、JP、TR、BX、CN）。\n- **本地图片需先上传**：工具要求可公开访问的图片 URL，本地文件需先通过上传脚本获取公网链接。\n- **不在范围内**：文字商标检索（无图片）；商标注册/申请；专利或版权检查；商标纠纷法律建议；商品 Listing 优化。\n\n## 核心概念\n\n图形商标检测通过分析产品图片，在全球多国/地区的已注册商标库中查找视觉相似的商标。工具采用基于 YOLO 的目标检测定位图片中的类 Logo 区域，再与全球商标数据库比对。\n\n**相似度评分**：`similarity` 值越高，表示检测到的图形与已注册商标在视觉上越相似；接近 1.0 表示近似一致，侵权风险越高。\n\n**商标状态含义**：\n\n| 状态 | 含义 |\n|--------|---------|\n| registered | 商标已有效注册 |\n| act | 商标处于有效状态 |\n| pend | 商标申请待审 |\n| filed | 商标申请已提交 |\n| ended | 商标已到期 |\n| DEL | 商标已注销/删除 |\n\n## 本地图片上传\n\n本工具要求**可公开访问的图片 URL**。若用户提供本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公网链接。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公网 URL（有效期 24 小时），用作 `imageUrl` 参数。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/trademarkGraphicDetection`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_trademark_graphic_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-trademark-graphic-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 基础图片商标检测**\n对产品图片在所有地区检测商标，最多返回 10 条结果：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 10\n```\n\n**2. 指定地区检测**\n仅对照美国与欧盟商标库检测：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 5\nregions: \"US,EM\"\n```\n\n**3. 带产品上下文的详细检测**\n提供产品标题与疑似 Logo 名称以提升检测精度：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 10\nproductTitle: \"Wireless Bluetooth Headphones with Noise Cancellation\"\ntrademarkName: \"SonicWave\"\nregions: \"US,GB,DE\"\n```\n\n**4. 开启切图的完整检测**\n开启 `enableLocalizing` 以获取检测到的 Logo 区域切图：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 20\nenableLocalizing: true\nregions: \"US\"\n```\n\n## 展示规则\n\n1. **清晰呈现结果**：以结构化表格展示商标图片、相似度、商标名称、状态、受理局、尼斯分类、申请人及关键日期。\n2. **高亮高风险匹配**：当相似度高于 0.8 时，明确提醒用户存在高侵权风险。\n3. **解释商标状态**：展示结果时说明各商标状态对风险评估的含义。\n4. **雷达结果**：响应中存在 `radarResult` 时突出展示，因其包含聚合风险评估。\n5. **子雷达结果**：单条结果含 `subRadarResult` 时，将其与对应匹配一并列出。\n6. **地区范围**：始终说明本次检索覆盖了哪些地区，便于用户理解检测范围。\n7. **错误处理**：检测失败时根据响应说明原因，并建议调整（如使用更清晰的图片、指定地区、调整 `topNumber`）。\n\n## 用户表达与场景速查\n\n**适用** —— 图形商标检测任务：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"这张图片有没有商标问题\" | 基础商标检测 |\n| \"这个 Logo 在哪注册过\" | 多地区商标检索 |\n| \"我的产品图有商标风险吗\" | 上架前风险评估 |\n| \"找和这个图形相似的商标\" | 相似度检索 |\n| \"对照美国商标查这张图\" | 指定地区检测 |\n| \"这个设计会不会侵权\" | 侵权风险检查 |\n| \"扫一下产品图里的 Logo\" | 产品图 Logo 检测 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-图形商标检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/trademarkGraphicDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| imageUrl | string | 是 | 产品图片URL或base64编码的图片数据（最大1000字符） |\n| topNumber | integer | 是 | 返回YOLO坐标的最大数量，默认 `5`，最大 `100`。实际返回数量可能少于传参数量 |\n| productTitle | string | 否 | 产品标题，用于上下文感知检测（最大1000字符） |\n| trademarkName | string | 否 | 可能的图形logo名称，用于缩小检索范围（最大1000字符） |\n| regions | string | 否 | 需要检测的国家/地区代码，多个时使用逗号隔开，不传默认全部国家。可选值：US（美国）、WO（世界知识产权）、ES（西班牙）、GB（英国）、DE（德国）、IT（意大利）、CA（加拿大）、MX（墨西哥）、EM（欧盟）、AU（澳大利亚）、FR（法国）、JP（日本）、TR（土耳其）、BX（玻利维亚）、CN（中国） |\n| enableLocalizing | boolean | 否 | 是否开启切图，默认 `false` |\n| enableRadar | boolean | 否 | 是否开启雷达监测，默认 `true` |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| boundingBoxCount | integer | 检测结果数量 |\n| radarResult | string | 雷达检测结果 |\n| total | integer | 记录数 |\n| data | array | 检测结果列表（详见下方） |\n| detectId | string | 检测ID |\n| columns | array | 渲染的列定义 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### data 数组项字段\n\n`data` 数组中每个对象包含以下字段：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| image | string | 匹配的商标图片地址 |\n| boundingBox | string | YOLO坐标（逗号隔开） |\n| subRadarResult | string | 子雷达检测结果 |\n| applicationNumber | string | 申请号 |\n| niceClassName | string | 尼斯分类名称（逗号隔开） |\n| applicantName | string | 权利人（逗号隔开） |\n| tradeMarkStatus | string | 商标状态，枚举值：`\"DEL\"`、`\"ended\"`、`\"registered\"`、`\"act\"`、`\"pend\"`、`\"filed\"`、`\"\"` |\n| niceClass | array | 尼斯分类详情 |\n| similarity | number | 相似度（0到1，值越高越相似） |\n| registrationNumber | string | 注册号 |\n| registrationOfficeCode | string | 商标受理局 |\n| registrationDate | string | 注册日期 |\n| bid | string | logo标识 |\n| trademarkName | string | 图片中的文字商标名称 |\n| applicationDate | string | 申请日期 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/trademarkGraphicDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 5, \"productTitle\": \"无线蓝牙耳机\", \"regions\": \"US,EM\"}'\n```\n\nFile v1.2.3:references/linkfox-ruiguan-utility-patent-detection.md\n\n---\nname: linkfox-ruiguan-utility-patent-detection\ndescription: 基于亚马逊等产品信息进行实用新型和发明专利检测，评估潜在的专利侵权与TRO风险。\n---\n\n# 睿观-实用新型专利检测（Ruiguan Utility Patent Detection）\n\n本技能基于产品标题、描述与目标销售地区检索相似的实用新型（发明）专利，帮助跨境电商卖家在刊登产品前评估潜在专利侵权与 TRO 风险。完整参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 基于产品标题与描述，检索目标市场（当前仅 US）相似的实用新型/发明专利。\n- 返回每条专利的相似度评分、有效性状态、申请/公开信息、TRO 维权史等结构化数据。\n- 帮助卖家在刊登前识别高相似度、有效专利与 TRO 风险专利，优先关注需复核项。\n\n### ❌ 边界与限制\n\n- **地区覆盖**：当前仅支持检索 US 专利。\n- **结果上限**：单次最多返回 200 条专利。\n- **输入长度**：`productTitle` 与 `productDescription` 各限 1000 字符。\n- **非法律意见**：结果仅表示相似度，不构成对侵权的法律判定，建议咨询专利律师获取权威结论。\n- **不在范围内**：外观设计专利检索、商标/品牌侵权核查、版权问题、产品合规认证（FCC、CE 等）、一般法律咨询与合同审查。\n\n## 核心概念\n\n**实用新型专利**（utility patent，亦称发明专利）保护新的、有用的发明或功能性改进，区别于保护外观的外观设计专利，它保护产品的工作方式、结构或组成。侵犯实用新型专利可能导致产品下架、诉讼或 TRO（临时限制令）。\n\n**相似度评分**：每条返回专利包含 `similarity` 字段（0--1），数值越高表示与查询产品越相关，高分专利需重点复核。\n\n**TRO 风险指标**：两个布尔字段标记维权历史：\n- `troCase` —— 该专利是否有 TRO 维权行动记录\n- `troHolder` —— 专利权人是否以发起 TRO 案件著称\n\n任一为真的专利需格外谨慎。\n\n**专利有效性**：`patentValidity` 字段标明专利为 `Active`（有效）或 `Invalid`（无效），仅有效专利存在侵权风险。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/utilityPatentDetection`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_utility_patent_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-utility-patent-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 产品基础专利风险检查**\n> \"帮我查一下这款硅胶厨用铲在美国有没有专利风险。\"\n\n用描述性的产品标题与描述构建请求，`region` 设为 `US`，`topNumber` 取合理值。\n\n**2. 上架前全面专利排查**\n> \"我准备上新一款无线耳机，做一次全面的专利排查。\"\n\n`topNumber` 取 200 以最大化覆盖，描述需详尽，涵盖蓝牙版本、充电仓设计、降噪特性等。\n\n**3. TRO 风险快速扫描**\n> \"在美国卖 LED 灯带有没有 TRO 风险？\"\n\n获取结果后，过滤并突出 `troCase` 或 `troHolder` 为 true 的专利。\n\n**4. 特定品类深入排查**\n> \"查一下带 USB 充电的便携搅拌机的专利风险。\"\n\n同时提供产品标题与详尽描述，重点描述功能性特征（电机类型、刀片设计、充电方式、容量）。\n\n## 展示规则\n\n1. **表格呈现数据**：以清晰的结构化表格展示结果，关键列包括专利标题、相似度评分、专利有效性、申请号、公开日、TRO 标记、预估到期日。\n2. **按相关性排序**：按相似度评分降序展示（最高相似度优先）。\n3. **突出高风险专利**：重点提示相似度高于 0.7、有效、或带 TRO 标记的专利。\n4. **TRO 警示**：若返回专利中存在 `troCase=true` 或 `troHolder=true`，需显著提示维权风险升高。\n5. **有效性区分**：展示时明确区分 Active 与 Invalid 专利，强调仅有效专利需关注。\n6. **结果量提示**：结果较多时展示最相关的若干条（如按相似度前 10--20 条），其余汇总说明。\n7. **错误处理**：查询失败时说明原因，并建议调整产品标题或描述以提升匹配效果。\n8. **双语标题**：可用时同时展示英文标题（`title`）与中文标题（`titleCn`），便于理解。\n9. **不提供法律建议**：仅客观呈现专利数据，不对是否侵权作出法律结论，建议咨询专利律师获取权威评估。\n\n## 用户表达与场景速查\n\n**适用** —— 产品专利风险评估相关查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查一下我产品的专利风险\" | 基础专利检测 |\n| \"有没有实用新型/发明专利问题\" | 实用新型专利检索 |\n| \"这个产品能不能卖（专利方面）\" | 上架前专利排查 |\n| \"这个产品有 TRO 风险吗\" | TRO 维权风险 |\n| \"找相似专利\" | 专利相似度检索 |\n| \"专利侵权排查\" | 上架前风险评估 |\n| \"卖这个会不会被起诉\" | 专利风险评估 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-发明专利检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/utilityPatentDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| productTitle | string | 是 | 产品标题，最大1000字符 |\n| productDescription | string | 是 | 产品描述，最大1000字符 |\n| region | string | 是 | 商品想要售卖的国家/地区代码，多个用逗号分隔，当前支持 US。默认 `US` |\n| topNumber | integer | 是 | 召回数量，范围：10--200，默认 `100` |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| detectId | string | 检测ID |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n| columns | array | 渲染的列定义 |\n| data | array | 专利列表（详见下方） |\n\n### 专利对象字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| globalUtilityId | string | 专利ID |\n| title | string | 发明专利标题 |\n| titleCn | string | 发明专利标题（中文） |\n| similarity | number | 产品与该专利的相似度（0--1） |\n| patentValidity | string | 专利有效性：`Active`（有效）或 `Invalid`（无效） |\n| applicationNumber | string | 申请号 |\n| applicationDate | string | 申请日（yyyy-MM-dd） |\n| publicationNumber | string | 公开号 |\n| publicationDate | string | 公开日（yyyy-MM-dd） |\n| estimatedDueDate | string | 预估到期日（yyyy-MM-dd） |\n| region | string | 受理局 |\n| patentAbstract | string | 摘要 |\n| patentAbstractCn | string | 摘要（中文） |\n| claims | string | 权利要求 |\n| claimsCn | string | 权利要求（中文） |\n| specification | string | 说明书 |\n| specificationCn | string | 说明书（中文） |\n| inventors | array | 发明家和国家拼接，数组格式 |\n| inventorAddresses | array | 发明人地址，数组格式 |\n| applicants | array | 申请人和国家拼接，数组格式 |\n| applicantAddresses | array | 权利人地址，数组格式 |\n| priorityNumber | array | 优先权号，数组格式 |\n| relatedPublicationDate | array | 首次公开日（yyyy-MM-dd），数组格式 |\n| patentImageUrl | string | 专利封面图 |\n| images | array | 专利附图 |\n| classNumList | array | 类别号路径列表，格式：classNum1 > classNum2 > classNum3 |\n| cpcKindRaw | array | CPC分类（原始 JSONArray） |\n| troCase | boolean | 是否有TRO维权史 |\n| troHolder | boolean | 是否是TRO权利人的专利 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/utilityPatentDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"productTitle\": \"便携式USB-C 65W氮化镓快充充电器\", \"productDescription\": \"一款紧凑型65W氮化镓USB-C快充充电器，配备可折叠插脚，支持PD3.0和QC4.0协议，双USB-C端口和一个USB-A端口，适用于笔记本电脑、手机和平板电脑。\", \"region\": \"US\", \"topNumber\": 100}'\n```\n\nFile v1.2.3:references/linkfox-zhihuiya-abstract-data-translated.md\n\n---\nname: linkfox-zhihuiya-abstract-data-translated\ndescription: 智慧芽专利标题与摘要翻译工具。支持通过专利 ID 或公开号获取中、英、日等跨语言的专利翻译内容。\n---\n\n# 智慧芽专利标题与摘要翻译（Zhihuiya Abstract Data Translated）\n\n本技能用于从智慧芽（PatSnap）专利数据库获取专利标题和摘要的翻译版本，支持中文、英文、日文翻译。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过**专利 ID**（`patentId`）或**公开号**（`patentNumber`）查询专利，返回其标题与摘要的翻译版本。\n- 支持中、英、日三种目标翻译语言（`lang`：`cn`/`en`/`jp`）。\n- 支持批量查询：多个专利 ID 或公开号用英文逗号分隔一次提交。\n- 支持同族专利摘要回退：当原专利无摘要时，可启用 `replaceByRelated = 1` 用同族专利摘要替代。\n\n### ❌ 边界与限制\n\n- **必须提供标识符**：至少需要 `patentId` 或 `patentNumber` 之一，工具不支持按关键词检索专利。\n- **翻译语言有限**：仅支持中文（`cn`）、英文（`en`）、日文（`jp`）。\n- **仅返回标题与摘要**：不返回权利要求、说明书等专利全文。\n- **同族替代为可选项**：仅当显式设置 `replaceByRelated = 1` 时才提供同族专利替代摘要。\n- **不在范围内**：专利全文/权利要求获取；按关键词、分类号、申请人检索专利；专利法律状态、引证分析、专利全景报告；专利估值或侵权分析。\n\n## 核心概念\n\n智慧芽（PatSnap）是领先的专利情报平台。本工具查询其数据库，返回一条或多条专利的翻译标题与摘要。\n\n**专利标识**：每条专利可通过 `patentId`（智慧芽内部 ID）或 `patentNumber`（公开号/公告号，如 `US20200012345A1`、`CN112345678A`）标识。若同时提供两者，优先使用 `patentId`。\n\n**同族专利回退**：当原专利无可用摘要时，可启用替代选项，使用相关同族专利的摘要。\n\n## 调用方式\n\n- **API 端点**：`POST /zhihuiya/abstractDataTranslated`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/zhihuiya_abstract_translated.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-abstract-data-translated-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 按公开号翻译单条专利摘要为英文**\n```\n查一下公开号 US20200012345A1 的英文摘要。\n```\n参数：`patentNumber = \"US20200012345A1\"`, `lang = \"en\"`\n\n**2. 批量翻译多条专利为中文**\n```\n把 CN112345678A 和 US20200067890A1 的摘要翻译成中文。\n```\n参数：`patentNumber = \"CN112345678A,US20200067890A1\"`, `lang = \"cn\"`\n\n**3. 按专利 ID 查询并启用同族回退**\n```\n查专利 ID 12345678 的日文摘要，如果摘要不可用就用同族专利替代。\n```\n参数：`patentId = \"12345678\"`, `lang = \"jp\"`, `replaceByRelated = 1`\n\n**4. 按专利 ID 批量查询**\n```\n翻译这些专利 ID 的标题和摘要：111111、222222、333333。\n```\n参数：`patentId = \"111111,222222,333333\"`, `lang = \"en\"`\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格展示公开号、标题、摘要。\n2. **标明语言**：在输出标题中注明翻译语言，便于用户确认结果语种。\n3. **同族专利提示**：若结果中出现 `pnRelated`，明确告知用户该摘要取自同族专利，并展示替代公开号。\n4. **长摘要处理**：摘要较长时完整展示，不截断，便于用户审阅完整内容。\n5. **错误处理**：查询失败或无结果时，说明可能原因（如公开号无效、数据库中未找到该专利）并给出修正建议。\n6. **不做主观评论**：仅原样呈现翻译文本，不对专利内容做解读或法律分析。\n\n## 用户表达与场景速查\n\n**适用** —— 专利摘要与标题翻译查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"翻译这个专利的摘要\" | 单条专利翻译 |\n| \"专利 XX 说了什么 / 是关于什么的\" | 摘要查阅 |\n| \"把这个专利翻译成中文/日文\" | 指定语言翻译 |\n| \"查一下公开号 XX 的摘要\" | 按公开号查询 |\n| \"批量翻译这些专利\" | 批量翻译 |\n| \"摘要缺失，试试同族专利\" | 同族专利回退 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 智慧芽摘要翻译 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/zhihuiya/abstractDataTranslated`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| patentId | string | patentId 和 patentNumber 至少填一个 | 智慧芽内部专利ID，多个用英文逗号隔开。最大长度 60,000 字符 |\n| patentNumber | string | patentId 和 patentNumber 至少填一个 | 公开(公告)号，多个用英文逗号隔开。最大长度 60,000 字符 |\n| replaceByRelated | integer | 否 | 摘要无法获取时是否用同族专利摘要替代：`1` 是，`0` 否。默认 `0` |\n| lang | string | 否 | 翻译目标语言。可选值：`en`（英文，默认）、`cn`（中文）、`jp`（日语）。最大长度 1,000 字符 |\n\n- `patentId` 和 `patentNumber` 至少需要提供一个。如果两个都存在，会优先使用 `patentId`\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 返回的专利记录数 |\n| data | array | 专利列表 |\n| data[].patentId | string | 智慧芽内部专利ID |\n| data[].pn | string | 公开(公告)号 |\n| data[].title | string | 标题翻译 |\n| data[].abstractText | string | 摘要翻译 |\n| data[].pnRelated | string | 替代专利的公开号（仅当使用同族专利替代时提供） |\n| columns | array | 渲染的列定义 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析 `data` 等业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | - | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/abstractDataTranslated \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"US20200012345A1\", \"lang\": \"en\", \"replaceByRelated\": 0}'\n```\n\n### 批量查询示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/abstractDataTranslated \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"CN112345678A,US20200067890A1\", \"lang\": \"cn\", \"replaceByRelated\": 1}'\n```\n\nFile v1.2.3:references/linkfox-zhihuiya-abstract-image.md\n\n---\nname: linkfox-zhihuiya-abstract-image\ndescription: 智慧芽专利摘要附图获取工具。通过专利 ID 或公开号查询并查看专利文件中的摘要示意图或图纸。\n---\n\n# 智慧芽-专利摘要附图查询（Zhihuiya Abstract Image）\n\n本技能用于从智慧芽专利数据库获取专利摘要附图（摘要示意图/图纸），帮助用户快速查看与特定专利相关的附图。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过专利 ID（`patentId`）或公开号（`patentNumber`）查询专利的摘要附图下载路径。\n- 支持单条查询与批量查询（多个值用英文逗号隔开，上限 100 条）。\n- 返回附图下载路径，便于直接查看专利图纸/示意图。\n\n### ❌ 边界与限制\n\n- **必填条件**：`patentId` 与 `patentNumber` 至少提供一个；两者都提供时优先使用 `patentId`。\n- **数量上限**：单次请求最多查询 100 条专利。\n- **仅返回摘要附图**：不提供专利全文、权利要求、法律状态、同族、引用/对比文件、估值或侵权分析。\n- **不含专利检索**：不支持按关键词或分类号检索专利，需用户自行提供专利 ID 或公开号。\n- **成本约束**：本工具消耗积分，同一会话同一参数组合默认只调用一次，失败/空结果不得自动换号连续试探。\n\n## 调用方式\n\n- **API 端点**：`POST /zhihuiya/abstractImage`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/zhihuiya_abstract_image.py '<JSON 参数>' [--inline]`\n- **成本约束**：同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-abstract-image-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 按公开号查询单条专利**\n> \"查一下专利 CN115059423A 的摘要附图。\"\n```json\n{\"patentNumber\": \"CN115059423A\"}\n```\n\n**2. 按公开号批量查询**\n> \"获取专利 US11234567B2、EP3456789A1、CN115059423A 的摘要附图。\"\n```json\n{\"patentNumber\": \"US11234567B2,EP3456789A1,CN115059423A\"}\n```\n\n**3. 按专利 ID 查询**\n> \"获取专利 ID 为 5e6f7a8b9c 的摘要附图。\"\n```json\n{\"patentId\": \"5e6f7a8b9c\"}\n```\n\n**4. 混合标识符批量查询**\n> \"我有这些专利 ID：abc123、def456，请获取它们的摘要附图。\"\n```json\n{\"patentId\": \"abc123,def456\"}\n```\n\n## 展示规则\n\n1. **展示图片**：响应含 `abstractDrawingPath` 时，用 Markdown 图片语法直接展示附图，便于用户直观查看。\n2. **标明专利**：每张附图旁标注公开号（`pn`），让用户知道该图属于哪件专利。\n3. **缺失附图**：某专利无摘要附图（`abstractDrawingPath` 为空）时，明确告知用户该专利无摘要附图。\n4. **批量结果**：多专利查询时，以清晰的列表或表格组织结果。\n5. **错误处理**：查询失败时，依据响应说明原因，并建议用户核实专利 ID 或公开号。\n6. **不做主观分析**：只呈现附图与元数据，不添加主观专利分析或法律解读。\n\n## 用户表达与场景速查\n\n**适用** —— 专利摘要附图检索：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"看一下专利 XX 的摘要附图\" | 单条专利附图查询 |\n| \"获取这些专利的图纸\" | 批量专利附图查询 |\n| \"专利附图长什么样\" | 摘要附图获取 |\n| \"获取 XX 的专利示意图\" | 附图下载路径获取 |\n| \"我要公开号 XX 的摘要附图\" | 按公开号查询 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 智慧芽-摘要附图 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/zhihuiya/abstractImage`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| patentId | string | 条件必填 | 专利ID。`patentId` 和 `patentNumber` 两个参数必须至少提供一个，如果两个都存在，会优先使用 `patentId`。多个用英文逗号隔开，上限100条。最大长度60000字符。 |\n| patentNumber | string | 条件必填 | 公开公告号。`patentId` 和 `patentNumber` 两个参数必须至少提供一个，如果两个都存在，会优先使用 `patentId`。多个用英文逗号隔开，上限100条。最大长度60000字符。 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| data | array | 专利摘要附图结果列表 |\n| data[].patentId | string | 专利ID |\n| data[].pn | string | 公开(公告)号 |\n| data[].abstractDrawingPath | string | 摘要附图图片下载路径 |\n| columns | array | 渲染的列定义 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析 `data` 等业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | - | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\n# 通过公开公告号查询\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/abstractImage \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"CN115059423A\"}'\n```\n\n```bash\n# 通过专利ID查询\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/abstractImage \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentId\": \"5e6f7a8b9c\"}'\n```\n\n```bash\n# 批量查询多个公开公告号\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/abstractImage \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"CN115059423A,US11234567B2,EP3456789A1\"}'\n```\n\nFile v1.2.3:references/linkfox-zhihuiya-bibliography.md\n\n---\nname: linkfox-zhihuiya-bibliography\ndescription: 智慧芽专利详细著录信息查询工具。支持查询申请人、发明人、分类号、引用关系及优先权等完整元数据。\n---\n\n# 智慧芽-专利详细著录信息查询（Zhihuiya Patent Bibliography）\n\n本技能用于通过专利ID或公开号查询智慧芽专利数据库中的专利著录（书目）信息，帮助用户获取特定专利的完整元数据。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过**专利ID**或**公开号**查询专利著录信息，单次请求最多 100 条。\n- 返回字段覆盖：标题、摘要、专利类型、申请人、当前专利权人、发明人、代理人/代理机构、审查员、优先权声明、申请/公开引用数据、IPC/CPC/UPC/LOC/FI/F-term/GBC 分类号、引用专利与非专利文献、分案/继续申请、PCT 数据、预估到期日等。\n\n### ❌ 边界与限制\n\n- **输入要求**：`patentId` 与 `patentNumber` 至少提供一个；二者同时存在时优先使用 `patentId`。\n- **数量上限**：单次请求最多 100 条，参数最大长度 60,000 字符。\n- **不在范围内**：按关键词/语义的全文本专利检索、专利全景分析报告、专利估值或法律状态跟踪、FTO/侵权分析、专利族树探索（除非给定具体公开号）。当用户说\"查找关于 X 的专利\"或\"在 Y 领域检索专利\"时属于专利检索任务，不适用本技能。\n- **数据时效**：著录数据来自智慧芽专利数据库，依赖其更新周期。\n\n## 核心概念\n\n专利著录数据（书目信息）是与专利文档关联的结构化元数据，包含标题、申请人、发明人、分类号、优先权声明、引用文献、摘要等。本工具支持按 **专利ID** 或 **公开号** 查询，单次最多返回 100 条专利的完整著录记录。\n\n**专利类型**（`patentType` 字段）：\n- `APPLICATION` —— 发明申请（已公开未授权）\n- `PATENT` —— 授权发明专利\n- `UTILITY` —— 实用新型\n- `DESIGN` —— 外观设计\n\n## 调用方式\n\n- **API 端点**：`POST /zhihuiya/bibliography`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/zhihuiya_bibliography.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-bibliography-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 按公开号查询单条专利**\n```\n用户：\"查一下 US10123456B2 的著录信息\"\n动作：patentNumber = \"US10123456B2\"\n```\n\n**2. 按公开号批量查询**\n```\n用户：\"获取 CN112345678A、EP3456789B1、US20210012345A1 的著录数据\"\n动作：patentNumber = \"CN112345678A,EP3456789B1,US20210012345A1\"\n```\n\n**3. 按专利ID查询**\n```\n用户：\"查询专利ID 8fa3b2c1-xxxx-xxxx-xxxx-xxxxxxxxxxxx 的著录信息\"\n动作：patentId = \"8fa3b2c1-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"\n```\n\n**4. 批量查询发明人与专利权人**\n```\n用户：\"我有 20 个公开号，查一下它们的发明人和专利权人\"\n动作：patentNumber = \"<逗号分隔的列表>\"\n随后从结果中抽取并展示发明人与专利权人。\n```\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格或组织良好的分区展示每条专利，重点突出常用字段：标题、申请人/专利权人、发明人、申请/公开日期、分类号、摘要。\n2. **遵循查询范围**：只展示用户询问的字段。若用户只要\"发明人\"，除非用户要求否则不要倾倒全部著录信息。\n3. **专利类型标签**：将 `patentType` 代码翻译为可读标签（APPLICATION = 发明申请，PATENT = 授权发明，UTILITY = 实用新型，DESIGN = 外观设计）。\n4. **多专利结果**：结果含多条专利时先用汇总表，再按用户需要展开单条详情。\n5. **错误处理**：查询返回错误或空结果时清晰说明，并建议用户核对专利ID或公开号。\n6. **不做主观分析**：只呈现事实性著录数据，不做推测性的法律或商业解读。\n\n## 用户表达与场景速查\n\n**适用** —— 专利著录/元数据查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查一下 XX 专利的信息\" | 单条专利著录 |\n| \"XX 专利的发明人是谁\" | 发明人查询 |\n| \"XX 专利是谁的\"、\"当前专利权人\" | 专利权人/申请人查询 |\n| \"XX 专利的 IPC/CPC 分类是什么\" | 分类号查询 |\n| \"看一下 XX 专利的摘要\" | 摘要获取 |\n| \"XX 专利引用了哪些专利\" | 引用分析 |\n| \"XX 专利什么时候到期\" | 到期日查询 |\n| \"查这几个专利的著录信息：A、B、C\" | 批量查询 |\n| \"专利详情\"、\"专利元数据\" | 通用著录查询 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 智慧芽-著录项目 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/zhihuiya/bibliography`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| patentId | string | 否* | 专利ID（专利id和公开号两个参数必须要有一个，如果两个都存在，会优先使用专利id），多个用英文逗号隔开，上限100条，最大长度60,000字符 |\n| patentNumber | string | 否* | 公开公告号（专利id和公开号两个参数必须要有一个，如果两个都存在，会优先使用专利id），多个用英文逗号隔开，上限100条，最大长度60,000字符 |\n\n> \\* `patentId` 和 `patentNumber` 至少需要提供一个。\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| data | array | 著录项目数据列表（详见下方数据字段） |\n| columns | array | 渲染的列 |\n| type | string | 渲染的样式 |\n| costToken | integer | 消耗token |\n\n### 数据字段（`data` 数组中的每个对象）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| patentId | string | 专利ID |\n| pn | string | 公开公告号 |\n| inventionTitle | array | 专利标题语言和名称 |\n| abstracts | array | 专利摘要 |\n| patentType | string | 专利类型，其中APPLICATION：发明申请，PATENT：授权发明，UTILITY：实用新型，DESIGN：外观设计 |\n| applicants | array | 原始申请人 |\n| assignees | array | 当前申请(专利权)人 |\n| inventors | array | 发明人 |\n| agents | array | 专利申请人 |\n| agency | array | 申请代理机构 |\n| examiners | array | 审查员信息 |\n| priorityClaims | array | 优先权声明 |\n| applicationReference | object | 申请文件引用数据 |\n| publicationReference | object | 公开文件引用数据 |\n| datesOfPublicAvailability | object | 公开可用日期 |\n| classificationIpcr | object | IPC分类号 |\n| classificationCpc | object | CPC分类号 |\n| classificationUpc | object | 美国专利分类号 |\n| classificationLoc | array | LOC分类号 |\n| classificationFi | array | FI分类号 |\n| classificationFterm | array | F_term分类号 |\n| classificationGbc | object | GBC分类号 |\n| referenceCitedPatents | array | 引用专利文献 |\n| referenceCitedOthers | array | 引用非专利文献 |\n| relatedDocuments | array | 分案继续申请信息 |\n| pctOrRegionalFilingData | object | PCT或区域阶段申请数据 |\n| pctOrRegionalPublishingData | object | PCT或区域阶段公开数据 |\n| exdt | integer | 智慧芽专利预估到期日 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | - | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n**通过公开公告号查询（单条专利）：**\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/bibliography \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"US10123456B2\"}'\n```\n\n**通过专利ID查询：**\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/bibliography \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentId\": \"some-patent-id-here\"}'\n```\n\n**通过公开公告号查询多条专利：**\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/bibliography \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"US10123456B2,CN112345678A,EP3456789B1\"}'\n```\n\nFile v1.2.3:references/linkfox-zhihuiya-claim-data-translated.md\n\n---\nname: linkfox-zhihuiya-claim-data-translated\ndescription: 智慧芽专利权利要求翻译工具。支持将专利的权利要求文本翻译并转换为中文、英文或日文版本。\n---\n\n# 智慧芽-专利权利要求翻译（Zhihuiya Patent Claims Translated）\n\n本技能用于从智慧芽（PatSnap）专利数据库查询翻译后的专利权利要求，支持按专利 ID 或公开号检索，并返回中文、英文或日文版本的权利要求文本。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 查询专利的**翻译后权利要求文本**，支持中文（`cn`）、英文（`en`）、日文（`jp`）三种语言。\n- 按内部专利 ID（`patentId`）或公开（公告）号（`patentNumber`）检索，单次最多 100 件专利。\n- 当原专利权利要求不可获取时，可启用同族专利替代（`replaceByRelated=1`）返回相关同族专利的权利要求。\n\n### ❌ 边界与限制\n\n- **至少一个标识**：必须提供 `patentId` 或 `patentNumber` 之一，否则查询失败。\n- **批量上限**：单次请求最多 100 件专利。\n- **语言支持**：仅支持中文（`cn`）、英文（`en`）、日文（`jp`）；默认英文（`en`）。\n- **同族替代**：仅当 `replaceByRelated=1` 且原专利权利要求不可获取时，才会返回同族专利的替代权利要求。\n- **不在范围内**：专利检索/发现（按关键词找专利）；专利引用或法律状态分析；专利摘要或说明书获取；专利组合统计与分析。\n\n## 核心概念\n\n专利权利要求界定了专利授予的法律保护范围。本工具获取专利权利要求的**翻译文本**，支持中文（`cn`）、英文（`en`）、日文（`jp`）三种语言。可按内部专利 ID 或公开（公告）号检索专利。\n\n**同族专利替代**：当某件专利的权利要求不可获取时，工具可选择用相关同族专利的权利要求替代，由 `replaceByRelated` 参数控制。\n\n**数据字段**：\n\n| 字段 | API 字段名 | 说明 | 示例 |\n|------|-----------|------|------|\n| 专利 ID | patentId | 内部专利标识 | 84a1b2c3-... |\n| 公开号 | pn | 专利的公开（公告）号 | CN112345678A |\n| 同族替代公开号 | pnRelated | 替代同族专利的公开号（仅在使用同族替代时出现） | US20210012345A1 |\n| 权利要求 | claims | 翻译后的权利要求文本 | 1. A method for... |\n\n**支持语言**：\n\n| 代码 | 语言 |\n|------|------|\n| en | 英文（默认） |\n| cn | 中文 |\n| jp | 日文 |\n\n用户未指定语言时，默认使用英文（`en`）。\n\n## 调用方式\n\n- **API 端点**：`POST /zhihuiya/claimDataTranslated`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/zhihuiya_claim_translated.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-claim-data-translated-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 按公开号查询单件专利的英文权利要求**\n```\npatentNumber: \"CN112345678A\"\nlang: \"en\"\n```\n\n**2. 按公开号查询多件专利的中文权利要求**\n```\npatentNumber: \"US20210012345A1,EP3456789B1\"\nlang: \"cn\"\n```\n\n**3. 查询日文权利要求并启用同族替代**\n```\npatentNumber: \"JP2021123456A\"\nlang: \"jp\"\nreplaceByRelated: 1\n```\n\n**4. 按专利 ID 查询**\n```\npatentId: \"84a1b2c3-d4e5-6f78-9abc-def012345678\"\nlang: \"en\"\n```\n\n## 展示规则\n\n1. **清晰呈现权利要求**：以规范格式展示翻译后的权利要求文本。返回多件专利时，以公开号作为标题分隔每件专利的权利要求。\n2. **同族替代提示**：响应中出现 `pnRelated` 时，明确告知用户权利要求取自相关同族专利，并展示替代公开号。\n3. **语言说明**：说明返回权利要求所使用的语言，便于用户确认正在查看的翻译版本。\n4. **大结果处理**：返回多件专利时，汇总数量并展示若干代表性条目，同时告知总数。\n5. **错误处理**：查询失败时根据错误响应说明原因，并建议检查专利 ID 或公开号。\n\n## 用户表达与场景速查\n\n**适用** —— 与专利权利要求文本及翻译相关的查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查一下专利 XX 的权利要求\" | 单件专利权利要求查询 |\n| \"把权利要求翻译成中文/日文\" | 权利要求翻译 |\n| \"专利 XX 的权利要求是什么\" | 权利要求内容获取 |\n| \"查这几件专利的权利要求：XX、YY\" | 批量专利权利要求查询 |\n| \"权利要求查不到，试试同族专利\" | 同族专利替代 |\n| \"专利 XX 的权利保护范围\" | 权利要求文本获取 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 智慧芽-权利要求翻译 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/zhihuiya/claimDataTranslated`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| patentId | string | 否* | 专利ID，多个用英文逗号隔开，上限100条。当与 `patentNumber` 同时存在时优先使用专利ID。最大长度：60000字符 |\n| patentNumber | string | 否* | 公开(公告)号，多个用英文逗号隔开，上限100条。最大长度：60000字符 |\n| lang | string | 否 | 翻译语言，支持 `en`（英文，默认）、`cn`（中文）、`jp`（日语）。最大长度：1000字符 |\n| replaceByRelated | integer | 否 | 权利要求无法获取时是否用同族专利替代：`1` 是，`0` 否（默认） |\n\n> *`patentId` 和 `patentNumber` 两个参数必须至少提供一个。如果两个都存在，会优先使用 `patentId`。\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| data | array | 专利列表（详见下方） |\n| columns | array | 渲染的列定义 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### data[] 对象\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| patentId | string | 专利ID |\n| pn | string | 公开(公告)号 |\n| pnRelated | string | 替代专利的公开号（仅当使用同族专利替代时提供） |\n| claims | string | 权利要求翻译文本 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析 `data` 等业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | - | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/claimDataTranslated \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"CN112345678A\", \"lang\": \"en\", \"replaceByRelated\": 0}'\n```\n\n### 多专利查询并启用同族替代示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/zhihuiya/claimDataTranslated \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"patentNumber\": \"US20210012345A1,EP3456789B1\", \"lang\": \"cn\", \"replaceByRelated\": 1}'\n```\n\nArchive v1.2.2: 50 files, 239992 bytes\n\nFiles: references/linkfox-ruiguan-copyright-detection.md (10186b), references/linkfox-ruiguan-detection-patent-design.md (14266b), references/linkfox-ruiguan-gun-parts-search.md (8523b), references/linkfox-ruiguan-text-trademark-detection.md (11766b), references/linkfox-ruiguan-trademark-graphic-detection.md (11252b), references/linkfox-ruiguan-utility-patent-detection.md (11187b), references/linkfox-zhihuiya-abstract-data-translated.md (9390b), references/linkfox-zhihuiya-abstract-image.md (8236b), references/linkfox-zhihuiya-bibliography.md (11085b), references/linkfox-zhihuiya-claim-data-translated.md (9720b), references/linkfox-zhihuiya-claim-data.md (9523b), references/linkfox-zhihuiya-description-data-translated.md (9151b), references/linkfox-zhihuiya-description-data.md (9372b), references/linkfox-zhihuiya-fulltext-image.md (8060b), references/linkfox-zhihuiya-legal-status.md (11334b), references/linkfox-zhihuiya-patent-cited.md (9593b), references/linkfox-zhihuiya-patent-family.md (9987b), references/linkfox-zhihuiya-patent-forward-citation.md (9175b), references/linkfox-zhihuiya-patent-image-search.md (17504b), references/linkfox-zhihuiya-pdf-data.md (9130b), references/linkfox-zhihuiya-simple-bibliography.md (10906b), references/linkfox-zhihuiya-utility-patent-image-search.md (17850b), references/onboarding.md (2068b), scripts/onboarding.py (24089b), scripts/ruiguan_copyright_detection.py (12750b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/ruiguan_image_compliance_search.py (12762b), scripts/ruiguan_text_trademark_detection.py (13145b), scripts/ruiguan_trademark_graphic_detection.py (12812b), scripts/ruiguan_utility_patent_detection.py (13145b), scripts/upload_image.py (4591b), scripts/zhihuiya_abstract_image.py (13082b), scripts/zhihuiya_abstract_translated.py (13142b), scripts/zhihuiya_bibliography.py (13068b), scripts/zhihuiya_cited_by.py (13060b), scripts/zhihuiya_cited_references.py (13124b), scripts/zhihuiya_claim_data.py (13051b), scripts/zhihuiya_claim_translated.py (13119b), scripts/zhihuiya_description_data.py (13098b), scripts/zhihuiya_description_translated.py (13166b), scripts/zhihuiya_fulltext_image.py (13082b), scripts/zhihuiya_legal_status.py (13066b), scripts/zhihuiya_patent_family.py (13076b), scripts/zhihuiya_patent_image_search.py (13506b), scripts/zhihuiya_pdf_data.py (13040b), scripts/zhihuiya_simple_bibliography.py (13122b), scripts/zhihuiya_utility_patent_image_search.py (13526b), skill-card.md (4850b), SKILL.md (25632b), _meta.json (157b)\n\nFile v1.2.2:SKILL.md\n\n---\nname: linkfox-ecommerce-compliance-detection\ndisplay_name: Linkfox 电商合规检测\ndisplay_name_en: LinkFox E-commerce Compliance Detection\ndescription: 电商知识产权与合规检测一站式 AI 工具集，整合睿观知产合规检测（版权/商标/外观专利/实用新型专利/图片政策）与智慧芽专利数据查询（著录/权利要求/说明书/附图/法律状态/家族/引用/以图搜图/PDF）共 2 类底层工具、22 项子能力。\ndescription_zh: 电商知产与合规检测工具集，整合睿观（ruiguan_ip_detection）与智慧芽（zhihuiya_patent）2 类底层工具、22 项子能力。睿观覆盖图片版权、图形/文字商标、外观专利、实用新型专利、图片政策合规检测，返回相似度、权利人、TRO 与雷达侵权判定，支持 25+ 国家/地区。智慧芽覆盖专利核心/详细著录、标题摘要/权利要求/说明书及翻译、附图、法律状态、专利家族、引用分析、PDF 下载及外观/实用新型以图搜图。当用户需上架前版权/商标/专利侵权排查、TRO 风险评估、图片合规审查、专利查询翻译或以图搜专利时触发。参数见 references/，脚本见 scripts/。\ndescription_en: One-stop e-commerce IP & compliance detection AI toolkit integrating 22 sub-capabilities across 2 tool families — Ruiguan (ruiguan_ip_detection: image copyright, graphic & text trademark, design & utility-model patent, and policy/compliance detection with similarity, rights owner, TRO litigation history and radar infringement verdicts across 25+ countries) and PatSnap/Zhihuiya (zhihuiya_patent: patent core/detailed bibliography, title-abstract translation, claims & translation, description & translation, abstract/fulltext drawings, legal status & event history, patent family, forward & back citations, PDF download, and design/utility-model patent image search). Triggered when the user needs pre-launch copyright/trademark/patent infringement checks, TRO risk assessment, product image compliance review, patent detail lookup & translation, or image-based patent search. Full params per sub-capability are in references/, executable scripts in scripts/.\ncategory: e-commerce\nversion: 1.0.0\nauthor: LinkFox\n---\n\n# Linkfox 电商合规检测（E-commerce Compliance Detection）\n\n电商知识产权与合规检测一站式 AI 工具集，整合 **2 类底层工具、22 项子能力**：睿观（`ruiguan_ip_detection`）负责图片/文本类知产侵权与合规风险检测，智慧芽（`zhihuiya_patent`）负责专利数据查询与以图搜图。各子能力完整参数、响应字段与错误码见 `references/` 下对应文件，可执行脚本见 `scripts/`。\n\n## 能力边界\n\n### ✅ 能力范围\n- **图片版权侵权检测**（`ruiguan_ip_detection`）：对图片 URL 与已登记版权作品库比对，返回相似度、权利人、版权标识码、TRO 维权史与雷达侵权判定（linkfox-ruiguan-copyright-detection）。\n- **图形商标 / Logo 检测**（`ruiguan_ip_detection`）：产品图片与全球 15 国已注册图形商标库视觉相似度比对，含商标名、注册状态、尼斯分类、申请人、雷达判定（linkfox-ruiguan-trademark-graphic-detection）。\n- **文字商标检测**（`ruiguan_ip_detection`）：产品 Listing 标题/描述文本与 15 国注册商标库比对，返回整体风险等级、黑白名单与逐条命中（linkfox-ruiguan-text-trademark-detection）。\n- **外观设计专利检测**（`ruiguan_ip_detection`）：产品图片检索 25+ 国家/地区外观专利，含 AI 雷达侵权判定、TRO 风险与专利法律状态（linkfox-ruiguan-detection-patent-design）。\n- **实用新型 / 发明专利检测**（`ruiguan_ip_detection`）：基于产品标题与描述检索相似实用新型/发明专利，含 TRO 风险与预估到期日（linkfox-ruiguan-utility-patent-detection，当前仅支持 US）。\n- **图片政策合规检测**（`ruiguan_ip_detection`）：在已知违规/禁售商品库中按视觉相似度检索潜在违规商品（linkfox-ruiguan-gun-parts-search）。\n- **专利以图搜图**（`zhihuiya_patent`）：通过图片 URL 检索相似外观设计（`D`）与实用新型（`U`）专利，按视觉相似度排序，支持按受理局、洛迦诺分类、法律状态、申请人、日期多维筛选（linkfox-zhihuiya-patent-image-search、linkfox-zhihuiya-utility-patent-image-search）。\n- **专利著录查询**（`zhihuiya_patent`）：核心著录（标题/摘要/发明人/申请人/IPC·CPC 主分类）与详细著录（完整分类号/引用/优先权/预估到期日）（linkfox-zhihuiya-simple-bibliography、linkfox-zhihuiya-bibliography）。\n- **专利全文与翻译**（`zhihuiya_patent`）：权利要求及翻译、说明书及翻译、标题摘要翻译，支持中/英/日（linkfox-zhihuiya-claim-data、linkfox-zhihuiya-claim-data-translated、linkfox-zhihuiya-description-data、linkfox-zhihuiya-description-data-translated、linkfox-zhihuiya-abstract-data-translated）。\n- **专利附图**（`zhihuiya_patent`）：摘要附图与全文附图（图纸/示意图/图表）下载路径（linkfox-zhihuiya-abstract-image、linkfox-zhihuiya-fulltext-image）。\n- **专利法律状态与家族**（`zhihuiya_patent`）：法律状态及事件历史（转让/许可/质押/诉讼/复审）、简单同族/INPADOC 同族跨国等同专利（linkfox-zhihuiya-legal-status、linkfox-zhihuiya-patent-family）。\n- **专利引用分析**（`zhihuiya_patent`）：被引用次数（3/5 年）及引用专利列表、参考文献（在先技术，含专利与非专利文献）（linkfox-zhihuiya-patent-cited、linkfox-zhihuiya-patent-forward-citation）。\n- **专利 PDF 下载**（`zhihuiya_patent`）：单篇/批量（上限 100）专利 PDF 全文下载链接（linkfox-zhihuiya-pdf-data）。\n- 覆盖睿观 25+ 国家/地区（外观专利）与 15 国（商标）、智慧芽全球专利库；本地图片可经 `upload_image.py` 转公开 URL 后检测/检索。\n\n### ❌ 边界与限制\n- **API Key 必需**：所有工具均需环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）；各工具独立计费、独立限频，数据时效与站点覆盖随数据源而异。\n- **计费约束**：同一会话同一参数组合默认只调用一次（脚本带 24h 本地缓存）；失败或空结果不得自动换图、换关键词、翻页或改参数连续试探；需继续检索时先向用户说明会产生额外消耗（各工具计费规则见 `skills-version.json` 对应条目与 references 内 api.md 的 `costToken` 字段；睿观雷达检测开启时计费翻倍，智慧芽多数按返回条数计费）。\n- **图片 URL 必需**：睿观图片类检测与智慧芽以图搜图仅接受可公开访问的图片 URL，不直接接收本地文件；本地图片须先用 `scripts/upload_image.py` 转为公开 URL（有效期 24 小时）。\n- **非法律意见**：所有检测结果仅呈现数据（相似度、风险指标、专利信息），不提供侵权法律结论、FTO 自由实施意见或诉讼策略；法律结论须咨询专业律师。\n- **不在范围内**：商标/专利/版权的注册申请与登记办理；店铺运营（Listing 刊登/订单/库存）、广告投放、物流与供应链；音乐/视频版权检测；基于文本的专利检索（关键词/摘要检索，本工具仅支持以图搜图）；专利年费管理与监控、专利估值或许可谈判；与平台或权利人的直接沟通；非电商任务。\n- **数据时效**：睿观检测为实时/准实时抓取；智慧芽专利数据为其数据库更新周期，`costToken`/`lastUpdate` 等字段标识消耗与刷新。\n\n## 工具选择指南\n\n按需求在下表定到子能力，再跳到【业务需求路由速查】查端点/脚本/references 取参执行。\n\n| 需求 / 用户说 | 默认推荐（子能力） | 何时换用其他 |\n|---|---|---|\n| 图片版权侵权 / TRO 风险（\"这张图有没有版权问题\"） | `linkfox-ruiguan-copyright-detection` | 查图形商标/Logo 用 `linkfox-ruiguan-trademark-graphic-detection`；查外观专利用 `linkfox-ruiguan-detection-patent-design` |\n| 图形商标 / Logo 侵权（\"图片有没有商标问题\"） | `linkfox-ruiguan-trademark-graphic-detection` | 查文字商标（标题/描述文本）用 `linkfox-ruiguan-text-trademark-detection` |\n| 文字商标 / 标题品牌侵权（\"标题有没有商标问题\"） | `linkfox-ruiguan-text-trademark-detection` | 查图形商标用 `linkfox-ruiguan-trademark-graphic-detection` |\n| 外观专利侵权 / TRO（\"产品外观有没有专利风险\"） | `linkfox-ruiguan-detection-patent-design`（睿观，25+ 国，含雷达判定与 TRO） | 仅需视觉相似专利列表（不要 TRO/侵权判定）用 `linkfox-zhihuiya-patent-image-search`（patentType=`D`） |\n| 实用新型/发明专利风险（\"产品结构有没有专利风险\"） | `linkfox-ruiguan-utility-patent-detection`（基于标题描述，仅 US） | 有产品图片想以图搜实用新型专利用 `linkfox-zhihuiya-utility-patent-image-search` |\n| 图片政策合规 / 禁售商品（\"这图有没有违规/禁售风险\"） | `linkfox-ruiguan-gun-parts-search` | — |\n| 以图搜外观专利（\"用图找相似外观专利\"） | `linkfox-zhihuiya-patent-image-search`（仅 `D`，强制 model 1/2） | 要实用新型以图搜图用 `linkfox-zhihuiya-utility-patent-image-search`；要 TRO/侵权判定用 `linkfox-ruiguan-detection-patent-design` |\n| 以图搜实用新型专利（\"用图找相似实用新型专利\"） | `linkfox-zhihuiya-utility-patent-image-search`（仅 `U`，强制 model 3/4） | 要外观专利以图搜图用 `linkfox-zhihuiya-patent-image-search`；要基于标题描述的实用新型侵权检测用 `linkfox-ruiguan-utility-patent-detection` |\n| 专利基本信息 / 发明人申请人（\"这专利是谁的\"） | `linkfox-zhihuiya-simple-bibliography`（核心著录，轻量） | 要完整分类号/引用/优先权/预估到期日用 `linkfox-zhihuiya-bibliography` |\n| 专利详细著录 / 分类号 / 优先权（\"专利完整信息\"） | `linkfox-zhihuiya-bibliography` | 只要标题/摘要/发明人用 `linkfox-zhihuiya-simple-bibliography` |\n| 专利标题/摘要翻译（\"翻译专利摘要\"） | `linkfox-zhihuiya-abstract-data-translated`（中/英/日） | 要权利要求翻译用 `linkfox-zhihuiya-claim-data-translated`；要说明书翻译用 `linkfox-zhihuiya-description-data-translated` |\n| 专利权利要求（\"看权利要求\"） | `linkfox-zhihuiya-claim-data` | 要翻译用 `linkfox-zhihuiya-claim-data-translated` |\n| 专利说明书（\"看说明书/全文\"） | `linkfox-zhihuiya-description-data` | 要翻译用 `linkfox-zhihuiya-description-data-translated`；要 PDF 用 `linkfox-zhihuiya-pdf-data` |\n| 专利附图 / 图纸（\"看专利图\"） | `linkfox-zhihuiya-abstract-image`（摘要附图，单张） | 要全部图纸用 `linkfox-zhihuiya-fulltext-image` |\n| 专利法律状态 / 是否有效（\"这专利还有效吗\"） | `linkfox-zhihuiya-legal-status` | — |\n| 专利家族 / 跨国等同（\"这专利的家族/等同专利\"） | `linkfox-zhihuiya-patent-family` | — |\n| 专利被引用次数 / 影响力（\"被引用多少次\"） | `linkfox-zhihuiya-patent-cited`（被引用，看谁引用了本专利） | 要本专利引用了哪些文献用 `linkfox-zhihuiya-patent-forward-citation` |\n| 专利参考文献 / 在先技术（\"引用了哪些专利\"） | `linkfox-zhihuiya-patent-forward-citation`（参考文献，看本专利引用了谁） | 要被引用次数用 `linkfox-zhihuiya-patent-cited` |\n| 专利 PDF 下载（\"下载专利 PDF\"） | `linkfox-zhihuiya-pdf-data` | — |\n\n### 工具选择思路\n- **重要**：多个子能力满足需求时，要依据需求深入分析子能力的功能、用途、出入参，从中调研出最合适的子能力，并推荐用户，让用户自己决定。\n- 满足程度同等的前提下，向用户推荐\"默认推荐子能力\"。\n\n## 业务需求路由速查\n\n按【工具选择指南】定到子能力 后，下表查端点、脚本与 references 文件取参执行：\n\n### 子能力 ↔ references 文件 ↔ 端点 ↔ 脚本（22 项）\n\n**ruiguan_ip_detection**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-ruiguan-copyright-detection | references/linkfox-ruiguan-copyright-detection.md | POST /ruiguan/copyrightDetection | ruiguan_copyright_detection.py |\n| linkfox-ruiguan-trademark-graphic-detection | references/linkfox-ruiguan-trademark-graphic-detection.md | POST /ruiguan/trademarkGraphicDetection | ruiguan_trademark_graphic_detection.py |\n| linkfox-ruiguan-text-trademark-detection | references/linkfox-ruiguan-text-trademark-detection.md | POST /ruiguan/textTrademarkDetection | ruiguan_text_trademark_detection.py |\n| linkfox-ruiguan-detection-patent-design | references/linkfox-ruiguan-detection-patent-design.md | POST /ruiguan/detectionPatentDesign | ruiguan_detection_patent_design.py |\n| linkfox-ruiguan-utility-patent-detection | references/linkfox-ruiguan-utility-patent-detection.md | POST /ruiguan/utilityPatentDetection | ruiguan_utility_patent_detection.py |\n| linkfox-ruiguan-gun-parts-search | references/linkfox-ruiguan-gun-parts-search.md | POST /ruiguan/gunPartsSearch | ruiguan_image_compliance_search.py |\n\n**zhihuiya_patent**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-zhihuiya-patent-image-search | references/linkfox-zhihuiya-patent-image-search.md | POST /zhihuiya/patentImageSearch | zhihuiya_patent_image_search.py |\n| linkfox-zhihuiya-utility-patent-image-search | references/linkfox-zhihuiya-utility-patent-image-search.md | POST /zhihuiya/patentImageSearch | zhihuiya_utility_patent_image_search.py ¹ |\n| linkfox-zhihuiya-simple-bibliography | references/linkfox-zhihuiya-simple-bibliography.md | POST /zhihuiya/simpleBibliography | zhihuiya_simple_bibliography.py |\n| linkfox-zhihuiya-bibliography | references/linkfox-zhihuiya-bibliography.md | POST /zhihuiya/bibliography | zhihuiya_bibliography.py |\n| linkfox-zhihuiya-abstract-data-translated | references/linkfox-zhihuiya-abstract-data-translated.md | POST /zhihuiya/abstractDataTranslated | zhihuiya_abstract_translated.py |\n| linkfox-zhihuiya-claim-data | references/linkfox-zhihuiya-claim-data.md | POST /zhihuiya/claimData | zhihuiya_claim_data.py |\n| linkfox-zhihuiya-claim-data-translated | references/linkfox-zhihuiya-claim-data-translated.md | POST /zhihuiya/claimDataTranslated | zhihuiya_claim_translated.py |\n| linkfox-zhihuiya-description-data | references/linkfox-zhihuiya-description-data.md | POST /zhihuiya/descriptionData | zhihuiya_description_data.py |\n| linkfox-zhihuiya-description-data-translated | references/linkfox-zhihuiya-description-data-translated.md | POST /zhihuiya/descriptionDataTranslated | zhihuiya_description_translated.py |\n| linkfox-zhihuiya-abstract-image | references/linkfox-zhihuiya-abstract-image.md | POST /zhihuiya/abstractImage | zhihuiya_abstract_image.py |\n| linkfox-zhihuiya-fulltext-image | references/linkfox-zhihuiya-fulltext-image.md | POST /zhihuiya/fulltextImage | zhihuiya_fulltext_image.py |\n| linkfox-zhihuiya-legal-status | references/linkfox-zhihuiya-legal-status.md | POST /zhihuiya/legalStatus | zhihuiya_legal_status.py |\n| linkfox-zhihuiya-patent-family | references/linkfox-zhihuiya-patent-family.md | POST /zhihuiya/patentFamily | zhihuiya_patent_family.py |\n| linkfox-zhihuiya-patent-cited | references/linkfox-zhihuiya-patent-cited.md | POST /zhihuiya/patentCited | zhihuiya_cited_by.py |\n| linkfox-zhihuiya-patent-forward-citation | references/linkfox-zhihuiya-patent-forward-citation.md | POST /zhihuiya/patentForwardCitation | zhihuiya_cited_references.py |\n| linkfox-zhihuiya-pdf-data | references/linkfox-zhihuiya-pdf-data.md | POST /zhihuiya/pdfData | zhihuiya_pdf_data.py |\n\n> ¹ `linkfox-zhihuiya-patent-image-search` 与 `linkfox-zhihuiya-utility-patent-image-search` 共用同一端点 `/zhihuiya/patentImageSearch`，均源自 `skills/` 下已拆分的同名 skill（外观版仅 `D`/model 1-2、实用新型版仅 `U`/model 3-4，互为镜像）。源脚本同名（`zhihuiya_patent_image_search.py`），为避免文件冲突，实用新型版在 `scripts/` 中更名为 `zhihuiya_utility_patent_image_search.py`；两者内容逐字保留、各强制对应专利类型。其 references 归档正文仍按源文件逐字保留原脚本名。\n\n## 调用方式\n\n- **网关**：`${LINKFOX_TOOL_GATEWAY}/<端点>`，请求方式 POST、Content-Type `application/json`，认证 Header `Authorization: <api_key>`（api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取；未配置按下方【解决认证和积分问题】处理）。各端点路径见上方【业务需求路由速查】与对应 references 文件。\n- **Python 脚本**：每项子能力对应 `scripts/<脚本名>.py '<JSON 参数>' [--inline]`（脚本名与端点见路由速查表）。图片类工具需先 `scripts/upload_image.py <本地图片路径>` 获取公开 URL。脚本内部完成网关调用、鉴权与落盘。\n- **输出策略（脚本默认行为）**：始终将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill>-<timestamp>.json`（`<cwd>` 为脚本执行时工作目录；`<session>` 取自环境变量 `SESSION_ID`；禁止写入 /tmp，当前目录不可写则报错）；响应体 ≤ 8 KB 落盘后完整打印到 stdout，> 8 KB 仅打印摘要（顶层字段、常见计数、最大列表长度 + 前 3 条样本）；加 `--inline` 强制全量打印（同样落盘）。\n- **读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 PowerShell `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n- **完整参数**：每个子能力的请求参数、响应字段、错误码、curl 示例见 `references/<子能力>.md`（文件内含该子能力 SKILL.md 正文与 api.md 全文）。\n\n## 使用示例\n\n以下按数据层给出代表性子能力的出入参示例；其余子能力参数见对应 references 文件。睿观图片类工具的 `imageUrl`、智慧芽以图搜图的 `url` 均须为可公开访问的图片 URL（本地图片先经 `upload_image.py` 转换）；智慧芽查询类统一用 `patentId` 或 `patentNumber`（公开号，二选一）。\n\n### 知产合规检测层（睿观 ruiguan_ip_detection）\n\n**1. 图片版权检测（copyrightDetection → ruiguan_copyright_detection.py）**\n```json\n{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 100, \"enableRadar\": true}\n```\n出参：`data[]`（similarity/rightsOwner/copyrightCode/subRadarResult/troCase/troHolder/path/pathThumb）、`total`、`costToken`。`enableRadar` 开启时计费翻倍但含雷达侵权判定。\n\n**2. 图形商标检测（trademarkGraphicDetection → ruiguan_trademark_graphic_detection.py）**\n```json\n{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 10, \"regions\": \"US,EM\", \"enableRadar\": true}\n```\n出参：`data[]`（similarity/trademarkName/tradeMarkStatus/registrationOfficeCode/niceClassName/applicantName/subRadarResult/image）、`total`、`boundingBoxCount`、`radarResult`、`costToken`。\n\n**3. 文字商标检测（textTrademarkDetection → ruiguan_text_trademark_detection.py）**\n```json\n{\"productTitle\": \"Wireless Bluetooth Headphones Noise Cancelling Over Ear\", \"regions\": \"US\", \"limit\": 100}\n```\n出参：`data[]`（trademarkName/region/score/highestModeScore/holder/isFamous/isActiveHolder）、`total`、`textTrademarkRadar`、`blacklistTrademarks`、`whitelistTrademarks`、`costToken`。基于文本（标题/描述），无需图片。\n\n**4. 外观专利检测（detectionPatentDesign → ruiguan_detection_patent_design.py）**\n```json\n{\"imageUrl\": \"https://example.com/product.jpg\", \"queryMode\": \"hybrid\", \"topNumber\": 50, \"regions\": \"US\", \"enableRadar\": true}\n```\n出参：`data[]`（similarity/patentProdCn/applicationNumber/patentLoc/patentValidity/troCase/troHolder/radarResult{same,exp}/patentImageUrl/images）、`total`、`costToken`。覆盖 25+ 国家/地区，`queryMode` 可选 `hybrid`/`image`/`text`。\n\n**5. 实用新型/发明专利检测（utilityPatentDetection → ruiguan_utility_patent_detection.py）**\n```json\n{\"productTitle\": \"便携式USB-C 65W氮化镓快充充电器\", \"productDescription\": \"紧凑型65W氮化镓USB-C快充充电器，可折叠插脚，支持PD3.0/QC4.0，双USB-C+USB-A\", \"region\": \"US\", \"topNumber\": 100}\n```\n出参：`data[]`（similarity/title/titleCn/patentValidity/applicationNumber/publicationDate/estimatedDueDate/troCase/troHolder/patentImageUrl/images）、`total`、`costToken`。基于标题+描述检索，当前仅支持 US。\n\n**6. 图片政策合规检测（gunPartsSearch → ruiguan_image_compliance_search.py）**\n```json\n{\"imageUrl\": \"https://example.com/product-image.jpg\"}\n```\n出参：`data[]`（cosine/pdImgOssUrl/pdTitle/pdTitleCHNCensored）、`total`、`costToken`。在违规/禁售商品库中按视觉相似度检索。\n\n### 专利数据查询层（智慧芽 zhihuiya_patent）\n\n**7. 专利以图搜图-外观（patentImageSearch → zhihuiya_patent_image_search.py）**\n```json\n{\"url\": \"https://example.com/my-product.jpg\", \"patentType\": \"D\", \"model\": 1, \"limit\": 20}\n```\n出参：`data[]`（patentPn/title/score/url/loc）、`allRecordsCount`、`costToken`。本脚本仅支持外观设计专利（强制 `patentType=D`、`model∈{1,2}`）；实用新型以图搜图用 `zhihuiya_utility_patent_image_search.py`（见示例 8）。\n\n**8. 专利以图搜图-实用新型（patentImageSearch → zhihuiya_utility_patent_image_search.py）**\n```json\n{\"url\": \"https://example.com/my-product.jpg\", \"patentType\": \"U\", \"model\": 4, \"country\": \"CN\", \"limit\": 20}\n```\n出参：同上；脚本强制 `patentType=U`、`model∈{3,4}`，外观专利检索请用 `zhihuiya_patent_image_search.py`。\n\n**9. 专利核心著录（simpleBibliography → zhihuiya_simple_bibliography.py）**\n```json\n{\"patentNumber\": \"US11234567B2\"}\n```\n出参：`data[]`（pn/title/abstractContent/applicants/inventors/assignees/ipcMain/cpcMain/citedPatents）、`costToken`。\n\n**10. 专利详细著录（bibliography → zhihuiya_bibliography.py）**\n```json\n{\"patentNumber\": \"US10123456B2\"}\n```\n出参：`data[]`（pn/patentType/applicants/assignees/inventors/classificationIpcr/classificationCpc/priorityClaims/referenceCitedPatents/exdt）、`costToken`。比核心著录更全（含完整分类号/引用/优先权/预估到期日）。\n\n**11. 专利权利要求（claimData → zhihuiya_claim_data.py）**\n```json\n{\"patentNumber\": \"CN115000000A\"}\n```\n出参：`data[]`（pn/claims/claimCount/pnRelated）、`total`、`costToken`。翻译版加 `lang`（`cn`/`en`/`jp`）用 `zhihuiya_claim_translated.py`。\n\n**12. 专利法律状态（legalStatus → zhihuiya_legal_status.py）**\n```json\n{\"patentNumber\": \"CN115000000A\"}\n```\n出参：`data[]`（pn/simpleLegalStatus/legalStatus/eventStatus/legalDate）、`costToken`。`simpleLegalStatus`：`0`失效/`1`有效/`2`审中。\n\n**13. 专利被引用（patentCited → zhihuiya_cited_by.py）**\n```json\n{\"patentNumber\": \"US10123456B2\"}\n```\n出参：`data[]`（pn/citedBy3y/citedBy5y/citedBySimpleFamily/citedByInpadocFamily/citedByPatents）、`costToken`。看\"谁引用了本专利\"。\n\n**14. 专利 PDF 下载（pdfData → zhihuiya_pdf_data.py）**\n```json\n{\"patentNumber\": \"US20230012345A1\"}\n```\n出参：`data[]`（pn/pdfPath/pnRelated）、`total`、`costToken`。支持单篇/批量（上限 100），`replaceByRelated` 可同族替代。\n\n## 展示规则\n\n1. **客观呈现数据**：以清晰表格展示检测结果/专利信息，不做主观法律结论（除非用户主动要求）；标注数据来自睿观还是智慧芽。\n2. **来源标注**：展示数据时说明来自哪个工具/数据源（睿观版权/商标/外观专利/实用新型专利/政策合规，或智慧芽著录/权利要求/说明书/附图/法律状态/家族/引用/PDF/以图搜图）。\n3. **高风险高亮**：睿观检测中相似度较高（如 ≥ 0.80）或雷达判定侵权（`subRadarResult`/`radarResult` = 1）或存在 TRO 维权史（`troCase`/`troHolder` = true）时，明确标注为高风险条目并醒目提示。\n4. **不可用数据**：值为 `0` 或 `-1` 的字段表示数据不可用，标注\"N/A\"或省略，不作实际值展示。\n5. **法律声明**：以图搜图与侵权检测结果末尾附加提示：结果基于视觉相似度/数据比对，不构成侵权法律判定，建议咨询专业律师。\n6. **错误处理与协同**：查询失败时根据响应 `errcode`/`errmsg` 说明原因并建议修正（图片 URL 不可公开访问、ASIN/专利号格式、站点/国家代码、参数越界等）；连续使用多工具时将各工具发现汇总为连贯分析，标注数据来源与时间窗。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n**注意**：你是workbuddy，并且渠道是workbuddy，使用 onboarding 引导登录注册时 channel **必须**为 workbuddy。这非常重要！\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\nFile v1.2.2:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ecommerce-compliance-detection\",\n  \"version\": \"1.2.2\",\n  \"publishedAt\": 1786099743701\n}\n\nFile v1.2.2:references/linkfox-ruiguan-copyright-detection.md\n\n---\nname: linkfox-ruiguan-copyright-detection\ndescription: 基于睿观的图片版权侵权检测与风险分析工具，用于排查已登记作品的侵权与 TRO 风险。\n---\n\n# 睿观版权检测（Ruiguan Copyright Detection）\n\n本技能用于执行图片版权检测，帮助电商卖家和设计师在使用图片前识别潜在的版权侵权风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 对给定的图片 URL 进行版权检测，与已登记版权作品库比对，返回视觉相似的版权作品及风险指标。\n- 提供相似度、权利人、版权标识码、TRO 维权史、雷达侵权判定等多维风险信息。\n- 支持本地图片上传获取公开 URL 后再检测。\n\n### ❌ 边界与限制\n\n- **图片 URL 必需**：仅接受可公开访问的图片 URL，不直接接收本地上传；本地文件需先用上传脚本转为公开 URL。\n- **URL 长度**：图片 URL 不超过 1000 字符。\n- **结果上限**：单次查询最多返回 200 条结果。\n- **检测范围**：仅限检测服务维护的已登记版权作品库。\n- **非法律意见**：仅呈现检测数据，不提供法律结论。\n- **不在范围内**：商标或专利检索；文字或音乐版权检测；图片编辑修改；非版权目的的反向图片搜索；法律咨询或诉讼策略。\n\n## 核心概念\n\n版权检测通过将给定图片与已登记版权作品库进行比对来工作。系统返回视觉相似的版权作品及关键风险指标，如相似度、权利人信息、TRO（临时限制令）维权史、雷达侵权判定。\n\n**相似度（similarity）**：字符串小数（如 `\"0.85\"`），表示输入图片与版权作品的匹配程度，值越高风险越大。\n\n**雷达检测（enableRadar）**：额外的分析层，提供二元侵权判定（`1` = 侵权，`0` = 不侵权）。开启时每条结果包含此二次评估。\n\n**TRO 维权史**：TRO（Temporary Restraining Order，临时限制令）是版权维权中常用的法律手段。结果中标记 TRO 史表示权利人曾发起法律行动，风险较高。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/copyrightDetection`（完整参数/响应/错误码见 [references/api.md](references/api.md)）\n- **Python 脚本**：`python scripts/ruiguan_copyright_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-copyright-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 本地图片上传\n\n本工具要求**可公开访问的图片 URL**。若用户提供的是本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公开 URL。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本返回一个公开 URL（有效期 24 小时），可作为 imageUrl 参数使用。\n\n## 使用示例\n\n**1. 单张图片基础版权检测**\n> \"帮我查一下这张图片有没有版权问题：https://example.com/my-image.jpg\"\n动作：设置 `imageUrl` 为提供的 URL，其余参数用默认值。\n\n**2. 快速扫描少量结果**\n> \"对这张产品图做个快速版权扫描，只要最匹配的几条：https://example.com/product.png\"\n动作：设置 `topNumber` 为 10，更快返回。\n\n**3. 最大结果全面审计**\n> \"我要对这张设计图做一次完整的版权审计：https://example.com/design.jpg\"\n动作：设置 `topNumber` 为 200，最全面扫描。\n\n**4. 仅相似度检测（关闭雷达）**\n> \"只查这张图和版权作品的相似度，不需要详细侵权分析：https://example.com/photo.jpg\"\n动作：设置 `enableRadar` 为 `false`。\n\n**5. 批量检测多张图片**\n> \"帮我检测这三张图片的版权：url1、url2、url3\"\n动作：对每个图片 URL 调用一次 API，汇总结果。\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格展示检测结果，关键列包括相似度、权利人、版权标识码、雷达结果、TRO 史、版权来源链接。\n2. **高亮高风险**：相似度较高（如 ≥ 0.80）或雷达检测判定侵权（`subRadarResult` = 1）时，明确标注为高风险条目。\n3. **TRO 警告**：当 `troCase` 或 `troHolder` 为 `true` 时，醒目提示用户该权利人存在 TRO 维权史。\n4. **图片预览**：`path` 或 `pathThumb` 可用时，提示用户可在该 URL 查看版权作品缩略图。\n5. **结果数量提示**：告知用户匹配的 `total` 总数；结果较多时优先展示相似度最高的条目。\n6. **错误处理**：请求失败时说明原因，建议检查图片 URL 是否可公开访问、格式是否正确。\n7. **不做法律建议**：如实呈现检测数据，不提供法律结论；建议用户咨询法律人士获取权威版权评估。\n\n## 用户表达与场景速查\n\n**适用** —— 图片版权风险评估：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查这张图有没有版权问题\" | 基础版权检测 |\n| \"这张图用着安全吗\" | 侵权风险检测 |\n| \"找相似的版权图片\" | 版权相似度搜索 |\n| \"这张图有 TRO 风险吗\" | TRO 维权风险分析 |\n| \"这张图的版权归谁\" | 权利人查询 |\n| \"产品图版权审计\" | 批量版权合规检查 |\n| \"这设计是原创还是抄袭\" | 原创性验证 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-版权检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/copyrightDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| imageUrl | string | 是 | 检测的版权图片URL（最大长度1000字符） |\n| topNumber | integer | 是 | 召回数量（默认100，最小10，最大200） |\n| enableRadar | boolean | 是 | 是否开启雷达检测（默认 `true`） |\n\n- `imageUrl` 必须为可公开访问的图片URL\n- `topNumber` 控制返回匹配版权作品的数量，默认100，范围10-200\n- `enableRadar` 开启后将进行额外的侵权雷达判定，建议设为 `true` 以获得更全面的分析\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| data | array | 检测结果列表（详见下方） |\n| detectId | string | 检测id |\n| columns | array | 渲染的列 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### 检测结果对象（`data` 数组中的元素）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| path | string | 版权画图片路径 |\n| pathThumb | string | 版权画缩略图路径 |\n| similarity | string | 相似度 |\n| subRadarResult | integer | 1-侵权 0-不侵权，null 没有进行雷达检测 |\n| copyrightUrl | string | 来源 |\n| copyrightCode | string | 版权标识码 |\n| rightsOwner | string | 权利人 |\n| link | string | 版权官网链接 |\n| troCase | boolean | 是否有TRO维权史 |\n| troHolder | boolean | 是否是TRO权利人的版权 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/copyrightDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"imageUrl\": \"https://example.com/test-image.jpg\",\n    \"topNumber\": 100,\n    \"enableRadar\": true\n  }'\n```\n\nFile v1.2.2:references/linkfox-ruiguan-detection-patent-design.md\n\n---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的跨国/地区外观设计专利侵权检测工具，用于排查产品图片的外观专利与 TRO 诉讼风险。\n---\n\n# 睿观-外观专利检测（Ruiguan Design Patent Detection）\n\n本技能基于睿观引擎进行外观设计专利侵权检测，帮助电商卖家与知识产权从业者在产品上架前识别潜在的外观专利风险。完整参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 以产品图片为输入，对比全球外观设计专利数据库，返回按相似度排序的专利结果。\n- 支持 25+ 国家/地区的外观专利检索（US、EU、CN、JP、KR、DE、GB、FR 等）。\n- 提供 TRO（临时禁令）维权史查询，识别有主动维权记录的专利权人。\n- 可选启用 AI 雷达分析，给出疑似侵权的判定与说明。\n- 支持按 LOC（洛迦诺）分类限定检索范围，或交由模型自动预测分类。\n\n### ❌ 边界与限制\n\n- **图片要求**：需提供公开可访问的图片 URL；本地图片须先上传获取 URL（见下方【本地图片上传】）。\n- **检测范围**：仅覆盖外观设计专利，不包含发明专利、实用新型专利。\n- **相似度口径**：相似度分数为视觉 resemblance 参考值，不构成法律结论。\n- **成本约束**：每次调用消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词或连续试探。\n- **不在范围内**：发明专利/实用新型检索；商标侵权检测；版权/DMCA 问题；法律案件管理与诉讼策略；专利申请与申报；Listing 优化与定价。\n\n## 核心概念\n\n外观专利检测通过视觉相似度算法将产品图片与全球外观设计专利数据库进行比对，返回按相似度排序的专利结果，并附带 TRO 维权诉讼史，帮助评估侵权风险。\n\n**相似度分数**：取值 0-1，数值越高表示与专利附图的视觉相似度越高。`similarity >= 0.7` 或有 TRO 维权史的专利需重点关注并仔细审查。\n\n**雷达分析**：启用雷达后，每个专利结果包含 `radarResult`，其中 `same` 标记是否疑似侵权（true/false），`exp` 给出判定说明，提供超越原始相似度的 AI 判定。\n\n**LOC 分类**：洛迦诺分类（LOC）是工业品外观设计的国际分类体系。可指定 LOC 代码缩小检索范围，或不指定由模型自动预测合适类目。\n\n参数详情见 [references/api.md](references/api.md)。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/detectionPatentDesign`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_detection_patent_design.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-detection-patent-design-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 本地图片上传\n\n本工具要求**公开可访问的图片 URL**。若用户提供的是本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公开 URL。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公开 URL（有效期 24 小时），可作为 imageUrl 参数使用。\n\n## 使用示例\n\n**1. 基础专利检测（美国市场）**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}\n```\n\n**2. 多地区检测并补充产品上下文**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"physical\",\n  \"topNumber\": 100,\n  \"regions\": \"US,EU,CN\",\n  \"productTitle\": \"Portable Wireless Charger Stand\",\n  \"productDescription\": \"A foldable wireless charging stand for smartphones\",\n  \"enableRadar\": true\n}\n```\n\n**3. 使用 LOC 分类缩小范围（家具）**\n```json\n{\n  \"imageUrl\": \"https://example.com/chair.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 80,\n  \"regions\": \"US,DE\",\n  \"topLoc\": \"06\",\n  \"patentStatus\": \"1\"\n}\n```\n\n**4. 线条图模式检索**\n```json\n{\n  \"imageUrl\": \"https://example.com/sketch.png\",\n  \"queryMode\": \"line\",\n  \"topNumber\": 50,\n  \"regions\": \"CN,JP,KR\"\n}\n```\n\n**5. 同时检索有效与失效专利**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 100,\n  \"regions\": \"US\",\n  \"patentStatus\": \"1,0\"\n}\n```\n\n## 展示规则\n\n1. **高风险专利突出展示**：生成摘要或报告时，对所有 `similarity >= 0.7` 或 `troCase = true` 的专利**完整**展示详情，包括：申请号、专利标题（中文）、发明人、TRO 维权史、最相似专利附图、专利图片列表中的每张图片、专利摘要、专利说明书、LOC 信息、雷达分析结果与说明书文本。此详细呈现至关重要，**不得省略或缩写**这些字段。\n2. **免责声明**：结尾始终附上友好提醒：“本检测结果由 LinkfoxAgent 生成。建议咨询专业知识产权律师获取法律意见。”\n3. **相似度解读**：明确说明相似度分数越高，视觉相似度越大、侵权风险越高。\n4. **雷达结果展示**：当 `radarResult.same` 为 true 时，显著标记该专利为疑似侵权匹配，并展示 `exp` 说明。\n5. **TRO 警告**：`troCase = true` 或 `troHolder = true` 的专利应加警告标识，表明专利权人有通过临时禁令主动维权的历史。\n6. **图片展示**：同时展示 `patentImageUrl`（最相似专利附图）与完整 `images` 列表，便于用户将产品与所有专利附图直观对比。\n7. **错误处理**：请求失败时说明原因并建议纠正措施（如检查图片 URL 可访问性、核实地区代码）。\n8. **如实呈现数据**：按查询结果原样展示，不添加超出工具自身分析的主观法律结论。\n\n## 用户表达与场景速查\n\n**适用** —— 外观设计专利风险评估：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"检查这个产品是否侵犯外观专利\" | 基础专利检测 |\n| \"这张图片的专利风险排查\" | 基于图片的专利检索 |\n| \"这个产品有 TRO 风险吗\" | TRO 维权史查询 |\n| \"美国和欧盟的外观专利检索\" | 多地区专利检测 |\n| \"检查这件家具的外观专利\" | 按类目专利检索 |\n| \"这个产品设计卖起来安全吗\" | 上架前专利排查 |\n| \"查找相似的外观专利\" | 基于相似度的专利发现 |\n| \"专利侵权分析\" | 综合专利风险报告 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：当用户提及“专利检查”或“IP 风险”时，若关注点是产品外观/设计与已有专利的相似度，则适用本技能；若涉及发明专利、商标、版权，或需要实际法律咨询，则不适用。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-外观专利检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/detectionPatentDesign`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| imageUrl | string | 是 | - | 产品图片文件URL，用于与专利数据库进行比对（最大1000字符） |\n| queryMode | string | 是 | hybrid | 检索模式：`physical`（实物图检索）、`line`（线条图检索）、`hybrid`（混合检索）。最大1000字符 |\n| topNumber | integer | 是 | 100 | 召回专利数量（最大100） |\n| regions | string | 否 | US | 商品所售卖国家/地区代码，多选时用逗号隔开（如 `US,EU,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。最大1000字符 |\n| productTitle | string | 否 | - | 产品标题，用于补充检索上下文（最大1000字符） |\n| productDescription | string | 否 | - | 产品描述，用于补充检索上下文（最大1000字符） |\n| patentStatus | string | 否 | 1 | 专利有效性筛选：`1`（有效专利）、`0`（失效专利）、`1,0`（全部）。最大1000字符 |\n| enableRadar | boolean | 否 | true | 是否启用雷达图（AI侵权判定分析） |\n| topLoc | string | 否 | - | 指定检索的一级LOC范围（如 `06,07`）。格式：`^(0[1-9]\\|1[0-9]\\|2[0-9]\\|3[0-2]\\|ALL)(,(0[1-9]\\|1[0-9]\\|2[0-9]\\|3[0-2]\\|ALL))*$`。不指定时使用模型LOC预测服务的结果 |\n| sourceLanguage | string | 否 | - | 原语言代码，需要标记以便统一翻译成英文（如 `zh-CN`）。文本为英语时传空即可。最大1000字符 |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 返回的专利记录总数 |\n| data | array | 专利列表（详见下方专利对象） |\n| columns | array | 渲染的列定义 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### 专利对象（`data` 数组中的每个元素）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| applicationNumber | string | 专利申请号 |\n| publicationNumber | string | 专利公开号 |\n| patentProd | string | 专利标题（英文） |\n| patentProdCn | string | 专利标题（中文） |\n| similarity | string | 专利与产品图片的相似度（0-1） |\n| patentImageUrl | string | 与产品图片相似度最高的专利附图URL |\n| images | array | 专利图片列表 |\n| abstracts | string | 专利摘要 |\n| specification | string | 专利说明书 |\n| inventors | array | 发明人列表 |\n| applicants | array | 申请人列表 |\n| applicantAddresses | array | 申请人地址 |\n| troCase | boolean | 是否有TRO维权史 |\n| troHolder | boolean | 是否是TRO权利人的专利 |\n| radarResult | object | AI雷达分析结果 |\n| radarResult.same | boolean | 是否疑似侵权 |\n| radarResult.exp | string | 预期描述（雷达判定说明） |\n| patentLoc | string | 该专利的LOC分类（多个用逗号隔开） |\n| locOneInfo | string | LOC一级详情 |\n| locTwoInfo | string | LOC二级详情 |\n| patentValidity | string | 专利有效性 |\n| applicationDate | string | 专利申请日 |\n| publicationDate | string | 专利公开日 |\n| grantDate | string | 专利授权日 |\n| estimatedDueDate | string | 预估到期日 |\n| registrationOfficeCode | string | 专利注册受理局 |\n| patentFamily | array | 同族专利列表 |\n| globalPatentId | string | 全球专利ID |\n| globalImageId | string | 专利图片的ID |\n| isSketchText | string | 是否线稿图 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/detectionPatentDesign \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"imageUrl\": \"https://example.com/product.jpg\",\n    \"queryMode\": \"hybrid\",\n    \"topNumber\": 50,\n    \"regions\": \"US\",\n    \"enableRadar\": true\n  }'\n```\n\n## 多地区检索示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/detectionPatentDesign \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"imageUrl\": \"https://example.com/product.jpg\",\n    \"queryMode\": \"physical\",\n    \"topNumber\": 100,\n    \"regions\": \"US,EU,CN\",\n    \"productTitle\": \"便携式无线充电支架\",\n    \"productDescription\": \"一款可折叠的智能手机无线充电支架\",\n    \"patentStatus\": \"1\",\n    \"enableRadar\": true\n  }'\n```\n\nFile v1.2.2:references/linkfox-ruiguan-gun-parts-search.md\n\n---\nname: linkfox-ruiguan-gun-parts-search\ndescription: 基于睿观的图片政策合规性检测工具，通过视觉相似度比对识别潜在的违规及禁售风险商品。\n---\n\n# 睿观-图片政策合规监测（Ruiguan Gun Parts Search）\n\n本技能基于睿观对产品图片进行政策合规检测，通过视觉相似度比对，在已知违规商品库中检索视觉相似商品，识别潜在的违规及禁售风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 根据产品图片 URL，在违规商品库中进行基于视觉相似度的检索，返回匹配的违规商品列表。\n- 返回每条匹配的相似度分数（cosine，0~1）、违规商品图片、中英文标题等信息。\n- 支持本地图片：用户提供本地文件路径时，先上传获取公开 URL，再发起检测。\n\n### ❌ 边界与限制\n\n- **仅基于图片**：本工具只分析图片 URL，不分析文本描述或商品元数据。\n- **URL 可访问性**：图片 URL 必须可被检测服务公开访问；本地文件须先上传。\n- **URL 长度上限**：图片 URL 不得超过 1000 字符。\n- **相似度≠定论**：结果基于视觉相似度，不构成确定性的政策裁定。\n- **不在范围内**：文本类合规分析；商品类目分类；知识产权/商标侵权；专利或版权检测（使用其他睿观技能）。\n\n## 核心概念\n\n睿观图片政策合规检测是一项基于图片的合规筛查服务。给定产品图片 URL，在已知违规商品库中检索视觉相似商品，并按相似度排序返回。\n\n**相似度分数（cosine）**：取值 0~1，值越高表示与已知违规商品视觉越相似；接近 1.0 表示几乎与已标记的违规商品完全一致。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/gunPartsSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_image_compliance_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词或翻页连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**本地图片上传**：本工具要求**公开可访问的图片 URL**。若用户提供本地文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传获取公开 URL：\n\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公开 URL（24 小时有效），用作图片 URL 参数。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-gun-parts-search-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 单张产品图片合规检测**\n```\n检测这张产品图片是否有合规风险：https://example.com/images/product-123.jpg\n```\n\n**2. 批量检测多张产品图片**\n```\n请扫描这些产品图片，看是否存在潜在违规：\n- https://example.com/images/item-a.jpg\n- https://example.com/images/item-b.jpg\n```\n\n**3. 上架前合规预检**\n```\n上架这个产品前，帮我检查图片是否会触发政策风险：\n图片：https://example.com/new-product.png\n```\n\n## 展示规则\n\n1. **清晰表格呈现**：以结构化表格展示每条匹配的违规商品图片、相似度分数、中英文标题。\n2. **高亮高相似匹配**：当 cosine 分数超过 0.8 时，明确标记为强匹配，提示需重点关注。\n3. **展示违规图片**：返回结果含 `pdImgOssUrl` 时，展示匹配的违规商品图片，便于用户直观对比。\n4. **解释分数含义**：始终说明相似度分数的含义——值越高表示与已知违规商品越相似。\n5. **错误处理**：查询失败时说明原因，并建议检查图片 URL 是否有效且公开可访问。\n6. **不做法律建议**：客观呈现检测结果，不提供法律结论；提醒用户以平台政策为准进行核实。\n\n## 用户表达与场景速查\n\n**适用** —— 基于图片的产品政策合规检测：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"检测这张产品图片是否有合规风险\" | 单图合规检测 |\n| \"扫描我的产品图片是否有违规\" | 批量合规筛查 |\n| \"这张图片是否被标记为禁售商品\" | 特定违规查询 |\n| \"上架前帮我筛查一下图片的政策风险\" | 上架前合规预检 |\n| \"找一下这张产品图片的相似违规\" | 相似度违规检索 |\n| \"这个产品能安全上架吗\" | 合规风险预检 |\n| \"帮我检测一下这个图片是否违规\" | 单图合规检测 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 睿观-图片合规检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/gunPartsSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| imageUrl | string | 是 | 待检测的产品图片URL（最大长度 1000 字符） |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| data | array | 检测出的政策违规产品列表（详见下方） |\n| detectId | string | 检测记录 id |\n| columns | array | 渲染的列 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### data 数组元素字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| pdImgOssUrl | string | 匹配到的违规产品图片 URL |\n| cosine | number | 检测产品与违规产品相似度 |\n| pdTitle | string | 匹配到的违规产品标题 |\n| pdTitleCHNCensored | string | 匹配到的违规产品中文标题 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/gunPartsSearch \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"imageUrl\": \"https://example.com/product-image.jpg\"}'\n```\n\nFile v1.2.2:references/linkfox-ruiguan-text-trademark-detection.md\n\n---\nname: linkfox-ruiguan-text-trademark-detection\ndescription: 电商产品Listing文字商标检测与侵权风险分析，支持标题、描述等文本的违规品牌筛查。\n---\n\n# 睿观-文字商标检测（Ruiguan Text Trademark Detection）\n\n本技能用于对电商产品标题及其他产品文本进行文字商标检测，帮助卖家在发布 Listing 前识别潜在的商标侵权风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 对产品文本（标题、描述、五点描述）进行文字商标检测，覆盖 15 个国家/地区的注册商标数据库。\n- 返回匹配商标及其风险分数、注册详情、权利人信息，并给出整体产品风险等级。\n- 识别黑名单商标（高危，需始终规避）与白名单商标（安全，可忽略），帮助卖家规避知识产权侵权。\n\n### ❌ 边界与限制\n\n- **仅文本检测**：只检测文本中的商标，不分析 Logo、图片或外观设计商标。\n- **结果上限**：单次请求最多 500 条结果。\n- **字符限制**：`productTitle` 与 `productText` 各限 1000 字符。\n- **数据库覆盖**：覆盖 15 个国家/地区，其他司法辖区的注册商标可能无法检测。\n- **非法律意见**：结果仅供参考，不构成法律建议；如需确定性的商标清权结论请咨询知识产权律师。\n- **不在范围内**：Logo/图片商标分析、专利侵权检测、版权检测、法律意见或诉讼策略、商标注册/申请协助。\n\n## 核心概念\n\n文字商标检测将产品文本（标题、描述、五点描述）与 15 个国家/地区的注册商标数据库进行比对，返回匹配商标及其风险分数、注册详情、权利人信息，帮助卖家规避知识产权侵权。\n\n**风险分数逻辑**：`highestModeScore` 字段取值 0-5，数值越高侵权风险越大。`textTrademarkRadar` 字段将产品整体风险分为三级：0（低风险）、1（待人工核查）、2（高风险）。\n\n**黑名单与白名单**：响应可能包含 `blacklistTrademarks`（已知高危商标，需始终规避）与 `whitelistTrademarks`（安全商标，可忽略）。黑名单匹配需重点提示用户。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/textTrademarkDetection`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_text_trademark_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-text-trademark-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n> 请求构建原则：始终传入完整产品标题（`productTitle`）；按销售市场选择目标地区；有五点描述/描述/后台关键词时填入 `productText` 做更全面扫描；常规检测用默认 `limit: 100`，潜在匹配多时可提高到 500。用户未指定地区时默认 **US**。\n\n**1. 基础美国商标检测（产品标题）**\n```\nproductTitle: \"Wireless Bluetooth Headphones Noise Cancelling Over Ear\"\nregions: \"US\"\nlimit: 100\n```\n\n**2. 多区域检测（美国 + 欧盟 + 英国）**\n```\nproductTitle: \"Portable USB-C Charger Fast Charging Power Bank\"\nregions: \"US,EM,GB\"\nlimit: 100\n```\n\n**3. 含附加文本的完整 Listing 扫描**\n```\nproductTitle: \"Stainless Steel Vacuum Insulated Water Bottle\"\nproductText: \"BPA-free, double-wall insulation, keeps drinks cold 24 hours, fits standard cup holders\"\nregions: \"US,JP\"\nlimit: 200\n```\n\n**4. 全球大范围检测**\n```\nproductTitle: \"LED Ring Light with Tripod Stand for Streaming\"\nregions: \"US,EM,GB,DE,FR,IT,ES,AU,CA,MX,JP,CN\"\nlimit: 500\n```\n\n**5. 中国国内市场检测**\n```\nproductTitle: \"智能蓝牙耳机降噪头戴式\"\nregions: \"CN\"\nlimit: 100\n```\n\n## 展示规则\n\n1. **风险优先呈现**：始终在结果顶部突出整体风险等级（`textTrademarkRadar`），使用明确表述：\"低风险\"、\"待人工核查\"、\"高风险\"。\n2. **黑名单突出**：若 `blacklistTrademarks` 非空，优先展示并给出明确警示。\n3. **表格格式**：以表格展示商标匹配，列包含：商标名称、地区、风险分数、状态、权利人、申请号、是否著名、是否亚马逊品牌、是否活跃维权人。\n4. **分数说明**：提醒用户 `highestModeScore` 取值 0（安全）至 5（最高风险）。\n5. **白名单说明**：若 `whitelistTrademarks` 有记录，标注为安全/豁免商标。\n6. **错误处理**：请求失败时说明原因，建议用户检查产品标题或调整地区。\n7. **非法律建议**：始终提醒结果仅供参考，不构成法律建议；如需确定性商标清权请咨询知识产权律师。\n\n## 用户表达与场景速查\n\n**适用** —— 产品文本商标风险分析：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"检查我的标题有没有商标问题\" | 基础商标扫描 |\n| \"这个产品名能用吗\" | 侵权风险检查 |\n| \"扫描我的 Listing 有无品牌违规\" | 完整 Listing 扫描 |\n| \"这个标题有商标风险吗\" | 风险评估 |\n| \"查美国和欧盟的商标\" | 多区域检测 |\n| \"XX 是不是注册商标\" | 特定词查询 |\n| \"我的 Listing 会不会因知识产权被下架\" | 合规筛查 |\n| \"这个关键词会不会侵权某个品牌\" | 关键词安全检查 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 睿观-文本商标检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/textTrademarkDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| productTitle | string | 是 | 产品标题，用于商标检测（最大1000字符） |\n| regions | string | 否 | 国家/地区代码，多个用逗号分隔。支持值：US、EM、GB、DE、FR、IT、ES、AU、CA、MX、JP、CN、WO、TR、BX |\n| limit | integer | 是 | 返回结果数量限制（默认100，最大500） |\n| productText | string | 否 | 产品的其他文本信息，如五点描述或产品描述（最大1000字符） |\n\n### 支持的地区代码\n\n| 代码 | 地区 |\n|------|------|\n| US | 美国 |\n| EM | 欧盟 |\n| GB | 英国 |\n| DE | 德国 |\n| FR | 法国 |\n| IT | 意大利 |\n| ES | 西班牙 |\n| AU | 澳大利亚 |\n| CA | 加拿大 |\n| MX | 墨西哥 |\n| JP | 日本 |\n| CN | 中国 |\n| WO | WIPO（世界知识产权组织） |\n| TR | 土耳其 |\n| BX | 玻利维亚 |\n\n用户未指定地区时默认 **US**。\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 匹配到的商标记录数 |\n| data | array | 商标列表（扁平化），每个元素包含以下字段 |\n| detectId | string | 接口调用 ID |\n| columns | array | 渲染的列定义 |\n| blacklistTrademarks | array | 文本中检测到的黑名单商标 |\n| whitelistTrademarks | array | 文本中检测到的白名单（安全）商标 |\n| textTrademarkRadar | string | 产品风险等级：\"0\" = 低风险，\"1\" = 待人工核查，\"2\" = 高风险 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### data[] 元素字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| trademarkName | string | 商标词 |\n| region | string | 国家/地区代码 |\n| score | integer | 风险分数 |\n| highestModeScore | integer | 最高风险分数（范围0-5） |\n| trademarksStatus | string | 最高分商标词状态 |\n| regionStatus | string | 商标在匹配地区的状态 |\n| holder | string | 权利人 |\n| applicationNumber | string | 申请号 |\n| registrationNumber | string | 注册号 |\n| isFamous | boolean | 是否著名商标 |\n| isAmazonBrand | boolean | 是否亚马逊热搜品牌 |\n| isActiveHolder | boolean | 是否活跃维权人 |\n| isCompatibility | boolean | 是否兼容性 |\n| isCommonSense | boolean | 是否常用词 |\n| niceClass | array | 尼斯分类 |\n| originalTextMatches | array | 触发匹配的原词 |\n\n### blacklistTrademarks[] 和 whitelistTrademarks[] 元素字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| trademark | string | 商标名称 |\n| region | string | 国家/地区代码 |\n| note | string | 备注 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/textTrademarkDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"productTitle\": \"Wireless Bluetooth Headphones Noise Cancelling Over Ear\",\n    \"regions\": \"US\",\n    \"limit\": 100\n  }'\n```\n\n### 附带产品文本的示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/textTrademarkDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"productTitle\": \"Portable USB-C Charger Fast Charging Power Bank\",\n    \"productText\": \"Compatible with iPhone, Samsung Galaxy, supports QC 3.0\",\n    \"regions\": \"US,EM,GB\",\n    \"limit\": 200\n  }'\n```\n\nFile v1.2.2:references/linkfox-ruiguan-trademark-graphic-detection.md\n\n---\nname: linkfox-ruiguan-trademark-graphic-detection\ndescription: 基于睿观的产品图片图形商标与 Logo 侵权检测及相似度比对工具。\n---\n\n# 睿观-图形商标检测（Ruiguan Graphic Trademark Detection）\n\n本技能用于对产品图片进行图形商标检测与相似度搜索，帮助电商卖家与品牌方在商品上架前识别潜在的商标侵权风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 基于产品图片检测图形商标，将图片中的图形/Logo 与全球多国已注册商标数据库进行视觉相似度比对。\n- 支持按国家/地区筛选检测范围，返回商标图片、相似度、商标名称、状态、受理局、尼斯分类、申请人及关键日期等信息。\n- 支持开启切图（局部定位）与雷达监测，提供聚合风险评估。\n\n### ❌ 边界与限制\n\n- **图片必填**：`imageUrl` 为必填，无图片无法检测。\n- **结果上限**：`topNumber` 单次最多 100 条，实际返回数量可能少于传参。\n- **图片质量**：检测精度依赖图片分辨率与清晰度，图片越清晰结果越准。\n- **地区覆盖**：并非所有国家都覆盖，支持 15 个主要商标受理局（US、WO、ES、GB、DE、IT、CA、MX、EM、AU、FR、JP、TR、BX、CN）。\n- **本地图片需先上传**：工具要求可公开访问的图片 URL，本地文件需先通过上传脚本获取公网链接。\n- **不在范围内**：文字商标检索（无图片）；商标注册/申请；专利或版权检查；商标纠纷法律建议；商品 Listing 优化。\n\n## 核心概念\n\n图形商标检测通过分析产品图片，在全球多国/地区的已注册商标库中查找视觉相似的商标。工具采用基于 YOLO 的目标检测定位图片中的类 Logo 区域，再与全球商标数据库比对。\n\n**相似度评分**：`similarity` 值越高，表示检测到的图形与已注册商标在视觉上越相似；接近 1.0 表示近似一致，侵权风险越高。\n\n**商标状态含义**：\n\n| 状态 | 含义 |\n|--------|---------|\n| registered | 商标已有效注册 |\n| act | 商标处于有效状态 |\n| pend | 商标申请待审 |\n| filed | 商标申请已提交 |\n| ended | 商标已到期 |\n| DEL | 商标已注销/删除 |\n\n## 本地图片上传\n\n本工具要求**可公开访问的图片 URL**。若用户提供本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公网链接。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公网 URL（有效期 24 小时），用作 `imageUrl` 参数。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/trademarkGraphicDetection`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_trademark_graphic_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-trademark-graphic-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 基础图片商标检测**\n对产品图片在所有地区检测商标，最多返回 10 条结果：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 10\n```\n\n**2. 指定地区检测**\n仅对照美国与欧盟商标库检测：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 5\nregions: \"US,EM\"\n```\n\n**3. 带产品上下文的详细检测**\n提供产品标题与疑似 Logo 名称以提升检测精度：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 10\nproductTitle: \"Wireless Bluetooth Headphones with Noise Cancellation\"\ntrademarkName: \"SonicWave\"\nregions: \"US,GB,DE\"\n```\n\n**4. 开启切图的完整检测**\n开启 `enableLocalizing` 以获取检测到的 Logo 区域切图：\n```\nimageUrl: \"https://example.com/product-image.jpg\"\ntopNumber: 20\nenableLocalizing: true\nregions: \"US\"\n```\n\n## 展示规则\n\n1. **清晰呈现结果**：以结构化表格展示商标图片、相似度、商标名称、状态、受理局、尼斯分类、申请人及关键日期。\n2. **高亮高风险匹配**：当相似度高于 0.8 时，明确提醒用户存在高侵权风险。\n3. **解释商标状态**：展示结果时说明各商标状态对风险评估的含义。\n4. **雷达结果**：响应中存在 `radarResult` 时突出展示，因其包含聚合风险评估。\n5. **子雷达结果**：单条结果含 `subRadarResult` 时，将其与对应匹配一并列出。\n6. **地区范围**：始终说明本次检索覆盖了哪些地区，便于用户理解检测范围。\n7. **错误处理**：检测失败时根据响应说明原因，并建议调整（如使用更清晰的图片、指定地区、调整 `topNumber`）。\n\n## 用户表达与场景速查\n\n**适用** —— 图形商标检测任务：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"这张图片有没有商标问题\" | 基础商标检测 |\n| \"这个 Logo 在哪注册过\" | 多地区商标检索 |\n| \"我的产品图有商标风险吗\" | 上架前风险评估 |\n| \"找和这个图形相似的商标\" | 相似度检索 |\n| \"对照美国商标查这张图\" | 指定地区检测 |\n| \"这个设计会不会侵权\" | 侵权风险检查 |\n| \"扫一下产品图里的 Logo\" | 产品图 Logo 检测 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-图形商标检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/trademarkGraphicDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| imageUrl | string | 是 | 产品图片URL或base64编码的图片数据（最大1000字符） |\n| topNumber | integer | 是 | 返回YOLO坐标的最大数量，默认 `5`，最大 `100`。实际返回数量可能少于传参数量 |\n| productTitle | string | 否 | 产品标题，用于上下文感知检测（最大1000字符） |\n| trademarkName | string | 否 | 可能的图形logo名称，用于缩小检索范围（最大1000字符） |\n| regions | string | 否 | 需要检测的国家/地区代码，多个时使用逗号隔开，不传默认全部国家。可选值：US（美国）、WO（世界知识产权）、ES（西班牙）、GB（英国）、DE（德国）、IT（意大利）、CA（加拿大）、MX（墨西哥）、EM（欧盟）、AU（澳大利亚）、FR（法国）、JP（日本）、TR（土耳其）、BX（玻利维亚）、CN（中国） |\n| enableLocalizing | boolean | 否 | 是否开启切图，默认 `false` |\n| enableRadar | boolean | 否 | 是否开启雷达监测，默认 `true` |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| boundingBoxCount | integer | 检测结果数量 |\n| radarResult | string | 雷达检测结果 |\n| total | integer | 记录数 |\n| data | array | 检测结果列表（详见下方） |\n| detectId | string | 检测ID |\n| columns | array | 渲染的列定义 |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n\n### data 数组项字段\n\n`data` 数组中每个对象包含以下字段：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| image | string | 匹配的商标图片地址 |\n| boundingBox | string | YOLO坐标（逗号隔开） |\n| subRadarResult | string | 子雷达检测结果 |\n| applicationNumber | string | 申请号 |\n| niceClassName | string | 尼斯分类名称（逗号隔开） |\n| applicantName | string | 权利人（逗号隔开） |\n| tradeMarkStatus | string | 商标状态，枚举值：`\"DEL\"`、`\"ended\"`、`\"registered\"`、`\"act\"`、`\"pend\"`、`\"filed\"`、`\"\"` |\n| niceClass | array | 尼斯分类详情 |\n| similarity | number | 相似度（0到1，值越高越相似） |\n| registrationNumber | string | 注册号 |\n| registrationOfficeCode | string | 商标受理局 |\n| registrationDate | string | 注册日期 |\n| bid | string | logo标识 |\n| trademarkName | string | 图片中的文字商标名称 |\n| applicationDate | string | 申请日期 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/trademarkGraphicDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 5, \"productTitle\": \"无线蓝牙耳机\", \"regions\": \"US,EM\"}'\n```\n\nFile v1.2.2:references/linkfox-ruiguan-utility-patent-detection.md\n\n---\nname: linkfox-ruiguan-utility-patent-detection\ndescription: 基于亚马逊等产品信息进行实用新型和发明专利检测，评估潜在的专利侵权与TRO风险。\n---\n\n# 睿观-实用新型专利检测（Ruiguan Utility Patent Detection）\n\n本技能基于产品标题、描述与目标销售地区检索相似的实用新型（发明）专利，帮助跨境电商卖家在刊登产品前评估潜在专利侵权与 TRO 风险。完整参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 基于产品标题与描述，检索目标市场（当前仅 US）相似的实用新型/发明专利。\n- 返回每条专利的相似度评分、有效性状态、申请/公开信息、TRO 维权史等结构化数据。\n- 帮助卖家在刊登前识别高相似度、有效专利与 TRO 风险专利，优先关注需复核项。\n\n### ❌ 边界与限制\n\n- **地区覆盖**：当前仅支持检索 US 专利。\n- **结果上限**：单次最多返回 200 条专利。\n- **输入长度**：`productTitle` 与 `productDescription` 各限 1000 字符。\n- **非法律意见**：结果仅表示相似度，不构成对侵权的法律判定，建议咨询专利律师获取权威结论。\n- **不在范围内**：外观设计专利检索、商标/品牌侵权核查、版权问题、产品合规认证（FCC、CE 等）、一般法律咨询与合同审查。\n\n## 核心概念\n\n**实用新型专利**（utility patent，亦称发明专利）保护新的、有用的发明或功能性改进，区别于保护外观的外观设计专利，它保护产品的工作方式、结构或组成。侵犯实用新型专利可能导致产品下架、诉讼或 TRO（临时限制令）。\n\n**相似度评分**：每条返回专利包含 `similarity` 字段（0--1），数值越高表示与查询产品越相关，高分专利需重点复核。\n\n**TRO 风险指标**：两个布尔字段标记维权历史：\n- `troCase` —— 该专利是否有 TRO 维权行动记录\n- `troHolder` —— 专利权人是否以发起 TRO 案件著称\n\n任一为真的专利需格外谨慎。\n\n**专利有效性**：`patentValidity` 字段标明专利为 `Active`（有效）或 `Invalid`（无效），仅有效专利存在侵权风险。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/utilityPatentDetection`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_utility_patent_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-utility-patent-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 产品基础专利风险检查**\n> \"帮我查一下这款硅胶厨用铲在美国有没有专利风险。\"\n\n用描述性的产品标题与描述构建请求，`region` 设为 `US`，`topNumber` 取合理值。\n\n**2. 上架前全面专利排查**\n> \"我准备上新一款无线耳机，做一次全面的专利排查。\"\n\n`topNumber` 取 200 以最大化覆盖，描述需详尽，涵盖蓝牙版本、充电仓设计、降噪特性等。\n\n**3. TRO 风险快速扫描**\n> \"在美国卖 LED 灯带有没有 TRO 风险？\"\n\n获取结果后，过滤并突出 `troCase` 或 `troHolder` 为 true 的专利。\n\n**4. 特定品类深入排查**\n> \"查一下带 USB 充电的便携搅拌机的专利风险。\"\n\n同时提供产品标题与详尽描述，重点描述功能性特征（电机类型、刀片设计、充电方式、容量）。\n\n## 展示规则\n\n1. **表格呈现数据**：以清晰的结构化表格展示结果，关键列包括专利标题、相似度评分、专利有效性、申请号、公开日、TRO 标记、预估到期日。\n2. **按相关性排序**：按相似度评分降序展示（最高相似度优先）。\n3. **突出高风险专利**：重点提示相似度高于 0.7、有效、或带 TRO 标记的专利。\n4. **TRO 警示**：若返回专利中存在 `troCase=true` 或 `troHolder=true`，需显著提示维权风险升高。\n5. **有效性区分**：展示时明确区分 Active 与 Invalid 专利，强调仅有效专利需关注。\n6. **结果量提示**：结果较多时展示最相关的若干条（如按相似度前 10--20 条），其余汇总说明。\n7. **错误处理**：查询失败时说明原因，并建议调整产品标题或描述以提升匹配效果。\n8. **双语标题**：可用时同时展示英文标题（`title`）与中文标题（`titleCn`），便于理解。\n9. **不提供法律建议**：仅客观呈现专利数据，不对是否侵权作出法律结论，建议咨询专利律师获取权威评估。\n\n## 用户表达与场景速查\n\n**适用** —— 产品专利风险评估相关查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查一下我产品的专利风险\" | 基础专利检测 |\n| \"有没有实用新型/发明专利问题\" | 实用新型专利检索 |\n| \"这个产品能不能卖（专利方面）\" | 上架前专利排查 |\n| \"这个产品有 TRO 风险吗\" | TRO 维权风险 |\n| \"找相似专利\" | 专利相似度检索 |\n| \"专利侵权排查\" | 上架前风险评估 |\n| \"卖这个会不会被起诉\" | 专利风险评估 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n    - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 睿观-发明专利检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/ruiguan/utilityPatentDetection`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| productTitle | string | 是 | 产品标题，最大1000字符 |\n| productDescription | string | 是 | 产品描述，最大1000字符 |\n| region | string | 是 | 商品想要售卖的国家/地区代码，多个用逗号分隔，当前支持 US。默认 `US` |\n| topNumber | integer | 是 | 召回数量，范围：10--200，默认 `100` |\n\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 记录数 |\n| detectId | string | 检测ID |\n| costToken | integer | 消耗token |\n| type | string | 渲染的样式 |\n| columns | array | 渲染的列定义 |\n| data | array | 专利列表（详见下方） |\n\n### 专利对象字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| globalUtilityId | string | 专利ID |\n| title | string | 发明专利标题 |\n| titleCn | string | 发明专利标题（中文） |\n| similarity | number | 产品与该专利的相似度（0--1） |\n| patentValidity | string | 专利有效性：`Active`（有效）或 `Invalid`（无效） |\n| applicationNumber | string | 申请号 |\n| applicationDate | string | 申请日（yyyy-MM-dd） |\n| publicationNumber | string | 公开号 |\n| publicationDate | string | 公开日（yyyy-MM-dd） |\n| estimatedDueDate | string | 预估到期日（yyyy-MM-dd） |\n| region | string | 受理局 |\n| patentAbstract | string | 摘要 |\n| patentAbstractCn | string | 摘要（中文） |\n| claims | string | 权利要求 |\n| claimsCn | string | 权利要求（中文） |\n| specification | string | 说明书 |\n| specificationCn | string | 说明书（中文） |\n| inventors | array | 发明家和国家拼接，数组格式 |\n| inventorAddresses | array | 发明人地址，数组格式 |\n| applicants | array | 申请人和国家拼接，数组格式 |\n| applicantAddresses | array | 权利人地址，数组格式 |\n| priorityNumber | array | 优先权号，数组格式 |\n| relatedPublicationDate | array | 首次公开日（yyyy-MM-dd），数组格式 |\n| patentImageUrl | string | 专利封面图 |\n| images | array | 专利附图 |\n| classNumList | array | 类别号路径列表，格式：classNum1 > classNum2 > classNum3 |\n| cpcKindRaw | array | CPC分类（原始 JSONArray） |\n| troCase | boolean | 是否有TRO维权史 |\n| troHolder | boolean | 是否是TRO权利人的专利 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分或余额不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n    \"errcode\": 401,\n    \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/ruiguan/utilityPatentDetection \\\n  -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"productTitle\": \"便携式USB-C 65W氮化镓快充充电器\", \"productDescription\": \"一款紧凑型65W氮化镓USB-C快充充电器，配备可折叠插脚，支持PD3.0和QC4.0协议，双USB-C端口和一个USB-A端口，适用于笔记本电脑、手机和平板电脑。\", \"region\": \"US\", \"topNumber\": 100}'\n```\n\nFile v1.2.2:references/linkfox-zhihuiya-abstract-data-translated.md\n\n---\nname: linkfox-zhihuiya-abstract-data-translated\ndescription: 智慧芽专利标题与摘要翻译工具。支持通过专利 ID 或公开号获取中、英、日等跨语言的专利翻译内容。\n---\n\n# 智慧芽专利标题与摘要翻译（Zhihuiya Abstract Data Translated）\n\n本技能用于从智慧芽（PatSnap）专利数据库获取专利标题和摘要的翻译版本，支持中文、英文、日文翻译。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过**专利 ID**（`patentId`）或**公开号**（`patentNumber`）查询专利，返回其标题与摘要的翻译版本。\n- 支持中、英、日三种目标翻译语言（`lang`：`cn`/`en`/`jp`）。\n- 支持批量查询：多个专利 ID 或公开号用英文逗号分隔一次提交。\n- 支持同族专利摘要回退：当原专利无摘要时，可启用 `replaceByRelated = 1` 用同族专利摘要替代。\n\n### ❌ 边界与限制\n\n- **必须提供标识符**：至少需要 `patentId` 或 `patentNumber` 之一，工具不支持按关键词检索专利。\n- **翻译语言有限**：仅支持中文（`cn`）、英文（`en`）、日文（`jp`）。\n- **仅返回标题与摘要**：不返回权利要求、说明书等专利全文。\n- **同族替代为可选项**：仅当显式设置 `replaceByRelated = 1` 时才提供同族专利替代摘要。\n- **不在范围内**：专利全文/权利要求获取；按关键词、分类号、申请人检索专利；专利法律状态、引证分析、专利全景报告；专利估值或侵权分析。\n\n## 核心概念\n\n智慧芽（PatSnap）是领先的专利情报平台。本工具查询其数据库，返回一条或多条专利的翻译标题与摘要。\n\n**专利标识**：每条专利可通过 `patentId`（智慧芽内部 ID）或 `patentNumber`（公开号/公告号，如 `US20200012345A1`、`CN112345678A`）标识。若同时提供两者，优先使用 `patentId`。\n\n**同族专利回退**：当原专利无可用摘要时，可启用替代选项，使用相关同族专利的摘要。\n\n## 调用方式\n\n- **API 端点**：`POST /zhihuiya/abstractDataTranslated`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/zhihuiya_abstract_translated.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-abstract-data-translated-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 按公开号翻译单条专利摘要为英文**\n```\n查一下公开号 US20200012345A1 的英文摘要。\n```\n参数：`patentNumber = \"US20200012345A1\"`, `lang = \"en\"`\n\n**2. 批量翻译多条专利为中文**\n```\n把 CN112345678A 和 US20200067890A1 的摘要翻译成中文。\n```\n参数：`patentNumber = \"CN112345678A,US20200067890A1\"`, `lang = \"cn\"`\n\n**3. 按专利 ID 查询并启用同族回退**\n```\n查专利 ID 12345678 的日文摘要，如果摘要不可用就用同族专利替代。\n```\n参数：`patentId = \"12345678\"`, `lang = \"jp\"`, `replaceByRelated = 1`\n\n**4. 按专利 ID 批量查询**\n```\n翻译这些专利 ID 的标题和摘要：111111、222222、333333。\n```\n参数：`patentId = \"111111,222222,333333\"`, `lang = \"en\"`\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格展示公开号、标题、摘要。\n2. **标明语言**：在输出标题中注明翻译语言，便于用户确认结果语种。\n3. **同族专利提示**：若结果中出现 `pnRelated`，明确告知用户该摘要取自同族专利，并展示替代公开号。\n4. **长摘要处理**：摘要较长时完整展示，不截断，便于用户审阅完整内容。\n5. **错误处理**：查询失败或无结果时，说明可能原因（如公开号无效、数据库中未找到该专利）并给出修正建议。\n6. **不做主观评论**：仅原样呈现翻译文本，不对专利内容做解读或法律分析。\n\n## 用户表达与场景速查\n\n**适用** —— 专利摘要与标题翻译查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"翻译这个专利的摘要\" | 单条专利翻译 |\n| \"专利 XX 说了什么 / 是关于什么的\" | 摘要查阅 |\n| \"把这个专利翻译成中文/日文\" | 指定语言翻译 |\n| \"查一下公开号 XX 的摘要\" | 按公开号查询 |\n| \"批量翻译这些专利\" | 批量翻译 |\n| \"摘要缺失，试试同族专利\" | 同族专利回退 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboardi\n\nArchive v1.2.1: 50 files, 239958 bytes\n\nFiles: references/linkfox-ruiguan-copyright-detection.md (10186b), references/linkfox-ruiguan-detection-patent-design.md (14266b), references/linkfox-ruiguan-gun-parts-search.md (8523b), references/linkfox-ruiguan-text-trademark-detection.md (11766b), references/linkfox-ruiguan-trademark-graphic-detection.md (11252b), references/linkfox-ruiguan-utility-patent-detection.md (11187b), references/linkfox-zhihuiya-abstract-data-translated.md (9390b), references/linkfox-zhihuiya-abstract-image.md (8236b), references/linkfox-zhihuiya-bibliography.md (11085b), references/linkfox-zhihuiya-claim-data-translated.md (9720b), references/linkfox-zhihuiya-claim-data.md (9523b), references/linkfox-zhihuiya-description-data-translated.md (9151b), references/linkfox-zhihuiya-description-data.md (9372b), references/linkfox-zhihuiya-fulltext-image.md (8060b), references/linkfox-zhihuiya-legal-status.md (11334b), references/linkfox-zhihuiya-patent-cited.md (9593b), references/linkfox-zhihuiya-patent-family.md (9987b), references/linkfox-zhihuiya-patent-forward-citation.md (9175b), references/linkfox-zhihuiya-patent-image-search.md (17504b), references/linkfox-zhihuiya-pdf-data.md (9130b), references/linkfox-zhihuiya-simple-bibliography.md (10906b), references/linkfox-zhihuiya-utility-patent-image-search.md (17850b), references/onboarding.md (2068b), scripts/onboarding.py (24089b), scripts/ruiguan_copyright_detection.py (12750b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/ruiguan_image_compliance_search.py (12762b), scripts/ruiguan_text_trademark_detection.py (13145b), scripts/ruiguan_trademark_graphic_detection.py (12812b), scripts/ruiguan_utility_patent_detection.py (13145b), scripts/upload_image.py (4591b), scripts/zhihuiya_abstract_image.py (13082b), scripts/zhihuiya_abstract_translated.py (13142b), scripts/zhihuiya_bibliography.py (13068b), scripts/zhihuiya_cited_by.py (13060b), scripts/zhihuiya_cited_references.py (13124b), scripts/zhihuiya_claim_data.py (13051b), scripts/zhihuiya_claim_translated.py (13119b), scripts/zhihuiya_description_data.py (13098b), scripts/zhihuiya_description_translated.py (13166b), scripts/zhihuiya_fulltext_image.py (13082b), scripts/zhihuiya_legal_status.py (13066b), scripts/zhihuiya_patent_family.py (13076b), scripts/zhihuiya_patent_image_search.py (13506b), scripts/zhihuiya_pdf_data.py (13040b), scripts/zhihuiya_simple_bibliography.py (13122b), scripts/zhihuiya_utility_patent_image_search.py (13526b), skill-card.md (3866b), SKILL.md (25632b), _meta.json (157b)\n\nArchive v1.2.0: 48 files, 230569 bytes\n\nFiles: references/linkfox-ruiguan-copyright-detection.md (10186b), references/linkfox-ruiguan-detection-patent-design.md (14266b), references/linkfox-ruiguan-gun-parts-search.md (8523b), references/linkfox-ruiguan-text-trademark-detection.md (11766b), references/linkfox-ruiguan-trademark-graphic-detection.md (11252b), references/linkfox-ruiguan-utility-patent-detection.md (11187b), references/linkfox-zhihuiya-abstract-data-translated.md (9390b), references/linkfox-zhihuiya-abstract-image.md (8236b), references/linkfox-zhihuiya-bibliography.md (11085b), references/linkfox-zhihuiya-claim-data-translated.md (9720b), references/linkfox-zhihuiya-claim-data.md (9523b), references/linkfox-zhihuiya-description-data-translated.md (9151b), references/linkfox-zhihuiya-description-data.md (9372b), references/linkfox-zhihuiya-fulltext-image.md (8060b), references/linkfox-zhihuiya-legal-status.md (11334b), references/linkfox-zhihuiya-patent-cited.md (9593b), references/linkfox-zhihuiya-patent-family.md (9987b), references/linkfox-zhihuiya-patent-forward-citation.md (9175b), references/linkfox-zhihuiya-patent-image-search.md (17504b), references/linkfox-zhihuiya-pdf-data.md (9130b), references/linkfox-zhihuiya-simple-bibliography.md (10906b), references/linkfox-zhihuiya-utility-patent-image-search.md (17850b), scripts/ruiguan_copyright_detection.py (12750b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/ruiguan_image_compliance_search.py (12762b), scripts/ruiguan_text_trademark_detection.py (13145b), scripts/ruiguan_trademark_graphic_detection.py (12812b), scripts/ruiguan_utility_patent_detection.py (13145b), scripts/upload_image.py (4591b), scripts/zhihuiya_abstract_image.py (13082b), scripts/zhihuiya_abstract_translated.py (13142b), scripts/zhihuiya_bibliography.py (13068b), scripts/zhihuiya_cited_by.py (13060b), scripts/zhihuiya_cited_references.py (13124b), scripts/zhihuiya_claim_data.py (13051b), scripts/zhihuiya_claim_translated.py (13119b), scripts/zhihuiya_description_data.py (13098b), scripts/zhihuiya_description_translated.py (13166b), scripts/zhihuiya_fulltext_image.py (13082b), scripts/zhihuiya_legal_status.py (13066b), scripts/zhihuiya_patent_family.py (13076b), scripts/zhihuiya_patent_image_search.py (13506b), scripts/zhihuiya_pdf_data.py (13040b), scripts/zhihuiya_simple_bibliography.py (13122b), scripts/zhihuiya_utility_patent_image_search.py (13526b), skill-card.md (4665b), SKILL.md (25592b), _meta.json (157b)\n\nArchive v1.0.1: 48 files, 230752 bytes\n\nFiles: references/linkfox-ruiguan-copyright-detection.md (10186b), references/linkfox-ruiguan-detection-patent-design.md (14266b), references/linkfox-ruiguan-gun-parts-search.md (8523b), references/linkfox-ruiguan-text-trademark-detection.md (11766b), references/linkfox-ruiguan-trademark-graphic-detection.md (11252b), references/linkfox-ruiguan-utility-patent-detection.md (11187b), references/linkfox-zhihuiya-abstract-data-translated.md (9390b), references/linkfox-zhihuiya-abstract-image.md (8236b), references/linkfox-zhihuiya-bibliography.md (11085b), references/linkfox-zhihuiya-claim-data-translated.md (9720b), references/linkfox-zhihuiya-claim-data.md (9523b), references/linkfox-zhihuiya-description-data-translated.md (9151b), references/linkfox-zhihuiya-description-data.md (9372b), references/linkfox-zhihuiya-fulltext-image.md (8060b), references/linkfox-zhihuiya-legal-status.md (11334b), references/linkfox-zhihuiya-patent-cited.md (9593b), references/linkfox-zhihuiya-patent-family.md (9987b), references/linkfox-zhihuiya-patent-forward-citation.md (9175b), references/linkfox-zhihuiya-patent-image-search.md (17504b), references/linkfox-zhihuiya-pdf-data.md (9130b), references/linkfox-zhihuiya-simple-bibliography.md (10906b), references/linkfox-zhihuiya-utility-patent-image-search.md (17850b), scripts/ruiguan_copyright_detection.py (12750b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/ruiguan_image_compliance_search.py (12762b), scripts/ruiguan_text_trademark_detection.py (13145b), scripts/ruiguan_trademark_graphic_detection.py (12812b), scripts/ruiguan_utility_patent_detection.py (13145b), scripts/upload_image.py (4591b), scripts/zhihuiya_abstract_image.py (13082b), scripts/zhihuiya_abstract_translated.py (13142b), scripts/zhihuiya_bibliography.py (13068b), scripts/zhihuiya_cited_by.py (13060b), scripts/zhihuiya_cited_references.py (13124b), scripts/zhihuiya_claim_data.py (13051b), scripts/zhihuiya_claim_translated.py (13119b), scripts/zhihuiya_description_data.py (13098b), scripts/zhihuiya_description_translated.py (13166b), scripts/zhihuiya_fulltext_image.py (13082b), scripts/zhihuiya_legal_status.py (13066b), scripts/zhihuiya_patent_family.py (13076b), scripts/zhihuiya_patent_image_search.py (13506b), scripts/zhihuiya_pdf_data.py (13040b), scripts/zhihuiya_simple_bibliography.py (13122b), scripts/zhihuiya_utility_patent_image_search.py (13526b), skill-card.md (4724b), SKILL.md (25592b), _meta.json (157b)\n\nArchive v1.0.0: 48 files, 230710 bytes\n\nFiles: references/linkfox-ruiguan-copyright-detection.md (10186b), references/linkfox-ruiguan-detection-patent-design.md (14266b), references/linkfox-ruiguan-gun-parts-search.md (8523b), references/linkfox-ruiguan-text-trademark-detection.md (11766b), references/linkfox-ruiguan-trademark-graphic-detection.md (11252b), references/linkfox-ruiguan-utility-patent-detection.md (11187b), references/linkfox-zhihuiya-abstract-data-translated.md (9390b), references/linkfox-zhihuiya-abstract-image.md (8236b), references/linkfox-zhihuiya-bibliography.md (11085b), references/linkfox-zhihuiya-claim-data-translated.md (9720b), references/linkfox-zhihuiya-claim-data.md (9523b), references/linkfox-zhihuiya-description-data-translated.md (9151b), references/linkfox-zhihuiya-description-data.md (9372b), references/linkfox-zhihuiya-fulltext-image.md (8060b), references/linkfox-zhihuiya-legal-status.md (11334b), references/linkfox-zhihuiya-patent-cited.md (9593b), references/linkfox-zhihuiya-patent-family.md (9987b), references/linkfox-zhihuiya-patent-forward-citation.md (9175b), references/linkfox-zhihuiya-patent-image-search.md (17504b), references/linkfox-zhihuiya-pdf-data.md (9130b), references/linkfox-zhihuiya-simple-bibliography.md (10906b), references/linkfox-zhihuiya-utility-patent-image-search.md (17850b), scripts/ruiguan_copyright_detection.py (12750b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/ruiguan_image_compliance_search.py (12762b), scripts/ruiguan_text_trademark_detection.py (13145b), scripts/ruiguan_trademark_graphic_detection.py (12812b), scripts/ruiguan_utility_patent_detection.py (13145b), scripts/upload_image.py (4591b), scripts/zhihuiya_abstract_image.py (13082b), scripts/zhihuiya_abstract_translated.py (13142b), scripts/zhihuiya_bibliography.py (13068b), scripts/zhihuiya_cited_by.py (13060b), scripts/zhihuiya_cited_references.py (13124b), scripts/zhihuiya_claim_data.py (13051b), scripts/zhihuiya_claim_translated.py (13119b), scripts/zhihuiya_description_data.py (13098b), scripts/zhihuiya_description_translated.py (13166b), scripts/zhihuiya_fulltext_image.py (13082b), scripts/zhihuiya_legal_status.py (13066b), scripts/zhihuiya_patent_family.py (13076b), scripts/zhihuiya_patent_image_search.py (13506b), scripts/zhihuiya_pdf_data.py (13040b), scripts/zhihuiya_simple_bibliography.py (13122b), scripts/zhihuiya_utility_patent_image_search.py (13526b), skill-card.md (4935b), SKILL.md (25437b), _meta.json (157b)","readmeExcerpt":"Skill: Linkfox 电商合规检测 Owner: linkfox-ai Summary: 电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。 Tags: latest:1.2.3 Version history: v1.2.3 | 2026-08-14T14:50:49.644Z | user Update from 1.2.2 to 1.2.3 v1.2.2 | 2026-08-07T10:49:03.701Z | user Update from 1.2.1 to 1.2.2 v1.2.1 | 2026-08-05T09:00:06.975Z | user Update from 1.2.0 to 1.2.1 v1.2.0 | 2026-07-16T04:00:55.636Z | user Update from 1.0.1 to 1.2.0 v1.0.1 | 2026","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 100, \"enableRadar\": true}"},{"language":"json","snippet":"{\"imageUrl\": \"https://example.com/product-image.jpg\", \"topNumber\": 10, \"regions\": \"US,EM\", \"enableRadar\": true}"},{"language":"json","snippet":"{\"productTitle\": \"Wireless Bluetooth Headphones Noise Cancelling Over Ear\", \"regions\": \"US\", \"limit\": 100}"},{"language":"json","snippet":"{\"imageUrl\": \"https://example.com/product.jpg\", \"queryMode\": \"hybrid\", \"topNumber\": 50, \"regions\": \"US\", \"enableRadar\": true}"},{"language":"json","snippet":"{\"productTitle\": \"便携式USB-C 65W氮化镓快充充电器\", \"productDescription\": \"紧凑型65W氮化镓USB-C快充充电器，可折叠插脚，支持PD3.0/QC4.0，双USB-C+USB-A\", \"region\": \"US\", \"topNumber\": 100}"},{"language":"json","snippet":"{\"imageUrl\": \"https://example.com/product-image.jpg\"}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-ecommerce-compliance-detection\ndisplay_name: Linkfox 电商合规检测\ndisplay_name_en: LinkFox E-commerce Compliance Detection\ndescription: 电商知识产权与合规检测一站式 AI 工具集，整合睿观知产合规检测（版权/商标/外观专利/实用新型专利/图片政策）与智慧芽专利数据查询（著录/权利要求/说明书/附图/法律状态/家族/引用/以图搜图/PDF）共 2 类底层工具、22 项子能力。\ndescription_zh: 电商知产与合规检测工具集，整合睿观（ruiguan_ip_detection）与智慧芽（zhihuiya_patent）2 类底层工具、22 项子能力。睿观覆盖图片版权、图形/文字商标、外观专利、实用新型专利、图片政策合规检测，返回相似度、权利人、TRO 与雷达侵权判定，支持 25+ 国家/地区。智慧芽覆盖专利核心/详细著录、标题摘要/权利要求/说明书及翻译、附图、法律状态、专利家族、引用分析、PDF 下载及外观/实用新型以图搜图。当用户需上架前版权/商标/专利侵权排查、TRO 风险评估、图片合规审查、专利查询翻译或以图搜专利时触发。参数见 references/，脚本见 scripts/。\ndescription_en: One-stop e-commerce IP & compliance detection AI toolkit integrating 22 sub-capabilities across 2 tool families — Ruiguan (ruiguan_ip_detection: image copyright, graphic & text trademark, design & utility-model patent, and policy/compliance detection with similarity, rights owner, TRO litigation history and radar infringement verdicts across 25+ countries) and PatSnap/Zhihuiya (zhihuiya_patent: patent core/detailed bibliography, title-abstract translation, claims & translation, description & translation, abstract/fulltext drawings, legal status & event history, patent family, forward & back citations, PDF download, and design/utility-model patent image search). Triggered when the user needs pre-launch copyright/trademark/patent infringement checks, TRO risk assessment, product image compliance review, patent detail lookup & translation, or image-based patent search. Full params per sub-capability are in references/, executable scripts in scripts/.\ncategory: e-commerce\nversion: 1.0.0\nauthor: LinkFox\n---\n\n# Linkfox 电商合规检测（E-commerce Compliance Detection）\n\n电商知识产权与合规检测一站式 AI 工具集，整合 **2 类底层工具、22 项子能力**：睿观（`ruiguan_ip_detection`）负责图片/文本类知产侵权与合规风险检测，智慧芽（`zhihuiya_patent`）负责专利数据查询与以图搜图。各子能力完整参数、响应字段与错误码见 `references/` 下对应文件，可执行脚本见 `scripts/`。\n\n## 能力边界\n\n### ✅ 能力范围\n- **图片版权侵权检测**（`ruiguan_ip_detection`）：对图片 URL 与已登记版权作品库比对，返回相似度、权利人、版权标识码、TRO 维权史与雷达侵权判定（linkfox-ruiguan-copyright-detection）。\n- **图形商标 / Logo 检测**（`ruiguan_ip_detection`）：产品图片与全球 15 国已注册图形商标库视觉相似度比对，含商标名、注册状态、尼斯分类、申请人、雷达判定（linkfox-ruiguan-trademark-graphic-detection）。\n- **文字商标检测**（`ruiguan_ip_detection`）：产品 Listing 标题/描述文本与 15 国注册商标库比对，返回整体风险等级、黑白名单与逐条命中（linkfox-ruiguan-text-trademark-detection）。\n- **外观设计专利检测**（`ruiguan_ip_detection`）：产品图片检索 25+ 国家/地区外观专利，含 AI 雷达侵权判定、TRO 风险与专利法律状态（linkfox-ruiguan-detection-patent-design）。\n- **实用新型 / 发明专利检测**（`ruiguan_ip_detection`）：基于产品标题与描述检索相似实用新型/发明专利，含 TRO 风险与预估到期日（linkfox-ruiguan-utility-patent-detection，当前仅支持 US）。\n- **图片政策合规检测**（`ruiguan_ip_detection`）：在已知违规/禁售商品库中按视觉相似度检索潜在违规商品（linkfox-ruiguan-gun-parts-search）。\n- **专利以图搜图**（`zhihuiya_patent`）：通过图片 URL 检索相似外观设计（`D`）与实用新型（`U`）专利，按视觉相似度排序，支持按受理局、洛迦诺分类、法律状态、申请人、日期多维筛选（linkfox-zhihuiya-patent-image-search、linkfox-zhihuiya-utility-patent-image-search）。\n- **专利著录查询**（`zhihuiya_patent`）：核心著录（标题/摘要/发明人/申请人/IPC·CPC 主分类）与详细著录（完整分类号/引用/优先权/预估到期日）（linkfox-zhihuiya-simple-bibliography、linkfox-zhihuiya-bibliography）。\n- **专利全文与翻译"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ecommerce-compliance-detection\",\n  \"version\": \"1.2.3\",\n  \"publishedAt\": 1786719049644\n}"},{"path":"references/linkfox-ruiguan-copyright-detection.md","content":"---\nname: linkfox-ruiguan-copyright-detection\ndescription: 基于睿观的图片版权侵权检测与风险分析工具，用于排查已登记作品的侵权与 TRO 风险。\n---\n\n# 睿观版权检测（Ruiguan Copyright Detection）\n\n本技能用于执行图片版权检测，帮助电商卖家和设计师在使用图片前识别潜在的版权侵权风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 对给定的图片 URL 进行版权检测，与已登记版权作品库比对，返回视觉相似的版权作品及风险指标。\n- 提供相似度、权利人、版权标识码、TRO 维权史、雷达侵权判定等多维风险信息。\n- 支持本地图片上传获取公开 URL 后再检测。\n\n### ❌ 边界与限制\n\n- **图片 URL 必需**：仅接受可公开访问的图片 URL，不直接接收本地上传；本地文件需先用上传脚本转为公开 URL。\n- **URL 长度**：图片 URL 不超过 1000 字符。\n- **结果上限**：单次查询最多返回 200 条结果。\n- **检测范围**：仅限检测服务维护的已登记版权作品库。\n- **非法律意见**：仅呈现检测数据，不提供法律结论。\n- **不在范围内**：商标或专利检索；文字或音乐版权检测；图片编辑修改；非版权目的的反向图片搜索；法律咨询或诉讼策略。\n\n## 核心概念\n\n版权检测通过将给定图片与已登记版权作品库进行比对来工作。系统返回视觉相似的版权作品及关键风险指标，如相似度、权利人信息、TRO（临时限制令）维权史、雷达侵权判定。\n\n**相似度（similarity）**：字符串小数（如 `\"0.85\"`），表示输入图片与版权作品的匹配程度，值越高风险越大。\n\n**雷达检测（enableRadar）**：额外的分析层，提供二元侵权判定（`1` = 侵权，`0` = 不侵权）。开启时每条结果包含此二次评估。\n\n**TRO 维权史**：TRO（Temporary Restraining Order，临时限制令）是版权维权中常用的法律手段。结果中标记 TRO 史表示权利人曾发起法律行动，风险较高。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/copyrightDetection`（完整参数/响应/错误码见 [references/api.md](references/api.md)）\n- **Python 脚本**：`python scripts/ruiguan_copyright_detection.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-copyright-detection-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 本地图片上传\n\n本工具要求**可公开访问的图片 URL**。若用户提供的是本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公开 URL。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本返回一个公开 URL（有效期 24 小时），可作为 imageUrl 参数使用。\n\n## 使用示例\n\n**1. 单张图片基础版权检测**\n> \"帮我查一下这张图片有没有版权问题：https://example.com/my-image.jpg\"\n动作：设置 `imageUrl` 为提供的 URL，其余参数用默认值。\n\n**2. 快速扫描少量结果**\n> \"对这张产品图做个快速版权扫描，只要最匹配的几条：https://example.com/product.png\"\n动作：设置 `topNumber` 为 10，更快返回。\n\n**3. 最大结果全面审计**\n> \"我要对这张设计图做一次完整的版权审计：https://example.com/design.jpg\"\n动作：设置 `topNumber` 为 200，最全面扫描。\n\n**4. 仅相似度检测（关闭雷达）**\n> \"只查这张图和版权作品的相似度，不需要详细侵权分析：https://example.com/photo.jpg\"\n动作：设置 `enableRadar` 为 `false`。\n\n**5. 批量检测多张图片**\n> \"帮我检测这三张图片的版权：url1、url2、url3\"\n动作：对每个图片 URL 调用一次 API，汇总结果。\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格展示检测结果，关键列包括相似度、权利人、版权标识码、雷达结果、TRO 史、版权来源链接。\n2. **高亮高风险**：相似度较高（如 ≥ 0.80）或雷达检测判定侵权（`subRadarResult` = 1）时，明确标注为高风险条目。\n3. **TRO 警告**：当 `troCase` 或 `troHolder` 为 `true` 时，醒目提示用户该权利人存在 TRO 维权史。\n4. **图片预览**：`path` 或 `pathThumb` 可用时，提示用户可在该 URL 查看版权作品缩略图。\n5. **结果数量提示**：告知用户匹配的 `total` 总数；结果较多时优先展示相似度最高的条目。\n6. **错误处理**：请求失败时说明原因，建议检查图片 URL 是否可公开访问、格式是否正确。\n7. **不做法律建议**：如实呈现检测数据，不提供法律结论；建议用户咨询法律人士获取权威版权评估。\n\n## 用户表达与场景速查\n\n**适用** —— 图片版权风险评估：\n\n| 用户说 | 场景 |\n|--------|------|\n|"},{"path":"references/linkfox-ruiguan-detection-patent-design.md","content":"---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的跨国/地区外观设计专利侵权检测工具，用于排查产品图片的外观专利与 TRO 诉讼风险。\n---\n\n# 睿观-外观专利检测（Ruiguan Design Patent Detection）\n\n本技能基于睿观引擎进行外观设计专利侵权检测，帮助电商卖家与知识产权从业者在产品上架前识别潜在的外观专利风险。完整参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 以产品图片为输入，对比全球外观设计专利数据库，返回按相似度排序的专利结果。\n- 支持 25+ 国家/地区的外观专利检索（US、EU、CN、JP、KR、DE、GB、FR 等）。\n- 提供 TRO（临时禁令）维权史查询，识别有主动维权记录的专利权人。\n- 可选启用 AI 雷达分析，给出疑似侵权的判定与说明。\n- 支持按 LOC（洛迦诺）分类限定检索范围，或交由模型自动预测分类。\n\n### ❌ 边界与限制\n\n- **图片要求**：需提供公开可访问的图片 URL；本地图片须先上传获取 URL（见下方【本地图片上传】）。\n- **检测范围**：仅覆盖外观设计专利，不包含发明专利、实用新型专利。\n- **相似度口径**：相似度分数为视觉 resemblance 参考值，不构成法律结论。\n- **成本约束**：每次调用消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词或连续试探。\n- **不在范围内**：发明专利/实用新型检索；商标侵权检测；版权/DMCA 问题；法律案件管理与诉讼策略；专利申请与申报；Listing 优化与定价。\n\n## 核心概念\n\n外观专利检测通过视觉相似度算法将产品图片与全球外观设计专利数据库进行比对，返回按相似度排序的专利结果，并附带 TRO 维权诉讼史，帮助评估侵权风险。\n\n**相似度分数**：取值 0-1，数值越高表示与专利附图的视觉相似度越高。`similarity >= 0.7` 或有 TRO 维权史的专利需重点关注并仔细审查。\n\n**雷达分析**：启用雷达后，每个专利结果包含 `radarResult`，其中 `same` 标记是否疑似侵权（true/false），`exp` 给出判定说明，提供超越原始相似度的 AI 判定。\n\n**LOC 分类**：洛迦诺分类（LOC）是工业品外观设计的国际分类体系。可指定 LOC 代码缩小检索范围，或不指定由模型自动预测合适类目。\n\n参数详情见 [references/api.md](references/api.md)。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/detectionPatentDesign`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_detection_patent_design.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-detection-patent-design-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 本地图片上传\n\n本工具要求**公开可访问的图片 URL**。若用户提供的是本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传以获取公开 URL。\n\n运行上传脚本：\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公开 URL（有效期 24 小时），可作为 imageUrl 参数使用。\n\n## 使用示例\n\n**1. 基础专利检测（美国市场）**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}\n```\n\n**2. 多地区检测并补充产品上下文**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"physical\",\n  \"topNumber\": 100,\n  \"regions\": \"US,EU,CN\",\n  \"productTitle\": \"Portable Wireless Charger Stand\",\n  \"productDescription\": \"A foldable wireless charging stand for smartphones\",\n  \"enableRadar\": true\n}\n```\n\n**3. 使用 LOC 分类缩小范围（家具）**\n```json\n{\n  \"imageUrl\": \"https://example.com/chair.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 80,\n  \"regions\": \"US,DE\",\n  \"topLoc\": \"06\",\n  \"patentStatus\": \"1\"\n}\n```\n\n**4. 线条图模式检索**\n```json\n{\n  \"imageUrl\": \"https://example.com/sketch.png\",\n  \"queryMode\": \"line\",\n  \"topNumber\": 50,\n  \"regions\": \"CN,JP,KR\"\n}\n```\n\n**"},{"path":"references/linkfox-ruiguan-gun-parts-search.md","content":"---\nname: linkfox-ruiguan-gun-parts-search\ndescription: 基于睿观的图片政策合规性检测工具，通过视觉相似度比对识别潜在的违规及禁售风险商品。\n---\n\n# 睿观-图片政策合规监测（Ruiguan Gun Parts Search）\n\n本技能基于睿观对产品图片进行政策合规检测，通过视觉相似度比对，在已知违规商品库中检索视觉相似商品，识别潜在的违规及禁售风险。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 根据产品图片 URL，在违规商品库中进行基于视觉相似度的检索，返回匹配的违规商品列表。\n- 返回每条匹配的相似度分数（cosine，0~1）、违规商品图片、中英文标题等信息。\n- 支持本地图片：用户提供本地文件路径时，先上传获取公开 URL，再发起检测。\n\n### ❌ 边界与限制\n\n- **仅基于图片**：本工具只分析图片 URL，不分析文本描述或商品元数据。\n- **URL 可访问性**：图片 URL 必须可被检测服务公开访问；本地文件须先上传。\n- **URL 长度上限**：图片 URL 不得超过 1000 字符。\n- **相似度≠定论**：结果基于视觉相似度，不构成确定性的政策裁定。\n- **不在范围内**：文本类合规分析；商品类目分类；知识产权/商标侵权；专利或版权检测（使用其他睿观技能）。\n\n## 核心概念\n\n睿观图片政策合规检测是一项基于图片的合规筛查服务。给定产品图片 URL，在已知违规商品库中检索视觉相似商品，并按相似度排序返回。\n\n**相似度分数（cosine）**：取值 0~1，值越高表示与已知违规商品视觉越相似；接近 1.0 表示几乎与已标记的违规商品完全一致。\n\n## 调用方式\n\n- **API 端点**：`POST /ruiguan/gunPartsSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/ruiguan_image_compliance_search.py '<JSON 参数>' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词或翻页连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**本地图片上传**：本工具要求**公开可访问的图片 URL**。若用户提供本地文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），须先上传获取公开 URL：\n\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\n脚本会返回一个公开 URL（24 小时有效），用作图片 URL 参数。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-gun-parts-search-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 单张产品图片合规检测**\n```\n检测这张产品图片是否有合规风险：https://example.com/images/product-123.jpg\n```\n\n**2. 批量检测多张产品图片**\n```\n请扫描这些产品图片，看是否存在潜在违规：\n- https://example.com/images/item-a.jpg\n- https://example.com/images/item-b.jpg\n```\n\n**3. 上架前合规预检**\n```\n上架这个产品前，帮我检查图片是否会触发政策风险：\n图片：https://example.com/new-product.png\n```\n\n## 展示规则\n\n1. **清晰表格呈现**：以结构化表格展示每条匹配的违规商品图片、相似度分数、中英文标题。\n2. **高亮高相似匹配**：当 cosine 分数超过 0.8 时，明确标记为强匹配，提示需重点关注。\n3. **展示违规图片**：返回结果含 `pdImgOssUrl` 时，展示匹配的违规商品图片，便于用户直观对比。\n4. **解释分数含义**：始终说明相似度分数的含义——值越高表示与已知违规商品越相似。\n5. **错误处理**：查询失败时说明原因，并建议检查图片 URL 是否有效且公开可访问。\n6. **不做法律建议**：客观呈现检测结果，不提供法律结论；提醒用户以平台政策为准进行核实。\n\n## 用户表达与场景速查\n\n**适用** —— 基于图片的产品政策合规检测：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"检测这张产品图片是否有合规风险\" | 单图合规检测 |\n| \"扫描我的产品图片是否有违规\" | 批量合规筛查 |\n| \"这张图片是否被标记为禁售商品\" | 特定违规查询 |\n| \"上架前帮我筛查一下图片的政策风险\" | 上架前合规预检 |\n| \"找一下这张产品图片的相似违规\" | 相似度违规检索 |\n| \"这个产品能安全上架吗\" | 合规风险预检 |\n| \"帮我检测一下这个图片是否违规\" | 单图合规检测 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboar"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。 Skill: Linkfox 电商合规检测 Owner: linkfox-ai Summary: 电商图文知识产权合规检测与专利搜索工具，支持版权、商标、专利侵权风险评估及专利详情与图像相似搜查。 Tags: latest:1.2.3 Version history: v1.2.3 | 2026-08-14T14:50:49.644Z | user Update from 1.2.2 to 1.2.3 v1.2.2 | 2026-08-07T10:49:03.701Z | user Update from 1.2.1 to 1.2.2 v1.2.1 | 2026-08-05T09:00:06.975Z | user Update from 1.2.0 to 1.2.1 v1.2.0 | 2026-07-16T04:00:55.636Z | user Update from 1.0.1 to 1.2.0 v1.0.1 | 2026","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1012,"uniquenessScore":45,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-12T02:22:08.533Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-12T02:22:08.533Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-12T13:21:45.439Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}