商品识款 Demo

使用 turing-shikuan-mcp 完成商品图片识款。

本 skill 同时覆盖两类内容：

• 首次配置 turing-shikuan-mcp
• 调用 turing-shikuan-mcp 完成识款并按固定格式输出

本 skill 不负责签发 API Key / API Secret，不负责真假鉴定，也不负责质量判断。

配置要求

如果用户已经在 Cursor、OpenClaw 或其他 IDE 中配置过 turing-shikuan-mcp，无需重复配置，可直接使用。

API 凭证

使用前需要准备：

• API Key
• API Secret

推荐通过环境变量提供：

export TURING_SHIKUAN_API_KEY="your_turing_api_key_here"
export TURING_SHIKUAN_API_SECRET="your_turing_api_secret_here"

setup.sh 同时兼容以下通用变量名：

export TURING_API_KEY="your_turing_api_key_here"
export TURING_API_SECRET="your_turing_api_secret_here"

不要把真实密钥直接写进仓库文件或提交到版本控制。

快速开始（首次使用必读）

首次使用前，运行：

bash setup.sh

验证配置

mcporter list | grep turing-shikuan-mcp

如果配置后仍未看到 turing-shikuan-mcp，刷新 MCP 列表或重启客户端后再试。

手动配置示例

如果用户不使用 mcporter，也可以按以下方式手动配置：

{
  "mcpServers": {
    "turing-shikuan-mcp": {
      "url": "https://turing-mcp-server-test.turingsenseai.com/mcp",
      "headers": {
        "x-api-key": "your_turing_api_key_here",
        "x-api-secret": "your_turing_api_secret_here"
      }
    }
  }
}

Quick Start

• 先判断用户需求是否属于“识款”而不是“鉴定”。
• 如果 turing-shikuan-mcp 尚未配置，先引导用户完成配置，不要直接猜测结果。
• 检查用户是否提供了可访问的图片 URL。
• 一旦满足条件，优先调用 turing-shikuan-mcp。
• 从返回结果中提取 kind、brand、series、summary。
• 按固定模板输出，不补写、不猜测、不扩展未返回信息。

适用场景

当用户希望识别商品图片中的以下信息时，触发本 skill：

• 品类
• 品牌
• 系列
• 简要商品信息

典型触发表达包括但不限于：

• 帮我识别这是什么商品
• 这是什么牌子
• 识别一下这个产品
• 看看这张图里的品牌和系列
• 帮我识款

不适用场景

以下需求不属于本 skill 范围：

• 真假鉴定
• 真伪判断
• 是否正品判断
• 质量判断
• 做工判断
• 价值判断

如果用户请求的是“鉴定”“验真”“判断是否正品”，必须明确说明：当前 skill 只负责识款，不负责鉴定。

前置要求

• 本 skill 依赖 turing-shikuan-mcp 可用。
• 当前主要输入为图片 URL，对应输入字段为 image_url。
• 当前主要输出字段为 kind、brand、series、summary。
• 若 turing-shikuan-mcp 未配置，应先执行配置流程，再进行识款。
• 若用户未提供可用于调用的图片 URL，必须明确提示用户提供可访问的图片 URL。
• 若 MCP 不可用、调用失败或未返回有效结果，不要伪造识别内容。
• 不要把“识款”和“鉴定”混为一谈。

执行规则

1. 先检查 turing-shikuan-mcp 是否可用。

   • 如果不可用，先引导用户配置 MCP。
   • 优先引导用户设置环境变量后执行 bash setup.sh。
   • 如果用户已经自行配置过，可直接跳过安装步骤。
   • 在 MCP 未可用之前，不要给出猜测性的识款结果。

2. 判断是否为识款需求。

   • 如果用户目标是识别商品是什么、识别品牌、识别品类、识别系列，继续执行。
   • 如果用户目标是判断真伪、是否正品、质量好坏，明确说明本 skill 不处理该类需求。

3. 检查输入是否满足调用条件。

   • 必须有可访问的图片 URL。
   • 如果没有图片 URL，不继续猜测，不凭常识补全结果。

4. 一旦判断为识款需求，优先调用 turing-shikuan-mcp。

   • 若存在多个工具，优先选择接收 image_url 的识款工具，例如 style_appraisal_from_url。
   • 不要在未调用 MCP 时凭常识猜测品牌、系列或商品名称。
   • 不要根据图片主观推断未返回的信息。

