dsh-quorum：DeepSeek Harness 机制强制的纪律层

前言¶

DeepSeek Harness (DSH) 的 Agent Teams 在协作中常遇到四个典型问题：权限失控、讨论边界模糊、成本事后可见、报告缺乏证据。现有的解决方案（如 firstmate）只能“礼貌请求”模型遵守纪律，因为终端 Harness 没有其他钩子。dsh-quorum 在机制层面强制执行这四项纪律。一个只读审核者不会“选择”不编辑文件；它无法编辑。

本质¶

这是一个插件包，不是运行时。DSH 的会话、模型请求、工具、Agent 循环、名册、邮箱、任务板和 Web UI 仍由 DSH 拥有。此插件包仅在顶层添加策略，并读取 DSH 已记录的持久化事实。

安装与前置条件¶

安装前需确认 DSH 版本在 >=0.2.0-rc.2 <0.3.0 范围内。该插件依赖 DSH 的 Agent Teams 服务，因此必须按顺序安装三个包：Web 应用、Agent Teams 配置文件，最后是 dsh-quorum。

dsh plugin --profile <name> add -w @deepseek-ai/dsh-web-app@0.2.0-rc.2
dsh plugin --profile <name> add -w @deepseek-ai/dsh-experimental-agent-team-profile@0.2.0-rc.2
dsh plugin --profile <name> add -w dsh-quorum@0.3.3

版本说明¶

0.3.3：当前发布版本，也是第一个通过 CI 发布并带有签名证明的版本。
0.3.2：从未发布到 npm（发布失败），已安装该版本的用户代码相同，无需迁移。
0.3.1：由维护者机器发布，不包含签名证明。
0.0.0-stage：npm 发布流程中的占位符，如果在 npm view 中看到此版本，说明处于发布窗口期，应重试。

安装速度¶

第一次安装命令较慢，主要因为 @deepseek-ai/dsh-web-app 需要拉取约 300 个包。实测在冷配置下安装 dsh-quorum 约需 24.5 秒，从 0.3.1 升级到 0.3.3 约需 36 秒。

使用与配置¶

版本锁定：如果关心实际运行的代码，必须锁定版本。上游建议锁定 Git 修订版，因为默认分支的后续推送会更改安装时的代码。
工作区标志：必须传递 -w 标志，因为 profile 是 pnpm workspace，不加该标志会报错。
依赖检查：必须先安装 Agent Teams 包，否则插件会静默失败，仅输出一条警告。

# 锁定版本安装
dsh plugin --profile <name> add -w 'github:141w/dsh-quorum#v0.3.3'

覆盖配置¶

插件行来自插件包层，用户层通过 cordis.patch.yml 进行覆盖。用户层不支持手动创建全新的插件行，只能针对已存在的行进行 id 定向覆盖。

- id: quorum
  name: dsh-quorum
  config: { ... }

注意事项¶

升级风险：从 0.1.0 到 0.3.1 升级可能会损坏会话。因为在这些版本中注入的 quorum_wait 消息缺少 id 和 role，导致会话无法再次打开。
静默失败：如果缺少 Agent Teams 包，插件不会崩溃，只会输出一条警告并保持待激活状态。
许可证：该插件采用 MIT 许可证，允许在 DSH 进程权限范围内运行。

结语¶

dsh-quorum 通过机制强制纪律，解决了 Agent Teams 开发中的核心协作痛点。如需查看完整文档或源码，请访问：GitHub 或社区目录。