商品识款 Demo
使用 turing-shikuan-mcp 完成商品图片识款。
本 skill 同时覆盖两类内容：
- 首次配置
turing-shikuan-mcp
- 调用
turing-shikuan-mcp 完成识款并按固定格式输出
本 skill 不负责签发 API Key / API Secret，不负责真假鉴定，也不负责质量判断。
配置要求
如果用户已经在 Cursor、OpenClaw 或其他 IDE 中配置过 turing-shikuan-mcp，无需重复配置，可直接使用。
API 凭证
使用前需要准备：
推荐通过环境变量提供：
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 不可用、调用失败或未返回有效结果，不要伪造识别内容。
- 不要把“识款”和“鉴定”混为一谈。
执行规则
-
先检查 turing-shikuan-mcp 是否可用。
- 如果不可用，先引导用户配置 MCP。
- 优先引导用户设置环境变量后执行
bash setup.sh。
- 如果用户已经自行配置过，可直接跳过安装步骤。
- 在 MCP 未可用之前，不要给出猜测性的识款结果。
-
判断是否为识款需求。
- 如果用户目标是识别商品是什么、识别品牌、识别品类、识别系列，继续执行。
- 如果用户目标是判断真伪、是否正品、质量好坏，明确说明本 skill 不处理该类需求。
-
检查输入是否满足调用条件。
- 必须有可访问的图片 URL。
- 如果没有图片 URL，不继续猜测，不凭常识补全结果。
-
一旦判断为识款需求，优先调用 turing-shikuan-mcp。
- 若存在多个工具，优先选择接收
image_url 的识款工具，例如 style_appraisal_from_url。
- 不要在未调用 MCP 时凭常识猜测品牌、系列或商品名称。
- 不要根据图片主观推断未返回的信息。
-
从 MCP 返回结果中提取以下字段：
kindbrandseriessummary
-
字段处理规则：
- 字段存在但值为空、无法识别时，写“未识别到”
- 字段未返回时，写“未返回”
- 不允许编造系列名、品牌名、商品信息
- 不允许根据
summary 扩展出未返回的数据
-
输出结果时，始终使用固定模板，保持简洁、结构化、适合中文用户阅读。
输出格式
始终按以下模板输出：
## 识款结果
- 品类：<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 不可用或返回不足时，宁可明确说明无法识别，也不要补全猜测
