OpenCode ACP 直连控制
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-opencode-acp-control。
技能介绍
要解决什么问题
当你的 AI 助手需要通过 Agent Client Protocol (ACP) 驱动本机上的 OpenCode,而不是靠人工在终端里敲命令时,必须把进程生命周期、会话 ID 和 JSON-RPC 消息流当成一套有状态管线来维护。常见痛点包括:启动后拿不到可靠的 sessionId、流式输出要靠固定间隔轮询拼起来、以及 OpenCode 重启后如何在保留历史的前提下接上旧会话。
技能如何工作
本技能把 OpenCode ACP 交互收成可重复的步骤表。先用 bash 在后台执行 opencode acp,记下 process 的 sessionId;随后按协议发送 initialize 与 session/new,保存返回的 opencodeSessionId。用户提示经 process.write 写入,并以约 2 秒 一次的 process.poll 读取;各行按 JSON 解析,把 session/update 通知累积为回答,直到出现带 stopReason 的响应(如 end_turn、cancelled、max_tokens)。每条出站请求需要自增 messageId,消息体符合 JSON-RPC 2.0 且以 \n 结尾。
恢复会话时执行 opencode session list,让用户点名目标,再 initialize 后调用 session/load(需 cwd 与 mcpServers);加载阶段会把完整对话历史流式回放。升级路径上可用 opencode --version 对比 GitHub latest release,必要时先 process.kill 再重启实例;opencodeSessionId 在进程重启后仍可通过 load 找回。
边界与注意点
轮询最长建议 5 分钟(约 150 次);空轮询表示仍在思考,应继续而非立即判定失败。解析错误可跳过单行;进程退出则需重新拉起并再走 initialize。session/cancel 为通知型调用,不要期待对称 JSON 响应。
使用场景
- 助手需在后台拉起 OpenCode ACP 进程,并把 initialize 与 session/new 返回的会话 ID 存下来供后续写读
- Coding agent 要把用户问题经 process.write 送入 OpenCode,并按 2 秒轮询拼接 session/update 直到 stopReason
- 用户想从 opencode session list 里选一条历史会话,用 session/load 带回完整对话上下文
- 部署环境 OpenCode 版本落后,需要先查版本、停掉旧进程再重启并 load 原有 opencodeSessionId
适合人员
- 通过 Clawdbot 等带 bash/process 工具的集成 agent,要把 OpenCode 当成可编程子进程的工程师
- 维护多轮 OpenCode 编码会话、需要在进程重启后用 session/load 接上历史的自动化作者
- 编写遵循 agentclientprotocol.com 文档、要自管 messageId 与 JSON-RPC 边界的 agent 实现者
- 负责升级本机 OpenCode 二进制、又要避免丢会话 ID 与对话状态的运维或平台同学