DeepSeek Harness Plugin

kui123456789/dsh-codex-workflow

Stars ★ 7 Category Workflow & Automation Added 2026-08-21

Coordinates Codex planning and independent review while the original DSH session implements and tests changes.

Install

# from a prebuilt release tarball

dsh plugin --profile web add "https://github.com/kui123456789/dsh-codex-workflow/releases/download/v1.0.6/dsh-codex-workflow-1.0.6.tgz"

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:kui123456789/dsh-codex-workflow

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

This plugin publishes its README in Chinese only.

让 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 插件时期。

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.