DeepSeek Harness plugin

dev-harness-dsh

Recoverable dev-harness orchestration for DeepSeek Harness.

Jump to install

Source facts

Repository
Dev-Wiki/dev-harness-dsh
Latest update
Aug 20, 2026
Category
Docs & Rendering
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Dev-Wiki/dev-harness-dsh
Plugin: dev-harness-dsh
Author: Dev-Wiki

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dev-harness-dsh

项目简介

dev-harness-dsh 把 Audit、Auto Fix、验证、QA、最终复核与统一报告编排为可恢复运行;V0、K1、K2、K3、K4、S1、S2、S3、S4 MVP 基线已完成

编程语言

JavaScript, TypeScript

构建系统

npm / package.json, pnpm

核心模块

  • src — 生产 Plugin、Human Command、Run Authorization、Audit/Auto Fix/Full Verification/QA/Reconciliation 合同、可恢复 Orchestrator、Run Summary 与原子 Run State
  • tests — 生产生命周期、命令、授权、CompletionStatus、提交/验证 boundary、漂移和恢复自动化
  • docs/product/REQUIREMENTS.md — MVP 产品边界与验收口径
  • docs/plan — 当前状态看板与任务执行层
  • docs/integration/DSH_API_BASELINE.md — rc.8 集成事实、证据等级与停止线
  • experiments/v0-minimal-plugin — 可构建、可打包的 V0 Plugin/Command、Agent、Workflow、Tool、Skill/worktree 与状态边界实验

使用说明

  • 开发依赖安装: pnpm install --frozen-lockfile --ignore-scripts
  • 构建: npm run harness:build
  • 完整验证: npm run harness:full(typecheck + lint + 68 个自动化用例 + build + pack dry-run)
  • 本地发布包: python3 release.py(先执行完整验证,再生成 dist/*.tgz;不上传 registry)
  • 插件安装与启用: [安装指南](docs/how-to/INSTALL.md)
  • 运行: N/A

使用示例

在带工作区目录的 DSH Session 中执行:

/harness-run fix-only

命令返回当前 Run 的权威视图(JSON):

{
  "runId": "dsh-20260820153000-a1b2c3d4",
  "revision": 3,
  "phase": "AUDIT",
  "status": "RUNNING",
  "authorization": {
    "schemaVersion": 1,
    "autoFix": "fix-only",
    "externalActions": {
      "push": false,
      "pull-request": false,
      "tag": false,
      "release": false,
      "deploy": false
    }
  }
}

常用命令:

  • /harness-run [fix-only|commit-each] [qa=<adapter-name>] — 新建可恢复 Run(默认 fix-only);
  • /harness-status [run-id] — 查看当前或指定 Run 状态;
  • /harness-resume <run-id> — 校验工作区与快照一致后恢复 Run(工作区任何变更都会 fail closed);
  • /harness-cancel [run-id] — 取消当前或指定 Run(终态 Run 幂等返回)。

完整安装、Skill 准备与卸载步骤见 [安装指南](docs/how-to/INSTALL.md)。

变更记录

版本变更见 [CHANGELOG.md](CHANGELOG.md)。当前为 0.1.0 预览期:与 DeepSeek Harness 0.1.0-rc.8 精确锁定,不声明跨 rc 兼容。

CI

GitHub Actions 工作流见 [.github/workflows/ci.yml](.github/workflows/ci.yml):push(main)与 pull_request 时运行 npm run harness:full 与 V0 fixture 完整验证。

构建本地发布包

python3 release.py

脚本先执行 npm run harness:full,成功后用禁用生命周期脚本的 npm pack 在临时目录构建并校验包名、版本、关键文件、条目数、大小和 SHA-256,最后将包放入 dist/。同名包默认不会被覆盖;确认替换时使用 python3 release.py --force,自定义目录时使用 --output-dir <path>

该脚本只构建本地 .tgz,不会执行 npm registry publish、Git tag、push 或外部 release。