AntaresCorn/dsh-auto-reviewer

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 预设。
• 自动授权提示：自动放行/拒绝时都会向对话流注入一条 Codex 风格的提示（放行：Automatic approval review approved (risk: low, authorization: unknown): Auto-review returned a low-risk allow decision.；拒绝：Automatic approval review denied (risk: high, authorization: unknown): Auto-review returned a high-risk deny decision.），方便追踪哪些提权被自动裁决。
• 自动补齐权限图标：安装插件后会自动为已安装的 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/（仓库已提交编译产物，普通用户无需构建）

安装/注入后必须完全重启 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 指向的运行时依赖来源。

使用方法

1. 打开一个新会话（或已有会话）。
2. 在权限弹窗/设置中选择 auto-review。
3. 正常让模型工作。当模型因为沙箱拒绝而请求 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