linkfox-ruiguan-image-compliance

Ruiguan 政策合规图像检测

本技能将指导你使用 Ruiguan 政策合规检测工具，识别商品图片中潜在的政策违规问题。该工具会与已知违禁商品数据库进行基于图像的相似度搜索。

核心概念

Ruiguan 政策合规图像检测是一项基于图像的合规筛查服务。提供商品图片 URL 后，它会在已知违规商品数据库中搜索视觉上相似的商品，并按视觉相似度对匹配的违规商品进行排序。

相似度分数（余弦）：取值范围为 0 到 1。数值越高，表示与已知违规商品的视觉相似度越高。分数接近 1.0 意味着商品图片与已标记的违规商品几乎相同。

参数指南

参数	类型	必填	说明	示例
图片 URL	imageUrl	是	要检查的商品图片 URL（最多 1000 个字符）	https://example.com/product.jpg

注意事项：

• 图片 URL 必须可公开访问
• 支持常见图像格式（JPG、PNG 等）
• URL 不得超过 1000 个字符

响应字段

字段	API 名称	说明
匹配总数	total	找到的匹配违规记录数
违规列表	data	匹配的违规商品数组
违规商品图片	pdImgOssUrl	匹配的违规商品图片 URL
相似度分数	cosine	输入图片与违规商品之间的相似度（0~1）
商品标题（英文）	pdTitle	匹配的违规商品英文标题
商品标题（中文）	pdTitleCHNCensored	匹配的违规商品中文标题
检测 ID	detectId	此检测会话的唯一标识符
Token 用量	costToken	此请求消耗的 Token 数量

本地图片上传

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

运行上传脚本：

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

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

使用示例

1. 检查单张商品图片的基本合规情况

Check this product image for policy compliance: https://example.com/images/product-123.jpg

2. 批量检查多张商品图片

Please scan these product images for potential policy violations:
- https://example.com/images/item-a.jpg
- https://example.com/images/item-b.jpg

3. 商品上架前合规筛查

Before I list this product, can you check if the image triggers any policy flags?
Image: https://example.com/new-product.png

显示规则

1. 使用清晰的表格展示结果：列出每项匹配的违规商品及其图片、相似度分数和商品标题
2. 突出显示高相似度匹配项：当余弦分数超过 0.8 时，明确标记该结果为强匹配，提示可能需要进一步关注
3. 包含违规商品图片：如果结果包含 pdImgOssUrl，请显示匹配的违规商品图片，方便用户进行视觉对比
4. 解释分数含义：始终说明相似度分数的含义——数值越高，表示与已知违规商品越相似
5. 错误处理：查询失败时，说明问题所在，并建议检查图片 URL 是否有效且可公开访问
6. 不提供法律建议：客观呈现检测结果，不给出法律结论；提醒用户核实平台政策

重要限制

• 仅检测图像：此工具仅处理图片 URL，不会分析文本描述或商品元数据
• URL 可访问性：检测服务必须能够公开访问图片 URL
• URL 长度限制：图片 URL 不得超过 1000 个字符
• 基于相似度：结果基于视觉相似度，不构成最终的政策判定

用户表达与场景快速参考

适用——基于图像的产品政策合规检查：

用户表达	场景
“检查这张产品图片是否存在合规风险”	单图合规检查
“扫描我的产品图片，查找违反政策的内容”	批量合规筛查
“这张图片是否被标记为违禁产品”	特定违规情况查询
“预先筛查我的商品刊登图片是否存在政策风险”	商品刊登前合规审查
“查找与这张产品图片相似的违规内容”	基于相似度的违规搜索
“这个产品能安全上架吗”	合规风险预检
“帮我检测一下这个图片是否违规”	单图合规检测

不适用——需求超出基于图像的政策合规检测范围：

• 基于文本的产品合规分析
• 通用产品类别分类
• 知识产权／商标侵权
• 专利或版权检测（请使用其他 Ruiguan 技能）

反馈：

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

1. 此技能描述的功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户对这项技能表达不满或称赞
4. 任何你认为可以改进的地方

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

处理大型响应

为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/ruiguan_image_compliance_search.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

将 --out-dir 指定在任何 git 工作树之外（例如，Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。保存的响应可能包含 PII、定价或身份验证敏感数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

此技能提供多个入口脚本：ruiguan_image_compliance_search.py、upload_image.py。传入 --script scripts/<name>.py 以选择所需脚本。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 会提取指定字段；可使用 --limit/--offset 进行切片，并使用 --format json|jsonl|csv|table 指定输出格式。

适合优先采用此模式的情况——根据响应特征自行判断，例如：

• 每条记录的字段较多，或包含不需要的字段
• 批量／分页结果（每次调用返回多个项目）
• 长文本字段（描述、评论、HTML、时间序列）
• 后续步骤会重复使用输出，而不是立即使用

对于较小且仅使用一次的响应，可直接调用主脚本。

⚠️ 预览仅包含截断后的架构和样例，并非完整数据。任何字段级判断都必须通过 read 从保存的文件中读取。

---

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