合并请求审查流水线ddtcorex/dsh-maestro-review

@ddtcorex/dsh-maestro-review

为 DeepSeek Harness 提供自动化合并请求审查：
可插拔的 ReviewProvider（优先支持 GitLab）、一个在全新工作树上启动审查者/审计者
子代理的编排器、用于 GitLab 事件的 webhook 接入，以及注入到 DSH Web 插槽中的
设置/隧道客户端 UI。

属于 Maestro Harness 套件（dsh-maestro-*）的一部分。Cordis 补丁行：
maestro-review-webhook（接入）、maestro-review-orchestrator（流水线）、
maestro-review-settings-rpc（设置 UI）——全部由这个 npm 包提供。

它提供什么

- ReviewProvider 抽象 —— 目前是 GitLab 客户端；其他代码托管平台可在同一
接口背后接入。
- 编排器 —— 审查者 + 审计者代理针对 MR 的一次性工作树运行，
模型选择可全局覆盖（reviewModel）以及按项目映射覆盖。
- Webhook 接入 —— 接收 GitLab MR 事件，将审查加入队列（去重 + 保留）。
- 审查发现/历史/信号 —— 发现由仅使用工具的审查子代理通过 review-findings
工具写入（绝不使用自由文本）；按 MR 跟踪历史 + 信号。
- Govard/工作区工具 在审查运行中可用。
- 客户端部分 —— 设置区段渲染到 DSH Web 插槽中；通知文案保留在
此处，投递则通过可选的 maestroNotifier 服务进行。

CI 审查者（无需本地检出）

同一流水线也可从 GitLab CI 无头运行：一个共享的审查者
项目（持有密钥 + 镜像）通过一个小型桥接作业为任意数量的源项目提供服务——
无需 DSH 主机，无需项目映射。快速运行
仅做 diff（或在设置了 REVIEW_PROFILE 时在真实检出上运行——仅审查者，
无审计者）；按需深度运行会克隆 MR head 并以仅审查者模式进行审查，附带
仅静态审计（容器中无 govard 运行时）。

完整设置、按场景的触发工作流（quick/deep × CI/webhook）、模型
选择以及故障排查：docs/ci-reviewer-setup.md。
模板位于 templates/，镜像位于 docker/。

设置

通过 共享命名空间设置存储
（~/.dsh/maestro/settings.json，由 @ddtcorex/dsh-maestro-config-lib 拥有）经由
src/config-store.ts 中的扁平适配器读取其配置；机器运行时状态保留在包本地的 sidecar 中。

安装

dsh plugin --profile web add @ddtcorex/dsh-maestro-review
或一次性安装全部：
dsh plugin --profile web add @ddtcorex/dsh-maestro-meta

开发

pnpm install
pnpm verify        # tsc --noEmit
pnpm test          # vitest run
pnpm build         # tsc -> lib/
pnpm run build:client   # 浏览器打包 -> lib/client.js（客户端变更后必需）

有关约定（主机/客户端拆分、密钥处理、实时验证规则），请参见 AGENTS.md。

发布

一次发布交付 两个必须保持同步的产物：npm
包和 ddtcorex/maestro-reviewer Docker 镜像——该镜像
从注册表安装 npm 包，而不是复制源代码，因此仅打标签发布还不足以将其交付给 CI 用户。简而言之：
更新 package.json + CHANGELOG.md + 三处镜像标签引用 →
打标签 vX.Y.Z（触发 npm 发布 + GitHub Release）→ 更新
profiles/reviewer-ci/package.json 自身的固定版本以匹配 → 重新构建并推送
Docker 镜像。完整的分步检查清单，包括 pnpm
供应链年龄门控变通方案，以及如何在完整发布前在镜像中实时测试修复：参见 AGENTS.md 中的 Release checklist。

许可证

MIT