前言¶

DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在使用 OpenAI Codex CLI 進行代碼分析或任務執行時，開發者通常需要 OpenAI 賬號登錄。dsh-codex 解決了這一痛點，它將 Codex CLI 接入 DSH 的工具與技能體系，允許開發者使用本地配置（如 DeepSeek）運行 Codex，無需 OpenAI 登錄。通過 dsh 工具，開發者可以以原生方式執行一次性任務、倉庫審查和會話續接。

前置要求¶

使用該插件前，需滿足以下條件：
1. DeepSeek Harness (dsh) 已安裝。
2. Codex CLI 已全局安裝：

    npm install -g @openai/codex
    codex --version

3. Codex 配置文件 ~/.codex/config.toml 已配置提供方（如 DeepSeek 的 model_provider、base_url 和 model），或通過 codex login 登錄。

安裝與啓用¶

該插件通過 cordis.patch.yml 適配層接入 DSH。

方式一：本地 patch 臨時加載（開發時）
在 DSH 倉庫根目錄執行以下命令，覆蓋加載插件：

pnpm dsh web --patch ./dsh-codex/cordis.patch.yml

啓動後，向智能體提問即可使用工具。

方式二：作爲 bundle 加入 profile
在 DSH 的 profile 配置文件中添加以下內容：

- insert:
    - id: codex
      name: './src/index.js'
      config:
        model: deepseek-v4-flash   # 留空則使用 ~/.codex/config.toml
        sandbox: read-only         # 可選: read-only | workspace-write | danger-full-access
        cd: /path/to/workspace

核心功能¶

插件提供了 4 個原生 dsh 工具，以及配套的 SKILL.md 技能文件和 Schemastery 配置。

1. codex_status: 查看當前 Codex CLI 版本、配置路徑及提供方摘要（提供方配置已打碼，不顯示密鑰）。
2. codex_exec: 執行一次性任務。需提供提示詞（prompt）、工作目錄（cd）和沙箱級別。
3. codex_review: 對倉庫代碼進行審查。支持基於 diff 或未提交更改的審查（默認爲只讀性質）。
4. codex_resume: 續接之前的會話。可指定 session id 或使用 last=true 續接最近一次會話。

典型用法¶

下面是幾個常用的操作示例：

# 1. 查看狀態（不消耗模型額度）
codex_status

# 2. 執行一次性審查任務
codex_exec prompt="審查 F:\8.15.6\src\app.ts，找出 bug 與優化點" cd="F:\8.15.6"

# 3. 審查當前倉庫的未提交更改
codex_review uncommitted=true

# 4. 續接上次會話並繼續工作
codex_resume last=true prompt="繼續完成剩餘部分"

配置與安全¶

配置項
插件支持通過 Schemastery 配置以下參數：
- codexPath: Codex CLI 的執行路徑，默認爲 codex。
- model: 默認模型覆蓋，留空則使用 ~/.codex/config.toml 中的配置。
- sandbox: 默認沙箱模式，默認爲 read-only，可選 workspace-write 或 danger-full-access。
- cd: 默認工作目錄。
- ephemeral: 是否啓用臨時會話，默認 false（持久化）。
- timeoutMs: 單次調用超時時間，默認 600000 毫秒（10 分鐘）。

安全邊界
- 默認只讀: 默認沙箱爲 read-only，Codex 無法修改文件。如需寫文件，必須顯式升級沙箱權限。
- 隱私保護: codex_status 輸出時會對提供方配置進行打碼，絕不展示密鑰。
- 數據發送: 每次執行 codex_exec 或 codex_review 都會將提示詞與倉庫內容片段發送給配置的提供方（如 DeepSeek），需注意 token 消耗。
- 會話文件: 默認會話文件寫入 ~/.codex/sessions，不需要留痕時建議設置 ephemeral=true。

總結¶

dsh-codex 是一個獨立社區項目，它將 OpenAI Codex CLI 的能力無縫集成到 DeepSeek Harness 的工具體系中。開發者無需 OpenAI 登錄，即可利用本地配置（DeepSeek）通過 dsh 工具執行代碼審查和任務。

鏈接¶

• GitHub: https://github.com/WODE25500/dsh-codex
• 插件目錄: https://www.skillhub.cn/plugins/WODE25500/dsh-codex