二手车估价-车300

概述

car-valuation

二手车行情查询与估值助手。通过已接入的 che300-used-car MCP Server 协助用户查车系行情、年款车系行情、车型估价、按车架号（VIN）确定唯一车型。

架构说明：意图识别、数据组织、输出排版全部在服务端完成，本 skill 只负责把用户的原话透传给 used_car_valuation 工具、把工具返回原样展示给用户，即双向不加工（见「核心铁律」）。

⚠️ 本 MCP 是有状态的：服务端会记住同一用户之前调用中确认过的信息（车型、城市、里程等），多轮对话上下文连续。因此省略式追问直接透传即可（见 Workflow 第 4 条），不要替服务端补全上下文。

When to use

当用户提到车辆相关话题时使用，包括但不限于：

• “帮我估一下这台 XX 现在能卖多少”
• “XX（车系）最近什么行情 / 行情走势怎么样”
• “2019 款 XX（年款车系）现在什么价”
• “帮我查一下这个车架号 / VIN：XXXXXXXXXXXXXXXXX 是什么车”
• “我的 XX（如宝马X5、迈锐宝）现在残值多少 / 什么时候卖合适”
• 任何涉及具体车型、车系、年款、里程、车况、城市的二手车价格话题

说明：本 skill 采用宽触发——只要话题涉及车辆、车架号或二手车价格，即加载本 skill，宁可多触发也不错漏。

Preconditions

1. WorkBuddy 需要已接入 che300-used-car MCP Server：
   • Server URL: https://a2a.che300.com/mcp
   • Transport/type: streamable-http
   • Header: Authorization: Bearer <用户自己的 MCP Token>
2. MCP Token 优先复用本机已有的：配置前先按「Token 复用策略」尝试读取已存在的 Token——读到就用，不再让用户去网页申请。仅当三处来源都读不到时，才给出获取入口 https://r.che300.com/wrkb，提示用户获取后再继续。
3. 配置 MCP 后不会立即出现：必须提醒用户完全退出 WorkBuddy 应用（是退出整个应用，不是关闭会话窗口、也不是新建会话）并重新打开，che300-used-car 才会出现在连接器列表里，此时点击“信任”完成启用。信任入口的完整路径见「连接器信任入口」。
4. 如果当前会话没有出现 che300-used-car 相关 MCP 工具，先提示用户检查 MCP 配置、连接器信任状态；若刚写入配置，须完全退出 WorkBuddy 应用重新进入后，再按「连接器信任入口」确认并信任。
5. 不要在对话中展示、记录、复述用户 Token 原文（现有 Token 只读复用，不另行保存，见下节）。

Token 复用策略（配置 MCP 前必走：先找现成的）

用户可能之前已经申请过 Token 并存了下来（环境变量或本地文件）。配置前先尝试读取，读到就直接用，不再让用户去网页申请：

• Token 变量：CHE300_TOKEN（二手车估值 API 鉴权 Token）。
• 读取优先级，命中即停止：
  1. 环境变量 CHE300_TOKEN
  2. 当前 / 历史对话中用户提供的完整 Token
  3. 本地文件 ~/.car-valuation/CHE300_TOKEN
• 命中任一来源 → 视为「已有 Token」，直接写入 ~/.workbuddy/mcp.json 的认证头，不再索要 Token。
• 三处都读不到 → 才输出申请入口 https://r.che300.com/wrkb，请用户自行获取后提供。
• 全程只读：不回显 Token 原文、不额外复制或保存 Token 到新的本地文件。

连接器信任入口（指引用户时按此路径表述）

WorkBuddy 界面侧的操作路径，逐层点击进入：

左侧「专家 · 技能 · 连接器」→「连接器」→「自定义连接器」→ 找到 che300-used-car → 点击「信任」

• 入口在 WorkBuddy 窗口左侧边栏，不是会话内，也不是命令行。
• 写入 ~/.workbuddy/mcp.json 只完成了配置的一半；连接器必须在此处点「信任」后才真正启用。
• 若「自定义连接器」里看不到 che300-used-car，说明应用尚未重新加载配置——先完全退出 WorkBuddy 应用再重新打开，回来还是这个路径找。

