前言¶
DeepSeek Harness（DSH）擅长规划、复查和推进对话，但若要执行依赖 Codex CLI 的本地编码任务，通常需要在 DSH 与终端之间来回切换：手动启动 Codex、盯进度、再把手写结果贴回对话。工作流被打断，长任务也难以在 DSH 重启后继续追踪。
dsh-codex-runner（维护者 halftin，分类：工作流）面向 Windows，让 DSH 通过插件直接启动并管理本机 Codex CLI：在当前工作区跑任务、后台执行、按运行 ID 查状态或取消、执行中追加指令，并把进展与完整答复接回 DSH 侧。Codex 仍使用你的本地工作区与已有登录；DSH 负责规划与验收，插件负责启动、监测与控制。
这是什么¶
一句话：dsh-codex-runner 是 DSH 插件，把 Codex CLI 接入 DSH 工作流，而不是替代 Codex 安装或账号登录。
- 仓库：halftin/dsh-codex-runner
- 目录页：skillhub 插件页
- 当前版本：
0.5.3-beta（预发行） - 许可：MIT
- 平台：Windows；Node.js
>=22.23.4；DSH>=0.2.1-rc.3 <0.3.0
插件已收录社区目录（DSH Market 使用的独立站点，与 DeepSeek / 幻方无官方从属关系），可在 awesome-dsh-plugin 条目 或 Market 中搜索 dsh-codex-runner 获取同版本发行包。
核心功能¶
下面介绍插件在资料中明确列出的能力。
| 需求 | 插件行为 |
|---|---|
| 把项目任务交给 Codex | 在当前工作区启动任务，返回完整最终答复 |
| 耗时任务 | 支持后台执行；DSH 重启后仍可按运行 ID 查询或取消 |
| 执行中改要求 | 向当前轮发送指令、中断当前轮，或排队追加下一轮 |
| 查看进展与历史 | 查询执行状态、账号额度、当前工作区关联会话 |
| 执行期间看输出 | App Server 与 exec 两种后端可在主聊天区显示正文与可展开操作（单纯显示不调用模型） |
| DSH 主动监督 | 分批读取进度、处理原请求问答；可按已有授权调整同一任务（消耗 DSH 模型 token） |
| 权限与配置 | 原生设置页、完整配置编辑器和可编辑字段注册表 |
| 可选增强 | 低额度暂停、额度恢复续跑、定时状态报告（文档说明会产生额外 token 开销） |
实时显示与主动监督默认开启，可分别关闭。一次 Codex 执行结束不等于用户目标已完成，结果仍由 DSH 复查；执行记录保存在当前工作区，插件不复制登录凭据，也不自动回滚项目改动。
运行关系可概括为：用户 ↔ DSH（规划与验收）↔ 插件（启动、监测与控制）↔ Codex CLI（本地工作区执行）。插件通过 Codex App Server 或兼容 CLI 驱动任务；启动、进程监测、状态查询等机械操作不单独调用模型。
安装与启用¶
环境前提：Windows、已安装的 DSH、已安装并完成登录的 Codex CLI。插件不包含 Codex CLI。Node 最低 22.23.4；资料中已验证 22.23.4 与 24.22.2。
通过 DSH 界面安装： 打开「插件 → 添加插件」，填写：
dsh-codex-runner@0.5.3-beta
安装后按提示启用插件或重启 DSH。
通过 CLI 安装： 将 <profile> 替换为实际 DSH profile：
dsh plugin --profile <profile> add dsh-codex-runner@0.5.3-beta
若已有预构建包，可安装本地 .tgz：
dsh plugin --profile <profile> add ./dsh-codex-runner-0.5.3-beta.tgz
也可使用 github:halftin/dsh-codex-runner#v0.5.3-beta 安装该版本源码。通过 DSH 安装插件即可，无需另行 npm install。npm 包名同为 dsh-codex-runner，next 渠道随新预发行版更新；上述命令固定安装 0.5.3-beta。
安装前建议阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，与 DSH 生态「一切皆插件」一致，安装来源与权限范围应自行确认。
典型用法¶
先做环境检查，再交任务。
- 在终端执行
codex login，完成 Codex 登录。 - 在 DSH 中选择项目工作区，运行
codex_doctor()检查连接，再用codex_models()查看可用模型。 - 向 DSH 说明目标、范围和验收要求；默认使用设置中的模型与思考强度。开启「DSH 自主选模型与推理强度」后，由 DSH 按任务明确选择并传入
model与effort；关闭时必须省略这两个参数。
对话示例（摘自 README）：
请使用 Codex 修复当前项目中的这个问题，先确认可用模型和思考强度，再执行任务、运行相关检查并复查结果
需要直接调用工具时，可将占位符换成实际值：
codex_run(prompt_file="task.md", label="task", detach=true)
codex_status(run_id="<返回的运行 ID>")
codex_say(run_id="<运行 ID>", action="steer", message="补充要求")
codex_cancel(run_id="<运行 ID>")
task.md 为当前工作区中的任务文件。每次执行返回唯一运行 ID，便于后续查询、追加或取消。
修改设置¶
在 DSH 中打开该插件详情页，修改后点击底部 保存。主要项包括：默认模型与推理强度、实时显示与主动监督、沙箱与审批、低额度暂停与自动恢复、定时查询 Codex 状态、高级设置（并发、历史、调试、本机 CLI 路径）。高级设置中的 编辑完整配置与注册表 提供表格、注册表 JSON、配置 JSON 三个页签；保存后的参数用于后续新任务，已启动任务保留启动时的参数。
「DSH 自主选模型与推理强度」默认为关；「模型选档」相关策略仍为 Beta，细节见仓库 configuration.md 与 tools.md。
适用场景与注意¶
适合： 已在 Windows 上使用 DSH 做项目规划与复查，且本机已配置 Codex CLI 的开发者；希望把「交给 Codex 改代码、跑检查」留在同一工作区与会话里，并需要后台跑、断线补读、按 ID 管控的任务。
注意：
- 仅支持 Windows；非 Windows 环境请勿按本文安装期望可用。
- 主动监督、定时状态报告、额度相关增强会消耗 DSH 或 Codex 侧模型 token，可按设置关闭或按需启用。
- 插件不代替 Codex 账号与额度管理；安装与启用前请核对 GitHub 源码与许可证，并理解插件与 DSH 同进程权限。
问题反馈：GitHub Issues。完整文档入口见仓库 docs/README.md。
结尾¶
经过上面的步骤，你可以在 DSH 里把 Codex 当作可编排的本地执行器：启动、后台、查进度、追加指令、读完整答复，再由 DSH 做验收与后续推进。当前预发行版本为 0.5.3-beta。
- 目录页：https://www.skillhub.cn/plugins/halftin/dsh-codex-runner
- 源码与 README：https://github.com/halftin/dsh-codex-runner
