前言¶
DeepSeek Harness（DSH）擅長規劃、複查和推進對話，但若要執行依賴 Codex CLI 的本地編碼任務，通常需要在 DSH 與終端之間來回切換：手動啓動 Codex、盯進度、再把手寫結果貼回對話。工作流被打斷，長任務也難以在 DSH 重啓後繼續追蹤。
dsh-codex-runner（維護者 halftin，分類：工作流）面向 Windows，讓 DSH 通過插件直接啓動並管理本機 Codex CLI：在當前工作區跑任務、後臺執行、按運行 ID 查狀態或取消、執行中追加指令，並把進展與完整答覆接回 DSH 側。Codex 仍使用你的本地工作區與已有登錄；DSH 負責規劃與驗收，插件負責啓動、監測與控制。
這是什麼¶
一句話：dsh-codex-runner 是 DSH 插件，把 Codex CLI 接入 DSH 工作流，而不是替代 Codex 安裝或賬號登錄。
- 倉庫：halftin/dsh-codex-runner
- 目錄頁：skillhub 插件頁
- 當前版本：
0.5.3-beta（預發行） - 許可：MIT
- 平臺：Windows；Node.js
>=22.23.4；DSH>=0.2.1-rc.3 <0.3.0
插件已收錄社區目錄（DSH Market 使用的獨立站點，與 DeepSeek / 幻方無官方從屬關係），可在 awesome-dsh-plugin 條目 或 Market 中搜索 dsh-codex-runner 獲取同版本發行包。
核心功能¶
下面介紹插件在資料中明確列出的能力。
| 需求 | 插件行爲 |
|---|---|
| 把項目任務交給 Codex | 在當前工作區啓動任務，返回完整最終答覆 |
| 耗時任務 | 支持後臺執行；DSH 重啓後仍可按運行 ID 查詢或取消 |
| 執行中改要求 | 向當前輪發送指令、中斷當前輪，或排隊追加下一輪 |
| 查看進展與歷史 | 查詢執行狀態、賬號額度、當前工作區關聯會話 |
| 執行期間看輸出 | App Server 與 exec 兩種後端可在主聊天區顯示正文與可展開操作（單純顯示不調用模型） |
| DSH 主動監督 | 分批讀取進度、處理原請求問答；可按已有授權調整同一任務（消耗 DSH 模型 token） |
| 權限與配置 | 原生設置頁、完整配置編輯器和可編輯字段註冊表 |
| 可選增強 | 低額度暫停、額度恢復續跑、定時狀態報告（文檔說明會產生額外 token 開銷） |
實時顯示與主動監督默認開啓，可分別關閉。一次 Codex 執行結束不等於用戶目標已完成，結果仍由 DSH 複查；執行記錄保存在當前工作區，插件不復制登錄憑據，也不自動回滾項目改動。
運行關係可概括爲：用戶 ↔ DSH（規劃與驗收）↔ 插件（啓動、監測與控制）↔ Codex CLI（本地工作區執行）。插件通過 Codex App Server 或兼容 CLI 驅動任務；啓動、進程監測、狀態查詢等機械操作不單獨調用模型。
安裝與啓用¶
環境前提：Windows、已安裝的 DSH、已安裝並完成登錄的 Codex CLI。插件不包含 Codex CLI。Node 最低 22.23.4；資料中已驗證 22.23.4 與 24.22.2。
通過 DSH 界面安裝： 打開「插件 → 添加插件」，填寫：
dsh-codex-runner@0.5.3-beta
安裝後按提示啓用插件或重啓 DSH。
通過 CLI 安裝： 將 <profile> 替換爲實際 DSH profile：
dsh plugin --profile <profile> add dsh-codex-runner@0.5.3-beta
若已有預構建包，可安裝本地 .tgz：
dsh plugin --profile <profile> add ./dsh-codex-runner-0.5.3-beta.tgz
也可使用 github:halftin/dsh-codex-runner#v0.5.3-beta 安裝該版本源碼。通過 DSH 安裝插件即可，無需另行 npm install。npm 包名同爲 dsh-codex-runner，next 渠道隨新預發行版更新；上述命令固定安裝 0.5.3-beta。
安裝前建議閱讀倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，與 DSH 生態「一切皆插件」一致，安裝來源與權限範圍應自行確認。
典型用法¶
先做環境檢查，再交任務。
- 在終端執行
codex login，完成 Codex 登錄。 - 在 DSH 中選擇項目工作區，運行
codex_doctor()檢查連接，再用codex_models()查看可用模型。 - 向 DSH 說明目標、範圍和驗收要求；默認使用設置中的模型與思考強度。開啓「DSH 自主選模型與推理強度」後，由 DSH 按任務明確選擇並傳入
model與effort；關閉時必須省略這兩個參數。
對話示例（摘自 README）：
請使用 Codex 修復當前項目中的這個問題，先確認可用模型和思考強度，再執行任務、運行相關檢查並複查結果
需要直接調用工具時，可將佔位符換成實際值：
codex_run(prompt_file="task.md", label="task", detach=true)
codex_status(run_id="<返回的運行 ID>")
codex_say(run_id="<運行 ID>", action="steer", message="補充要求")
codex_cancel(run_id="<運行 ID>")
task.md 爲當前工作區中的任務文件。每次執行返回唯一運行 ID，便於後續查詢、追加或取消。
修改設置¶
在 DSH 中打開該插件詳情頁，修改後點擊底部 保存。主要項包括：默認模型與推理強度、實時顯示與主動監督、沙箱與審批、低額度暫停與自動恢復、定時查詢 Codex 狀態、高級設置（併發、歷史、調試、本機 CLI 路徑）。高級設置中的 編輯完整配置與註冊表 提供表格、註冊表 JSON、配置 JSON 三個頁籤；保存後的參數用於後續新任務，已啓動任務保留啓動時的參數。
「DSH 自主選模型與推理強度」默認爲關；「模型選檔」相關策略仍爲 Beta，細節見倉庫 configuration.md 與 tools.md。
適用場景與注意¶
適合： 已在 Windows 上使用 DSH 做項目規劃與複查，且本機已配置 Codex CLI 的開發者；希望把「交給 Codex 改代碼、跑檢查」留在同一工作區與會話裏，並需要後臺跑、斷線補讀、按 ID 管控的任務。
注意：
- 僅支持 Windows；非 Windows 環境請勿按本文安裝期望可用。
- 主動監督、定時狀態報告、額度相關增強會消耗 DSH 或 Codex 側模型 token，可按設置關閉或按需啓用。
- 插件不代替 Codex 賬號與額度管理；安裝與啓用前請覈對 GitHub 源碼與許可證，並理解插件與 DSH 同進程權限。
問題反饋：GitHub Issues。完整文檔入口見倉庫 docs/README.md。
結尾¶
經過上面的步驟，你可以在 DSH 裏把 Codex 當作可編排的本地執行器：啓動、後臺、查進度、追加指令、讀完整答覆，再由 DSH 做驗收與後續推進。當前預發行版本爲 0.5.3-beta。
- 目錄頁：https://www.skillhub.cn/plugins/halftin/dsh-codex-runner
- 源碼與 README：https://github.com/halftin/dsh-codex-runner
