前言¶

在 DeepSeek Harness（DSH）裏做日常編碼，常見矛盾是：同一會話裏既要純討論、又要只讀審查、又要真改代碼跑驗證，而通用預設往往不分場景，推理預算也固定在一檔。手工切換模型等級、反覆寫「先別改文件」既費 token，也容易和 Agent 的實際工具權限不一致。

DSH Codex Coding（npm 包名 dsh-plugin-codex-coding，顯示名 DSH Codex Coding）由 ygzhang-lab 維護，歸類爲工作流類插件。它把 Codex 風格的交付契約、三種工作流模式、推理等級自動切換和會話內可視化控制收進一個可選預設；不選該預設時，Host 啓動階段不會因插件改變任何 Agent 行爲。

下文介紹插件定位、核心能力、安裝與典型用法。事實依據爲項目 GitHub README 與發佈包元數據；當前文檔版本爲 0.2.2-rc.1，許可證 MIT。

這是什麼¶

一句話：一個自定義 DSH 預設（Codex Coding）+ 三個自定義 DSH 工具，外加契約化的系統提示與 apply_patch 等編碼能力，通過 bundle 注入 profile。

唯一入口是新建會話時在預設選擇器裏選 Codex Coding。bundle 在 cordis.patch.yml 裏主要插入兩行：dsh-plugin-codex-coding（Host 配置與 Desktop 設置頁）和 preset-coding（預設本體）。其它預設的會話不加載本插件的行爲。

社區目錄頁：SkillHub 插件頁、dsh-plugin.org 中文條目。源碼與 issue：ygzhang-lab/dsh-plugin-codex-coding。

核心功能¶

五段式交付契約¶

獨立系統提示段落 coding:contract（order 10，不塞進人格前綴）固定流程：

1. 建立上下文：讀 AGENTS.md 與相關文件，用 coding_context 拉倉庫事實。
2. 定義完成標準：一句話目標；多步任務用 todo_write 寫 3–6 個可驗證步驟。
3. 最小修改：讀後改，優先 apply_patch，不碰無關 diff，不擅自 git commit。
4. 驗證後再宣稱成功：復現失敗、修根因、跑最窄檢查、git diff / git status 自檢。
5. 緊湊交付：只報結果、改動文件、驗證證據與剩餘風險。

另對 Bug / Feature / Refactor / Review / Docs 五類任務有細分打法，避免所有需求套同一模板。

工作流三模式（可自動、可手動）¶

推理等級與工作流分離：Low 只表示推理預算，不代表必須改代碼。

默認 auto 由提示詞按請求選擇。手動切換可用輸入框命令或 Agent 工具 coding_mode：

/workflow review
coding_mode(mode="review")
coding_mode(mode="auto")

每輪結束在對話流末尾展示 工作流模式 卡片（僅 Codex Coding 預設）：可點 自動 / 問答模式 / 審查模式 / Codex Coding；歷史輪次卡片只讀。推理等級另有一行，來源區分自動、會話覆蓋、設置固定。

推理等級自動切換¶

插件配置默認爲 auto 時，在 prompt 組裝前做規則分類，不額外調用模型判斷複雜度：

• 默認 Low：問答、簡單修復、單文件審查等絕大多數任務。
• High：多文件改動，或單功能模塊的審查/重構；較長 todo 計劃（6 步以上或 5 項以上未完成）也會升到 High。
• Max：項目級搭建/重構/審查，或一次性無法修復的 Bug 等少數場景。

臨時覆蓋：輸入框推理選擇器、coding_reasoning(effort="high")，或在設置頁固定 low / high / max。設置頁固定優先於會話覆蓋。

工具與 DSH 原生能力¶

• apply_patch：Codex 語法多文件/多 hunk/移動；上下文不匹配時給出 expected 與片段，避免靜默改錯。
• coding_context：任務開始時調用一次，返回分支、變更統計、AGENTS.md 路徑列表、驗證命令猜測、當前策略等緊湊快照。
• coding_reasoning / coding_mode：查看或覆蓋推理等級、工作流模式。
• 優先複用 DSH 內置 read / write / edit / glob / grep / bash / job_* / todo_write / web_* 等，不重複造輪子。

