用 Grok Build 接入 ACP Runtime#

这节不是“装个 Grok CLI 试试聊天”，而是把 Grok Build 当成一个可接入 Agent 系统的 runtime：能接收任务、流式返回、恢复会话、处理异常，并且不把登录凭据塞进代码仓库。

0. 一句话先讲明白#

Grok Build 可以通过 grok agent stdio 暴露 ACP 风格的结构化事件流。实测到 2026-05-26，grok 0.1.219 (c9b7cdec2) 能在 Docker 里用只读挂载的 ~/.grok 登录缓存跑通 headless JSON、streaming JSON、ACP stdio、session/load 恢复，以及接入 CommHub 的 grok-build-acp runtime E2E。

但这条路还不是“随便接上就生产可用”。你必须处理 4 个工程细节：持久化 Grok 返回的真实 sessionId、过滤 session/load 回放事件、用非回放的 agent_message_chunk 拼最终回复、在 session/cancel 不可用时用进程级中止和重启恢复。

你将学到#

• Grok Build 在 Agent runtime 里的定位
• 为什么这条接入走 ACP-first，而不是只用普通 CLI 输出
• 最小 Docker 探测应该验证哪些能力
• session/new、session/prompt、session/load 的关键状态
• 为什么恢复会话时要忽略 _meta.isReplay
• session/cancel 不可用时怎么设计中止策略
• 上线前的 E2E gate 应该挡住哪些假通过

适合谁#