13个Harness能力矩阵对比：CodexHost如何接入Grok、DeepSeek Harness、OpenCode与Cursor

【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-host

CodexHost 是一个让Codex Desktop 直接运行 Grok、DeepSeek Harness、OpenCode、Cursor等 13 款 AI 编码 Harness 的开源工具。它不重做聊天界面，而是把各家 Harness 的原生接口接进官方桌面端：流式回复、编辑 Diff、Fork、提问、工具审批、Usage 面板全部在同一个窗口里完成。本文用官方能力矩阵逐项对比 13 款 Harness 的差异，并拆解 Grok、DeepSeek Harness、OpenCode、Cursor 四者的接入原理，帮你在 10 分钟内选对工具。

什么是 Harness 能力矩阵

CodexHost 把"能力"拆成 13 个维度：流式响应、工具状态、Edit Diff、提问/取消、Model/Thinking 选择、工具审批、权限模式、跨 Agent 协作、Usage、Fork、上下文压缩、斜杠命令、编辑上条消息。每一项都以官方能力表为准，只统计当前插件真实可调用的能力，不把终端里的功能自动算数。完整边界说明见 docs/harnesses/capability-boundaries.md。

13款Harness矩阵对比：哪些能力全员支持

先看好消息：以下 8 项能力 13 款 Harness全部支持，接入即可用：

• ✅ 流式响应、工具状态
• ✅ Edit Diff（每轮变更可一键展开审阅）
• ✅ 提问与主动取消
• ✅ Model / Thinking 选择
• ✅ 斜杠命令
• ✅ 编辑上条消息

真正的差异集中在剩下 5 项，下面这张表就是选型的关键：

数据来自 README.md 的官方 Feature Matrix（完整 13 款 Harness 逐项 ✅ 版本）。

怎么选？

• 想要"全能型"：Pi、OMP、Claude Code、Grok、DSH 几乎没有短板
• 在意权限模式：避开 Pi（它没有可切换的权限策略，详见 能力边界）
• 在意压缩：避开 AGY 与 Cursor（原生接口未提供出口）
• Kimi Code 的 Fork 是部分支持（◐）

Grok 接入：ACP 加扩展，权限一次定型

Grok 插件（packages/adapters/grok/）基于ACP 协议加私有扩展接入，审批、压缩、Credits、Fork/跨目录 Fork/Rollback 全部打通。

两个使用要点：

1. 权限模式在 Session 创建时固定，不能靠恢复后的配置写入补设（见 插件化架构文档 的差异表）；
2. Subagent 原生投影：Grok 的 spawn/task 工具会映射成桌面端的标准子代理列表，每个子任务有独立图标、可点开完整对话，且不注入任何自定义状态。实现细节见 docs/harnesses/grok/subagent-status-and-model.md。

DeepSeek Harness 接入：不是 Provider，是独立 Harness

很多新手会问：DeepSeek 不是模型厂商吗？为什么单独接入？答案是DeepSeek Harness（DSH）拥有完整的 Agent Loop、工具、沙箱、会话持久化和交互能力，把它塞进 Pi 的模型目录会丢掉它自己的会话与工具语义。所以它作为独立插件存在于 packages/adapters/deepseek-harness/。

接入走官方loopback Web Host HTTP/WebSocket API：CodexHost 优先连上你已启动的 DSH Web，连不上时自动拉起本地dsh web，全程不读取、不改写 DSH 原生日志文件。

DSH 最值得注意的机制是多代会话日志路由：0.1.5-rc.1用 V0/V3 日志，0.1.7-rc.1起升级为 V4 日志，Adapter 按 SemVer 把不同 CLI 版本路由到对应协议 profile，并做独立的 header、Assistant 流块与 Fork 边界校验。每版都跑真实 CLI 生命周期 Gate（托管 Web 启动、流式增量、取消、冷恢复），验证记录见 docs/harnesses/deepseek/dsh-015rc1-validation.md。

OpenCode 接入：双版本 SDK + 原生服务进程

OpenCode 插件（packages/adapters/opencode/）同时支持CLI v1 和 v2 两代：打开会话时探测--version，自动把会话交给对应的原生客户端——v1 走@opencode-ai/sdk的/v2/client导出，v2 走@opencode/clientPromise 客户端，互不混用。

运行机制上，每个会话由 CodexHost 监管一个只监听 loopback 的opencode serve子进程（随机密码、固定用户名opencode），不接你共享的后台服务。能力面覆盖：Model/Thinking/权限切换、/compact压缩、Usage 投影、原生审批与 Question、精确 Fork（用原生before边界，校验语义前缀与源未变）、Rollback。调研与实现全貌见 docs/harnesses/opencode/opencode-harness-integration-analysis.md。

Cursor 接入：实验性 ACP 通道

Cursor 插件（packages/adapters/cursor-cli/）启动cursor-agent acp，通过官方ACP SDK over stdio通信，保留 Cursor 自身的 CLI 认证、原生工具和交互式审批。已实现：流式文本/推理、结构化 Edit Diff、动态模型目录与 Thinking 组合、原生斜杠命令、向外跨 Harness 委派。

它的 Fork 路径最有意思：macOS/Linux 上通过隔离的 CLI 会话副本执行原生/fork，再用/rewind的"仅恢复对话"回退，最后由 ACP 恢复——全程不重写原生消息来合成回滚。

当前限制要心里有数：上下文压缩、Usage 上报暂缺；Windows 上的 Fork/修订尚不支持；无人值守入站委派依赖原生--force（Run Everything），且可能被团队策略静默降级。完整边界见 docs/harnesses/cursor/cursor-cli-experimental.md。

日常怎么用：一个窗口切换所有 Harness

• 切换 Agent：在输入框右下角的 Agent / Model 选择器里切换 Harness，所有会话共享同一条侧边栏
• 跨 Agent 委派：输入#选择目标 Agent，例如"让#claude-code独立审查这个变更"，CodexHost 会在目标 Harness 里开一个独立原生会话并行执行
• 用量总览：上下文占用、缓存命中率、费用估算实时可见

进一步阅读

• 官方功能矩阵与快速上手：README.md
• 各 Harness 能力边界：docs/harnesses/capability-boundaries.md
• 插件化架构（新增 Harness 只需交付插件，不改核心）：docs/architecture/harness-plugin-architecture.md
• 插件源码总目录：packages/adapters/

一句话总结：13 款 Harness 里，8 项能力全员拉满，差异集中在审批、权限、压缩、Fork 与协作五个维度——对照上表，你就能在 10 分钟内挑出最适合自己工作流的那一个。

【免费下载链接】codex-hostRun Pi and Claude Code directly in Codex Desktop. 在 Codex Desktop 中直接运行 Pi 和 Claude Code。项目地址: https://gitcode.com/gh_mirrors/co/codex-host