协调 Codex 制定计划和独立审查,由 DSH 原会话完成代码修改与测试。
安装
# Release 预构建包
dsh plugin --profile web add "https://github.com/kui123456789/dsh-codex-workflow/releases/download/v1.0.6/dsh-codex-workflow-1.0.6.tgz"
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:kui123456789/dsh-codex-workflow
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
让 Codex 负责只读规划和审查,让宿主 Agent 负责实施与测试的独立 Skill。支持规划、澄清、修复复审和单独审查,运行于 Windows、Linux、macOS。
适用于能够读取 SKILL.md 并执行本地 Node 命令的 Agent。不同宿主的 Skill 安装位置、发现方式和调用语法由宿主决定。
2.x 已从 DSH 插件转为独立 Skill。 旧 DSH 插件入口、侧栏和安装方式已经退役;旧数据和配置不自动迁移。文档导航区分现行指南与历史资料。
下载与安装
- 从 GitHub Releases 下载附件
codex-workflow.zip。 - 解压后,将完整的
codex-workflow/目录复制到宿主支持的 Skill 目录。保留SKILL.md、references/、agents/和scripts/的相对位置。 - 准备以下运行环境,在 Skill 目录运行能力检查。
| 依赖 | 要求 |
|---|---|
| Node.js | `^22.19.0 |
| Codex CLI | 模型操作前完成配置和登录 |
| Git | 审查 Git 工作区时需要;非 Git 工作区须提供明确文件范围 |
node scripts/workflow.mjs doctor
分发包已包含运行时,使用时无需安装 npm 依赖。Release 中自动生成的 Source code 是源码快照,需要自行构建;直接安装请使用 codex-workflow.zip。附件 artifacts.json 和 SHA256SUMS 提供逐文件清单及 SHA-256 校验值。
doctor 检查 Node、Codex CLI 版本及命令能力,不调用模型,也不验证登录或真实推理成功。doctor --offline 只检查 Node。完整真实调用的验证范围见版本验证记录。
使用方式
让宿主读取 SKILL.md,再提出任务。支持命名 Skill 的宿主可以使用 $codex-workflow;其他宿主使用其自身的 Skill 调用方式。
规划并实施的请求示例:
使用 codex-workflow,为当前项目增加健康检查命令。由 Codex 规划和审查,你负责实现并运行测试。
单独审查的请求示例:
使用 codex-workflow 审查当前项目的未提交修改,报告发现和测试缺口;本次只审查。
正常流程是 Codex 规划、用户回答必要问题、宿主实施并测试、Codex 审查。阻塞问题进入修复复审;仅有非阻塞建议时,提交用户决定;通过后报告结论和实际验证证据。单独请求审查不授权自动修复。
运行时默认最多审查 3 轮,仍有阻塞问题且连续 1 轮无可验证变化时停止修复。失败、证据不足或进程清理不确定时,宿主按返回的状态停止或等待,不能把这些情况当作通过。
命令与状态
统一入口是 node scripts/workflow.mjs <command>。命令返回 JSON,诊断写入 stderr。长文本使用 JSON 输入文件或 stdin;业务命令包括:
| 用途 | 命令 |
|---|---|
| 规划与澄清 | start、continue |
| 审查实施结果或单独审查 | review、review-only |
| 状态与原线程恢复 | status、resume |
| 非阻塞建议决策与取消 | decide、cancel |
模型操作在后台 worker 中执行。提交命令返回工作流 ID 后,使用 status 查询结果;单次等待最多 30 秒。resume 只续接符合条件的原线程,不能替换为最近使用的线程。参数、输入格式和完整返回字段见 CLI 协议。
状态默认保存在 ~/.codex-workflow/,由 SQLite 和工作流产物目录组成。通过 CODEX_WORKFLOW_HOME 或 --home 可以覆盖;状态目录须位于目标项目之外。同一项目目录默认只允许一个活动工作流,不需要常驻服务或网络监听。证据失效、取消及恢复诊断见恢复与证据。
从源码开发
开发需要 package.json 指定的 pnpm 版本。首次安装与常用检查:
pnpm install --frozen-lockfile
pnpm verify
pnpm pack:skill
pnpm verify 包含类型检查、构建和完整测试。pnpm pack:skill 生成 dist/codex-workflow/ 和 dist/codex-workflow.zip;生成的 scripts/workflow.mjs 与 dist/ 不手工编辑。
发布前运行 pnpm verify:isolated,它在源码副本中连续执行两轮 release:check。详细步骤、收据位置和产物交付方式见发布检查清单。仓库开发约定见 AGENTS.md。
验证与历史
v2.0.0 验证记录固定到发布提交:三平台六项 CI、本机和 GitHub 隔离发布门禁均通过;真实 Codex 功能链路未验收通过。模拟 Codex 子进程测试与真实模型验证分别记录。
CHANGELOG保留版本变化;DSH 历史资料中的宿主配置、ephemeral 会话和侧栏说明属于 1.x 插件时期。
链接
同类插件
loopx-project/loopx#dsh-loopx-plugin★ 6722
LoopX——面向长周期 Agent 的提供商中立、本地优先状态内核与控制平面:在 DeepSeek Harness 执行层之上持久化 Goal、Todo、门禁、证据、配额、恢复与交接状态;插件负责引导安装 CLI 与技能、准入有界的同会话续跑,并为精确绑定的工作循环提供本地 GoalBar。
Q00/ouroboros#integrations/dsh-plugin★ 6381
通过 DSH MCP 客户端挂载 Ouroboros 的纯配置包,在 DSH 中提供 36 个涵盖需求访谈、Seed、执行、评估与演化流程的工具。
chuspeeism/dashi-taskboard#deepseek-harness★ 3507
把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述文件连接,而不是使用固定端口。
NanmiCoder/dsh-agent-teams★ 3026
AgentTeams 多智能体团队。
EthanYoQ/AI-Novel-Writer#dsh-ai-novel-writer★ 2711
安装专用 AI 小说创作预设与工作台:提供带修订号的本地项目资产、紧凑侧边工作台,以及需要原生审批的逐文件变更。
shanliuling/dsh-image-gen★ 1626
为 DeepSeek Harness 提供原生对话生图能力:直接让 Agent 画图,插件自动完成生成并把结果保留在当前会话中。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。