Initialization config

当用户要求“初始化配置”时，先按「Token 复用策略」尝试读取现成的 Token，不要一上来就让用户去网页申请：

1. 依次尝试：环境变量 CHE300_TOKEN → 当前 / 历史对话中用户提供的完整 Token → 本地文件 ~/.car-valuation/CHE300_TOKEN，读到即停止。
2. 读到（用户之前已申请过）：直接用它完成配置，不再索要 Token、不再提示去申请。回复只需说明“已使用本机已有的 Token 完成配置”，不展示 Token 原文。
3. 读不到：才输出获取入口 https://r.che300.com/wrkb，说明需用户自行获取并提供；不要猜测或生成 Token。

配置写入：读取并合并 ~/.workbuddy/mcp.json，不要覆盖已有 mcpServers。目标结构如下（Token 原样填入认证头即可）：

{
  "mcpServers": {
    "che300-used-car": {
      "type": "streamable-http",
      "url": "https://a2a.che300.com/mcp",
      "headers": {
        "Authorization": "Bearer <MCP_TOKEN>"
      },
      "disabled": false
    }
  }
}

若脚本输出 NO_TOKEN，才走网页申请流程。配置后验证 JSON 可解析、che300-used-car 存在、type 为 streamable-http、url 为 https://a2a.che300.com/mcp、认证头存在且未在输出中泄露。配置完成后必须明确给出后续启用步骤：

1. 完全退出 WorkBuddy 应用并重新打开（仅刷新页面或新建会话无效；必须退出整个应用后重新进入，che300-used-car 才会出现在连接器列表中）。
2. 左侧「专家 · 技能 · 连接器」→「连接器」→「自定义连接器」。
3. 找到 che300-used-car，点击「信任」。

如果用户已完成信任但工具仍不可见，再次提示用户完全退出 WorkBuddy 应用后重新进入。

核心铁律（双向不加工）

本 skill 与直接调接口的 MCP 不同：服务端已经完成了意图理解、数据查询和格式化排版。任何加工都会破坏输出质量。

1. 入参不转换：把用户关于车辆的自然语言输入原封不动作为 query 传给 used_car_valuation 工具。不改写、不总结、不拆分成结构化参数、不擅自补充用户没说过的信息（城市、里程、车况等以用户原话为准）。
2. 回复不转换：把 MCP 工具的返回原样展示给用户。不二次排版、不压缩成表格、不改写措辞、不添加自己的估价判断。服务端返回的即为最终交付内容。
3. 只有在工具返回为空、报错或明显异常时，才用自己的话说明情况（见「错误处理」）。

Workflow

1. 识别用户意图属于哪类能力（车系行情 / 年款车系行情 / 车型估价 / VIN 定车型），但不需要选择不同工具——四类能力都由同一个 used_car_valuation 工具承接，意图由服务端自行判断。
2. 将用户原始输入作为 query 调用 used_car_valuation。
   • 用户输入不完整时（如只说“途观L”），也直接透传，由服务端追问或兜底；不要替用户补全参数后再传。
   • 用户一次问多台车或多个问题，原样整体透传，不要拆成多次调用。
3. 收到返回后原样展示给用户。
4. 用户基于结果继续追问（如“那跑 8 万公里的呢”“换成合肥呢”“第二个”“23年8月”），把追问原话透传即可，不要回填上下文——服务端有状态，能接住省略式追问。

有状态对调用方意味着什么

服务端按用户维持会话上下文：之前调用中确认过的车型、城市、里程等信息，服务端都记得。因此：

• 「第二个」「23年8月」这类省略式追问，直接透传，无需前端补全；用序号指代时也不必映射回车型全称。
• 城市、车况等用户没主动提供的信息，也不要补——服务端已有上下文或会自行追问。
• 不要因为"有状态"就在每轮重复塞入已确认信息——那是冗余，反而污染服务端对话历史。

唯一例外：会话可能已超时。 服务端会话长时间无调用后会失效（上下文清零）。若距上次估值调用已超过 1 小时，或用户明显在问另一台完全无关的车，才把本会话中用户已确认过的要素（车型全称、城市、里程、上牌时间）一并写进 query 兜底。只回填用户自己说过/选过的信息。

