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）
- 插件安装与启用: 安装指南
- 运行: 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 准备与卸载步骤见 安装指南。
变更记录
版本变更见 CHANGELOG.md。当前为 0.1.0 预览期：与 DeepSeek Harness 0.1.0-rc.8 精确锁定，不声明跨 rc 兼容。
CI
GitHub Actions 工作流见 .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。
