English | 中文
dsh-auto-reviewer — Codex-style "approve for me" permission mode
为 DeepSeek Harness 提供类似 Codex Auto Reviewer / "approve for me" 的权限模式：
- 在现有 Permissions 列表中新增 auto-review 选项；
- 模型在沙箱中请求提权时，插件自动判断这次操作是否危险、是否已被用户明确确认；
- 安全操作自动同意（
allowed-once），危险/模糊操作转交用户确认，明显恶意/破坏性操作直接拒绝；
- 模糊场景可选调用 LLM 进行自动审查，LLM 不可用或拿不准时安全地退回人工确认。
这是一个社区项目，与 DeepSeek 官方无关。
特性
-
新增权限预设：通过 cordis.patch.yml 扩展官方 permission-presets 表，UI 的权限下拉框会多出 auto-review 选项，选择后写入 workspace-write + ask，并记录为 auto-review 预设。
-
结构化自动授权提示：自动放行/拒绝时注入一条 form: notice 的插件消息——折叠行显示单行摘要（如 approved(low) · bash · workspace-write · npm test），展开显示多行详情：判定结果、风险等级、授权依据、工具名、请求的沙箱模式、判断依据（命中的规则名 / 快路径 / LLM 理由）与实际命令（单行截断到 160 字符）：
Automatic approval review approved (risk: low, authorization: user-confirmed)
tool: bash
mode: workspace-write
basis: auto-approve: workspace-write escalation without a high-risk rule
request: run the tests
command: npm test
-
自动补齐权限图标：安装插件后会自动为已安装的 DSH 权限选择弹框补上 auto-review 图标（盾牌+星芒），与内置预设风格一致；升级或重装 dsh 后重启服务即自动重新补齐，浏览器强制刷新后生效。
-
审批瀑布前置：使用 ctx.on('approval/request', handler, true) 把自动审查器放在交互式 UI 应答者之前；返回 allowed-once/rejected 即直接裁决，调用 next() 则正常弹出人工确认。
-
多级安全策略：
- 快速放行：
workspace-write 且非高风险；
- 用户确认放行：最近用户消息中有明确“请执行/我确认/允许”等信号，且非致命破坏操作；
- 模糊转人工：LLM 返回
ask、LLM 不可用或超时；
- 直接拒绝：命中
blocklist，或未获用户确认的致命破坏操作（rm -rf /、mkfs、curl | sh 等）。
-
可选 LLM 审查：默认使用当前会话的 provider/model 对模糊请求做一次短输出 JSON 审查；可配置独立 llmProvider/llmModel。
安装
作为 GitHub 仓库装配（推荐）
dsh plugin --profile web add github:AntaresCorn/dsh-auto-reviewer
或手动 clone 后装配（仓库已提交编译好的 lib/；本地目录装配前需先装好开发依赖并链接宿主包）：
git clone https://github.com/AntaresCorn/dsh-auto-reviewer.git
cd dsh-auto-reviewer
npm install
npm run link-host
cd ..
dsh plugin --profile web add /path/to/dsh-auto-reviewer
说明：dsh plugin add /path/to/dir 会以 link: 方式指向该目录，所以装配前必须在仓库目录执行 npm install 和 npm run link-host。
本地构建
npm install # 安装 typescript / @types/node 等开发依赖
npm run link-host # 把 node_modules/@deepseek-ai 软链到已安装的 dsh 宿主包（避免重复副本）
npm run build # src/ → lib/（仓库已提交编译产物，普通用户无需构建）
npm test # node:test 单测：审批通知格式化与各决策分支
安装/注入后必须完全重启 DeepSeek Harness，新建会话，在权限选择器中选择 auto-review。
⚠️ 经验教训（2026-08-16 实测）：不要在运行中的对话里用 dev_install_package / dev_inject_plugin 热装载后继续对话。
热装载路径与正式 bundle 装配路径不一致，可能导致 loader/agent 上下文损坏（Cannot read properties of undefined (reading 'enabled')）。
正式安装请走官方 dsh plugin --profile web add <目录>，然后 systemctl --user restart dsh-web（或对应重启方式）。
开发目录的 node_modules 只用于本地编译/类型检查，不要让它成为 profile link 指向的运行时依赖来源。
使用方法
- 打开一个新会话（或已有会话）。
- 在权限弹窗/设置中选择 auto-review。
- 正常让模型工作。当模型因为沙箱拒绝而请求
sandbox_permissions 提权时，本插件自动裁决：
- 安全 → 自动放行；
- 有风险 → 弹出人工确认；
- 明确恶意/未确认的破坏性操作 → 拒绝。
配置
插件默认配置已在 cordis.patch.yml 中给出。你可以通过 profile 的 cordis.patch.yml 覆盖：
| 配置项 | 默认值 | 说明 |
|---|
presetName | auto-review | 本插件响应的权限预设名 |
llmProvider | '' | 审查 LLM provider，留空使用当前会话 |
llmModel | '' | 审查 LLM model，留空使用当前会话 |
maxContextMessages | 12 | 参与判断的最近用户消息数 |
autoApproveWorkspaceWrite | true | 自动放行非高风险 workspace-write 提权 |
autoApproveDangerFullAccess | true | 自动放行非高风险 danger-full-access 提权 |
autoApproveUserConfirmed | true | 用户明确确认且非致命破坏时放行 |
askOnAmbiguous | true | 模糊时转人工；false 则拒绝 |
rejectCritical | true | 未确认的致命破坏操作直接拒绝 |
useLlm | true | 对模糊请求使用 LLM 审查 |
timeoutMs | 10000 | LLM 审查超时 |
blocklist | [] | 自定义正则黑名单 |
blocklistMode | reject | 命中黑名单时 reject 或 ask |
extraInstructions | '' | 追加给审查 LLM 的指令 |
安全说明
- 任何内部异常都会失败关闭：调用
next() 转人工确认，不会自动放行。
- 自动放行只针对单次操作（
allowed-once），不会记住“永远允许”。
- 本插件不会绕过
never 策略：如果会话被切到 danger-full-access（approval: never），审批服务会在到达本插件前直接拒绝。
- 请先阅读源码再安装；本插件只做权限决策，不执行任何网络请求以外的 LLM 审查调用。
仓库结构
dsh-auto-reviewer/
├── cordis.patch.yml # 扩展权限表 + 装配插件
├── package.json # 插件包元数据（dsh.bundle.patch）
├── scripts/build.sh # tsc 构建脚本（无需 DSH checkout）
├── scripts/link-host-deps.sh # 软链宿主 @deepseek-ai 依赖（避免重复副本）
├── src/index.ts # 自动审查实现
├── README.md # 中文说明
└── README.en.md # English README
License
BSD-3-Clause
