dsh-approval-alert

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-approval-alert

DeepSeek Harness（dsh）审批提醒插件：当会话**等待审批**或**等待你回答提问**时，即使你在浏览器的其他标签页刷视频、或者在使用其他软件，也会**弹系统通知、响提示音、标签页标题闪烁**提醒你回 dsh 处理，避免会话一直干等。

## 特性

- ✅ 同时覆盖两种"卡住等你"的场景：**审批**（approval）与**用户提问**（question）
- ✅ 三种提醒手段：桌面通知（Web Notification）+ 提示音（WebAudio）+ 标签页标题 `[审批]/[提问]` 前缀
- ✅ 重复提醒：未处理期间按设定间隔（默认 30s）重复提醒，直到你处理或切回页面
- ✅ 设置页开关：总开关 / 提示音 / 重复间隔 / "开启通知并测试"按钮
- ✅ 通知内容自动带上审批工具名、原因或提问内容
- ✅ **v2 主机端通知**：由 dsh 进程直接弹系统通知（node-notifier），**浏览器标签页关闭、没有 GUI 连接也能提醒**
- ✅ 偏好存 localStorage，无服务器依赖

## 安装

### 从 npm 安装（发布后）

```powershell
dsh plugin --profile web add dsh-approval-alert
# 或
npm i -g dsh-approval-alert   # 若作为全局插件分发
```

## 使用

1. 打开 dsh web → **设置 → 审批提醒**
2. 点击 **「开启通知并测试」** 授权浏览器通知权限（浏览器要求权限必须来自点击手势）
3. 按需调整：提示音、重复提醒间隔（0 = 不重复）
4. 之后当会话需要审批/提问而你不在页面上时，就会收到提醒；点击通知可切回 dsh 窗口

## 工作原理

### 浏览器端（v1）

- 插件注册到客户端 `conversation.input.dock` 插槽（与官方 todo / 队列面板同插槽，多渲染、互不冲突），用套件提供的 `useSession` 钩子订阅当前会话快照的 `pending` 列表
- 过滤出 `approval` / `question` 两种 pending（与 dsh 自带审批弹窗、提问面板**同源数据**）
- 挂载期间若页面隐藏或失焦：立即提醒一次，并按设定间隔重复
- 处理完成（pending 消失）或你切回页面（`visibilitychange` / `focus`）→ 停止提醒、恢复标题
- 通知 `tag` 按审批/提问 id 区分：同一 pending 的重复提醒合并不堆叠，不同 pending 各弹各的

### 主机端（v2）

- 主机半（`lib/index.js`）**仅监听 `approval/asked` / `approval/decided` 会话事件**（纯观察者，不触碰 `approval/request` waterfall，避免干扰 GUI 审批通道）
- 每次 `approval/asked` 后**延迟 `delayMs`（默认 5s）检查**：若该审批仍未被应答（你没答）→ 弹系统通知；若 `approval/decided` 以 `unavailable` 结束（无 GUI 连接、无人应答）→ 立即通知
- 通知用 **node-notifier**（Windows snoretoast / macOS terminal-notifier / Linux notify-send），由 dsh 进程直接发送，**与 UI 形态无关**
- 配置 `host-config.json`（插件目录内）：`{ "enabled": true, "delayMs": 5000 }`，改完即生效，无需重启
- 说明：浏览器开着时，v2 的延迟通知相当于一条"跟进提醒"；只想用浏览器端提醒可把 `enabled` 设为 `false`

## 环境兼容性（FAQ）

| 使用环境 | v1 浏览器通知 | 声音/标题 | v2 主机端通知 |
|---|---|---|---|
| Chrome / Edge（普通标签页） | ✅ | ✅ | ✅ |
| Chrome / Edge「安装为应用」独立窗口 | ✅ | ✅ | ✅ |
| 桌面端（Electron 内核） | ✅（Chromium 支持 Notification） | ✅ | ✅ |
| 桌面端（系统 WebView，如 Tauri / WebView2） | ⚠️ 可能不支持（无 Notification API 与权限 UI） | ✅ | ✅ |
| 无 GUI / 浏览器关闭 | ❌ | ❌ | ✅ |

- **v2 与 UI 形态无关**：由 dsh 进程（node 侧）经 node-notifier 发送，浏览器、桌面端、CLI 都适用
- **v1 依赖渲染环境**：Chrome/Edge（含安装为应用）与 Electron 支持 Web Notification；系统 WebView（WebView2 / WKWebView）通常不支持 → v1 通知静默失效，但声音、标题闪烁不受影响，v2 兜底

### 浏览器通知权限授权（Edge / Chrome）

1. 打开 dsh 页面 → **设置 → 审批提醒**
2. 点击 **「开启通知并测试」**——若显示 `权限: default`，浏览器会弹出授权请求，点 **允许**
3. 若之前误点了"阻止"（显示 `权限: denied`），`requestPermission()` 不会再询问，必须手动改回：
   - **Edge**：地址栏左侧网站信息图标 → **网站权限** → **通知** → **允许**；或 Edge 设置 → Cookie 和网站权限 → 通知 → 找到 `127.0.0.1` → 允许
   - **Chrome**：地址栏左侧锁形图标 → **网站设置** → **通知** → **允许**；或 Chrome 设置 → 隐私和安全 → 网站设置 → 通知 → 找到 `127.0.0.1` → 允许
4. 改完**刷新页面**，再点「开启通知并测试」验证

### Windows 弹不出通知的排查（与浏览器无关）

1. 设置 → 系统 → 通知 → **「获取来自应用和其他发送者的通知」** 开启
2. 应用列表中找到 **Chrome / Edge** → 通知开启
3. **请勿打扰**（专注助手）关闭
4. 浏览器 / dsh **不要以管理员身份运行**（Windows 会抑制提权进程的 toast）
5. 通知中心有旧队列时先清空（tag 冲突会导致新通知被替换进队列而不弹出）

## 未来方向（Roadmap）

- **工作区级提醒** —— 当前只提醒当前会话；后续可扩展为工作区内任意会话的审批都提醒（侧栏"等待审批"角标同源数据）
- **通知点击跳转** —— 目前点击通知只聚焦窗口；后续可携带会话/审批 id 直接跳转到对应会话

## 许可

MIT