前言¶
DeepSeek Harness（DSH）采用插件化架构，旨在将复杂的开发流程标准化。在实际工作中，从代码审计、自动修复、验证、QA 到最终复核与报告生成的流程往往容易中断，且难以复现或恢复。dev-harness-dsh 插件通过编排这些环节，将其转化为可恢复运行的 Run，从而解决流程中断与状态管理的问题。
这是什么¶
dev-harness-dsh 是由 Dev-Wiki 维护的 DSH 插件。它将 Audit、Auto Fix、验证、QA、最终复核与统一报告整合为可恢复运行的流程。目前，该插件已完成 V0、K1、K2、K3、K4、S1、S2、S3、S4 的 MVP 基线开发。
核心功能¶
- 可恢复运行编排：将开发流程中的各个阶段（审计、修复、验证等）编排为可恢复的 Run。
- MVP 基线完成：V0 至 S4 的核心基线功能已实现。
- 语言支持：支持 JavaScript 与 TypeScript。
- 构建系统：基于 npm 或 pnpm。
安装与启用¶
安装前请确保本地已安装所需版本的 DSH 及其依赖。
- 安装依赖
pnpm install --frozen-lockfile --ignore-scripts
- 构建插件
npm run harness:build
- 安装插件
具体的安装步骤请参考项目文档中的 安装指南。
注意：安装前请检查源码与许可证。
典型用法¶
运行流程¶
在 DSH Session 中，可以使用以下命令启动或管理 Run：
- 新建可恢复 Run
/harness-run fix-only
该命令会返回当前 Run 的权威视图（JSON），包含 runId、revision、phase（如 AUDIT）和状态。
- 查看状态
/harness-status [run-id]
- 恢复 Run
/harness-resume <run-id>
此命令会校验工作区与快照一致后恢复 Run。工作区的任何变更都会导致恢复失败。
- 取消 Run
/harness-cancel [run-id]
本地发布包构建¶
如需构建本地发布包：
python3 release.py
该脚本会先执行 npm run harness:full（包含 68 个自动化用例），成功后使用禁用生命周期脚本的 npm pack 在临时目录构建并校验包，最后将包放入 dist/。该脚本仅构建本地 .tgz，不上传至 registry。
完整验证¶
npm run harness:full
此命令包含类型检查、Lint、68 个自动化测试、构建和打包 dry-run 验证。
适用场景与注意¶
- 版本锁定：dev-harness-dsh 版本 0.1.0 与 DeepSeek Harness 0.1.0-rc.8 精确锁定，不声明跨 rc 兼容。
- 运行权限：插件以当前 DSH 进程的权限运行，请确保安装前已审查源码。
- 环境要求：Node.js 版本需满足
^22.19.0 || >=24.0.0。 - 许可证：插件未在资料中声明许可证，使用前请自行确认合规性。
总结¶
dev-harness-dsh 为 DSH 用户提供了结构化的开发流程编排能力，通过可恢复的 Run 管理代码审计与修复流程，适合需要自动化与标准化开发链路的团队。更多细节与源码，请访问 GitHub 仓库。
