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