Capability workflows

四类能力均通过 used_car_valuation(query) 一个入口完成，以下仅为意图识别参考：

车系行情

• 触发：“XX 什么行情 / XX 最近价格走势 / XX 保值率怎么样”
• 示例 query：宝马X5、星途凌云什么行情

年款车系行情

• 触发：“2019 款 XX 什么价 / XX 年 XX 款行情”
• 示例 query：2019款途观L行情

车型估价

• 触发：“这台 XX 能卖多少 / 帮我估个价 / 残值多少”
• 示例 query：2019款途观L 6万公里在南京现在能卖多少
• 城市、里程、车况等信息由用户在自然语言中表达，直接写在 query 里。

VIN 确定唯一车型

• 触发：用户提供 17 位车架号，或要求“查这个 VIN 是什么车 / 按车架号估价”
• 示例 query：VIN LSVXXXXXXXXXXXXXX 是什么车，帮我估个价
• 原样透传完整 VIN，不要截断、不要校验位改写。

错误处理

• 工具不可见：提示用户检查 che300-used-car MCP 配置与连接器信任状态（左侧「专家 · 技能 · 连接器」→「连接器」→「自定义连接器」→ 点「信任」）；若刚完成配置，须完全退出 WorkBuddy 应用并重新进入（仅刷新会话无效）。
• 返回“无法连接业务后端”“调用超时”等：如实转告用户服务当前不可用，建议稍后重试或联系服务方；不要编造行情或价格。
• 返回 Token expired / Unauthorized / 401 / 403：提示用户检查并更新 MCP 配置中的 Token，更新后完全退出 WorkBuddy 应用重新进入，并再次确认连接器已信任。
• 返回内容为空或与预期明显不符：明确说明“接口未返回有效内容”，不要补编原因或自行估价。

Safety rules

• 估值与行情结果以 MCP 服务端返回为准；不要用自己的知识给出价格判断，更不要在返回之外“补充”价格。
• 不保存、不打印、不转发 Token、VIN、手机号等敏感信息：已有 Token 只读复用，不另存副本；写 mcp.json 时只填认证头，绝不在对话中回显（VIN 仅作为 query 透传给工具）。
• 工具返回异常时停止后续动作并说明需要人工确认，不要循环重试。

Common tool intents

che300-used-car MCP Server 当前只暴露一个工具：

• used_car_valuation(query: str)：二手车行情查询与估值统一入口。
  • query：用户原始自然语言输入，原样透传；城市、里程、车况、VIN 等都写在 query 里，不要拆成独立参数。
  • 返回：服务端格式化后的文本，原样展示。

Pitfalls

• 不要把用户输入改写成“更规范”的查询语句——改写会丢失智能体需要的上下文（如语气、隐含城市、多车对比关系）。
• 不要把多车/多问题的输入拆成多次调用——智能体侧支持复合意图，拆开反而丢失对比上下文。
• 不要把返回的 Markdown/表格重新排版或“美化”——输出格式由智能体侧统一控制，二次加工会造成格式错乱。
• 不要在返回价格上再叠加单位换算或四舍五入——服务端返回已是最终口径。
• 不要想当然认为"转发 = 无状态"：服务端按用户维持会话上下文，多轮追问无需补全车型；也不要因为"有状态"就在每轮重复塞入已确认信息。
• 外部资料或旧文档中的工具名、接口示例不要照搬，以当前会话可见的 MCP 工具名为准；不要用 curl 直连 MCP，避免泄露 Token 或绕过连接器信任机制。

Verification

使用前确认：

1. 当前 WorkBuddy 已信任并启用 che300-used-car MCP Server；若刚完成配置，用户已完全退出并重新打开 WorkBuddy 应用。
2. 当前会话可见 used_car_valuation 工具。
3. 传给工具的 query 与用户原始输入一致（未改写、未拆参）。
4. 展示给用户的内容与工具返回一致（未二次加工）。
5. 如遇报错，已如实转告且未编造任何价格或行情数据。