# didi-ride-skill **Repository Path**: didiopensource/didi-ride-skill ## Basic Information - **Project Name**: didi-ride-skill - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-04-01 - **Last Updated**: 2026-04-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # didi-ride-skill [English](README.en.md) | 中文 【滴滴出行统一入口】处理用户所有出行相关需求，提供完整的打车服务和路线规划功能。 **ClawHub**: [didi-ride-skill-official](https://clawhub.ai/didi/didi-ride-skill-official) > **服务范围**：支持滴滴出行服务覆盖的中国大陆城市。 ## 目录 - [快速开始](#快速开始) - [功能介绍](#功能介绍) - [前置安装](#前置安装) - [MCP 工具](#mcp-工具) - [工作流程](#工作流程) - [使用示例](#使用示例) - [技术支持](#技术支持) --- ## 快速开始 **3 步开始使用：** **Step 1 — 安装 mcporter** ```bash npm install -g mcporter ``` **Step 2 — 获取并配置 MCP KEY** 扫描 [滴滴 MCP 平台](https://mcp.didichuxing.com/claw) 二维码获取 KEY，然后直接告诉 AI： ``` 你: 我的 MCP Key 是 xxxxxx ``` **Step 3 — 开始出行** ``` 你: 帮我打车去北京西站 你: 从国贸到三里屯怎么走 ``` --- ## 功能介绍 ### 打车服务 | 功能 | 说明 | |------|------| | 实时叫车 | 地址解析 → 价格预估 → 车型决策（用户或偏好）→ 创建订单 | | 预约出行 | 创建定时任务，到点后自动发起打车请求 | | 查询订单 | 用户主动发送「查询订单」，单次查询当前状态 | | 查询司机位置 | 逆地址编码，美化输出司机位置信息 | | 取消订单 | 展示订单信息 → 用户确认 → 取消 | | 价格预估 | 获取各车型价格对比 | | 偏好设置 | 记住常用地址（家/公司）、车型偏好、叫车手机号 | ### 路线规划 | 功能 | 说明 | |------|------| | 驾车路线 | 规划小客车/轿车出行方案 | | 公交地铁 | 综合公交、地铁通勤方案 | | 步行路线 | 规划步行出行方案 | | 骑行路线 | 规划骑行出行方案 | | 周边搜索 | 搜索附近的地点、设施 | --- ## 前置安装 ### 1. 获取 MCP KEY **方式 A：扫码获取（推荐，最快）** 打开滴滴出行 App，扫描下方二维码，即可快速获取 MCP KEY： ![滴滴出行APP扫码获取MCP Key](https://s3-yspu-cdn.didistatic.com/mcp-web/qrcode/didi_ride_skill_qrcode.png) **方式 B：访问官网** 访问 [滴滴 MCP 平台](https://mcp.didichuxing.com/claw) 获取 MCP KEY。 ### 2. 安装 mcporter ```bash npm install -g mcporter ``` ### 3. 配置 MCP KEY **方式 A：对话中输入（推荐）** 直接在对话中告诉 AI 您的 MCP KEY，AI 会自动持久化配置： ``` 你: 我的 MCP Key 是 xxxxxx ``` **方式 B：环境变量** ```bash export DIDI_MCP_KEY="YOUR_MCP_KEY_HERE" ``` **方式 C：配置文件** 编辑 `~/.openclaw/openclaw.json`： ```json { "skills": { "entries": { "didi-ride-skill": { "apiKey": "YOUR_MCP_KEY_HERE" } } } } ``` ### 4. 验证配置 ```bash # 检查 Key 是否已配置 echo $DIDI_MCP_KEY # 测试 API 连通性 export MCP_URL="https://mcp.didichuxing.com/mcp-servers?key=$DIDI_MCP_KEY" mcporter call "$MCP_URL" maps_textsearch --args '{"keywords":"西二旗地铁站","city":"北京市"}' ``` --- ## MCP 工具 ### 打车相关 | 工具 | 用途 | |------|------| | `maps_textsearch` | 文本地址解析，获取经纬度坐标 | | `taxi_estimate` | 价格预估，查询可用车型及价格 | | `taxi_create_order` | 创建打车订单 | | `taxi_query_order` | 查询订单状态和司机信息 | | `taxi_get_driver_location` | 获取司机实时位置 | | `maps_regeocode` | 逆地址编码（坐标转地址） | | `taxi_cancel_order` | 取消订单 | | `taxi_generate_ride_app_link` | 生成 App 深度链接（无 API 直发权限时的备选方案） | ### 路线规划相关 | 工具 | 用途 | |------|------| | `maps_direction_driving` | 驾车路线规划 | | `maps_direction_transit` | 公交地铁路线规划 | | `maps_direction_walking` | 步行路线规划 | | `maps_direction_bicycling` | 骑行路线规划 | | `maps_place_around` | 周边搜索 | --- ## 工作流程 ### 打车流程 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 用户发起打车请求 │ │ "我要从国贸去三里屯" │ └──────────────────────────┬──────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Step 1: 地址解析 (maps_textsearch) │ │ - 解析起点：国贸 → (116.458, 39.908) │ │ - 解析终点：三里屯 → (116.455, 39.937) │ └──────────────────────────┬──────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Step 2: 确认起终点 │ │ - 推断地址或多候选结果时，向用户确认起终点 │ │ - 用户明确指定且精确匹配的地点无需确认 │ └──────────────────────────┬──────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Step 3: 价格预估 (taxi_estimate) │ │ - 获取可用车型列表和价格 │ │ - 展示给用户选择（如用户未明确车型） │ └──────────────────────────┬──────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Step 4: 车型决策 │ │ - 用户指定车型或按偏好直发 │ └──────────────────────────┬──────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Step 5: 创建订单 (taxi_create_order) │ │ - 使用用户选择的车型创建订单 │ └──────────────────────────┬──────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Step 6: 输出订单信息 + 提示跟踪 │ │ - 输出订单号、起终点、车型、预估价 │ │ - 提示用户：发送「查询订单」可了解订单状态 │ └──────────────────────────┬──────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Step 7: 发单后自动回查（自动创建 cron） │ │ - 创建 5 分钟后的定时回查任务 │ │ - 到点自动查询订单状态并推送通知 │ └─────────────────────────────────────────────────────────────────┘ ``` ### 订单状态说明 | 状态代码 | 状态文本 | 说明 | |---------|---------|------| | 0 | 匹配中 | 正在为您匹配司机 | | 1 | 司机已接单 | 展示司机信息及距上车点距离/ETA | | 2 | 司机已到达 | 提示前往上车 | | 4 | 行程进行中 | 行程已开始 | | 5 | 订单完成 | 展示费用信息 | | 6 | 订单已被系统取消 | 系统自动取消 | | 7 | 订单已被取消 | 用户取消 | | 3/8-12 | 其他终态 | 显示对应状态描述 | ### 用户确认机制 | 操作 | 确认方式 | |------|----------| | 实时单下单 | 允许用户指定车型或按偏好直发，不必确认 | | 预约出行 | 直接创建 cron（托管叫车需求，到点后发起打车） | | 取消订单 | 展示订单信息 → 等待用户确认 | --- ## 使用示例 ### 打车服务 **基础叫车** ``` 你: 帮我叫个车从北京西站到西二旗地铁站 AI: 正在解析地址... 已找到起点：北京西站 (116.321, 39.894) 已找到终点：西二旗地铁站 (116.297, 40.053) 正在查询价格... 1. 特惠快车: 约 32 元 2. 快车: 约 34 元 3. 专车: 约 54 元 请选择车型，或说"确认"使用推荐车型。 ``` **指定车型** ``` 你: 叫个快车从家到公司 AI: 正在为您呼叫快车... 订单已创建！订单号: qo01uCXI6ojeiD ``` **预约出行** ``` 你: 明天早上8点从家到公司 AI: 已设置定时任务：明天 08:00 到点后将自动发起打车请求。 ``` **查询订单** ``` 你: 查询订单 qo01uCXI6ojeiD AI: 订单号: qo01uCXI6ojeiD 状态: 司机已接单 车牌: 京A·XXXXX 距离: 约 1.2 公里 预计到达: 3 分钟 ``` > 注意：当前仅支持查询进行中的订单，历史订单请在滴滴出行 App 中查看。 **查询司机位置** ``` 你: 司机现在在哪里 AI: 🚗 司机位置信息 📍 位置: 北京市朝阳区建国门外大街1号国贸附近 📏 距您: 约 1.2 公里 ⏱️ 预计到达: 约 3 分钟 ``` ### 路线规划 **驾车路线** ``` 你: 规划从望京SOHO到国贸的驾车路线 AI: 🚗 驾车路线规划 📍 路线: 望京SOHO → 国贸 📏 距离: 约 8.5 公里 ⏱️ 预计: 约 25 分钟 ``` **公交地铁路线** ``` 你: 查一下从北京西站到西二旗的公交地铁路线 AI: 🚌 公交地铁路线 📍 路线: 北京西站 → 西二旗地铁站 ⏱️ 预计: 约 55 分钟 🔄 换乘: 地铁9号线 → 地铁13号线 ``` **步行路线** ``` 你: 从家到地铁站步行要多久 AI: 🚶 步行路线 📍 路线: 家 → 地铁站 📏 距离: 约 800 米 ⏱️ 预计: 约 10 分钟 ``` **骑行路线** ``` 你: 骑车从望京到三里屯怎么走 AI: 🚴 骑行路线 📍 路线: 望京 → 三里屯 📏 距离: 约 6.2 公里 ⏱️ 预计: 约 28 分钟 ``` **周边搜索** ``` 你: 附近有什么咖啡馆 AI: ☕ 周边搜索结果 📍 当前位置周边咖啡馆： 1. 瑞幸咖啡 - 距您约 150 米 2. 星巴克 - 距您约 320 米 3. Manner Coffee - 距您约 580 米 ``` --- ## 技术支持 - 详细工作流程: [SKILL.md](SKILL.md) - API 参考文档: [api_references.md](references/api_references.md) - 错误处理指南: [error_handling.md](references/error_handling.md)