{"id":"cfde686f-3a5a-484f-bd6c-9f41d0fe8783","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design","name":"睿观-外观专利检测","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design","generatedAt":"2026-10-13T08:02:08.675Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T19:17:46.584Z","emptyReason":null},"description":"基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。 Skill: 睿观-外观专利检测 Owner: linkfox-ai Summary: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-14T05:23:23.257Z | user Update from 1.0.6 t","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-ruiguan-detection-patent-design","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-ruiguan-detection-patent-design","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-ruiguan-detection-patent-design","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T19:17:46.584Z","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-11T19:17:46.584Z","emptyReason":null},"stars":null,"forks":null,"downloads":1004,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.0.7","tractionLabel":"1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T19:17:46.570Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T19:17:46.584Z","lastCrawledAt":"2026-10-11T19:17:46.570Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T19:17:46.570Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.7","createdAt":"2026-09-14T05:23:23.257Z","changelog":"Update from 1.0.6 to 1.0.7","fileCount":8,"zipByteSize":27238},{"version":"1.0.6","createdAt":"2026-08-14T14:58:56.118Z","changelog":"Update from 1.0.5 to 1.0.6","fileCount":8,"zipByteSize":27273},{"version":"1.0.5","createdAt":"2026-08-07T10:55:08.030Z","changelog":"Update from 1.0.4 to 1.0.5","fileCount":8,"zipByteSize":27282},{"version":"1.0.4","createdAt":"2026-07-13T12:15:49.827Z","changelog":"Update from 1.0.3 to 1.0.4","fileCount":6,"zipByteSize":18201},{"version":"1.0.3","createdAt":"2026-07-06T11:24:16.064Z","changelog":"Update from 1.0.2 to 1.0.3","fileCount":6,"zipByteSize":17635},{"version":"1.0.2","createdAt":"2026-07-03T08:22:47.994Z","changelog":"Update from 1.0.1 to 1.0.2","fileCount":5,"zipByteSize":16161},{"version":"1.0.1","createdAt":"2026-07-03T06:54:04.233Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":5,"zipByteSize":16128}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-ruiguan-detection-patent-design","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-ruiguan-detection-patent-design/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/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-13T08:02:08.673Z"}},"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-ruiguan-detection-patent-design/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-ruiguan-detection-patent-design/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-11T19:17:46.584Z","emptyReason":null},"readme":"Skill: 睿观-外观专利检测\n\nOwner: linkfox-ai\n\nSummary: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\n\nTags: latest:1.0.7\n\nVersion history:\n\nv1.0.7 | 2026-09-14T05:23:23.257Z | user\n\nUpdate from 1.0.6 to 1.0.7\n\nv1.0.6 | 2026-08-14T14:58:56.118Z | user\n\nUpdate from 1.0.5 to 1.0.6\n\nv1.0.5 | 2026-08-07T10:55:08.030Z | user\n\nUpdate from 1.0.4 to 1.0.5\n\nv1.0.4 | 2026-07-13T12:15:49.827Z | user\n\nUpdate from 1.0.3 to 1.0.4\n\nv1.0.3 | 2026-07-06T11:24:16.064Z | user\n\nUpdate from 1.0.2 to 1.0.3\n\nv1.0.2 | 2026-07-03T08:22:47.994Z | user\n\nUpdate from 1.0.1 to 1.0.2\n\nv1.0.1 | 2026-07-03T06:54:04.233Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nArchive index:\n\nArchive v1.0.7: 8 files, 27238 bytes\n\nFiles: references/api.md (6432b), references/onboarding.md (1999b), scripts/onboarding.py (24027b), scripts/ruiguan_detection_patent_design.py (12836b), scripts/upload_image.py (4822b), skill-card.md (2898b), SKILL.md (12684b), _meta.json (158b)\n\nFile v1.0.7:SKILL.md\n\n---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\n---\n\n# Ruiguan Design Patent Detection\n\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\n\n## Core Concepts\n\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\n\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\n\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\n\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\n\n## Parameters Guide\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Yes | - | Product image URL to check against the patent database |\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\n| productTitle | No | - | Product title for supplementary context |\n| productDescription | No | - | Product description for supplementary context |\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\n\n### Supported Regions\n\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland), IE (Ireland), IL (Israel), DK (Denmark), NZ (New Zealand), AT (Austria), BX (Bolivia), FI (Finland), WO (WIPO)\n\nDefault region is **US**. Use US when the user does not specify a region.\n\n### LOC Level-1 Categories\n\n| Code | Category |\n|------|----------|\n| 01 | Food |\n| 02 | Clothing, haberdashery and sewing accessories |\n| 03 | Travel goods, cases, parasols and personal items n.e.c. |\n| 04 | Brushes |\n| 05 | Textiles, artificial and natural sheet material |\n| 06 | Furniture and household goods |\n| 07 | Household items n.e.c. |\n| 08 | Tools and hardware |\n| 09 | Packages and containers for transport or handling of goods |\n| 10 | Clocks, watches, measuring/checking/signaling instruments |\n| 11 | Ornamental articles |\n| 12 | Means of transport or hoisting |\n| 13 | Equipment for production, distribution or transformation of electricity |\n| 14 | Recording, telecommunication or data processing equipment |\n| 15 | Machines n.e.c. |\n| 16 | Photographic, cinematographic and optical apparatus |\n| 17 | Musical instruments |\n| 18 | Printing and office machinery |\n| 19 | Stationery, office equipment, art materials, teaching materials |\n| 20 | Sales and advertising equipment, signs |\n| 21 | Games, toys, tents and sports goods |\n| 22 | Arms, pyrotechnic articles, hunting/fishing/pest-killing articles |\n| 23 | Fluid distribution, sanitary, heating, ventilation, air-conditioning equipment, solid fuel |\n| 24 | Medical and laboratory equipment |\n| 25 | Building units and construction elements |\n| 26 | Lighting apparatus |\n| 27 | Tobacco and smoking supplies |\n| 28 | Pharmaceutical/cosmetic products, toilet articles and apparatus |\n| 29 | Devices and equipment against fire, for accident prevention and rescue |\n| 30 | Articles for care and handling of animals |\n| 31 | Machines and apparatus for preparing food or drink n.e.c. |\n| 32 | Graphic symbols, logos, surface patterns, ornamentation, interior/exterior arrangements |\n| ALL | All categories |\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发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示算力或余额不足**：消息含\"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path (e.g., `C:\\Users\\...\\photo.png`, `/home/.../image.jpg`), you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.\n\n## Usage Examples\n\n**1. Basic patent check for a product image (US market)**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}\n```\n\n**2. Multi-region check with product context**\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. Narrowed search using LOC classification (furniture)**\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. Line drawing mode for sketch-based search**\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. Check both active and expired patents**\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## Display Rules\n\n1. **High-risk patent highlighting**: When generating summaries or reports, display ALL patents with `similarity >= 0.7` or `troCase = true` in full detail. For each such patent, include: application number, patent title (Chinese), inventors, TRO enforcement history, the most-similar patent drawing, every image in the patent image list, patent abstract, patent specification, LOC info, radar analysis result, and specification text. This detailed presentation is critically important -- do NOT abbreviate or omit these fields.\n2. **Disclaimer**: Always append a friendly reminder at the end: \"This detection result is generated by LinkfoxAgent. It is recommended to consult a professional IP attorney for legal advice.\"\n3. **Similarity interpretation**: Clearly explain that higher similarity scores indicate greater visual resemblance and higher infringement risk.\n4. **Radar result display**: When `radarResult.same` is true, prominently flag the patent as a suspected infringement match and display the `exp` explanation.\n5. **TRO warning**: Patents with `troCase = true` or `troHolder = true` should be highlighted with a warning, as they indicate the patent holder has a history of active enforcement via Temporary Restraining Orders.\n6. **Image display**: Show both `patentImageUrl` (the most similar patent drawing) and the full `images` list so users can visually compare their product against all patent drawings.\n7. **Error handling**: When a request fails, explain the issue and suggest corrective actions (e.g., check image URL accessibility, verify region codes).\n8. **Present data faithfully**: Show query results as-is without adding subjective legal conclusions beyond the tool's own analysis.\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Design patent risk assessment:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"Check if this product infringes any design patents\" | Basic patent detection |\n| \"Patent risk check for this image\" | Image-based patent search |\n| \"Does this product have TRO risk\" | TRO enforcement history lookup |\n| \"Design patent search for US and EU\" | Multi-region patent detection |\n| \"Check appearance patent for this furniture\" | Category-specific patent search |\n| \"Is this product design safe to sell\" | Pre-listing patent clearance |\n| \"Find similar design patents\" | Similarity-based patent discovery |\n| \"Patent infringement analysis\" | Comprehensive patent risk report |\n\n**Not applicable** -- Needs beyond design patent detection:\n- Utility patent or invention patent searches\n- Trademark infringement checks\n- Copyright/DMCA issues\n- Legal case management or litigation strategy\n- Patent application or filing assistance\n- Product listing optimization or pricing\n\n**Boundary judgment**: When users mention \"patent check\" or \"IP risk\", if the concern is about product appearance/design similarity to existing patents, this skill applies. If they are asking about utility patents, trademarks, copyrights, or need actual legal counsel, this skill does not apply.\n\n## 算力消耗规则\n\n雷达检测开启消耗 92 算力，未开启消耗 61 算力。\n\n> **重要**：本技能消耗大量算力，如果调用次数超过5次，必须用`AskUserQuestion` 和用户进行二次确认，要明确告知用户已消耗算力和继续调用的话预计消耗的算力，让用户自行决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.7:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1789363403257\n}\n\nFile v1.0.7:references/api.md\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\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-xxx-xxx\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.7:references/onboarding.md\n\n# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.7:skill-card.md\n\n## Description:\n\nChecks product images with LinkFox Ruiguan design-patent detection to surface visually similar patents, TRO enforcement signals, similarity scores, and AI radar analysis across supported regions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nE-commerce sellers, IP professionals, and agents use this skill to check product image URLs or local product images for design-patent similarity, TRO enforcement signals, and region-scoped risk indicators before listing or reviewing products.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Local product images may be uploaded to a public URL for patent checking.\n\nMitigation: Use only images and product details that may be shared with LinkFox and potentially exposed through a public image URL; avoid confidential or regulated images.\n\nRisk: API keys, account details, billing actions, or order data may appear in logs or transcripts during onboarding and payment flows.\n\nMitigation: Use onboarding and billing commands only when account management is intended, minimize transcript exposure, and rotate any API key that appears in logs or shared conversations.\n\nRisk: Patent-check responses and sensitive product details are written to local session data files.\n\nMitigation: Review saved LinkFox data directories before sharing a workspace or transcript, and delete files that contain confidential product or account information when no longer needed.\n\nRisk: Detection output can support risk assessment but is not legal advice.\n\nMitigation: Treat similarity scores, TRO signals, and radar analysis as screening indicators and consult a qualified IP attorney before making legal or commercial decisions.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design)\n- [LinkFox Publisher Profile](https://clawhub.ai/user/linkfox-ai)\n- [Ruiguan API Reference](artifact/references/api.md)\n- [Authentication and Billing Onboarding](artifact/references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, JSON, guidance]\n\n**Output Format:** [Markdown guidance with JSON API parameters, shell commands, and saved JSON response files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Full API responses are saved to LinkFox session data directories; large responses are summarized unless inline output is requested.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.6: 8 files, 27273 bytes\n\nFiles: references/api.md (6432b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/upload_image.py (4592b), skill-card.md (2874b), SKILL.md (12588b), _meta.json (158b)\n\nFile v1.0.6:SKILL.md\n\n---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\n---\n\n# Ruiguan Design Patent Detection\n\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\n\n## Core Concepts\n\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\n\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\n\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\n\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\n\n## Parameters Guide\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Yes | - | Product image URL to check against the patent database |\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\n| productTitle | No | - | Product title for supplementary context |\n| productDescription | No | - | Product description for supplementary context |\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\n\n### Supported Regions\n\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland), IE (Ireland), IL (Israel), DK (Denmark), NZ (New Zealand), AT (Austria), BX (Bolivia), FI (Finland), WO (WIPO)\n\nDefault region is **US**. Use US when the user does not specify a region.\n\n### LOC Level-1 Categories\n\n| Code | Category |\n|------|----------|\n| 01 | Food |\n| 02 | Clothing, haberdashery and sewing accessories |\n| 03 | Travel goods, cases, parasols and personal items n.e.c. |\n| 04 | Brushes |\n| 05 | Textiles, artificial and natural sheet material |\n| 06 | Furniture and household goods |\n| 07 | Household items n.e.c. |\n| 08 | Tools and hardware |\n| 09 | Packages and containers for transport or handling of goods |\n| 10 | Clocks, watches, measuring/checking/signaling instruments |\n| 11 | Ornamental articles |\n| 12 | Means of transport or hoisting |\n| 13 | Equipment for production, distribution or transformation of electricity |\n| 14 | Recording, telecommunication or data processing equipment |\n| 15 | Machines n.e.c. |\n| 16 | Photographic, cinematographic and optical apparatus |\n| 17 | Musical instruments |\n| 18 | Printing and office machinery |\n| 19 | Stationery, office equipment, art materials, teaching materials |\n| 20 | Sales and advertising equipment, signs |\n| 21 | Games, toys, tents and sports goods |\n| 22 | Arms, pyrotechnic articles, hunting/fishing/pest-killing articles |\n| 23 | Fluid distribution, sanitary, heating, ventilation, air-conditioning equipment, solid fuel |\n| 24 | Medical and laboratory equipment |\n| 25 | Building units and construction elements |\n| 26 | Lighting apparatus |\n| 27 | Tobacco and smoking supplies |\n| 28 | Pharmaceutical/cosmetic products, toilet articles and apparatus |\n| 29 | Devices and equipment against fire, for accident prevention and rescue |\n| 30 | Articles for care and handling of animals |\n| 31 | Machines and apparatus for preparing food or drink n.e.c. |\n| 32 | Graphic symbols, logos, surface patterns, ornamentation, interior/exterior arrangements |\n| ALL | All categories |\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发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path (e.g., `C:\\Users\\...\\photo.png`, `/home/.../image.jpg`), you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.\n\n## Usage Examples\n\n**1. Basic patent check for a product image (US market)**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}\n```\n\n**2. Multi-region check with product context**\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. Narrowed search using LOC classification (furniture)**\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. Line drawing mode for sketch-based search**\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. Check both active and expired patents**\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## Display Rules\n\n1. **High-risk patent highlighting**: When generating summaries or reports, display ALL patents with `similarity >= 0.7` or `troCase = true` in full detail. For each such patent, include: application number, patent title (Chinese), inventors, TRO enforcement history, the most-similar patent drawing, every image in the patent image list, patent abstract, patent specification, LOC info, radar analysis result, and specification text. This detailed presentation is critically important -- do NOT abbreviate or omit these fields.\n2. **Disclaimer**: Always append a friendly reminder at the end: \"This detection result is generated by LinkfoxAgent. It is recommended to consult a professional IP attorney for legal advice.\"\n3. **Similarity interpretation**: Clearly explain that higher similarity scores indicate greater visual resemblance and higher infringement risk.\n4. **Radar result display**: When `radarResult.same` is true, prominently flag the patent as a suspected infringement match and display the `exp` explanation.\n5. **TRO warning**: Patents with `troCase = true` or `troHolder = true` should be highlighted with a warning, as they indicate the patent holder has a history of active enforcement via Temporary Restraining Orders.\n6. **Image display**: Show both `patentImageUrl` (the most similar patent drawing) and the full `images` list so users can visually compare their product against all patent drawings.\n7. **Error handling**: When a request fails, explain the issue and suggest corrective actions (e.g., check image URL accessibility, verify region codes).\n8. **Present data faithfully**: Show query results as-is without adding subjective legal conclusions beyond the tool's own analysis.\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Design patent risk assessment:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"Check if this product infringes any design patents\" | Basic patent detection |\n| \"Patent risk check for this image\" | Image-based patent search |\n| \"Does this product have TRO risk\" | TRO enforcement history lookup |\n| \"Design patent search for US and EU\" | Multi-region patent detection |\n| \"Check appearance patent for this furniture\" | Category-specific patent search |\n| \"Is this product design safe to sell\" | Pre-listing patent clearance |\n| \"Find similar design patents\" | Similarity-based patent discovery |\n| \"Patent infringement analysis\" | Comprehensive patent risk report |\n\n**Not applicable** -- Needs beyond design patent detection:\n- Utility patent or invention patent searches\n- Trademark infringement checks\n- Copyright/DMCA issues\n- Legal case management or litigation strategy\n- Patent application or filing assistance\n- Product listing optimization or pricing\n\n**Boundary judgment**: When users mention \"patent check\" or \"IP risk\", if the concern is about product appearance/design similarity to existing patents, this skill applies. If they are asking about utility patents, trademarks, copyrights, or need actual legal counsel, this skill does not apply.\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 雷达检测开启 ? 86.4 : 58.05。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.6:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.6\",\n  \"publishedAt\": 1786719536118\n}\n\nFile v1.0.6:references/api.md\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\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-xxx-xxx\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.6:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.6:skill-card.md\n\n## Description:\n\nChecks product images against Ruiguan's design patent database to surface similar patents, TRO history, and radar-based infringement indicators across 25+ regions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal e-commerce sellers, IP professionals, and developers use this skill to submit product images and context to LinkFox Ruiguan for design patent similarity search, TRO history checks, and risk-oriented result summaries before listing products.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Product images, product descriptions, account credentials, and billing actions may be sent through LinkFox services.\n\nMitigation: Use this skill only when sharing those materials with LinkFox is acceptable, and avoid confidential product designs unless public upload and third-party processing are approved.\n\nRisk: Patent detection calls consume LinkFox credits and may trigger billing or account onboarding flows.\n\nMitigation: Confirm expected credit use with the user before running paid searches, prefer cached results for repeated parameter sets, and manage payments deliberately.\n\nRisk: Local product images are uploaded to obtain public URLs, and full API responses are persisted locally.\n\nMitigation: Review and remove generated public image links and saved result files when they are no longer needed, especially in shared workspaces.\n\nRisk: The detection result is not legal advice and may be incomplete or misleading if treated as a final infringement determination.\n\nMitigation: Present results faithfully, highlight similarity and TRO indicators, and direct users to consult a qualified IP attorney for legal decisions.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design)\n- [睿观-外观专利检测 API reference](artifact/references/api.md)\n- [Authentication and billing onboarding](artifact/references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance, Files]\n\n**Output Format:** [Markdown guidance with shell commands, JSON API responses, stdout summaries, and saved JSON result files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires a public image URL and a LinkFox API key; API responses are cached for 24 hours and full results are saved under a LinkFox session data directory.]\n\n## Skill Version(s):\n\n1.0.6 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.5: 8 files, 27282 bytes\n\nFiles: references/api.md (6432b), references/onboarding.md (2046b), scripts/onboarding.py (24089b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/upload_image.py (4591b), skill-card.md (2997b), SKILL.md (12588b), _meta.json (158b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\n---\n\n# Ruiguan Design Patent Detection\n\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\n\n## Core Concepts\n\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\n\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\n\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\n\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\n\n## Parameters Guide\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Yes | - | Product image URL to check against the patent database |\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\n| productTitle | No | - | Product title for supplementary context |\n| productDescription | No | - | Product description for supplementary context |\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\n\n### Supported Regions\n\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland), IE (Ireland), IL (Israel), DK (Denmark), NZ (New Zealand), AT (Austria), BX (Bolivia), FI (Finland), WO (WIPO)\n\nDefault region is **US**. Use US when the user does not specify a region.\n\n### LOC Level-1 Categories\n\n| Code | Category |\n|------|----------|\n| 01 | Food |\n| 02 | Clothing, haberdashery and sewing accessories |\n| 03 | Travel goods, cases, parasols and personal items n.e.c. |\n| 04 | Brushes |\n| 05 | Textiles, artificial and natural sheet material |\n| 06 | Furniture and household goods |\n| 07 | Household items n.e.c. |\n| 08 | Tools and hardware |\n| 09 | Packages and containers for transport or handling of goods |\n| 10 | Clocks, watches, measuring/checking/signaling instruments |\n| 11 | Ornamental articles |\n| 12 | Means of transport or hoisting |\n| 13 | Equipment for production, distribution or transformation of electricity |\n| 14 | Recording, telecommunication or data processing equipment |\n| 15 | Machines n.e.c. |\n| 16 | Photographic, cinematographic and optical apparatus |\n| 17 | Musical instruments |\n| 18 | Printing and office machinery |\n| 19 | Stationery, office equipment, art materials, teaching materials |\n| 20 | Sales and advertising equipment, signs |\n| 21 | Games, toys, tents and sports goods |\n| 22 | Arms, pyrotechnic articles, hunting/fishing/pest-killing articles |\n| 23 | Fluid distribution, sanitary, heating, ventilation, air-conditioning equipment, solid fuel |\n| 24 | Medical and laboratory equipment |\n| 25 | Building units and construction elements |\n| 26 | Lighting apparatus |\n| 27 | Tobacco and smoking supplies |\n| 28 | Pharmaceutical/cosmetic products, toilet articles and apparatus |\n| 29 | Devices and equipment against fire, for accident prevention and rescue |\n| 30 | Articles for care and handling of animals |\n| 31 | Machines and apparatus for preparing food or drink n.e.c. |\n| 32 | Graphic symbols, logos, surface patterns, ornamentation, interior/exterior arrangements |\n| ALL | All categories |\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发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path (e.g., `C:\\Users\\...\\photo.png`, `/home/.../image.jpg`), you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.\n\n## Usage Examples\n\n**1. Basic patent check for a product image (US market)**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}\n```\n\n**2. Multi-region check with product context**\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. Narrowed search using LOC classification (furniture)**\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. Line drawing mode for sketch-based search**\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. Check both active and expired patents**\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## Display Rules\n\n1. **High-risk patent highlighting**: When generating summaries or reports, display ALL patents with `similarity >= 0.7` or `troCase = true` in full detail. For each such patent, include: application number, patent title (Chinese), inventors, TRO enforcement history, the most-similar patent drawing, every image in the patent image list, patent abstract, patent specification, LOC info, radar analysis result, and specification text. This detailed presentation is critically important -- do NOT abbreviate or omit these fields.\n2. **Disclaimer**: Always append a friendly reminder at the end: \"This detection result is generated by LinkfoxAgent. It is recommended to consult a professional IP attorney for legal advice.\"\n3. **Similarity interpretation**: Clearly explain that higher similarity scores indicate greater visual resemblance and higher infringement risk.\n4. **Radar result display**: When `radarResult.same` is true, prominently flag the patent as a suspected infringement match and display the `exp` explanation.\n5. **TRO warning**: Patents with `troCase = true` or `troHolder = true` should be highlighted with a warning, as they indicate the patent holder has a history of active enforcement via Temporary Restraining Orders.\n6. **Image display**: Show both `patentImageUrl` (the most similar patent drawing) and the full `images` list so users can visually compare their product against all patent drawings.\n7. **Error handling**: When a request fails, explain the issue and suggest corrective actions (e.g., check image URL accessibility, verify region codes).\n8. **Present data faithfully**: Show query results as-is without adding subjective legal conclusions beyond the tool's own analysis.\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Design patent risk assessment:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"Check if this product infringes any design patents\" | Basic patent detection |\n| \"Patent risk check for this image\" | Image-based patent search |\n| \"Does this product have TRO risk\" | TRO enforcement history lookup |\n| \"Design patent search for US and EU\" | Multi-region patent detection |\n| \"Check appearance patent for this furniture\" | Category-specific patent search |\n| \"Is this product design safe to sell\" | Pre-listing patent clearance |\n| \"Find similar design patents\" | Similarity-based patent discovery |\n| \"Patent infringement analysis\" | Comprehensive patent risk report |\n\n**Not applicable** -- Needs beyond design patent detection:\n- Utility patent or invention patent searches\n- Trademark infringement checks\n- Copyright/DMCA issues\n- Legal case management or litigation strategy\n- Patent application or filing assistance\n- Product listing optimization or pricing\n\n**Boundary judgment**: When users mention \"patent check\" or \"IP risk\", if the concern is about product appearance/design similarity to existing patents, this skill applies. If they are asking about utility patents, trademarks, copyrights, or need actual legal counsel, this skill does not apply.\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 雷达检测开启 ? 86.4 : 58.05。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1786100108030\n}\n\nFile v1.0.5:references/api.md\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\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-xxx-xxx\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.5:references/onboarding.md\n\n# 解决认证和积分问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。\n\nFile v1.0.5:skill-card.md\n\n## Description:\n\n睿观-外观专利检测 helps agents check product images against Ruiguan design patent data across 25+ regions and return similarity, TRO, and radar-analysis results for patent risk review.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal e-commerce sellers, IP professionals, and agent operators use this skill to submit product images and related product context for design patent similarity checks, TRO history review, and risk-oriented patent result summaries. It is for design patent screening and does not replace professional legal advice.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Product images and metadata are sent to LinkFox/Ruiguan for analysis, and local image files may be uploaded to a publicly accessible URL.\n\nMitigation: Use the skill only for images and product details that are acceptable to share with the service; avoid unreleased, confidential, or sensitive listings unless this data flow has been approved.\n\nRisk: The skill can guide API-key setup, phone-based onboarding, and paid credit purchase flows.\n\nMitigation: Confirm account ownership, payment authorization, and expected credit consumption before login, ordering, or analysis calls.\n\nRisk: Full API responses are stored locally and may include patent results, product context, and analysis details.\n\nMitigation: Run the skill in an appropriate workspace and review local retention requirements for the generated linkfox session data.\n\nRisk: Design patent similarity and radar outputs are screening signals, not legal determinations.\n\nMitigation: Present results faithfully, include the professional IP attorney reminder, and avoid treating the output as legal advice.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design)\n- [Publisher profile](https://clawhub.ai/user/linkfox-ai)\n- [睿观-外观专利检测 API reference](artifact/references/api.md)\n- [Authentication and billing onboarding guide](artifact/references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, JSON, Shell commands, Configuration, Guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON patent detection results saved to local files]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Calls a paid LinkFox/Ruiguan service, may upload local images to a public 24-hour URL, caches repeated requests for 24 hours, and stores full API responses under a local linkfox session directory.]\n\n## Skill Version(s):\n\n1.0.5 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.4: 6 files, 18201 bytes\n\nFiles: references/api.md (6432b), scripts/ruiguan_detection_patent_design.py (12780b), scripts/upload_image.py (4591b), skill-card.md (2563b), SKILL.md (13205b), _meta.json (158b)\n\nFile v1.0.4:SKILL.md\n\n---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\n---\n\n# Ruiguan Design Patent Detection\n\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\n\n## Core Concepts\n\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\n\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\n\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\n\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\n\n## Parameters Guide\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Yes | - | Product image URL to check against the patent database |\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\n| productTitle | No | - | Product title for supplementary context |\n| productDescription | No | - | Product description for supplementary context |\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\n\n### Supported Regions\n\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland), IE (Ireland), IL (Israel), DK (Denmark), NZ (New Zealand), AT (Austria), BX (Bolivia), FI (Finland), WO (WIPO)\n\nDefault region is **US**. Use US when the user does not specify a region.\n\n### LOC Level-1 Categories\n\n| Code | Category |\n|------|----------|\n| 01 | Food |\n| 02 | Clothing, haberdashery and sewing accessories |\n| 03 | Travel goods, cases, parasols and personal items n.e.c. |\n| 04 | Brushes |\n| 05 | Textiles, artificial and natural sheet material |\n| 06 | Furniture and household goods |\n| 07 | Household items n.e.c. |\n| 08 | Tools and hardware |\n| 09 | Packages and containers for transport or handling of goods |\n| 10 | Clocks, watches, measuring/checking/signaling instruments |\n| 11 | Ornamental articles |\n| 12 | Means of transport or hoisting |\n| 13 | Equipment for production, distribution or transformation of electricity |\n| 14 | Recording, telecommunication or data processing equipment |\n| 15 | Machines n.e.c. |\n| 16 | Photographic, cinematographic and optical apparatus |\n| 17 | Musical instruments |\n| 18 | Printing and office machinery |\n| 19 | Stationery, office equipment, art materials, teaching materials |\n| 20 | Sales and advertising equipment, signs |\n| 21 | Games, toys, tents and sports goods |\n| 22 | Arms, pyrotechnic articles, hunting/fishing/pest-killing articles |\n| 23 | Fluid distribution, sanitary, heating, ventilation, air-conditioning equipment, solid fuel |\n| 24 | Medical and laboratory equipment |\n| 25 | Building units and construction elements |\n| 26 | Lighting apparatus |\n| 27 | Tobacco and smoking supplies |\n| 28 | Pharmaceutical/cosmetic products, toilet articles and apparatus |\n| 29 | Devices and equipment against fire, for accident prevention and rescue |\n| 30 | Articles for care and handling of animals |\n| 31 | Machines and apparatus for preparing food or drink n.e.c. |\n| 32 | Graphic symbols, logos, surface patterns, ornamentation, interior/exterior arrangements |\n| ALL | All categories |\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\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- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。\n\n## Local Image Upload\n\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path (e.g., `C:\\Users\\...\\photo.png`, `/home/.../image.jpg`), you must upload it first to obtain a public URL.\n\nRun the upload script:\n```bash\npython scripts/upload_image.py /path/to/local/image.png\n```\n\nThe script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.\n\n## Usage Examples\n\n**1. Basic patent check for a product image (US market)**\n```json\n{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}\n```\n\n**2. Multi-region check with product context**\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. Narrowed search using LOC classification (furniture)**\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. Line drawing mode for sketch-based search**\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. Check both active and expired patents**\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## Display Rules\n\n1. **High-risk patent highlighting**: When generating summaries or reports, display ALL patents with `similarity >= 0.7` or `troCase = true` in full detail. For each such patent, include: application number, patent title (Chinese), inventors, TRO enforcement history, the most-similar patent drawing, every image in the patent image list, patent abstract, patent specification, LOC info, radar analysis result, and specification text. This detailed presentation is critically important -- do NOT abbreviate or omit these fields.\n2. **Disclaimer**: Always append a friendly reminder at the end: \"This detection result is generated by LinkfoxAgent. It is recommended to consult a professional IP attorney for legal advice.\"\n3. **Similarity interpretation**: Clearly explain that higher similarity scores indicate greater visual resemblance and higher infringement risk.\n4. **Radar result display**: When `radarResult.same` is true, prominently flag the patent as a suspected infringement match and display the `exp` explanation.\n5. **TRO warning**: Patents with `troCase = true` or `troHolder = true` should be highlighted with a warning, as they indicate the patent holder has a history of active enforcement via Temporary Restraining Orders.\n6. **Image display**: Show both `patentImageUrl` (the most similar patent drawing) and the full `images` list so users can visually compare their product against all patent drawings.\n7. **Error handling**: When a request fails, explain the issue and suggest corrective actions (e.g., check image URL accessibility, verify region codes).\n8. **Present data faithfully**: Show query results as-is without adding subjective legal conclusions beyond the tool's own analysis.\n## User Expression & Scenario Quick Reference\n\n**Applicable** -- Design patent risk assessment:\n\n| User Says | Scenario |\n|-----------|----------|\n| \"Check if this product infringes any design patents\" | Basic patent detection |\n| \"Patent risk check for this image\" | Image-based patent search |\n| \"Does this product have TRO risk\" | TRO enforcement history lookup |\n| \"Design patent search for US and EU\" | Multi-region patent detection |\n| \"Check appearance patent for this furniture\" | Category-specific patent search |\n| \"Is this product design safe to sell\" | Pre-listing patent clearance |\n| \"Find similar design patents\" | Similarity-based patent discovery |\n| \"Patent infringement analysis\" | Comprehensive patent risk report |\n\n**Not applicable** -- Needs beyond design patent detection:\n- Utility patent or invention patent searches\n- Trademark infringement checks\n- Copyright/DMCA issues\n- Legal case management or litigation strategy\n- Patent application or filing assistance\n- Product listing optimization or pricing\n\n**Boundary judgment**: When users mention \"patent check\" or \"IP risk\", if the concern is about product appearance/design similarity to existing patents, this skill applies. If they are asking about utility patents, trademarks, copyrights, or need actual legal counsel, this skill does not apply.\n\n## 积分消耗规则\n\n按动态规则计费：消耗积分 = 雷达检测开启 ? 86.4 : 58.05。\n\n> **重要**：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。\n\n**Feedback:**\n\nAuto-detect and report feedback via the Feedback API when any of the following apply:\n1. The functionality or purpose described in this skill does not match actual behavior\n2. The skill's results do not match the user's intent\n3. The user expresses dissatisfaction or praise about this skill\n4. Anything you believe could be improved\n\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\n---\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.4:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.4\",\n  \"publishedAt\": 1783944949827\n}\n\nFile v1.0.4:references/api.md\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\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-xxx-xxx\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.4:skill-card.md\n\n## Description: <br>\nGuides agents through Ruiguan/Linkfox design patent risk checks for product images, including similarity search, TRO history signals, and radar analysis across 25+ supported countries and regions. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nExternal sellers, IP professionals, and agent developers use this skill to check whether a product image may resemble existing design patents before listing or reviewing products. It helps prepare patent-risk summaries while preserving the skill's instruction to avoid legal conclusions beyond the returned data. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Product images, descriptions, and sales context are sent to an external Ruiguan/Linkfox service for analysis. <br>\nMitigation: Use the skill only for data that may be shared with that provider, and avoid confidential unreleased products unless the provider's data handling is acceptable. <br>\nRisk: Detailed API responses are saved locally and may contain product, patent, and sales-context data. <br>\nMitigation: Review saved response files after use and remove them when they are no longer needed. <br>\nRisk: The artifact includes feedback-reporting behavior separate from the patent-analysis API. <br>\nMitigation: Review or disable feedback reporting before installation when user comments or operational details should not be sent externally. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design) <br>\n- [API reference](artifact/references/api.md) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, shell commands, guidance] <br>\n**Output Format:** [Markdown guidance with JSON request examples, shell commands, and saved JSON response files] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Requires a public image URL or uploads a local image to obtain one; full API responses are saved locally and smaller responses may also print as JSON.] <br>\n\n## Skill Version(s): <br>\n1.0.4 (source: server release evidence) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.3: 6 files, 17635 bytes\n\nFiles: references/api.md (6396b), scripts/ruiguan_detection_patent_design.py (12861b), scripts/upload_image.py (4755b), skill-card.md (2908b), SKILL.md (12080b), _meta.json (158b)\n\nFile v1.0.3:SKILL.md\n\n---\r\nname: linkfox-ruiguan-detection-patent-design\r\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\r\n---\r\n\r\n# Ruiguan Design Patent Detection\r\n\r\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\r\n\r\n## Core Concepts\r\n\r\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\r\n\r\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\r\n\r\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\r\n\r\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\r\n\r\n## Parameters Guide\r\n\r\n| Parameter | Required | Default | Description |\r\n|-----------|----------|---------|-------------|\r\n| imageUrl | Yes | - | Product image URL to check against the patent database |\r\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\r\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\r\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\r\n| productTitle | No | - | Product title for supplementary context |\r\n| productDescription | No | - | Product description for supplementary context |\r\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\r\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\r\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\r\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\r\n\r\n### Supported Regions\r\n\r\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland), IE (Ireland), IL (Israel), DK (Denmark), NZ (New Zealand), AT (Austria), BX (Bolivia), FI (Finland), WO (WIPO)\r\n\r\nDefault region is **US**. Use US when the user does not specify a region.\r\n\r\n### LOC Level-1 Categories\r\n\r\n| Code | Category |\r\n|------|----------|\r\n| 01 | Food |\r\n| 02 | Clothing, haberdashery and sewing accessories |\r\n| 03 | Travel goods, cases, parasols and personal items n.e.c. |\r\n| 04 | Brushes |\r\n| 05 | Textiles, artificial and natural sheet material |\r\n| 06 | Furniture and household goods |\r\n| 07 | Household items n.e.c. |\r\n| 08 | Tools and hardware |\r\n| 09 | Packages and containers for transport or handling of goods |\r\n| 10 | Clocks, watches, measuring/checking/signaling instruments |\r\n| 11 | Ornamental articles |\r\n| 12 | Means of transport or hoisting |\r\n| 13 | Equipment for production, distribution or transformation of electricity |\r\n| 14 | Recording, telecommunication or data processing equipment |\r\n| 15 | Machines n.e.c. |\r\n| 16 | Photographic, cinematographic and optical apparatus |\r\n| 17 | Musical instruments |\r\n| 18 | Printing and office machinery |\r\n| 19 | Stationery, office equipment, art materials, teaching materials |\r\n| 20 | Sales and advertising equipment, signs |\r\n| 21 | Games, toys, tents and sports goods |\r\n| 22 | Arms, pyrotechnic articles, hunting/fishing/pest-killing articles |\r\n| 23 | Fluid distribution, sanitary, heating, ventilation, air-conditioning equipment, solid fuel |\r\n| 24 | Medical and laboratory equipment |\r\n| 25 | Building units and construction elements |\r\n| 26 | Lighting apparatus |\r\n| 27 | Tobacco and smoking supplies |\r\n| 28 | Pharmaceutical/cosmetic products, toilet articles and apparatus |\r\n| 29 | Devices and equipment against fire, for accident prevention and rescue |\r\n| 30 | Articles for care and handling of animals |\r\n| 31 | Machines and apparatus for preparing food or drink n.e.c. |\r\n| 32 | Graphic symbols, logos, surface patterns, ornamentation, interior/exterior arrangements |\r\n| ALL | All categories |\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /ruiguan/detectionPatentDesign`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/ruiguan_detection_patent_design.py '<JSON 参数>' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-detection-patent-design-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## Local Image Upload\r\n\r\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path (e.g., `C:\\Users\\...\\photo.png`, `/home/.../image.jpg`), you must upload it first to obtain a public URL.\r\n\r\nRun the upload script:\r\n```bash\r\npython scripts/upload_image.py /path/to/local/image.png\r\n```\r\n\r\nThe script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.\r\n\r\n## Usage Examples\r\n\r\n**1. Basic patent check for a product image (US market)**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 50,\r\n  \"regions\": \"US\"\r\n}\r\n```\r\n\r\n**2. Multi-region check with product context**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"physical\",\r\n  \"topNumber\": 100,\r\n  \"regions\": \"US,EU,CN\",\r\n  \"productTitle\": \"Portable Wireless Charger Stand\",\r\n  \"productDescription\": \"A foldable wireless charging stand for smartphones\",\r\n  \"enableRadar\": true\r\n}\r\n```\r\n\r\n**3. Narrowed search using LOC classification (furniture)**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/chair.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 80,\r\n  \"regions\": \"US,DE\",\r\n  \"topLoc\": \"06\",\r\n  \"patentStatus\": \"1\"\r\n}\r\n```\r\n\r\n**4. Line drawing mode for sketch-based search**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/sketch.png\",\r\n  \"queryMode\": \"line\",\r\n  \"topNumber\": 50,\r\n  \"regions\": \"CN,JP,KR\"\r\n}\r\n```\r\n\r\n**5. Check both active and expired patents**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 100,\r\n  \"regions\": \"US\",\r\n  \"patentStatus\": \"1,0\"\r\n}\r\n```\r\n\r\n## Display Rules\r\n\r\n1. **High-risk patent highlighting**: When generating summaries or reports, display ALL patents with `similarity >= 0.7` or `troCase = true` in full detail. For each such patent, include: application number, patent title (Chinese), inventors, TRO enforcement history, the most-similar patent drawing, every image in the patent image list, patent abstract, patent specification, LOC info, radar analysis result, and specification text. This detailed presentation is critically important -- do NOT abbreviate or omit these fields.\r\n2. **Disclaimer**: Always append a friendly reminder at the end: \"This detection result is generated by LinkfoxAgent. It is recommended to consult a professional IP attorney for legal advice.\"\r\n3. **Similarity interpretation**: Clearly explain that higher similarity scores indicate greater visual resemblance and higher infringement risk.\r\n4. **Radar result display**: When `radarResult.same` is true, prominently flag the patent as a suspected infringement match and display the `exp` explanation.\r\n5. **TRO warning**: Patents with `troCase = true` or `troHolder = true` should be highlighted with a warning, as they indicate the patent holder has a history of active enforcement via Temporary Restraining Orders.\r\n6. **Image display**: Show both `patentImageUrl` (the most similar patent drawing) and the full `images` list so users can visually compare their product against all patent drawings.\r\n7. **Error handling**: When a request fails, explain the issue and suggest corrective actions (e.g., check image URL accessibility, verify region codes).\r\n8. **Present data faithfully**: Show query results as-is without adding subjective legal conclusions beyond the tool's own analysis.\r\n## User Expression & Scenario Quick Reference\r\n\r\n**Applicable** -- Design patent risk assessment:\r\n\r\n| User Says | Scenario |\r\n|-----------|----------|\r\n| \"Check if this product infringes any design patents\" | Basic patent detection |\r\n| \"Patent risk check for this image\" | Image-based patent search |\r\n| \"Does this product have TRO risk\" | TRO enforcement history lookup |\r\n| \"Design patent search for US and EU\" | Multi-region patent detection |\r\n| \"Check appearance patent for this furniture\" | Category-specific patent search |\r\n| \"Is this product design safe to sell\" | Pre-listing patent clearance |\r\n| \"Find similar design patents\" | Similarity-based patent discovery |\r\n| \"Patent infringement analysis\" | Comprehensive patent risk report |\r\n\r\n**Not applicable** -- Needs beyond design patent detection:\r\n- Utility patent or invention patent searches\r\n- Trademark infringement checks\r\n- Copyright/DMCA issues\r\n- Legal case management or litigation strategy\r\n- Patent application or filing assistance\r\n- Product listing optimization or pricing\r\n\r\n**Boundary judgment**: When users mention \"patent check\" or \"IP risk\", if the concern is about product appearance/design similarity to existing patents, this skill applies. If they are asking about utility patents, trademarks, copyrights, or need actual legal counsel, this skill does not apply.\r\n\r\n\r\n**Feedback:**\r\n\r\nAuto-detect and report feedback via the Feedback API when any of the following apply:\r\n1. The functionality or purpose described in this skill does not match actual behavior\r\n2. The skill's results do not match the user's intent\r\n3. The user expresses dissatisfaction or praise about this skill\r\n4. Anything you believe could be improved\r\n\r\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\r\n---\r\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1783337056064\n}\n\nFile v1.0.3:references/api.md\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`）读取（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\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 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式。|\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\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-xxx-xxx\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nFile v1.0.3:skill-card.md\n\n## Description: <br>\nChecks product images with Ruiguan design patent search to help identify visual similarity, potential infringement indicators, and TRO enforcement risk across supported patent regions. <br>\n\nThis skill is ready for commercial/non-commercial use. <br>\n\n## Publisher: <br>\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai) <br>\n\n### License/Terms of Use: <br>\nMIT-0 <br>\n\n\n## Use Case: <br>\nE-commerce sellers, IP professionals, and agents use this skill to check product image URLs or uploaded local images against Ruiguan's design patent database before listing products. It supports similarity review, radar analysis, TRO indicators, and structured patent-result reporting. <br>\n\n### Deployment Geography for Use: <br>\nGlobal <br>\n\n## Known Risks and Mitigations: <br>\nRisk: Local image inputs may be uploaded to LinkFox/Ruiguan services as public URLs that remain valid for up to 24 hours. <br>\nMitigation: Use only product images and descriptions that are appropriate to send to the service, and avoid confidential prototypes unless the user accepts that exposure. <br>\nRisk: The skill persists full patent-search responses locally, which may include product context and detailed patent-result data. <br>\nMitigation: Review the saved linkfox session data path, protect it according to the user's data-handling requirements, and delete results that should not be retained. <br>\nRisk: Feedback about the skill may be reported to an external LinkFox feedback endpoint. <br>\nMitigation: Do not include confidential product details or sensitive user information in feedback content. <br>\nRisk: Similarity and radar results can inform patent-risk review but are not legal advice. <br>\nMitigation: Present results faithfully and recommend professional IP counsel for legal conclusions or listing decisions. <br>\n\n\n## Reference(s): <br>\n- [ClawHub skill page](https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design) <br>\n- [Ruiguan API reference](artifact/references/api.md) <br>\n- [LinkFox Skills authorization guide](https://skill.linkfox.com/linkfoxskills/guide.htm) <br>\n\n\n## Skill Output: <br>\n**Output Type(s):** [text, markdown, JSON, shell commands, configuration, guidance] <br>\n**Output Format:** [Markdown guidance with JSON API parameters, shell commands, and saved JSON result files] <br>\n**Output Parameters:** [1D] <br>\n**Other Properties Related to Output:** [Full API responses are saved under a local linkfox session data directory; large responses are summarized unless inline output is requested.] <br>\n\n## Skill Version(s): <br>\n1.0.3 (source: server release metadata) <br>\n\n## Ethical Considerations: <br>\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>\n\nArchive v1.0.2: 5 files, 16161 bytes\n\nFiles: references/api.md (6396b), scripts/ruiguan_detection_patent_design.py (12861b), scripts/upload_image.py (4755b), SKILL.md (12080b), _meta.json (158b)\n\nFile v1.0.2:SKILL.md\n\n---\r\nname: linkfox-ruiguan-detection-patent-design\r\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\r\n---\r\n\r\n# Ruiguan Design Patent Detection\r\n\r\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\r\n\r\n## Core Concepts\r\n\r\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\r\n\r\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\r\n\r\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\r\n\r\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\r\n\r\n## Parameters Guide\r\n\r\n| Parameter | Required | Default | Description |\r\n|-----------|----------|---------|-------------|\r\n| imageUrl | Yes | - | Product image URL to check against the patent database |\r\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\r\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\r\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\r\n| productTitle | No | - | Product title for supplementary context |\r\n| productDescription | No | - | Product description for supplementary context |\r\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\r\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\r\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\r\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\r\n\r\n### Supported Regions\r\n\r\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland), IE (Ireland), IL (Israel), DK (Denmark), NZ (New Zealand), AT (Austria), BX (Bolivia), FI (Finland), WO (WIPO)\r\n\r\nDefault region is **US**. Use US when the user does not specify a region.\r\n\r\n### LOC Level-1 Categories\r\n\r\n| Code | Category |\r\n|------|----------|\r\n| 01 | Food |\r\n| 02 | Clothing, haberdashery and sewing accessories |\r\n| 03 | Travel goods, cases, parasols and personal items n.e.c. |\r\n| 04 | Brushes |\r\n| 05 | Textiles, artificial and natural sheet material |\r\n| 06 | Furniture and household goods |\r\n| 07 | Household items n.e.c. |\r\n| 08 | Tools and hardware |\r\n| 09 | Packages and containers for transport or handling of goods |\r\n| 10 | Clocks, watches, measuring/checking/signaling instruments |\r\n| 11 | Ornamental articles |\r\n| 12 | Means of transport or hoisting |\r\n| 13 | Equipment for production, distribution or transformation of electricity |\r\n| 14 | Recording, telecommunication or data processing equipment |\r\n| 15 | Machines n.e.c. |\r\n| 16 | Photographic, cinematographic and optical apparatus |\r\n| 17 | Musical instruments |\r\n| 18 | Printing and office machinery |\r\n| 19 | Stationery, office equipment, art materials, teaching materials |\r\n| 20 | Sales and advertising equipment, signs |\r\n| 21 | Games, toys, tents and sports goods |\r\n| 22 | Arms, pyrotechnic articles, hunting/fishing/pest-killing articles |\r\n| 23 | Fluid distribution, sanitary, heating, ventilation, air-conditioning equipment, solid fuel |\r\n| 24 | Medical and laboratory equipment |\r\n| 25 | Building units and construction elements |\r\n| 26 | Lighting apparatus |\r\n| 27 | Tobacco and smoking supplies |\r\n| 28 | Pharmaceutical/cosmetic products, toilet articles and apparatus |\r\n| 29 | Devices and equipment against fire, for accident prevention and rescue |\r\n| 30 | Articles for care and handling of animals |\r\n| 31 | Machines and apparatus for preparing food or drink n.e.c. |\r\n| 32 | Graphic symbols, logos, surface patterns, ornamentation, interior/exterior arrangements |\r\n| ALL | All categories |\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /ruiguan/detectionPatentDesign`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/ruiguan_detection_patent_design.py '<JSON 参数>' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-detection-patent-design-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## Local Image Upload\r\n\r\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path (e.g., `C:\\Users\\...\\photo.png`, `/home/.../image.jpg`), you must upload it first to obtain a public URL.\r\n\r\nRun the upload script:\r\n```bash\r\npython scripts/upload_image.py /path/to/local/image.png\r\n```\r\n\r\nThe script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.\r\n\r\n## Usage Examples\r\n\r\n**1. Basic patent check for a product image (US market)**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 50,\r\n  \"regions\": \"US\"\r\n}\r\n```\r\n\r\n**2. Multi-region check with product context**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"physical\",\r\n  \"topNumber\": 100,\r\n  \"regions\": \"US,EU,CN\",\r\n  \"productTitle\": \"Portable Wireless Charger Stand\",\r\n  \"productDescription\": \"A foldable wireless charging stand for smartphones\",\r\n  \"enableRadar\": true\r\n}\r\n```\r\n\r\n**3. Narrowed search using LOC classification (furniture)**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/chair.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 80,\r\n  \"regions\": \"US,DE\",\r\n  \"topLoc\": \"06\",\r\n  \"patentStatus\": \"1\"\r\n}\r\n```\r\n\r\n**4. Line drawing mode for sketch-based search**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/sketch.png\",\r\n  \"queryMode\": \"line\",\r\n  \"topNumber\": 50,\r\n  \"regions\": \"CN,JP,KR\"\r\n}\r\n```\r\n\r\n**5. Check both active and expired patents**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 100,\r\n  \"regions\": \"US\",\r\n  \"patentStatus\": \"1,0\"\r\n}\r\n```\r\n\r\n## Display Rules\r\n\r\n1. **High-risk patent highlighting**: When generating summaries or reports, display ALL patents with `similarity >= 0.7` or `troCase = true` in full detail. For each such patent, include: application number, patent title (Chinese), inventors, TRO enforcement history, the most-similar patent drawing, every image in the patent image list, patent abstract, patent specification, LOC info, radar analysis result, and specification text. This detailed presentation is critically important -- do NOT abbreviate or omit these fields.\r\n2. **Disclaimer**: Always append a friendly reminder at the end: \"This detection result is generated by LinkfoxAgent. It is recommended to consult a professional IP attorney for legal advice.\"\r\n3. **Similarity interpretation**: Clearly explain that higher similarity scores indicate greater visual resemblance and higher infringement risk.\r\n4. **Radar result display**: When `radarResult.same` is true, prominently flag the patent as a suspected infringement match and display the `exp` explanation.\r\n5. **TRO warning**: Patents with `troCase = true` or `troHolder = true` should be highlighted with a warning, as they indicate the patent holder has a history of active enforcement via Temporary Restraining Orders.\r\n6. **Image display**: Show both `patentImageUrl` (the most similar patent drawing) and the full `images` list so users can visually compare their product against all patent drawings.\r\n7. **Error handling**: When a request fails, explain the issue and suggest corrective actions (e.g., check image URL accessibility, verify region codes).\r\n8. **Present data faithfully**: Show query results as-is without adding subjective legal conclusions beyond the tool's own analysis.\r\n## User Expression & Scenario Quick Reference\r\n\r\n**Applicable** -- Design patent risk assessment:\r\n\r\n| User Says | Scenario |\r\n|-----------|----------|\r\n| \"Check if this product infringes any design patents\" | Basic patent detection |\r\n| \"Patent risk check for this image\" | Image-based patent search |\r\n| \"Does this product have TRO risk\" | TRO enforcement history lookup |\r\n| \"Design patent search for US and EU\" | Multi-region patent detection |\r\n| \"Check appearance patent for this furniture\" | Category-specific patent search |\r\n| \"Is this product design safe to sell\" | Pre-listing patent clearance |\r\n| \"Find similar design patents\" | Similarity-based patent discovery |\r\n| \"Patent infringement analysis\" | Comprehensive patent risk report |\r\n\r\n**Not applicable** -- Needs beyond design patent detection:\r\n- Utility patent or invention patent searches\r\n- Trademark infringement checks\r\n- Copyright/DMCA issues\r\n- Legal case management or litigation strategy\r\n- Patent application or filing assistance\r\n- Product listing optimization or pricing\r\n\r\n**Boundary judgment**: When users mention \"patent check\" or \"IP risk\", if the concern is about product appearance/design similarity to existing patents, this skill applies. If they are asking about utility patents, trademarks, copyrights, or need actual legal counsel, this skill does not apply.\r\n\r\n\r\n**Feedback:**\r\n\r\nAuto-detect and report feedback via the Feedback API when any of the following apply:\r\n1. The functionality or purpose described in this skill does not match actual behavior\r\n2. The skill's results do not match the user's intent\r\n3. The user expresses dissatisfaction or praise about this skill\r\n4. Anything you believe could be improved\r\n\r\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\r\n---\r\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.2\",\n  \"publishedAt\": 1783066967994\n}\n\nFile v1.0.2:references/api.md\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`）读取（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\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 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式。|\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\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-xxx-xxx\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise\n\nArchive v1.0.1: 5 files, 16128 bytes\n\nFiles: references/api.md (6397b), scripts/ruiguan_detection_patent_design.py (12863b), scripts/upload_image.py (4756b), SKILL.md (12080b), _meta.json (158b)\n\nFile v1.0.1:SKILL.md\n\n---\r\nname: linkfox-ruiguan-detection-patent-design\r\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\r\n---\r\n\r\n# Ruiguan Design Patent Detection\r\n\r\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\r\n\r\n## Core Concepts\r\n\r\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\r\n\r\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\r\n\r\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\r\n\r\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\r\n\r\n## Parameters Guide\r\n\r\n| Parameter | Required | Default | Description |\r\n|-----------|----------|---------|-------------|\r\n| imageUrl | Yes | - | Product image URL to check against the patent database |\r\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\r\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\r\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\r\n| productTitle | No | - | Product title for supplementary context |\r\n| productDescription | No | - | Product description for supplementary context |\r\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\r\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\r\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\r\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\r\n\r\n### Supported Regions\r\n\r\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland), IE (Ireland), IL (Israel), DK (Denmark), NZ (New Zealand), AT (Austria), BX (Bolivia), FI (Finland), WO (WIPO)\r\n\r\nDefault region is **US**. Use US when the user does not specify a region.\r\n\r\n### LOC Level-1 Categories\r\n\r\n| Code | Category |\r\n|------|----------|\r\n| 01 | Food |\r\n| 02 | Clothing, haberdashery and sewing accessories |\r\n| 03 | Travel goods, cases, parasols and personal items n.e.c. |\r\n| 04 | Brushes |\r\n| 05 | Textiles, artificial and natural sheet material |\r\n| 06 | Furniture and household goods |\r\n| 07 | Household items n.e.c. |\r\n| 08 | Tools and hardware |\r\n| 09 | Packages and containers for transport or handling of goods |\r\n| 10 | Clocks, watches, measuring/checking/signaling instruments |\r\n| 11 | Ornamental articles |\r\n| 12 | Means of transport or hoisting |\r\n| 13 | Equipment for production, distribution or transformation of electricity |\r\n| 14 | Recording, telecommunication or data processing equipment |\r\n| 15 | Machines n.e.c. |\r\n| 16 | Photographic, cinematographic and optical apparatus |\r\n| 17 | Musical instruments |\r\n| 18 | Printing and office machinery |\r\n| 19 | Stationery, office equipment, art materials, teaching materials |\r\n| 20 | Sales and advertising equipment, signs |\r\n| 21 | Games, toys, tents and sports goods |\r\n| 22 | Arms, pyrotechnic articles, hunting/fishing/pest-killing articles |\r\n| 23 | Fluid distribution, sanitary, heating, ventilation, air-conditioning equipment, solid fuel |\r\n| 24 | Medical and laboratory equipment |\r\n| 25 | Building units and construction elements |\r\n| 26 | Lighting apparatus |\r\n| 27 | Tobacco and smoking supplies |\r\n| 28 | Pharmaceutical/cosmetic products, toilet articles and apparatus |\r\n| 29 | Devices and equipment against fire, for accident prevention and rescue |\r\n| 30 | Articles for care and handling of animals |\r\n| 31 | Machines and apparatus for preparing food or drink n.e.c. |\r\n| 32 | Graphic symbols, logos, surface patterns, ornamentation, interior/exterior arrangements |\r\n| ALL | All categories |\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /ruiguan/detectionPatentDesign`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/ruiguan_detection_patent_design.py '<JSON 参数>' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-detection-patent-design-<timestamp>.json`（`<cwd>` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`<session>` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## Local Image Upload\r\n\r\nThis tool requires a **publicly accessible image URL**. If the user provides a local image file path (e.g., `C:\\Users\\...\\photo.png`, `/home/.../image.jpg`), you must upload it first to obtain a public URL.\r\n\r\nRun the upload script:\r\n```bash\r\npython scripts/upload_image.py /path/to/local/image.png\r\n```\r\n\r\nThe script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.\r\n\r\n## Usage Examples\r\n\r\n**1. Basic patent check for a product image (US market)**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 50,\r\n  \"regions\": \"US\"\r\n}\r\n```\r\n\r\n**2. Multi-region check with product context**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"physical\",\r\n  \"topNumber\": 100,\r\n  \"regions\": \"US,EU,CN\",\r\n  \"productTitle\": \"Portable Wireless Charger Stand\",\r\n  \"productDescription\": \"A foldable wireless charging stand for smartphones\",\r\n  \"enableRadar\": true\r\n}\r\n```\r\n\r\n**3. Narrowed search using LOC classification (furniture)**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/chair.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 80,\r\n  \"regions\": \"US,DE\",\r\n  \"topLoc\": \"06\",\r\n  \"patentStatus\": \"1\"\r\n}\r\n```\r\n\r\n**4. Line drawing mode for sketch-based search**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/sketch.png\",\r\n  \"queryMode\": \"line\",\r\n  \"topNumber\": 50,\r\n  \"regions\": \"CN,JP,KR\"\r\n}\r\n```\r\n\r\n**5. Check both active and expired patents**\r\n```json\r\n{\r\n  \"imageUrl\": \"https://example.com/product.jpg\",\r\n  \"queryMode\": \"hybrid\",\r\n  \"topNumber\": 100,\r\n  \"regions\": \"US\",\r\n  \"patentStatus\": \"1,0\"\r\n}\r\n```\r\n\r\n## Display Rules\r\n\r\n1. **High-risk patent highlighting**: When generating summaries or reports, display ALL patents with `similarity >= 0.7` or `troCase = true` in full detail. For each such patent, include: application number, patent title (Chinese), inventors, TRO enforcement history, the most-similar patent drawing, every image in the patent image list, patent abstract, patent specification, LOC info, radar analysis result, and specification text. This detailed presentation is critically important -- do NOT abbreviate or omit these fields.\r\n2. **Disclaimer**: Always append a friendly reminder at the end: \"This detection result is generated by LinkfoxAgent. It is recommended to consult a professional IP attorney for legal advice.\"\r\n3. **Similarity interpretation**: Clearly explain that higher similarity scores indicate greater visual resemblance and higher infringement risk.\r\n4. **Radar result display**: When `radarResult.same` is true, prominently flag the patent as a suspected infringement match and display the `exp` explanation.\r\n5. **TRO warning**: Patents with `troCase = true` or `troHolder = true` should be highlighted with a warning, as they indicate the patent holder has a history of active enforcement via Temporary Restraining Orders.\r\n6. **Image display**: Show both `patentImageUrl` (the most similar patent drawing) and the full `images` list so users can visually compare their product against all patent drawings.\r\n7. **Error handling**: When a request fails, explain the issue and suggest corrective actions (e.g., check image URL accessibility, verify region codes).\r\n8. **Present data faithfully**: Show query results as-is without adding subjective legal conclusions beyond the tool's own analysis.\r\n## User Expression & Scenario Quick Reference\r\n\r\n**Applicable** -- Design patent risk assessment:\r\n\r\n| User Says | Scenario |\r\n|-----------|----------|\r\n| \"Check if this product infringes any design patents\" | Basic patent detection |\r\n| \"Patent risk check for this image\" | Image-based patent search |\r\n| \"Does this product have TRO risk\" | TRO enforcement history lookup |\r\n| \"Design patent search for US and EU\" | Multi-region patent detection |\r\n| \"Check appearance patent for this furniture\" | Category-specific patent search |\r\n| \"Is this product design safe to sell\" | Pre-listing patent clearance |\r\n| \"Find similar design patents\" | Similarity-based patent discovery |\r\n| \"Patent infringement analysis\" | Comprehensive patent risk report |\r\n\r\n**Not applicable** -- Needs beyond design patent detection:\r\n- Utility patent or invention patent searches\r\n- Trademark infringement checks\r\n- Copyright/DMCA issues\r\n- Legal case management or litigation strategy\r\n- Patent application or filing assistance\r\n- Product listing optimization or pricing\r\n\r\n**Boundary judgment**: When users mention \"patent check\" or \"IP risk\", if the concern is about product appearance/design similarity to existing patents, this skill applies. If they are asking about utility patents, trademarks, copyrights, or need actual legal counsel, this skill does not apply.\r\n\r\n\r\n**Feedback:**\r\n\r\nAuto-detect and report feedback via the Feedback API when any of the following apply:\r\n1. The functionality or purpose described in this skill does not match actual behavior\r\n2. The skill's results do not match the user's intent\r\n3. The user expresses dissatisfaction or praise about this skill\r\n4. Anything you believe could be improved\r\n\r\nCall the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.\r\n---\r\n*For more high-quality, professional cross-border e-commerce skills, set [LinkFox Skills](https://skill.linkfox.com/).*\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1783061644233\n}\n\nFile v1.0.1:references/api.md\n\n# 睿观-外观专利检测 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_AGENT_API_URL}/ruiguan/detectionPatentDesign`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: <api_key>`，api_key 从环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）读取（如未配置，提示用户前往 https://skill.linkfox.com/linkfoxskills/guide.htm 申请）\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 | 认证失败 | 检查请求头 `Authorization` 是否正确携带 API Key；API Key 申请方式请参考上述[调用规范](#调用规范)下的认证方式。|\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\n---\n\n## Feedback API\n\n> This endpoint is **separate** from the tool API above. Do not mix the two base URLs.\n\n- **POST** `https://skill-api.linkfox.com/api/v1/public/feedback`\n- **Content-Type:** `application/json`\n\n```json\n{\n  \"skillName\": \"linkfox-xxx-xxx\",\n  \"sentiment\": \"POSITIVE\",\n  \"category\": \"OTHER\",\n  \"content\": \"Results were accurate, user was satisfied.\"\n}\n```\n\n**Field rules:**\n- `skillName`: Use this skill's `name` from the YAML frontmatter\n- `sentiment`: Choose ONE — `POSITIVE` (praise), `NEUTRAL` (suggestion without emotion), `NEGATIVE` (complaint or error)\n- `category`: Choose ONE — `BUG` (malfunction or wrong data), `COMPLAINT` (user dissatisfaction), `SUGGESTION` (improvement idea), `OTHER`\n- `content`: Include what the user said or intended, what actually happened, and why it is a problem or praise","readmeExcerpt":"Skill: 睿观-外观专利检测 Owner: linkfox-ai Summary: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-14T05:23:23.257Z | user Update from 1.0.6 t","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"python scripts/upload_image.py /path/to/local/image.png"},{"language":"json","snippet":"{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 50,\n  \"regions\": \"US\"\n}"},{"language":"json","snippet":"{\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}"},{"language":"json","snippet":"{\n  \"imageUrl\": \"https://example.com/chair.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 80,\n  \"regions\": \"US,DE\",\n  \"topLoc\": \"06\",\n  \"patentStatus\": \"1\"\n}"},{"language":"json","snippet":"{\n  \"imageUrl\": \"https://example.com/sketch.png\",\n  \"queryMode\": \"line\",\n  \"topNumber\": 50,\n  \"regions\": \"CN,JP,KR\"\n}"},{"language":"json","snippet":"{\n  \"imageUrl\": \"https://example.com/product.jpg\",\n  \"queryMode\": \"hybrid\",\n  \"topNumber\": 100,\n  \"regions\": \"US\",\n  \"patentStatus\": \"1,0\"\n}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-ruiguan-detection-patent-design\ndescription: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。\n---\n\n# Ruiguan Design Patent Detection\n\nThis skill guides you on how to perform design patent infringement detection using the Ruiguan engine, helping e-commerce sellers and IP professionals identify potential design patent risks before listing products.\n\n## Core Concepts\n\nDesign patent detection compares a product image against a global design patent database using visual similarity algorithms. The system returns patents ranked by similarity score, along with TRO (Temporary Restraining Order) litigation history, helping users assess infringement risk.\n\n**Similarity score**: A value between 0 and 1. Higher values indicate greater visual resemblance to the patent drawing. Patents with `similarity >= 0.7` or those flagged with TRO enforcement history deserve special attention and should be reviewed carefully.\n\n**Radar analysis**: When radar is enabled, each patent result includes a `radarResult` with a `same` flag (suspected infringement: true/false) and an `exp` field (explanation). This provides an AI-powered judgment beyond raw similarity.\n\n**LOC classification**: The Locarno Classification (LOC) is an international system for categorizing industrial designs. You can optionally specify LOC codes to narrow the search scope, or leave it unset to let the model predict the appropriate categories automatically.\n\n## Parameters Guide\n\n| Parameter | Required | Default | Description |\n|-----------|----------|---------|-------------|\n| imageUrl | Yes | - | Product image URL to check against the patent database |\n| queryMode | Yes | hybrid | Search mode: `physical` (real product photo), `line` (line drawing), `hybrid` (combined) |\n| topNumber | Yes | 100 | Number of patent results to return (max 100) |\n| regions | No | US | Country/region codes, comma-separated for multiple (e.g., `US,EU,CN`) |\n| productTitle | No | - | Product title for supplementary context |\n| productDescription | No | - | Product description for supplementary context |\n| patentStatus | No | 1 | Patent validity: `1` (active), `0` (expired), `1,0` (both) |\n| enableRadar | No | true | Enable AI radar analysis for suspected infringement judgment |\n| topLoc | No | - | LOC level-1 codes to restrict search scope (e.g., `06,07`). Omit to use auto-prediction |\n| sourceLanguage | No | - | Source language code for translation (e.g., `zh-CN`). Leave empty if text is already in English |\n\n### Supported Regions\n\nUS (United States), EU (European Union), CN (China), JP (Japan), KR (South Korea), DE (Germany), GB (United Kingdom), FR (France), IT (Italy), AU (Australia), CA (Canada), BR (Brazil), MX (Mexico), IN (India), TH (Thailand), SE (Sweden), CH (Switzerland),"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n  \"slug\": \"linkfox-ruiguan-detection-patent-design\",\n  \"version\": \"1.0.7\",\n  \"publishedAt\": 1789363403257\n}"},{"path":"references/api.md","content":"# 睿观-外观专利检测 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 的 **##"},{"path":"references/onboarding.md","content":"# 解决认证和算力问题\n\n调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。\n\n**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。\n1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册\n2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册\n3. 手机号路径：\n   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements\n   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`\n   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：\n     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY \"<key>\"`\n     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.zshrc && source ~/.zshrc`\n     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY=\"<key>\"' >> ~/.bashrc && source ~/.bashrc`\n     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可\n\n**billing 场景**：`errcode=402` 或消息含 `算力/余额/quota/insufficient/充值/套餐到期`。\n- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选\n- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）\n- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）\n- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询\n\n排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。"},{"path":"skill-card.md","content":"## Description:\n\nChecks product images with LinkFox Ruiguan design-patent detection to surface visually similar patents, TRO enforcement signals, similarity scores, and AI radar analysis across supported regions.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[linkfox-ai](https://clawhub.ai/user/linkfox-ai)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nE-commerce sellers, IP professionals, and agents use this skill to check product image URLs or local product images for design-patent similarity, TRO enforcement signals, and region-scoped risk indicators before listing or reviewing products.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Local product images may be uploaded to a public URL for patent checking.\n\nMitigation: Use only images and product details that may be shared with LinkFox and potentially exposed through a public image URL; avoid confidential or regulated images.\n\nRisk: API keys, account details, billing actions, or order data may appear in logs or transcripts during onboarding and payment flows.\n\nMitigation: Use onboarding and billing commands only when account management is intended, minimize transcript exposure, and rotate any API key that appears in logs or shared conversations.\n\nRisk: Patent-check responses and sensitive product details are written to local session data files.\n\nMitigation: Review saved LinkFox data directories before sharing a workspace or transcript, and delete files that contain confidential product or account information when no longer needed.\n\nRisk: Detection output can support risk assessment but is not legal advice.\n\nMitigation: Treat similarity scores, TRO signals, and radar analysis as screening indicators and consult a qualified IP attorney before making legal or commercial decisions.\n\n## Reference(s):\n\n- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-ruiguan-detection-patent-design)\n- [LinkFox Publisher Profile](https://clawhub.ai/user/linkfox-ai)\n- [Ruiguan API Reference](artifact/references/api.md)\n- [Authentication and Billing Onboarding](artifact/references/onboarding.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, JSON, guidance]\n\n**Output Format:** [Markdown guidance with JSON API parameters, shell commands, and saved JSON response files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Full API responses are saved to LinkFox session data directories; large responses are summarized unless inline output is requested.]\n\n## Skill Version(s):\n\n1.0.7 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。 Skill: 睿观-外观专利检测 Owner: linkfox-ai Summary: 基于睿观的外观专利侵权检测，支持25+国家/地区的图片专利检索。当用户提到外观专利检测、专利侵权检查、专利风险分析、TRO案件查询、外观设计专利搜索、设计专利相似度、产品专利排查、design patent detection, patent infringement, design patent, TRO cases, patent risk, patent search, Ruiguan时触发此技能。即使用户未明确提及\"外观专利\"，只要其需求涉及检查产品图片是否可能侵犯已有的外观设计专利，或提到侵权、专利、TRO、外观专利等关键词，也应触发此技能。 Tags: latest:1.0.7 Version history: v1.0.7 | 2026-09-14T05:23:23.257Z | user Update from 1.0.6 t","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1434,"uniquenessScore":52,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T19:17:46.584Z","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-11T19:17:46.584Z","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-13T08:02:08.675Z","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"}]}}}