dsh-yolo-mode

Readme

# dsh-yolo-mode

> DeepSeek Harness 插件：用大模型自动裁决沙箱**升权申请**（LLM-powered auto-approval）。

当会话处于可写沙箱模式、审批策略为 `ask` 时，`dsh-yolo-mode` 拦截 `escalate sandbox to ...` 升权申请，按你选择的**预设**或**自定义权限层级**由大模型裁决「放行 / 拒绝 / 转人工」。任何不确定或失败路径都不会放行（**fail-closed**）。

[![npm version](https://img.shields.io/npm/v/dsh-yolo-mode)](https://www.npmjs.com/package/dsh-yolo-mode)
[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-0.1.0--rc.6-blue)](https://github.com/deepseek-ai/deepseek-harness)
[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)

---

## 功能特性

- **LLM 自动裁决**：在 `workspace-write` 会话中，对 `danger-full-access` / `workspace-write` 升权申请调用大模型分级（`allow / deny / unsure`），确定时免去人工弹窗。
- **内置预设**：`off` / `strict` / `balanced`（默认）/ `permissive` / `yolo` / `custom`，覆盖从「全部转人工」到「确定性全放行」的完整光谱。
- **自定义层级**：`levels` 支持逐目标模式、逐工具（`tools.<toolName>`）的 `allow / judge / delegate / deny` 策略，及 `error` / `unsure` 回退。
- **每预设默认提示词**：`judge.systemPrompt` 留空时按预设自动选用对应裁判提示词（strict 最保守、permissive 宽松、custom 按层级表）。
- **图形化配置**：设置面板「YOLO 审批」页在线修改预设 / 生效模式 / 裁判模型（下拉选择）/ 层级表，保存即生效；输入栏状态 chip + 决策统计面板。
- **完整审计**：每次裁决落 JSONL 日志，含工具、目标模式、当前模式、理由、决策与结果；状态弹窗一键「打开日志」用系统默认应用查看。
- **fail-closed**：超时、非法输出、模型不可用、并发溢出等一切异常路径都回退为「拒绝」或「转人工」。

## 安装

### 1. 安装插件包

```bash
# 从 npm
dsh plugin --profile web add dsh-yolo-mode

# 或从本地路径
dsh plugin --profile web add <项目绝对路径>
```

### 2.（可选）覆盖插件配置

`dsh plugin add` 会通过插件包自带的 `cordis.patch.yml` 自动挂载 `yolo-mode` 与
`yolo-mode-bridge` 两个入口，**不需要**再手动 `insert`。需要调整配置时，在
`$DSH_HOME/profiles/web/cordis.patch.yml` 里按 id 覆盖主条目即可：

```yaml
- id: yolo-mode
  name: dsh-yolo-mode
  config:
    preset: balanced
    judge:
      provider: <provider>
      model: <model>
```

> 注意：不要再用 `- insert:` 添加 `yolo-mode` / `yolo-mode-bridge`，否则启动会报
> `duplicate loader entry id: yolo-mode`。

重启 DSH 并刷新浏览器后生效。

### 安装注意事项

- 推荐直接 `dsh plugin --profile web add dsh-yolo-mode`（npm 发布版已包含构建产物，
  peer 依赖由 DSH 的 `$DSH_HOME/profiles/node_modules` fallback 提供，开箱即用）。
- 本地 `link:` 开发时，checkout 需位于 `$DSH_HOME/profiles/` 下（或仓库自带
  node_modules），否则 `@deepseek-ai/*` peer 依赖会因 Node 按真实路径解析而报
  `ERR_MODULE_NOT_FOUND`。

## 配置

插件行 `config` 全字段可选，未填按默认值：

| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| `preset` | `off\|strict\|balanced\|permissive\|yolo\|custom` | `balanced` | 使用的预设；`custom` 时以 `levels` 为准 |
| `modes` | `string[]` | `['workspace-write']` | 会话有效沙箱模式 ∈ 此列表时才介入（`read-only` / `workspace-write` / `danger-full-access`） |
| `levels` | `object` | `{}` | 权限层级表；`levels.tools.<toolName>` 对任意预设逐工具覆盖 |
| `judge.provider` | `string` | `''` | 裁判模型 provider；空 = 未配置（judge 决策按错误回退） |
| `judge.model` | `string` | `''` | 裁判模型；与 provider 同非空才启用裁判 |
| `judge.systemPrompt` | `string` | `''` | 裁判 system prompt；空 = 按预设取默认 |
| `judge.timeoutMs` | `number` | `20000` | 单次裁判超时（毫秒） |
| `judge.maxTokens` | `number` | `256` | 裁判输出最大 token 数 |
| `judge.concurrency` | `number` | `2` | 并发裁判上限，溢出按错误回退 |
| `includeSubagents` | `boolean` | `true` | 子代理会话是否同样裁决 |
| `auditFile` | `string` | `''` | 审计日志路径；空 = `%TEMP%/dsh-yolo/judge.log` |

### 权限层级（`levels`）

```yaml
levels:
  workspace-write: judge        # 目标模式 → 策略
  danger-full-access: judge
  error: delegate               # 裁判错误回退
  unsure: delegate              # 裁判不确定回退
  tools:
    pwsh: delegate              # 逐工具覆盖，优先级最高
    write: allow
```

策略取值 `allow | judge | delegate | deny`；优先级：`levels.tools[toolName]` → 基础行（`custom` 时为 `levels[targetMode]`，其余预设为内置表）。

## 预设

| 预设 | `workspace-write` | `danger-full-access` | 失败回退 | 不确定回退 | 说明 |
|---|---|---|---|---|---|
| `off` | delegate | delegate | delegate | delegate | 不介入，全部转人工 |
| `strict` 严格 | judge | delegate | rejected | delegate | 仅裁决 `workspace-write`；`danger-full-access` 恒转人工 |
| `balanced` 均衡（默认） | judge | judge | delegate | delegate | 裁决全部升级目标；失败 / 不确定转人工 |
| `permissive` 宽松 | judge | judge | delegate | **allowed-once** | 裁决全部目标；不确定视为允许（慎用） |
| `yolo` | allow | allow | — | — | 确定性全放行，零 LLM 调用 |
| `custom` | 依 `levels` | 依 `levels` | 依 `levels.error` | 依 `levels.unsure` | 全字段开放 |

每预设默认裁判提示词（`judge.systemPrompt` 留空时自动选用）：

| 预设 | 默认裁判立场 |
|---|---|
| `off` / `yolo` | 不调用裁判 |
| `strict` | 最保守：`danger-full-access` 一律拒绝；仅最小范围 `workspace-write` 且理由极充分才允许 |
| `balanced` | 通用审计：只依据事实、防回环、存疑即 deny/unsure |
| `permissive` | 宽松：理由合理且范围可接受即倾向允许，仅明显破坏性 / 供应链风险拒绝 |
| `custom` | 按 `levels` 层级表裁决，存疑按 `levels.error` / `levels.unsure` 回退 |

## 界面

- **输入栏 chip**：显示 `YOLO <preset>`，点击弹出统计面板（总审批 / 放行 / 拒绝 / 转人工 + 最近决策表，每页 5 条，带上一页 / 下一页翻页）。
- **打开日志**：弹窗右上「打开日志」按钮用系统默认应用打开审计 JSONL（`auditFile` 配置或默认 `%TEMP%/dsh-yolo/judge.log`）；文件尚不存在时提示暂无记录。
- **设置页**：「YOLO 审批」页在线修改预设、生效沙箱模式、裁判模型（provider / model 下拉，取自 Harness 模型配置）、层级表（JSON）；切换预设时自动预填充该预设的默认提示词与层级表。

## 安全

- **fail-closed**：只有明确得到 `allow` 才返回一次性 `allowed-once`；其余一切路径拒绝或转人工。
- **防回环**：裁判 prompt 与 agent 上下文隔离，防止模型借 Web 审批回环自批准 `danger-full-access`。
- **不改写策略**：仅在 `ask` 策略下作为应答者，不改变 DSH 的沙箱 / 审批词汇。
- **默认保守**：默认预设 `balanced`（不确定转人工），不默认启用 `permissive` / `yolo`。
- **审计**：每次裁决落一行 JSONL，含 `{time, sessionId, origin, toolName, callId?, targetMode, currentMode, justification, decision, outcome, reason?}`。

## 开发

```bash
npm test        # node --test 全量测试
npm run build   # 构建客户端 bundle（rolldown）
```

## 许可

[MIT](LICENSE)