前言¶

在 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