前言¶
DeepSeek Harness（DSH）采用插件化架构，将功能扩展视为独立的契约。在工程开发场景中，当 Agent 需要修改代码或执行发布验证时，如果没有受治理的流程，这些操作往往是不可审计的。dsh-engineering-control-plane 插件通过将一次实现、修复或验证请求固定为一个可追踪的 Mission，提供了受治理的工程任务执行能力。
是什么¶
该插件是 DeepSeek Harness 的工程任务编排与发布门禁插件，由 bailong-Hakuryu 维护。它负责把 Agent 的工程目标转化为明确的 Mission，并控制其单向阶段推进。通过绑定 Evidence（证据）和 Quality Gate（质量门禁），它确保了从“谁改的”到“为什么放行”的完整链路可追溯。
核心功能¶
插件提供以下核心能力：
* 任务编排与发布门禁：管理工程任务的执行流程与发布准入。
* 状态跟踪：提供任务路由、计划执行、验证和状态跟踪。
* 单向阶段推进：Mission 按固定顺序推进，不可逆。
* Evidence（证据）绑定：将角色输出、验证结果等摘要绑定，作为审核依据。
* Quality Gate（质量门禁）：基于确定性规则判断任务是否通过。
* 持久化与恢复：使用 SQLite 持久化数据，支持从 BLOCKED 或 REWORK_REQUIRED 状态恢复。
* 只读完整性检查：提供 doctor 命令验证 SQLite 数据与 Schema。
* 路由支持：支持被动路由（自然语言指令）和主动指令（/mission）。
安装与启用¶
安装前请确保已安装 DeepSeek Harness CLI，且运行环境满足 Node.js 版本要求（^22.19.0 || >=24.0.0）。
- 下载对应版本的 Release tarball（当前为 v0.2.2）。
- 使用官方命令安装插件。
dsh plugin --profile web add D:\Downloads\dsh-engineering-control-plane-0.2.2.tgz
- 检查最终配置组合。
dsh --profile web --dump-config
- 在目标 Git 仓库目录启动 Harness Web。
dsh web
默认配置下，插件会绑定当前工作目录为 current-workspace，并读取仓库的 package.json 来运行 test（必需）、typecheck 和 build 脚本。验证过程中不会触发 postinstall 等安装钩子，依赖需提前安装好。
典型用法¶
插件支持两种调用方式：
被动调用（推荐）
直接描述工程目标，模型会将请求路由到 Mission 工具。
请为当前仓库实现这个功能，并在完成后运行完整验证。
请修复这个问题，所有修改必须经过 Mission 发布门禁。
主动调用
在 Harness Web 或 CLI 中直接输入指令。
/mission 为当前仓库执行一次发布前验证，要求测试、类型检查和构建全部通过
如果明确不需要治理流程，可以指定“直接模式，不创建 Mission”。
使用说明与注意¶
在使用该插件时，请注意以下事实：
- 验证命令来源：验证命令来自宿主配置，不由模型临时编造。
- 门禁逻辑：只有确定性 Quality Gate 可以产生
APPROVED状态。 - 证据完整性：缺失、损坏、截断或不确定的证据会导致任务
fail closed。 - 并发限制：一个工作区同时只允许一个非终态 Mission。
- 依赖处理：验证时绝不先安装依赖，因此不会触发仓库的
postinstall等钩子。 - 职责边界：该插件负责工程治理，不等同于漏洞扫描器；安全评估由可选的 Security Assurance 插件负责。
总结¶
dsh-engineering-control-plane 通过引入 Mission、Evidence 和 Quality Gate，将 Agent 的代码修改行为转化为受控、可审计的工程流程。它适合需要严格治理流程的团队，通过单向阶段推进和 SQLite 持久化，保证了执行过程的完整性与可恢复性。更多细节可查阅 GitHub 仓库。
