[English](README.en.md) | [中文](README.md)

# 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 字符）：

  ```text
  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 仓库装配（推荐）

```bash
dsh plugin --profile web add github:AntaresCorn/dsh-auto-reviewer
```

或手动 clone 后装配（仓库已提交编译好的 `lib/`；本地目录装配前需先装好开发依赖并链接宿主包）：

```bash
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`。

### 本地构建

```bash
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 指向的运行时依赖来源。

## 使用方法

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