联调工具与 AI 助手

曹操开放平台为接入方提供一套联调工具：一个云端 AI 助手（打开网页就能用）和一个本地命令行工具 cop-cli（可以自己敲、也可以交给你本地的 AI 助手来敲）。 它们解决的是同一件事——把"读文档、写代码、跑通一单"这条路变短。

---

一、它解决什么问题

对接开放平台，过去最费时间的往往不是写业务逻辑，而是这些：

你会遇到的	过去怎么办	现在怎么办
接口文档很长，不知道从哪读起	通读全部文档，靠自己拼出流程	直接问一句「这个流程要调哪几个接口」，助手给出接口和出处
签名一直算不对，报签名错误	反复比对文档里的示例代码	用签名对拍命令，一眼看出待签串哪里不一样
想试一单，要先写完整个下单程序	先写代码，写完才知道参数对不对	一条命令就能下单，参数对不对立刻知道
叫了单但没司机接，不知道查什么	群里发问，等人回	助手按检查清单逐项排除：城市、车型、在线状态、位置
接口权限没开通，调用报未授权	提工单等开通	自己一条命令开通
需要跑「司机举手后再确认接单」的流程	手写脚本抢 7 秒窗口	助手在同一次动作里等待并确认，不会超时

一句话：能问、能跑、能自己解决，把联调从"读文档 + 等回复"变成"边问边跑"。

提醒：所有联调都在沙箱环境进行，不产生真实费用、不派真实司机。线上验证仍需按 接入流程 走正式应用流程。

---

二、三种形态，挑一种就行

不确定选哪个，看这张表：

你的情况	建议
刚开始了解，想先问几个问题	云端 AI 助手
不想在本机装任何东西	云端 AI 助手
想快速验一单，看看流程长什么样	云端 AI 助手
要把联调写进脚本、放进流水线反复跑	本地命令行
要精确控制每一个参数、看原始返回	本地命令行
正在写对接代码，想边写边调	本地 AI 助手 + 技能
想让 AI 直接在你的工程里生成对接代码	本地 AI 助手 + 技能

三种形态互不冲突，随时可以换，也可以混着用。

分别怎么用，见：

• 云端 AI 助手——打开网页就能用，不装任何东西
• 本地联调：cop-cli 与本地 AI 助手——安装、走通一单、开接口权限、造沙箱司机，以及两份技能

---

三、常见问题

三种形态到底选哪个？ 先用云端 AI 助手把问题问清楚；开始写代码时装 cop-cli；本机已有 AI 编程助手就再跑一次 cop-cli skill setup。

联调会产生真实费用吗？会派真实司机吗？ 不会。全程在沙箱环境，司机是你自己造的沙箱测试司机，计价规则也是虚拟数据。线上以真实计价规则为准。

和网页版在线调试页是什么关系？ 互补。网页版适合单个接口点一下看返回，见 在线调试；这里介绍的工具适合跑完整流程和自动化。

助手答不上来怎么办？ 它会明确说答不上来并引导你提工单。工单入口：开发者管理中心 → 应用 → 问题反馈。提工单时先点分享按钮，把对话链接一起贴上，对接人能直接看到完整过程，定位快很多。这类问题也会被收集起来补进知识库，所以如实提问比自己猜答案更有价值。

分享链接能撤销吗？ 不能手动撤销，7 天后自动过期。在此之前拿到链接的人都能查看，所以别往公开渠道发。

cop-cli 支持哪些系统？ macOS（Intel / Apple Silicon）、Linux、Windows。

装完技能后，我的代码或凭据会被上传吗？ 不会。cop-cli 在你本机运行，登录凭据存在本机的系统凭据存储里。技能内容内嵌在程序里，安装时不联网。