dsh-auto-review · DSH Hub


🔌 官方接缝	`approval/request` waterfall 上的 answerer；不接管的请求一律 `next()` 委托——人类审批流程绝不被短路。
🧠 第二模型裁决	一次性 fork 子代理，只读工具白名单（`read`/`glob`/`grep`）+ 结构化裁决 schema `{ decision, reason, riskLevel }`。
🛡️ fail closed	审查代理崩溃、超时、schema 不符都绝不放行：按 `fallbackPolicy` 回退，默认 `rejected`。
🧩 配置驱动路由	每工具策略（`ai`/`human`/`never`）+ 正则风险规则，全部可在 cordis.yml 中修改。
💬 拒绝理由到达模型	审查理由经 callId 注入被拒工具结果，agent 据此调整。
📜 完整审计链	`autoReview/verdict` 会话事件（审查代理身份/裁决/理由/风险/耗时）+ invariant 伴生强制「模型可见 ⟺ 已记录」。
🔁 防递归	审查代理自身的审批请求按身份识别并委托；`maxDepth` + 工具白名单保证其无法再委派。
⌨️ 会话级命令	`/auto-review on

                       approval/request waterfall（answerer 链）
                        │
┌───────────────────────┴──────────────────────┐
│ dsh-auto-review answerer                     │
│  · 会话已启用？  · 策略 = ai？               │  否 ── next() ──▶ 人类 answerer（UI）
│  · 风险规则 → toolsPolicy → 默认值          │
└───────────────────────┬──────────────────────┘
                        │ 是
                        ▼
        ┌───────────────────────────────────┐
        │ 审查子代理（fork，一次性）          │
        │  · toolFilter：read/glob/grep     │
        │  · outputSchema：{decision,       │
        │    reason, riskLevel}             │
        │  · 超时 + req.signal 中止          │
        └───────────────┬───────────────────┘
                        │ 裁决 / 失败（fail-closed 回退）
                        ▼
 allow → allowed-once        deny → rejected，理由注入被拒工具结果
                                        （经 callId 关联）
                        │
                        ▼
 审计：approval/asked → autoReview/verdict → approval/decided
       （会话事件，log-only，invariant 校验）

# 1. npm tarball（构建产物，无需构建许可）
pnpm pack                       # → dsh-auto-review-0.1.0.tgz
dsh plugin --profile web add ./dsh-auto-review-0.1.0.tgz
dsh --profile web               # 重启生效

# 2. git 源（钉住 commit；自包含 prepare 负责构建）
#    pnpm ≥ 10 默认阻止生命周期构建：先把提示的 allowBuilds 键
#    加入 profile 的 pnpm-workspace.yaml。
dsh plugin --profile web add "github:PerryLink/dsh-auto-review#"

# 3. 本地 link（开发调试）
dsh plugin --profile web add link:/path/to/dsh-auto-review

dsh --profile web --dump-config | grep -A4 'id: auto-review'

键	默认	含义
`enableByDefault`	`true`	会话初始是否启用；`/auto-review on\|off` 写入的 durable 覆盖优先于它
`toolsPolicy.default`	`human`	未列出工具的策略（委托人类 answerer）
`toolsPolicy.overrides`	`{}`	每工具策略：`ai`（AI 裁决）、`human`（强制人类）、`never`（确定性拒绝）
`riskRules`	`[]`	`{pattern, policy}` 按顺序匹配请求 reason（首个命中生效），先于工具表
`reviewerProvider`	`fork`	审查代理的 subagent provider（进程内 fork 后端）
`reviewerModel`	(继承)	审查模型 id；不设则继承会话 agent 的模型路由
`reviewerTimeoutMs`	`60000`	裁决截止时间；超时走回退策略
`reviewerTools`	`[read, glob, grep]`	审查子代理的工具白名单——其余工具在其中不可见
`fallbackPolicy`	`rejected`	审查失败处理：`rejected`（fail closed）、`delegate`（继续沿链）、`allow-readonly`（放行——见安全边界）
`maxReviewsPerTurn`	`10`	每个开放回合的裁决预算；耗尽后委托人类
`reasonMaxChars`	`2000`	审查理由与脱敏参数预览的长度上限
`reviewerGuidance`	(无)	追加进审查 prompt 的可选指导语（建议性，非硬规则）

- insert:
    - id: auto-review
      name: dsh-auto-review
      config:
        toolsPolicy:
          overrides: { bash: ai, write: ai, edit: ai }
        riskRules:
          - pattern: '(?i)(rm\s+(-[a-z]+\s+)*/|git\s+push\s+--force)'
            policy: never
        reviewerTimeoutMs: 30000
        fallbackPolicy: delegate

/auto-review on|off|status

pnpm install                # node ^22.19 || >=24
pnpm run typecheck          # tsc，src + 测试
pnpm test                   # vitest：61 个测试、6 个套件
pnpm run build              # tsc 声明 + tsdown 打包（lib/）
pnpm run verify:self-contained
pnpm pack                   # 发布产物

dsh-auto-review

安装

说明文档

🤖 dsh-auto-review

为什么用第二个模型而不是规则？

✨ 特性

工作原理

🚀 快速开始

⚙️ 配置

⌨️ 会话级命令

🔒 安全边界

⚠️ 已知局限

🏷️ GitHub 话题

🔗 相关项目

🧑‍💻 开发

📄 License