5. 从 MCP 返回结果中提取以下字段：

   • kind
   • brand
   • series
   • summary

6. 字段处理规则：

   • 字段存在但值为空、无法识别时，写“未识别到”
   • 字段未返回时，写“未返回”
   • 不允许编造系列名、品牌名、商品信息
   • 不允许根据 summary 扩展出未返回的数据

7. 输出结果时，始终使用固定模板，保持简洁、结构化、适合中文用户阅读。

输出格式

始终按以下模板输出：

## 识款结果
- 品类：<kind；为空时写“未识别到”，未返回时写“未返回”>
- 品牌：<brand；为空时写“未识别到”，未返回时写“未返回”>
- 系列：<series；为空时写“未识别到”，未返回时写“未返回”>
- 简要说明：<summary；为空时写“未识别到”，未返回时写“未返回”>
- 结果说明：结果来自 turing-shikuan-mcp，仅用于识款，不代表真假鉴定结论。

如果返回字段不完整，则最后一项改为：

- 结果说明：结果来自 turing-shikuan-mcp，仅用于识款，不代表真假鉴定结论。部分字段未返回或未识别到。

异常处理

MCP 未配置或不可用

处理规则：

• 先说明当前无法直接调用 turing-shikuan-mcp
• 优先引导用户设置 API Key / Secret 并执行 bash setup.sh
• 如果用户不用 mcporter，再提供手动 MCP JSON 配置方式
• 在配置完成前，不输出猜测性的识别结果

参考表述：

• 当前还不能直接调用 turing-shikuan-mcp。请先配置 API 凭证并运行 bash setup.sh，配置完成后我再继续识款。

用户没有提供图片 URL

处理规则：

• 明确告知：当前识款依赖图片 URL
• 要求用户补充可访问的图片 URL
• 不要直接输出猜测结果

参考表述：

• 当前识款需要可访问的图片 URL，请提供图片 URL 后我再继续识别。
• 目前我只能基于图片 URL 调用识款能力，暂时不能仅根据文字描述输出识款结果。

图片 URL 无法访问

处理规则：

• 明确说明该 URL 当前无法访问或无法用于调用
• 要求用户更换为可直接访问的图片 URL
• 不输出猜测结果

参考表述：

• 这个图片 URL 当前无法访问，无法完成识款。请提供一个可直接访问的图片 URL 后再试。

MCP 返回字段不完整

处理规则：

• 只输出实际返回的字段
• 空值写“未识别到”
• 缺失字段写“未返回”
• 在结果说明中明确提示“部分字段未返回或未识别到”

用户实际想做真假鉴定

处理规则：

• 直接说明当前 skill 只负责识款，不负责真假鉴定、真伪判断或质量判断
• 如果用户同时需要识别商品信息，可以继续完成识款部分
• 不输出任何真实性结论

参考表述：

• 我可以先帮你识别这件商品的品类、品牌和系列，但当前能力只到识款，不提供真假鉴定结论。

Do / Don't

Do

• 识别到是“识款”需求后，优先调用 turing-shikuan-mcp
• 若 MCP 尚未配置，先引导完成配置，再执行识款
• 仅基于 MCP 实际返回的 kind、brand、series、summary 输出结果
• 对空字段明确写“未识别到”
• 对缺失字段明确写“未返回”
• 在结果说明中持续强调“仅用于识款，不代表真假鉴定结论”

Don't

• 不要在未调用 MCP 时猜测品牌、系列或商品名称
• 不要把识款结果表述成鉴定结果
• 不要根据 summary 扩展出型号、年份、材质、价格、渠道、真伪等未返回信息
• 不要假设用户上传的是某个特定品牌
• 不要在 MCP 不可用时编造识别内容
• 不要把真实 API Key / Secret 写进仓库或示例文件

边界与限制

• 本 skill 当前只做识款，不做真假鉴定
• 不输出真实性结论
• 不对商品是否正品作出判断
• 不根据 summary 扩展出未经返回的数据
• 不假设用户上传的是某个特定品牌
• 当图片不可访问、MCP 不可用或返回不足时，宁可明确说明无法识别，也不要补全猜测