前言¶

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