sophhub 0.4.19 → 0.4.21

package/skills/didi-ride/src/assets/PREFERENCE.md

@@ -1,58 +1,58 @@
-# 用户偏好设置
-
-> 此文件存储用户的个性化偏好数据，用于优化打车体验。当用户的 query 中没有明确指定时，系统会根据此文件的偏好自动匹配。注意：当起终点是从偏好推断的（非用户明确指定），必须先向用户确认后再执行。
-
-## 优先级说明
-
-1. **用户 query 参数**（优先级最高）：用户在当前对话中明确指定的地址、车型等
-2. **PREFERENCE.md 偏好数据**（优先级次之）：用户预设的个性化偏好
-
-## 地址别名
-
-| 别名 | 地址名称 | 经度 | 纬度 | 城市 |
-| ---- | -------- | ---- | ---- | ---- |
-| 家   |          |      |      |      |
-| 公司 |          |      |      |      |
-
-> 说明：
-> - "家"和"公司"为内置别名，支持"从家到公司"、"打车回家"等经典简化表达。
-> - 此表可自由扩展行数，用户可添加任意别名（如"妈妈家"、"儿子的学校"、"健身房"等）。
-> - **精确优先，语义兜底**：优先精确匹配别名（"家"只匹配"家"，不会匹配"妈妈家"）；无精确匹配时用语义理解（"接孩子"可匹配"儿子的学校"）。
-
-## 场景车型偏好
-
-| 场景   | 偏好车型 | 品类代码 | 说明     |
-| ------ | -------- | -------- | -------- |
-| 上班   |          |          |          |
-| 下班   |          |          |          |
-| 其他   |          |          |          |
-
-> 说明：当用户说"我要上班"或"下班回家"时，自动使用对应的车型偏好
->
-> 品类代码来自 `taxi_estimate` 返回的 `product_category` 字段。常见值：快车=1，特惠快车=201，滴滴轻享=193，专车=8，豪华车=17。
-> ⚠️ 注意：可用车型以 API 实际返回为准，新增车型会自动出现在预估结果中。支持多车型时用英文逗号分隔，如 `1,201`
-
-## 默认偏好
-
-| 配置项     | 值   | 说明 |
-| ---------- | ---- | ---- |
-| 默认车型   |      | 无明确需求时使用 |
-| 叫车手机号 |      | 默认叫车号码 |
-
-## 使用示例
-
-1. **地址别名使用**（语义匹配，精确优先）：
-   - "我要回家" → 精确匹配别名"家"（用户自己的家），不会匹配"妈妈家"
-   - "从家到公司" → 精确匹配"家"为起点，"公司"为终点
-   - "从家去公司" → 同上，"家"= 用户自己的家
-   - "去妈妈家" / "去我妈那儿" → 匹配别名"妈妈家"（需明确含"妈妈"语义）
-   - "送儿子上学" / "接孩子" → 匹配别名"儿子的学校"
-   - "去健身" → 匹配别名"健身房"
-
-2. **场景偏好使用**：
-   - "我要上班" → 自动使用"上班"场景的车型偏好
-   - "下班了" → 自动使用"下班"场景的车型偏好
-
-## 更新日志
-
-- 2026-03-11: 初始化偏好文件
+# 用户偏好设置
+
+> 此文件存储用户的个性化偏好数据，用于优化打车体验。当用户的 query 中没有明确指定时，系统会根据此文件的偏好自动匹配。注意：当起终点是从偏好推断的（非用户明确指定），必须先向用户确认后再执行。
+
+## 优先级说明
+
+1. **用户 query 参数**（优先级最高）：用户在当前对话中明确指定的地址、车型等
+2. **PREFERENCE.md 偏好数据**（优先级次之）：用户预设的个性化偏好
+
+## 地址别名
+
+| 别名 | 地址名称 | 经度 | 纬度 | 城市 |
+| ---- | -------- | ---- | ---- | ---- |
+| 家   |          |      |      |      |
+| 公司 |          |      |      |      |
+
+> 说明：
+> - "家"和"公司"为内置别名，支持"从家到公司"、"打车回家"等经典简化表达。
+> - 此表可自由扩展行数，用户可添加任意别名（如"妈妈家"、"儿子的学校"、"健身房"等）。
+> - **精确优先，语义兜底**：优先精确匹配别名（"家"只匹配"家"，不会匹配"妈妈家"）；无精确匹配时用语义理解（"接孩子"可匹配"儿子的学校"）。
+
+## 场景车型偏好
+
+| 场景   | 偏好车型 | 品类代码 | 说明     |
+| ------ | -------- | -------- | -------- |
+| 上班   |          |          |          |
+| 下班   |          |          |          |
+| 其他   |          |          |          |
+
+> 说明：当用户说"我要上班"或"下班回家"时，自动使用对应的车型偏好
+>
+> 品类代码来自 `taxi_estimate` 返回的 `product_category` 字段。常见值：快车=1，特惠快车=201，滴滴轻享=193，专车=8，豪华车=17。
+> ⚠️ 注意：可用车型以 API 实际返回为准，新增车型会自动出现在预估结果中。支持多车型时用英文逗号分隔，如 `1,201`
+
+## 默认偏好
+
+| 配置项     | 值   | 说明 |
+| ---------- | ---- | ---- |
+| 默认车型   |      | 无明确需求时使用 |
+| 叫车手机号 |      | 默认叫车号码 |
+
+## 使用示例
+
+1. **地址别名使用**（语义匹配，精确优先）：
+   - "我要回家" → 精确匹配别名"家"（用户自己的家），不会匹配"妈妈家"
+   - "从家到公司" → 精确匹配"家"为起点，"公司"为终点
+   - "从家去公司" → 同上，"家"= 用户自己的家
+   - "去妈妈家" / "去我妈那儿" → 匹配别名"妈妈家"（需明确含"妈妈"语义）
+   - "送儿子上学" / "接孩子" → 匹配别名"儿子的学校"
+   - "去健身" → 匹配别名"健身房"
+
+2. **场景偏好使用**：
+   - "我要上班" → 自动使用"上班"场景的车型偏好
+   - "下班了" → 自动使用"下班"场景的车型偏好
+
+## 更新日志
+
+- 2026-03-11: 初始化偏好文件

