DeepSeek Harness 并行多角色代码评审插件：dsh-review-squad

前言¶

DeepSeek Harness (DSH) 提供了子代理注册表和并行工具能力，这使得实现复杂的代码审查工作流成为可能。现有的 DSH Git 插件多停留在 diff 查看或工作区清理阶段。dsh-review-squad 利用 DSH 的并行子代理特性，将代码审查转化为一个标准化的工作流步骤。

是什么¶

这是一个并行多角色代码评审插件。它通过 /review 命令派出四名只读评审员子代理（安全、正确性、测试、风格），每名评审员可独立配置模型与思考强度，最终汇总为按严重度分组的结构化报告。

核心功能¶

并行多角色评审：同时进行安全、正确性、测试和风格四类检查。
只读模式：评审员被严格限制，禁用写入、子代理、Web 搜索等工具，确保环境安全。
独立配置：每名评审员可指定不同的模型（如安全用强模型，风格用快模型）和思考强度。
后台执行：默认作为后台任务运行，不阻塞对话。
结构化报告：汇总报告按严重度分组，方便快速定位问题。
热更新配置：支持通过 Web UI 或 settings.yaml 实时覆盖配置，无需重启。

安装与启用¶

使用前需确保 DeepSeek Harness (dsh) 版本 ≥ 0.1.1-rc.2。

dsh plugin --profile web add dsh-review-squad

典型用法¶

Slash Command¶

在聊天中直接使用以下命令：

/review                          # 完整小队评审未提交更改
/review staged                   # 仅评审暂存区更改
/review commit abc1234           # 评审指定提交
/review path src/lib             # 评审指定路径
/review security tests           # 仅评审特定角色
/review --style                  # 排除风格评审
/review stop                      # 停止当前评审会话

Tool¶

Agent 也可以调用 code_review 工具，参数包括：
* scope: 评审范围（diff / staged / commit:<sha> / path:<dir-or-file>）
* focus: 附加关注点
* reviewers: 评审员列表（逗号分隔，--key 可排除）

配置说明¶

支持在 ~/.dsh/settings.yaml 中通过 review-squad: 节点覆盖配置，或使用 Web UI 设置页面修改。

# ~/.dsh/settings.yaml
review-squad:
  language: zh
  timeoutMs: 300000
  reviewers:
    - key: security
      role: Security reviewer
      instructions: Hunt for injection, authz gaps, committed secrets, unsafe crypto.
      agentOptions:
        provider: deepseek-official
        model: deepseek-v4-pro
        reasoningEffort: max
    - key: style
      role: Style reviewer
      instructions: Naming, duplication, complexity, conventions.
      agentOptions:
        provider: my-cheap-gateway
        model: glm-4.6-flash

适用场景与注意¶

依赖：依赖 @deepseek-ai/dsh-base 提供的 spawn 和 tool-str-replace-editor。
权限限制：插件以当前 DSH 进程权限运行，评审员工具被严格限制，无法写入文件或调用外部网络。
报告限制：报告生成有最大字符数限制（maxReportChars），超过后会丢弃 INFO → LOW → MEDIUM 严重度的内容。
合规性：插件遵循 MIT 许可证，建议在安装前检查源码。

结语¶

对于需要在 DSH 工作流中集成深度、自动化代码审查的场景，该插件提供了灵活且可控的解决方案。更多细节与源码可参考项目仓库。