Codex 执行模式 airainal/dsh-codex-mode

DeepSeek Harness 的 Codex 模式

给 DSH 用的 Codex 风格执行模式。它在权限菜单顶部加一个开关，保留一份持久计划，工具运行时输出可见进度，并在回合因未完成工作停下时继续推进。

和纯提示词模式的关键区别：模型发出工具调用却不带文字时，宿主驱动会在工具运行之前提交一条简短进度消息，作为持久助手消息的一部分。长回合不会变成静默的工具循环。

Codex 模式菜单

它做什么

- Codex 开关位于权限菜单顶部，在分隔线之上。开关不改变沙箱或审批级别。
- 全局记忆：最后状态存在配置档的 codex_mode 存储域里。开启或关闭会作用于所有活跃根会话；新建和恢复的会话自动继承。
- 可见进度：每批工具运行前都会显示。模型自己的说明会保留；缺失时由驱动按用户语言插入。
- 回合续跑：待办列表还有未完成工作，且助手没有在提问时，继续推进回合。
- 持久会话身份：存为 codex-read-only、codex-workspace-write 或 codex-danger-full-access，因此模式会出现在会话日志里，恢复后依然有效。
- 同样的安全闸门：Full access 和 Auto review 与原生权限控制一致。

要求

- DSH Desktop 或 Web，带插件管理器。已在 DSH 0.2.1-rc.3 上测试。
- 包声明了 engines.dsh: ^0.2.1-rc.1；请装在 0.2.1-rc.x 运行时上。
- 首次安装需要 Git 和访问 GitHub 的网络。

安装

方式 1：把 GitHub 链接交给 DSH

新建 DSH 会话，发送：

Install this DSH plugin bundle from GitHub: https://github.com/airainal/dsh-codex-mode

智能体可以用该 URL 调用 plugin_manager 工具。管理器会检查 GitHub 仓库、安装包并启用它。你也可以打开 Plugins → Install bundle，粘贴：

https://github.com/airainal/dsh-codex-mode

如果你的 DSH 版本要求显式 git 规格，用：

github:airainal/dsh-codex-mode

方式 2：安装发布 tarball

从 Releases 下载资源，把发布资源 URL 或下载好的 .tgz 路径粘贴到 Plugins → Install bundle：

https://github.com/airainal/dsh-codex-mode/releases/download/v1.1.0/dsh-codex-mode-1.1.0.tgz

安装之后

1. 打开任意会话。
2. 点击输入框底部的权限控件。
3. 在菜单顶部打开 Codex Mode。
4. 照旧选择 Read Only、Workspace Write 或 Full access。模式和权限级别相互独立。

桌面应用里 HMR 会立即生效。如果你的配置档禁用了 HMR，安装后重启 DSH。
要移除它，打开 Plugins → Codex Mode → Remove，或让智能体移除这个 bundle。

使用

菜单有两个维度：

- Codex 开关控制执行协议；
- 权限选项控制沙箱与审批策略。

选中 Workspace Write 时打开 Codex，会把每个活跃的根会话切到对应的 codex-workspace-write 身份，但每个沙箱仍是 workspace-write。开关的最后状态会被记住；新建或恢复的会话会自动切到对应的 codex- 身份。模式开启时更改权限，会保留全局模式，只改该会话的权限基座。

同样的开关也提供 Host 命令：

/codex-mode on
/codex-mode off

Codex 开启时 Auto review 不可用，因为没有 codex-auto 身份。想用 Auto review，先关掉 Codex。

模式开启时，触发器右侧会显示 Codex 标记。它以 240 ms 的宽度/透明度过渡滑出，切换过程中菜单保持打开。

工作原理

这个包是 DSH bundle，分 Host 和 Web 客户端两半。

- cordis.patch.yml 添加三个 codex- 权限预设，并挂载 Host 插件。
- 配置档级的 codex_mode 存储域保存 { enabled, updatedAt }。/codex-mode on|off 命令先写入它，再把对应的 codex- 或基础预设应用到每个活跃根会话。agent/created 监听器把记住的值应用到新建和恢复的根智能体。
- Host 插件添加 codex:mode 系统提示词段落，并包装每个活跃智能体的 step。Codex 模式下，只含工具调用的 assistant/message 在提交前会补一个开头的进度文本块；对应的 text-chunks 记录加入流，工具调用块索引相应后移，让内容与流保持对齐。
- agent/turn-stopping 在计划未完成且回复不是提问时，提供一次继续引导。
- 客户端插件把当前会话的权限控件替换为同样的控件加 Codex 行，保留原有权限图标和 Full-access/Auto-review 风险对话框。

这是 Codex 的步骤驱动器，不是第二套工具运行时。回合构建、工具分发、审批、重试、压缩和事件日志仍由 DSH 负责。完整分叉这些系统会复制大量经过测试的基础设施；驱动器改的是用户真正看到的部分：进度输出和回合继续。

为什么进度行是可证明的

这行不是 UI 状态标签。在一次明确告诉模型不要输出文本的测试回合中，模型的流里只有推理和工具调用块，没有 text-chunks。提交的 assistant 消息是：

[reasoning, "我先读取 dsh-codex-mode/client.js。", tool-call]

对应的流索引是推理 0、文本 1、工具调用 2。
文本只能来自 Host 驱动。测试在本地针对 DSH 0.2.1-rc.3 运行；会话日志本身未公开。

适用范围与限制

- 这个包面向 DSH 0.2.1-rc.x。它用到运行中智能体的 step 和会话追加边界；未来 DSH 版本可能改动这些内部实现。
- 它不是完整的 Codex 引擎。自由格式 apply_patch、Codex 风格的单工具调度、shell/输出限制、Codex 压缩阈值都未实现。
- 这个 bundle 会覆盖 permission 行，加入 codex- 预设。如果你在配置档里维护了自定义权限预设，安装前请把它们带进 cordis.patch.yml。
- 内置的 /permission 命令也会列出 codex- 身份。全局开关请用输入框菜单或 /codex-mode on|off；直接改 /permission 只是对当前会话的覆盖。
- 设置里的默认权限选择器会列出 codex- 预设，因为它们就是普通权限预设；要切换运行中的会话，请用输入框菜单。

截图

| 菜单，浅色 | 触发器 |
| Menu | Trigger |

| 深色风险确认 | 窄布局 |
| Dark | Narrow |

开发

没有构建步骤。

git clone https://github.com/airainal/dsh-codex-mode.git
cd dsh-codex-mode

通过 Plugins → Install bundle 把这个目录安装为 bundle，或者让 DSH 智能体用 plugin_manager 安装该路径。Host 插件导出 apply()，客户端是普通的 window.__ModuleLoader__ 模块，bundle 补丁是 cordis.patch.yml。

构建发布 tarball：

pnpm pack

中文快速安装

把下面这句直接发给新的 DSH 会话：

安装这个 DSH 插件 bundle：https://github.com/airainal/dsh-codex-mode

装好后打开任意会话，点输入框下方的权限按钮，在菜单顶部打开 Codex 模式。
开关状态会被记住并同步到所有会话，新会话自动继承；权限级别不会改变。

License

MIT. See LICENSE.