package/skills/didi-ride/src/package.json

@@ -1,15 +1,15 @@
-{
-  "name": "didi-ride-skill",
-  "version": "1.1.0",
-  "description": "DiDi Ride Skill for OpenClaw - 打车、路线规划、周边搜索",
-  "type": "module",
-  "author": "DiDi MCP Team",
-  "homepage": "https://mcp.didichuxing.com",
-  "keywords": [
-    "didi",
-    "taxi",
-    "mcp",
-    "openclaw",
-    "mobility"
-  ]
-}
+{
+  "name": "didi-ride-skill",
+  "version": "1.1.0",
+  "description": "DiDi Ride Skill for OpenClaw - 打车、路线规划、周边搜索",
+  "type": "module",
+  "author": "DiDi MCP Team",
+  "homepage": "https://mcp.didichuxing.com",
+  "keywords": [
+    "didi",
+    "taxi",
+    "mcp",
+    "openclaw",
+    "mobility"
+  ]
+}

package/skills/didi-ride/src/references/api_references.md

@@ -1,171 +1,171 @@
-# API 文档
-
-## 响应格式说明
-
-所有工具均返回 `content[].text`（自然语言文本）。部分工具（网约车类）额外返回 `structuredContent`（结构化数据）。
-
-- 如果响应中存在 `structuredContent`，优先使用其中的字段做逻辑判断和字段提取
-- 如果没有 `structuredContent`，则解析 `content[].text` 获取所需信息
-
-## 函数签名
-
-```
-/**
-   * 根据用户输入的起点终点坐标，规划骑行通勤方案
-   *
-   * @param destination 终点坐标，格式为：经度,纬度
-   * @param need_geo? 是否需要返回途经的点序列，默认值为true
-   * @param origin 起点坐标，格式为：经度,纬度
-   */
-  function maps_direction_bicycling(destination: string, need_geo?: boolean, origin: string);
-
-  /**
-   * 根据用户起终点经纬度坐标规划以小客车、轿车通勤出行的方案
-   *
-   * @param destination 终点坐标，格式为：经度,纬度
-   * @param need_geo? 是否需要返回途经的点序列，默认值为true
-   * @param origin 起点坐标，格式为：经度,纬度
-   */
-  function maps_direction_driving(destination: string, need_geo?: boolean, origin: string);
-
-  /**
-   * 根据用户起终点坐标，规划综合公交、地铁的通勤方案
-   *
-   * @param city 查询城市（**必须使用完整格式，如"北京市"而非"北京"**）
-   * @param destination 终点坐标，格式为：经度,纬度
-   * @param origin 起点坐标，格式为：经度,纬度
-   */
-  function maps_direction_transit(city: string, destination: string, origin: string);
-
-  /**
-   * 根据用户输入的起点终点坐标，规划步行通勤方案
-   *
-   * @param destination 终点坐标，格式为：经度,纬度
-   * @param need_geo? 是否需要返回途经的点序列，默认值为true
-   * @param origin 起点坐标，格式为：经度,纬度
-   */
-  function maps_direction_walking(destination: string, need_geo?: boolean, origin: string);
-
-  /**
-   * 根据用户传入关键词和位置坐标，搜索出周边的POI地点信息
-   *
-   * @param keywords 搜索关键词
-   * @param location 位置坐标，格式为：经度,纬度
-   * @param max_distance? 搜索半径，单位：米
-   */
-  function maps_place_around(keywords: string, location: string, max_distance?: string);
-
-  /**
-   * 将经纬度坐标转换为地址信息
-   *
-   * @param location 位置坐标，格式为：经度,纬度
-   */
-  function maps_regeocode(location: string);
-
-  /**
-   * 根据用户传入关键词和城市，搜索出相关的POI地点信息
-   *
-   * @param city 查询城市（**必须使用完整格式，如"北京市"而非"北京"**）
-   * @param keywords 搜索关键词
-   * @param location? 位置坐标，格式为：经度,纬度
-   */
-  function maps_textsearch(city: string, keywords: string, location?: string);
-
-  /**
-   * 取消打车订单
-   *
-   * @param order_id 订单ID，从订单创建或查询结果中获取
-   * @param reason? 取消原因，可选参数。例如：不需要了、等待时间太长、临时有事等
-   */
-  function taxi_cancel_order(order_id: string, reason?: string);
-
-  /**
-   * 直接通过API创建打车订单，无需打开任何应用程序界面，系统自动完成整个发单流程
-   *
-   * @param caller_car_phone? 叫车人手机号，如果有就要传递，没有就不传
-   * @param estimate_trace_id 预估流程ID，从预估结果中获取
-   * @param product_category 车型品类标识，从预估结果中获取，传入多个车型时，用英文逗号分割，不要带空格
-   * @returns structuredContent.orderId   订单ID，后续查询/取消订单使用
-   * @returns structuredContent.status    订单初始状态（created）
-   */
-  function taxi_create_order(caller_car_phone?: string, estimate_trace_id: string, product_category: string);
-
-  /**
-   * 查看当前可用的网约车车型，请先获取对应地点的经纬度信息，如果有maps_textsearch的tool，优先使用maps_textsearch进行经纬度的获取。
-   *
-   * @param from_lat 出发纬度，必须从地图相关的工具获取，不能假设
-   * @param from_lng 出发经度，必须从地图相关的工具获取，不能假设
-   * @param from_name 出发地名称
-   * @param to_lat 目的纬度，必须从地图相关的工具获取，不能假设
-   * @param to_lng 目的经度，必须从地图相关的工具获取，不能假设
-   * @param to_name 目的地名称
-   * @returns structuredContent.traceId          预估流程ID，创建订单时必须传入
-   * @returns structuredContent.items[]          可用车型列表
-   * @returns structuredContent.items[].productName     车型名称
-   * @returns structuredContent.items[].productCategory 车型品类代码，创建订单时传入
-   * @returns structuredContent.items[].priceText       预估价格（元）
-   */
-  function taxi_estimate(from_lat: string, from_lng: string, from_name: string, to_lat: string, to_lng: string, to_name: string);
-
-  /**
-   * 根据起点、终点和车型生成打开移动应用或小程序的深度链接，用户点击后将跳转到相应的打车应用完成发单操作
-   *
-   * @param from_lat 出发纬度，必须从地图相关的工具获取，不能假设
-   * @param from_lng 出发经度，必须从地图相关的工具获取，不能假设
-   * @param product_category? 车型品类标识列表，从预估结果中获取，支持多个车型，仅当用户明确指定某个或某些品类时才传递此参数，格式为英文逗号,分割
-   * @param to_lat 目的地纬度，必须从地图相关的工具获取，不能假设
-   * @param to_lng 目的经度，必须从地图相关的工具获取，不能假设
-   */
-  function taxi_generate_ride_app_link(from_lat: string, from_lng: string, product_category?: string, to_lat: string, to_lng: string);
-
-  /**
-   * 获取打车订单对应司机的实时位置经纬度
-   *
-   * @param order_id 打车订单ID
-   */
-  function taxi_get_driver_location(order_id: string);
-
-  /**
-   * 查询打车订单的状态和信息，如司机联系方式、车牌号、预估到达时间
-   *
-   * ⚠️ 重要：此函数单次调用仅返回当前状态。
-   * 单次调用返回当前状态，详见 SKILL.md `### 3.6 查询订单`。
-   *
-   * @param order_id? 订单ID，从创建订单结果中获取，如果有就要传递，如果没有，会查询当前账号下未完成的订单
-   * @returns structuredContent.statusCode  订单状态码（见下表）
-   * @returns structuredContent.statusText  状态文本描述
-   * @returns structuredContent.driver      司机信息（name/phone/carModel/carPlate），接单后可用
-   * @returns structuredContent.map.distanceKm  距离（公里），行程中可用
-   * @returns structuredContent.map.eta         预计剩余时间（分钟），行程中可用
-   * @returns structuredContent.map.phase       当前阶段：to_pickup（前往上车点）| to_dropoff（前往终点）
-   *
-   * 订单状态码：
-   *   0  匹配中（非终态）
-   *   1  司机已接单（非终态）
-   *   2  司机已到达（非终态，里程碑通知）
-   *   3  未知状态（终态）
-   *   4  行程开始（非终态，里程碑通知）
-   *   5  订单完成（终态）✅
-   *   6  订单已被系统取消（终态）✅
-   *   7  订单已被取消（终态）✅
-   *   8  未知状态（终态）✅
-   *   9  未知状态（终态）✅
-   *   10 未知状态（终态）✅
-   *   11 客服关闭订单（终态）✅
-   *   12 未能完成服务（终态）✅
-   */
-  function taxi_query_order(order_id?: string);
-```
-
-Examples:
-
-```bash
-# 设置 MCP_URL 变量
-MCP_URL="https://mcp.didichuxing.com/mcp-servers?key=$DIDI_MCP_KEY"
-
-# 地址解析（city 建议使用完整行政区名称）
-mcporter call "$MCP_URL" maps_textsearch --args '{"keywords":"望京SOHO","city":"北京市"}'
-
-# 价格预估（注意：所有参数值必须加引号，使用字符串格式）
-mcporter call "$MCP_URL" taxi_estimate --args '{"from_lat":"39.9","from_lng":"116.4","from_name":"望京SOHO","to_lat":"39.9","to_lng":"116.4","to_name":"国贸"}'
-```
+# API 文档
+
+## 响应格式说明
+
+所有工具均返回 `content[].text`（自然语言文本）。部分工具（网约车类）额外返回 `structuredContent`（结构化数据）。
+
+- 如果响应中存在 `structuredContent`，优先使用其中的字段做逻辑判断和字段提取
+- 如果没有 `structuredContent`，则解析 `content[].text` 获取所需信息
+
+## 函数签名
+
+```
+/**
+   * 根据用户输入的起点终点坐标，规划骑行通勤方案
+   *
+   * @param destination 终点坐标，格式为：经度,纬度
+   * @param need_geo? 是否需要返回途经的点序列，默认值为true
+   * @param origin 起点坐标，格式为：经度,纬度
+   */
+  function maps_direction_bicycling(destination: string, need_geo?: boolean, origin: string);
+
+  /**
+   * 根据用户起终点经纬度坐标规划以小客车、轿车通勤出行的方案
+   *
+   * @param destination 终点坐标，格式为：经度,纬度
+   * @param need_geo? 是否需要返回途经的点序列，默认值为true
+   * @param origin 起点坐标，格式为：经度,纬度
+   */
+  function maps_direction_driving(destination: string, need_geo?: boolean, origin: string);
+
+  /**
+   * 根据用户起终点坐标，规划综合公交、地铁的通勤方案
+   *
+   * @param city 查询城市（**必须使用完整格式，如"北京市"而非"北京"**）
+   * @param destination 终点坐标，格式为：经度,纬度
+   * @param origin 起点坐标，格式为：经度,纬度
+   */
+  function maps_direction_transit(city: string, destination: string, origin: string);
+
+  /**
+   * 根据用户输入的起点终点坐标，规划步行通勤方案
+   *
+   * @param destination 终点坐标，格式为：经度,纬度
+   * @param need_geo? 是否需要返回途经的点序列，默认值为true
+   * @param origin 起点坐标，格式为：经度,纬度
+   */
+  function maps_direction_walking(destination: string, need_geo?: boolean, origin: string);
+
+  /**
+   * 根据用户传入关键词和位置坐标，搜索出周边的POI地点信息
+   *
+   * @param keywords 搜索关键词
+   * @param location 位置坐标，格式为：经度,纬度
+   * @param max_distance? 搜索半径，单位：米
+   */
+  function maps_place_around(keywords: string, location: string, max_distance?: string);
+
+  /**
+   * 将经纬度坐标转换为地址信息
+   *
+   * @param location 位置坐标，格式为：经度,纬度
+   */
+  function maps_regeocode(location: string);
+
+  /**
+   * 根据用户传入关键词和城市，搜索出相关的POI地点信息
+   *
+   * @param city 查询城市（**必须使用完整格式，如"北京市"而非"北京"**）
+   * @param keywords 搜索关键词
+   * @param location? 位置坐标，格式为：经度,纬度
+   */
+  function maps_textsearch(city: string, keywords: string, location?: string);
+
+  /**
+   * 取消打车订单
+   *
+   * @param order_id 订单ID，从订单创建或查询结果中获取
+   * @param reason? 取消原因，可选参数。例如：不需要了、等待时间太长、临时有事等
+   */
+  function taxi_cancel_order(order_id: string, reason?: string);
+
+  /**
+   * 直接通过API创建打车订单，无需打开任何应用程序界面，系统自动完成整个发单流程
+   *
+   * @param caller_car_phone? 叫车人手机号，如果有就要传递，没有就不传
+   * @param estimate_trace_id 预估流程ID，从预估结果中获取
+   * @param product_category 车型品类标识，从预估结果中获取，传入多个车型时，用英文逗号分割，不要带空格
+   * @returns structuredContent.orderId   订单ID，后续查询/取消订单使用
+   * @returns structuredContent.status    订单初始状态（created）
+   */
+  function taxi_create_order(caller_car_phone?: string, estimate_trace_id: string, product_category: string);
+
+  /**
+   * 查看当前可用的网约车车型，请先获取对应地点的经纬度信息，如果有maps_textsearch的tool，优先使用maps_textsearch进行经纬度的获取。
+   *
+   * @param from_lat 出发纬度，必须从地图相关的工具获取，不能假设
+   * @param from_lng 出发经度，必须从地图相关的工具获取，不能假设
+   * @param from_name 出发地名称
+   * @param to_lat 目的纬度，必须从地图相关的工具获取，不能假设
+   * @param to_lng 目的经度，必须从地图相关的工具获取，不能假设
+   * @param to_name 目的地名称
+   * @returns structuredContent.traceId          预估流程ID，创建订单时必须传入
+   * @returns structuredContent.items[]          可用车型列表
+   * @returns structuredContent.items[].productName     车型名称
+   * @returns structuredContent.items[].productCategory 车型品类代码，创建订单时传入
+   * @returns structuredContent.items[].priceText       预估价格（元）
+   */
+  function taxi_estimate(from_lat: string, from_lng: string, from_name: string, to_lat: string, to_lng: string, to_name: string);
+
+  /**
+   * 根据起点、终点和车型生成打开移动应用或小程序的深度链接，用户点击后将跳转到相应的打车应用完成发单操作
+   *
+   * @param from_lat 出发纬度，必须从地图相关的工具获取，不能假设
+   * @param from_lng 出发经度，必须从地图相关的工具获取，不能假设
+   * @param product_category? 车型品类标识列表，从预估结果中获取，支持多个车型，仅当用户明确指定某个或某些品类时才传递此参数，格式为英文逗号,分割
+   * @param to_lat 目的地纬度，必须从地图相关的工具获取，不能假设
+   * @param to_lng 目的经度，必须从地图相关的工具获取，不能假设
+   */
+  function taxi_generate_ride_app_link(from_lat: string, from_lng: string, product_category?: string, to_lat: string, to_lng: string);
+
+  /**
+   * 获取打车订单对应司机的实时位置经纬度
+   *
+   * @param order_id 打车订单ID
+   */
+  function taxi_get_driver_location(order_id: string);
+
+  /**
+   * 查询打车订单的状态和信息，如司机联系方式、车牌号、预估到达时间
+   *
+   * ⚠️ 重要：此函数单次调用仅返回当前状态。
+   * 单次调用返回当前状态，详见 SKILL.md `### 3.6 查询订单`。
+   *
+   * @param order_id? 订单ID，从创建订单结果中获取，如果有就要传递，如果没有，会查询当前账号下未完成的订单
+   * @returns structuredContent.statusCode  订单状态码（见下表）
+   * @returns structuredContent.statusText  状态文本描述
+   * @returns structuredContent.driver      司机信息（name/phone/carModel/carPlate），接单后可用
+   * @returns structuredContent.map.distanceKm  距离（公里），行程中可用
+   * @returns structuredContent.map.eta         预计剩余时间（分钟），行程中可用
+   * @returns structuredContent.map.phase       当前阶段：to_pickup（前往上车点）| to_dropoff（前往终点）
+   *
+   * 订单状态码：
+   *   0  匹配中（非终态）
+   *   1  司机已接单（非终态）
+   *   2  司机已到达（非终态，里程碑通知）
+   *   3  未知状态（终态）
+   *   4  行程开始（非终态，里程碑通知）
+   *   5  订单完成（终态）✅
+   *   6  订单已被系统取消（终态）✅
+   *   7  订单已被取消（终态）✅
+   *   8  未知状态（终态）✅
+   *   9  未知状态（终态）✅
+   *   10 未知状态（终态）✅
+   *   11 客服关闭订单（终态）✅
+   *   12 未能完成服务（终态）✅
+   */
+  function taxi_query_order(order_id?: string);
+```
+
+Examples:
+
+```bash
+# 设置 MCP_URL 变量
+MCP_URL="https://mcp.didichuxing.com/mcp-servers?key=$DIDI_MCP_KEY"
+
+# 地址解析（city 建议使用完整行政区名称）
+mcporter call "$MCP_URL" maps_textsearch --args '{"keywords":"望京SOHO","city":"北京市"}'
+
+# 价格预估（注意：所有参数值必须加引号，使用字符串格式）
+mcporter call "$MCP_URL" taxi_estimate --args '{"from_lat":"39.9","from_lng":"116.4","from_name":"望京SOHO","to_lat":"39.9","to_lng":"116.4","to_name":"国贸"}'
+```

package/skills/didi-ride/src/references/error_handling.md

@@ -1,68 +1,68 @@
-# 错误处理指南
-
-本文档说明 didi-ride-skill skill 使用过程中可能遇到的错误及解决方案。
-
-> `<skill-dir>` 代表 didi-ride-skill 技能的安装根目录（即 SKILL.md 所在目录），可通过 `openclaw skills info didi-ride-skill` 获取。
-
-## 目录
-
-- [错误处理指南](#错误处理指南)
-  - [目录](#目录)
-  - [统一错误码表](#统一错误码表)
-  - [API 返回 400 错误](#400-错误排查)
-  - [常见问题 (FAQ)](#常见问题-faq)
-  - [获取帮助](#获取帮助)
-
-***
-
-## 统一错误码表
-
-所有 MCP 工具返回的统一错误码对照：
-
-| 错误码 | 说明 | 解决方案 |
-|--------|------|----------|
-| `-32001` | 命中限流 | 请等待一段时间后重试（配额限制按时间窗口重置） |
-| `-32002` | 鉴权失败（`auth failed`） | Key 存在但无效或已过期，执行 `### 3.9 MCP KEY 与配置` 的引导流程（含发送二维码） |
-| `-32010` | 参数验证失败 | 检查参数格式，确保所有值为字符串 |
-| `-32011` | 订单不存在 | 确认订单ID正确 |
-| `-32021` | 预估结果过期 | 重新调用价格预估获取新的 traceId |
-| `-32030` | 不支持订单类型 | 该类型订单不支持此操作 |
-| `-32031` | 订单未支付 | 订单未进入支付状态 |
-| `-32040` | 订单已经取消过了 | 订单已被取消，无需重复操作 |
-| `-32041` | 订单无法被取消 | 司机已接单或订单已完成，无法通过 API 取消 |
-| `-32050` | 内部错误 | 稍后重试，如持续失败请联系客服 |
-| `-32060` | 支付失败 | 检查支付账户状态或更换支付方式 |
-
-***
-
-## 400 错误排查
-
-> 💡 **故障排查**：如果配置后 API 返回 400 错误，请检查：
-> 1. 参数名是否正确（如 `keywords` 而非 `keyword`）
-> 2. 城市名称是否使用完整格式（如 `"北京市"` 而非 `"北京"`）
-> 3. 所有参数值是否为字符串格式（加引号）
-
-***
-
-## 常见问题 (FAQ)
-
-**Q: 为什么说"我要上班"没反应？**
-A: 需要先配置 `assets/PREFERENCE.md` 中的家和公司地址，以及上班场景的车型偏好。
-
-**Q: 预估价格和实际价格不一致？**
-A: 预估价格为参考值，实际费用以行程完成后为准。
-
-**Q: 如何查看历史订单？**
-A: 当前 API 仅支持查询 MCP 渠道未完成订单，历史订单请在滴滴 App 中查看。
-
-**Q: 支持哪些城市？**
-A: 支持滴滴服务覆盖的所有中国大陆城市。
-
-***
-
-## 获取帮助
-
-如果以上方案无法解决问题，请：
-
-1. 检查 [workflow.md](./workflow.md) 确认操作流程
-2. 访问 <https://mcp.didichuxing.com> 获取最新文档
+# 错误处理指南
+
+本文档说明 didi-ride-skill skill 使用过程中可能遇到的错误及解决方案。
+
+> `<skill-dir>` 代表 didi-ride-skill 技能的安装根目录（即 SKILL.md 所在目录），可通过 `openclaw skills info didi-ride-skill` 获取。
+
+## 目录
+
+- [错误处理指南](#错误处理指南)
+  - [目录](#目录)
+  - [统一错误码表](#统一错误码表)
+  - [API 返回 400 错误](#400-错误排查)
+  - [常见问题 (FAQ)](#常见问题-faq)
+  - [获取帮助](#获取帮助)
+
+***
+
+## 统一错误码表
+
+所有 MCP 工具返回的统一错误码对照：
+
+| 错误码 | 说明 | 解决方案 |
+|--------|------|----------|
+| `-32001` | 命中限流 | 请等待一段时间后重试（配额限制按时间窗口重置） |
+| `-32002` | 鉴权失败（`auth failed`） | Key 存在但无效或已过期，执行 `### 3.9 MCP KEY 与配置` 的引导流程（含发送二维码） |
+| `-32010` | 参数验证失败 | 检查参数格式，确保所有值为字符串 |
+| `-32011` | 订单不存在 | 确认订单ID正确 |
+| `-32021` | 预估结果过期 | 重新调用价格预估获取新的 traceId |
+| `-32030` | 不支持订单类型 | 该类型订单不支持此操作 |
+| `-32031` | 订单未支付 | 订单未进入支付状态 |
+| `-32040` | 订单已经取消过了 | 订单已被取消，无需重复操作 |
+| `-32041` | 订单无法被取消 | 司机已接单或订单已完成，无法通过 API 取消 |
+| `-32050` | 内部错误 | 稍后重试，如持续失败请联系客服 |
+| `-32060` | 支付失败 | 检查支付账户状态或更换支付方式 |
+
+***
+
+## 400 错误排查
+
+> 💡 **故障排查**：如果配置后 API 返回 400 错误，请检查：
+> 1. 参数名是否正确（如 `keywords` 而非 `keyword`）
+> 2. 城市名称是否使用完整格式（如 `"北京市"` 而非 `"北京"`）
+> 3. 所有参数值是否为字符串格式（加引号）
+
+***
+
+## 常见问题 (FAQ)
+
+**Q: 为什么说"我要上班"没反应？**
+A: 需要先配置 `assets/PREFERENCE.md` 中的家和公司地址，以及上班场景的车型偏好。
+
+**Q: 预估价格和实际价格不一致？**
+A: 预估价格为参考值，实际费用以行程完成后为准。
+
+**Q: 如何查看历史订单？**
+A: 当前 API 仅支持查询 MCP 渠道未完成订单，历史订单请在滴滴 App 中查看。
+
+**Q: 支持哪些城市？**
+A: 支持滴滴服务覆盖的所有中国大陆城市。
+
+***
+
+## 获取帮助
+
+如果以上方案无法解决问题，请：
+
+1. 检查 [workflow.md](./workflow.md) 确认操作流程
+2. 访问 <https://mcp.didichuxing.com> 获取最新文档