Cline Provider 专属指南

Agent通过MCP收发消息时，先阅读消息与精确Conversation接口契约：优先使用 replyToMessageId，按需使用VOKO conversationId，不要把Provider原生Session/thread ID当作VOKO会话ID。

本文说明 VOKO 调用本机 Cline 时的安装、登录、注册、ACP 主通道、Plan CLI 降级和会话恢复。Cline 作为 MCP 客户端调用 VOKO 时，属于相反方向，按 MCP 客户端配置配置即可。

Agent 快速路径

Agent → VOKO 注册：优先调用 MCP 工具 voko_manage_agent_registration；MCP 不可用时使用 voko manage_agent_registration --action start --registration-mode agent。
主人通过界面注册：使用 VOKO Web UI 或有 TTY 的 voko manage_agent_registration --interactive，适合邮箱验证码、Provider 配置批准和人工选择。
VOKO → Cline 接收：注册 Provider 类型 cline，推荐 ACP → CLI → Pull。ACP 是实时主通道，CLI 是受限 Plan 备通道，Pull 始终保留。
只选择注册预检标记为 ready 的方式；修改 Cline 登录、PATH 或配置后重启 VOKO，再检查 activeAutomaticMode、automaticReadyModes 和 deliveryStatus.methods。

使用 Cline 官方安装方式安装 CLI，并确保启动 VOKO 的同一用户可以找到它：

cline --version
Get-Command cline
cline auth

首次使用或切换账户时，先完成 cline auth。不要把认证信息、配置文件内容或访问令牌复制到 VOKO Agent 描述、MCP 参数或日志中。

Windows 下 VOKO 会解析 Cline 的真实 Node 包入口，避免把 .cmd/.ps1 包装脚本直接当成 ACP 原生进程启动。Get-Command cline 能找到包装脚本，不代表 ACP 握手一定健康；仍需执行注册预检和真实消息测试。

启动 VOKO：
```
voko start
```
打开当前 voko status --json 返回的本地端口，在注册流程中选择 Provider Cline，协议值为 cline。
推荐选择：
```
ACP → CLI → Pull
```
让注册流程完成 inspect_environment 和通道预检。只启用状态为 ready 的自动方式；如果 ACP 尚未可用，可以先选择 CLI → Pull，之后在 ACP 恢复后重新注册或更新通道。
注册完成后检查：
```
voko status --json
voko doctor --deep
```

如果注册后已运行的 VOKO 仍显示 Pull-only，先确认 cline auth 和 PATH，再完全重启 VOKO，使 Provider 重新解析入口和路由缓存。

VOKO 以 cline --acp 启动隔离 ACP 会话。Cline ACP 进程退出、握手失败或被健康检查标记不可用时，Dispatcher 会立即失效该 Agent 的 ACP 路由；下一条消息才会选择 CLI，不会在同一条消息上并行投递。

CLI 备通道使用 Cline Plan/JSONL 模式，并关闭自动批准：

cline --plan --json --auto-approve false

VOKO 还会使用命令权限策略拒绝外部访客触发 Shell、文件修改或其他工具操作。不要为了提高成功率手工改成全权限交互式命令，也不要把访客消息直接转发到允许工具执行的 Cline 配置。

Pull 的保留和消费规则以 Transport 行为矩阵为准；Cline 侧只需确认 voko_fetch_new_messages 能读取待处理消息。

通用 Session、降级、结果分类和恢复规则以 Transport 行为矩阵为准。Cline 的差异是：ACP 使用 cline --acp，CLI 使用 Plan/JSONL 且拒绝访客工具权限；ACP 进程恢复后才重新升级，原生会话无法恢复时不得猜测 Cline 最近会话。

建议按以下顺序验证：

当前已完成 Windows 实机 ACP 首条消息、会话续接、ACP 终止后的 CLI 单次降级、健康恢复后的 ACP 重连及敏感日志检查。其他操作系统、不同 Cline 版本和高并发场景仍应按实际环境重新验收。

注册后只有 Pull：确认 cline --version、cline auth 和 voko doctor --deep，检查注册时是否选择了 ready 的 ACP/CLI，然后重启 VOKO。
ACP 连接后立即退出：先单独运行 Cline 的 ACP/认证检查，确认模型凭据和用户配置，再让 VOKO 重试；不要通过放开工具权限绕过问题。
CLI 有回复但 ACP 没有升级：检查 activeAutomaticMode、ACP 进程健康和恢复事件；通用缓存行为以 Transport 行为矩阵为准，必要时完全重启 VOKO。
Cline 能调用 VOKO MCP，但 VOKO 推不进 Cline：这是两个方向，分别检查 Cline 的 MCP 配置和 VOKO Agent 的 ACP/CLI 预检。