linkfox-ruiguan-copyright-detection

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Ruiguan Copyright Detection

Ruiguan 版权检测

This skill guides you on how to perform image copyright detection, helping e-commerce sellers and designers identify potential copyright infringement risks before using images.

本技能将指导您如何进行图片版权检测，帮助电商卖家和设计师在使用图片前识别潜在的版权侵权风险。

Core Concepts

核心概念

Copyright detection works by comparing a given image against a database of registered copyrighted works. The system returns visually similar copyrighted images along with key risk indicators such as similarity score, rights owner information, TRO (Temporary Restraining Order) litigation history, and radar-based infringement assessment.

Similarity: A decimal string (e.g.,

"0.85"

) representing how closely the input image matches a copyrighted work. Higher values indicate greater risk.

Radar detection: An additional layer of analysis that provides a binary infringement judgment (

= infringing,

= not infringing). When enabled, each result includes this secondary assessment.

TRO history: TRO (Temporary Restraining Order) is a legal mechanism commonly used in copyright enforcement. Results flagged with TRO history indicate the rights owner has previously pursued legal action, signaling elevated risk.

版权检测通过将给定图片与已登记版权作品的数据库进行比对来实现。系统会返回视觉相似的版权作品，以及关键风险指标，包括相似度得分、权利人信息、TRO（临时限制令）诉讼历史和基于雷达的侵权评估。

相似度：一个十进制字符串（例如

"0.85"

），表示输入图片与版权作品的匹配程度。数值越高，风险越大。

雷达检测：额外的分析层，提供二元侵权判定（

=侵权，

=不侵权）。启用后，每个结果都会包含该二次评估。

TRO历史：TRO（临时限制令）是版权执法中常用的法律机制。带有TRO历史标记的结果表明权利人曾采取过法律行动，意味着风险较高。

Parameters

参数

Parameter	Type	Required	Default	Description
imageUrl	string	Yes	-	URL of the image to check for copyright infringement (max 1000 characters)
topNumber	integer	No	100	Number of results to return (min: 10, max: 200)
enableRadar	boolean	No	true	Whether to enable radar-based infringement detection

参数	类型	是否必填	默认值	描述
imageUrl	string	是	-	待检查版权侵权的图片URL（最多1000字符）
topNumber	integer	否	100	返回结果数量（最小值：10，最大值：200）
enableRadar	boolean	否	true	是否启用基于雷达的侵权检测

Parameter Guidelines

参数指南

imageUrl: Must be a publicly accessible image URL. Supports common image formats. The URL must not exceed 1000 characters.
topNumber: Controls how many matching copyrighted works are returned. Use a smaller number (e.g., 10-20) for quick checks; use the maximum (200) for thorough audits.
enableRadar: When set to
```
true
```
, each result includes a radar-based infringement judgment. Keep enabled for comprehensive analysis; disable only when a faster, similarity-only scan is sufficient.

imageUrl：必须是可公开访问的图片URL，支持常见图片格式，且URL长度不得超过1000字符。
topNumber：控制返回的匹配版权作品数量。快速检查可使用较小数值（如10-20）；全面审核可使用最大值200。
enableRadar：设为
```
true
```
时，每个结果包含雷达侵权判定。全面分析时保持启用；仅需快速相似度扫描时可禁用。

调用方式

API 端点：
```
POST /ruiguan/copyrightDetection
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/ruiguan_copyright_detection.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-copyright-detection-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前 3 条样本）
加
```
--inline
```
强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用

jq

或

ConvertFrom-Json

从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

API 端点：
```
POST /ruiguan/copyrightDetection
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/ruiguan_copyright_detection.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时，需先向用户说明会产生额外消耗。

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-copyright-detection-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在Claude Code中即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入/tmp，若当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后将完整JSON打印到stdout
响应体 > 8 KB：落盘后stdout仅输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度+前3条样本）
加
```
--inline
```
参数强制全量打印到stdout（同样会落盘）

读数据建议：先查看摘要判断是否足够；需要具体字段时，优先使用

jq

或

ConvertFrom-Json

从保存的JSON文件中按需抽取，避免整份JSON进入上下文。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

发生以下异常情况时，采用

references/onboarding.md

中的指引解决问题：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息包含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。

Local Image Upload

本地图片上传

This 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.

Run the upload script:

bash

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

The script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.

本工具需要可公开访问的图片URL。如果用户提供本地图片文件路径（例如

C:\Users\...\photo.png

、

/home/.../image.jpg

），您必须先上传该图片以获取公开URL。

运行上传脚本：

bash

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

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

Usage Examples

使用示例

1. Basic Copyright Check for a Single Image User: "Check if this image has any copyright issues: https://example.com/my-image.jpg" Action: Call with

imageUrl

set to the provided URL, using defaults for other parameters.

2. Quick Scan with Fewer Results User: "Do a quick copyright scan on this product image, I just need the top matches: https://example.com/product.png" Action: Call with

topNumber

set to 10 for faster results.

3. Thorough Audit with Maximum Results User: "I need a full copyright audit on this design: https://example.com/design.jpg" Action: Call with

topNumber

set to 200 for the most comprehensive scan.

4. Similarity-Only Check (No Radar) User: "Just check the similarity of this image against copyrighted works, no need for detailed infringement analysis: https://example.com/photo.jpg" Action: Call with

enableRadar

set to

false

5. Batch Checking (Multiple Images) User: "Check these three images for copyright: url1, url2, url3" Action: Call the API once for each image URL and consolidate results.

