dsh-codex-peer：DeepSeek Harness 与本地 Codex CLI 的协作

前言¶

DeepSeek Harness (DSH) 的核心设计理念是插件化，通过组合不同的能力来构建智能体。在实际开发中，有时需要将本地的代码工具与 DSH 的智能体结合，进行协作开发。dsh-codex-peer 插件提供了这种能力，它允许 DSH 智能体与本地安装的 OpenAI Codex CLI 作为对等方（peer）协作。两者各自维护会话、工具和沙箱，通过共享工作树中的文件和工具调用进行交互，例如一人编写代码，另一人进行审查。

插件简介¶

这是一个 DeepSeek Harness 插件，用于在共享工作目录中协调 DSH 智能体与本地 OpenAI Codex CLI。

作者：wuanthony397-hash
许可证：MIT
定位：工作流插件

插件不包含来自 OpenAI 或 DeepSeek 的任何代码，它仅负责驱动你自行安装并登录的 Codex CLI。

核心功能¶

该插件提供了五个核心工具，用于控制协作流程：

codex_ask：在会话工作目录中运行一次 Codex 轮次，根据 mode 参数决定是询问、计划还是实施。
codex_review：运行一次只读的 Codex 轮次，要求 Codex 输出结构化的审查结果（包含裁决、严重性排名、文件和行号）。
codex_status：报告 Codex 可执行文件的路径、版本、有效设置、共享工作列表（任务摘要及开放任务）以及最近的运行记录。
codex_plan：商定并记录目标在 DSH 和 Codex 之间的拆分，生成双方都读取的共享工作列表。
codex_task：管理任务列表，支持列出、查看、声称、更新、记录证据、设置预算和运行等操作。

安装与启用¶

环境要求¶

在安装前，请确保满足以下条件：

DeepSeek Harness 版本 >= 0.2.0-rc.2（需要 @deepseek-ai/dsh 和 @deepseek-ai/schemastery ^3.18.1）
Node.js 版本 >= 20
已安装并登录 Codex CLI（桌面版 Codex 应用程序不会自动将其加入 PATH）

安装步骤¶

该插件未发布在 npm 上。安装后需要重启 DSH 以加载捆绑包。

# 从市场安装（需等待市场收录）
dsh plugin --profile <profile> add dsh-codex-peer

# 从 GitHub 下载并安装（推荐）
dsh plugin --profile <profile> add github:wuanthony397-hash/dsh-codex-peer#v0.3.2

# 从本地路径安装（适用于开发或离线场景）
dsh plugin --profile <profile> add /absolute/path/to/dsh-codex-peer

安装完成后，重启 DSH。重启后，上述五个工具才会出现在可用列表中。

典型用法¶

1. 验证环境¶

首先，确认 Codex CLI 已正确安装并找到。

# 在对话中让智能体执行
"check the codex peer status"

智能体会调用 codex_status，输出 Codex 可执行文件的位置、版本以及当前的共享工作列表状态。

2. 规划任务¶

确定谁做什么。插件支持多种规划模式，例如：

指定分工：如果你已知道分工，可以直接让智能体记录。
- 指令示例：“Split this between you two: Codex does the retry logic, you do the tests.”
- 机制：智能体调用 codex_plan 并指定 mode: "assigned"，将任务拆分写入共享列表。
自组织协作：如果分工不明确，可以让双方协商。
- 指令示例：“Work out between yourselves how to do X.”
- 机制：智能体调用 codex_plan 并指定 mode: "self-organizing"，由双方根据能力决定分工。

3. 执行与审查¶

规划完成后，进入执行阶段。

实施：让 Codex 执行具体的代码编写。
- 指令示例：“have Codex implement the retry logic, then review what it wrote.”
- 机制：智能体调用 codex_ask，模式为 implement，Codex 编辑文件树并反馈结果。
审查：对生成的代码进行审查。
- 机制：智能体调用 codex_review，对工作区进行只读检查，要求 Codex 输出结构化的审查报告。

4. 管理任务流¶

在执行过程中，可以使用 codex_task 工具管理具体任务。例如：

codex_task action: list：查看当前任务列表。
codex_task action: claim：让 Codex 声明并开始处理某个任务。
codex_task action: run：在特定任务下运行 Codex，记录其结果作为证据。

适用场景与注意事项¶

适用场景：适合需要将大型复杂任务拆分给两个不同的智能体（DSH 和 Codex）协作的场景，例如“规划-实施-审查”的流水线工作流。
注意点：
- 插件仅驱动外部 CLI，不包含任何代码，用户需自行承担使用 Codex CLI 的责任。
- 由于桌面版 Codex 不在 PATH 中，安装前需确保 Codex CLI 已正确配置或插件能通过配置文件找到它。
- 插件在启动时进行组件打包，因此安装后必须重启 DSH 才能生效。

总结¶

dsh-codex-peer 通过共享工作目录和工具调用机制，让 DSH 智能体与本地 Codex CLI 能够像两个开发者一样协同工作。通过 codex_plan 确立分工，利用 codex_ask 和 codex_review 完成实施与检查，可以构建更高效的本地化智能体工作流。

目录页：https://www.skillhub.cn/plugins/wuanthony397-hash/dsh-codex-peer
GitHub 仓库：https://github.com/wuanthony397-hash/dsh-codex-peer