Desktop 設置頁還可一鍵控制 本地 Skill 加載，以及多選 已安裝的 DSH 工具插件 是否向該預設暴露工具（核心工具如 bash、apply_patch、todo_write 不可關閉）。

配置與語言¶

• Desktop：Plugins → DSH Codex Coding（bundle 頁）可改推理策略、會話語言、Skill 與工具開關。
• CLI：編輯 profile 的 cordis.patch.yml，按 id 覆蓋 dsh-plugin-codex-coding 的 config（需寫全字段，見官方示例中的 reasoning、localSkills、language、disabledPlugins）。

插件僅提供中/英語言包；會話語言可跟隨 DSH 界面或固定爲中文/English。

安裝與啓用¶

版本配對（必看）¶

DSH 0.2.1.x 與 0.2.2.x 在模型選擇與推理定檔接口上不兼容，須按 README 版本表配對：

當前發佈線 engines.dsh 爲 >=0.2.2-rc.1 <0.3.0；在 0.2.1.x 上安裝 0.2.2 線會被判爲不兼容。升級 DSH 後請同步升級插件。Node.js 要求 >=24.9.0（與 DSH 0.2.2+ 一致）。

dsh plugin add 可能出現 missing peer 警告（profile 默認 autoInstallPeers: false），README 說明這是預期行爲，安裝後可用 dsh --profile <profile> --dump-config 確認 bundle 已組合。

DSH Desktop¶

在 Plugins / 添加插件 中輸入包名：

dsh-plugin-codex-coding

安裝並啓用 bundle 後重啓 DSH，新建會話，預設選 Codex Coding。

CLI¶

下面命令將插件加入指定 profile（<profile> 換成你的 profile 名）：

dsh plugin --profile <profile> add dsh-plugin-codex-coding
dsh --profile <profile>

新建會話後同樣選擇 Codex Coding 預設。

典型用法¶

經過上面的安裝步驟後，可按 README 快速使用方法 直接開聊。默認 auto 會同時選工作流與推理等級。

1. 修 Bug 並跑最窄測試（自然語言即可）：

幫我修一下這個報錯：先定位原因，再改，最後跑最窄的測試。

2. 只想審查、不改倉庫：

/workflow review

或讓 Agent 調用 coding_mode(mode="review")。

3. 臨時拉高推理（僅在設置 reasoning 爲 auto 時由工具覆蓋）：

coding_reasoning(effort="high")

4. 查狀態：

/workflow
coding_reasoning()

Codex 模式下 Agent 會按契約：先 coding_context，再計劃與 apply_patch 小步修改，最後驗證並簡短彙報。

適用場景與注意¶

適合誰：已在用 DSH 0.2.2.x、希望把「討論 / 審查 / 真寫代碼」和推理預算拆開管線的開發者；需要 Codex 風格 patch 與固定交付節奏的團隊也可把該預設當作可複用的編碼模板。

使用前請知悉：

• 插件與 DSH 宿主持相同的進程權限；安裝前請自行審閱 源碼 與 MIT 許可證，勿在未信任的環境盲目啓用 bundle。
• DSH 生態主張「一切皆插件」；SkillHub、dsh-plugin.org 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係，本文不作「官方應用商店」表述。
• 卸載或禁用 bundle 後，Codex Coding 預設及其工具一併消失；已有普通預設會話不受影響。

結尾¶

DSH Codex Coding 把 Codex 式交付契約、三模式工作流、自適應推理和會話內卡片控制收斂到一個可選預設裏，入口清晰、對非 Coding 會話零侵入。若你正在 DSH 上搭編碼工作流，可按版本表安裝 dsh-plugin-codex-coding，從一次 Codex Coding 會話試起。

• 目錄頁：https://www.skillhub.cn/plugins/ygzhang-lab/dsh-plugin-codex-coding
• 倉庫：https://github.com/ygzhang-lab/dsh-plugin-codex-coding