1. 单张图片基础版权检查 用户：“检查这张图片是否存在版权问题：https://example.com/my-image.jpg” 操作：调用时将

imageUrl

设为提供的URL，其他参数使用默认值。

2. 快速扫描（返回较少结果） 用户：“快速扫描这张产品图片的版权，我只需要最匹配的结果：https://example.com/product.png” 操作：调用时将

topNumber

设为10以获取更快结果。

3. 全面审核（返回最多结果） 用户：“我需要对这个设计进行完整的版权审核：https://example.com/design.jpg” 操作：调用时将

topNumber

设为200以获取最全面的扫描结果。

4. 仅相似度检查（无雷达检测） 用户：“只需检查这张图片与版权作品的相似度，无需详细侵权分析：https://example.com/photo.jpg” 操作：调用时将

enableRadar

设为

false

。

5. 批量检查（多张图片） 用户：“检查这三张图片的版权：url1, url2, url3” 操作：针对每个图片URL调用一次API，然后整合结果。

Display Rules

展示规则

Present data clearly: Show detection results in a well-structured table. Key columns to display include: similarity score, rights owner, copyright code, radar result, TRO history, and copyright source link.
Highlight high-risk results: When similarity is high (e.g., >= 0.80) or radar detection flags infringement (
```
subRadarResult
```
= 1), clearly mark these as high-risk entries.
TRO warnings: When
```
troCase
```
or
```
troHolder
```
is
```
true
```
, prominently warn the user about existing TRO litigation history associated with the rights owner.
Image previews: When
```
path
```
or
```
pathThumb
```
URLs are available, mention that thumbnail previews of the copyrighted works can be viewed at those URLs.
Result count notice: Inform the user of the
```
total
```
number of matches found. If many results are returned, show the most relevant (highest similarity) entries first.
Error handling: When a request fails, explain the reason and suggest checking that the image URL is publicly accessible and correctly formatted.
No legal advice: Present detection results factually. Do not provide legal conclusions — recommend the user consult legal counsel for definitive copyright assessments.

清晰展示数据：以结构清晰的表格展示检测结果，需显示的关键列包括：相似度得分、权利人、版权编码、雷达检测结果、TRO历史和版权来源链接。
高亮高风险结果：当相似度较高（例如≥0.80）或雷达检测标记为侵权（
```
subRadarResult
```
=1）时，明确将这些条目标记为高风险。
TRO警告：当
```
troCase
```
或
```
troHolder
```
为
```
true
```
时，显著提醒用户该权利人存在已有的TRO诉讼历史。
图片预览：当存在
```
path
```
或
```
pathThumb
```
URL时，告知用户可通过这些URL查看版权作品的缩略图预览。
结果数量通知：告知用户找到的匹配结果总数
```
total
```
。若返回大量结果，优先显示最相关（相似度最高）的条目。
错误处理：请求失败时，说明原因并建议检查图片URL是否可公开访问且格式正确。
不提供法律建议：如实呈现检测结果，不提供法律结论——建议用户咨询法律顾问以获取明确的版权评估。

Important Limitations

重要限制

Image URL required: The tool accepts image URLs only, not local file uploads. The image must be publicly accessible.
URL length: The image URL must not exceed 1000 characters.
Result cap: A maximum of 200 results can be returned per query.
Detection scope: Results are limited to the copyrighted works database maintained by the detection service.

需提供图片URL：本工具仅接受图片URL，不支持本地文件上传，图片必须可公开访问。
URL长度限制：图片URL长度不得超过1000字符。
结果上限：每次查询最多返回200条结果。
检测范围：结果仅限于检测服务维护的版权作品数据库。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Image copyright risk assessment:

User Says	Scenario
"Check if this image has copyright issues"	Basic copyright detection
"Is this image safe to use"	Infringement risk check
"Find similar copyrighted images"	Copyright similarity search
"Does this image have TRO risk"	TRO litigation risk analysis
"Who owns the copyright for this image"	Rights owner lookup
"Copyright audit for product images"	Batch copyright compliance check
"Is this design original or copied"	Originality verification

Not applicable -- Needs beyond image copyright detection:

Trademark or patent searches
Text or music copyright checks
Image editing or modification
Reverse image search for non-copyright purposes
Legal advice or litigation strategy

适用场景——图片版权风险评估：

用户表述	场景
“检查这张图片是否有版权问题”	基础版权检测
“这张图片使用是否安全”	侵权风险检查
“查找相似的版权图片”	版权相似度搜索
“这张图片是否存在TRO风险”	TRO诉讼风险分析
“这张图片的版权归谁所有”	权利人查询
“产品图片版权审核”	批量版权合规检查
“这个设计是原创还是抄袭的”	原创性验证

不适用场景——超出图片版权检测的需求：

商标或专利检索
文本或音乐版权检查
图片编辑或修改
非版权目的的反向图片搜索
法律建议或诉讼策略

积分消耗规则

按动态规则计费：消耗积分 = 雷达检测开启 ? 86.4 : 58.05。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

按动态规则计费：消耗积分 = 雷达检测开启 ? 86.4 : 58.05。

重要：本技能的服务按倍数动态计算，可能一次性消耗大量积分，必须提醒用户，由用户决定是否继续。

反馈：

当出现以下任一情况时，自动通过反馈API检测并上报反馈：

本技能描述的功能或用途与实际行为不符
技能结果不符合用户意图
用户表达了对本技能的不满或赞扬
任何您认为可以改进的地方

按照

references/api.md

中的说明调用反馈API，请勿中断用户流程。

如需更多高质量的专业跨境电商技能，请访问 LinkFox Skills.