DeepSeek Harness 插件

kui123456789/dsh-codex-workflow

Star 数 ★ 7 分类 工作流与自动化 收录于 2026-08-21

协调 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 插件入口、侧栏和安装方式已经退役;旧数据和配置不自动迁移。文档导航区分现行指南与历史资料。

下载与安装

  1. 从 GitHub Releases 下载附件 codex-workflow.zip。
  2. 解压后,将完整的 codex-workflow/ 目录复制到宿主支持的 Skill 目录。保留 SKILL.md、references/、agents/ 和 scripts/ 的相对位置。
  3. 准备以下运行环境,在 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 插件时期。

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。