前言¶
在 DeepSeek Harness（DSH）里跑 agent，常见摩擦不是「模型不够聪明」，而是会话习惯：口头说「已修复」却不见任何命令输出；一次 diff 动五个文件；把猜测说成验证结论；长对话后半段上下文挤掉前面的决定。DSH 生态里可以用插件 bundle 声明 agent 预设，把 persona 和工作顺序写进 Cordis 组合，而不是只靠默认聊天式 prompt。下面介绍社区插件 dsh-codex-preset（维护者 qianai05233），它把 OpenAI Codex CLI 那套「先探明、再计划、小步改、必验证、再交代」落成 DSH 里的 Codex 模式 预设。
这是什么¶
dsh-codex-preset 是 DSH 的 Codex 模式 agent preset：不换底层模型，换一套固定工作顺序和 证据纪律——关于代码库的断言，必须能追溯到「读过文件」或「跑过命令」。插件在 SkillHub 分类为 工作流；仓库 github.com/qianai05233/dsh-codex-preset，许可证 MIT（package.json 版本 1.0.0）。
它解决什么问题¶
README 把默认 agent 的几类问题，收成 persona 里的硬约束，对应五个阶段：
| 阶段 | 要求 |
|---|---|
| ① EXPLORE | 动手前先探明：glob 找文件、grep 找符号，只读不写 |
| ② PLAN | 先列 todo_write；需求含糊用 ask_user_question，不许猜 |
| ③ IMPLEMENT | 改前必读；小步走；不顺手重构无关代码 |
| ④ VERIFY | 与「会聊天的模型」的分界线：没跑过的结论不许说成事实；每个非零 exit code 都要处理 |
| ⑤ INTEGRATE | 讲清改了什么、跑了什么、结果如何；落库走 git 工具 |
VERIFY 和 证据纪律 是核心差异：不允许把未执行的检查包装成已确认事实。
与内置 standard 预设的差异¶
作者说明下列差异是 有意为之，不是遗漏：
- persona 写死五阶段工作流——本 preset 的主要价值
- 保留 shell / jobs / subagent / workflow——编码要能跑命令、看长任务、并行分工
- 挂 plan-mode——「先探明再动手」在 DSH 里由 plan mode 强制落地
- 挂 compaction 剪枝——长会话控制上下文
声明的 17 个插件均来自 DSH 本体，无需额外安装（README 前置说明）。
技术实现：Cordis patch 声明预设¶
DSH 早期用 $DSH_HOME/.agent-presets/<id>/ 存预设的机制 已废弃（官方 skill editing-cordis-compositions 称该目录不再被读取）。现役写法是由 bundle 的 patch 声明 @deepseek-ai/dsh-agent-preset 行；本仓库是该写法的完整示例。
cordis.patch.yml 中核心形态如下（README 摘录，插件列表在资料中为 17 项，此处不展开完整数组）：
- id: preset-codex
name: '@deepseek-ai/dsh-agent-preset'
config:
id: codex
name: Codex 模式
order: 5
plugins: [ ... 17 个 ... ]
package.json 里通过 dsh.bundle.patch 指向 ./cordis.patch.yml，随插件安装注入 Web profile 的组合。
安装与启用¶
前置：DSH >= 0.1.7-rc.1。
在资料给出的命令下安装（注意 --profile web）：
dsh plugin --profile web add github:qianai05233/dsh-codex-preset
重启 dsh web 后，在界面 Agent 预设 中选择 Codex 模式。
典型用法与自定义¶
启用预设即典型用法：选 Codex 模式后，后续会话会按 EXPLORE → PLAN → IMPLEMENT → VERIFY → INTEGRATE 推进；需要改工作流文案时，编辑仓库内 cordis.patch.yml 的 persona.prefix，改完后用同一安装命令重装：
dsh plugin --profile web add github:qianai05233/dsh-codex-preset
README 未提供独立「业务场景脚本」；价值体现在 agent 行为约束，而非额外 CLI 子命令。
适用场景与注意¶
适合谁
- 希望在 DSH Web 里获得接近 Codex CLI 工程节奏的团队或个人
- 需要强制「先读再改、必跑再结论、小步 diff」的编码会话
- 想参考 Cordis patch 声明 agent preset 写法、扩展自己的 bundle 的开发者
注意
- 插件随当前 dsh 进程权限 运行；安装前请自行审阅 仓库源码 与 MIT 许可证
- SkillHub（目录页）是社区插件目录，与 DeepSeek / 幻方无官方从属关系；DSH 理念是「一切皆插件」，本 preset 是工作流类社区贡献之一
- 仓库 README 星标为 0（以 GitHub 页面为准），不代表功能完整性；以 README 与
cordis.patch.yml为准
配套与其他链接¶
同维护者可选配套（README 列出，非本插件必需）：
- dsh-codex-panel——悬浮控制面板，一键同意 git/GitHub 写操作
- dsh-freeapi-panel——多家正规免费 LLM provider 聚合
目录页：https://www.skillhub.cn/plugins/qianai05233/dsh-codex-preset
GitHub：https://github.com/qianai05233/dsh-codex-preset
经过上面的步骤，若你受困于「说得多、验得少、改得散」，可以在 DSH 里用 Codex 模式把五阶段和证据纪律写进 preset，而不是每次靠人工提醒 agent 先 grep 再改、先跑再报结果。
