任务状态提醒DeepVite/dsh-alert

dsh-agent-alert

DeepSeek Harness 任务状态提醒插件：当智能体任务完成、出错或等待审批时，弹出 Windows 浏览器通知并播放提示音。
DeepSeek Harness 的桌面提醒插件：当智能体完成任务、出错或等待审批时，弹出 Windows 浏览器通知并播放提示音。

这是什么

dsh-agent-alert 是 DeepSeek Harness（DSH）的桌面提醒插件：它监听智能体运行状态，在以下三种时刻提醒你回到页面：

| 状态 | 通知标题 | 说明 |
| --- | --- | --- |
| 回答完成 | DeepSeek 回答完成 | 一次回答已完成，可以回来继续操作 |
| 出错 | DeepSeek 出错 | 任务异常（附加错误信息） |
| 等待审批 | DeepSeek 等待审批 | 有操作需要你在页面确认 |

提醒方式

1. 浏览器通知：Windows 系统通知（Notification），点击可聚焦回页面；
2. 标题闪烁：标签页标题短暂加上 "BELL …" 前缀；
3. 页面提示音：Web Audio 双音哔声（可选）；
4. PowerShell 提示音：Node 端通过子进程静默播放（[console]::beep 双音，或系统 WAV 文件）。

同类提醒 1 秒内只触发一次，避免刷屏。

安装

npm exec -- dsh plugin --profile web add dsh-agent-alert

或者直接从 GitHub 仓库安装：

npm exec -- dsh plugin --profile web add github:DeepVite/dsh-alert

也可以作为本地工作区包放入 web profile，并在 cordis.patch.yml 中插入：

- insert:
- id: dsh-agent-alert
name: 'dsh-agent-alert'

安装完成后重启 dsh web 并刷新页面。

配置

config.json（包根目录）所有字段均可省略，缺省值如下：

| 字段 | 缺省 | 说明 |
| --- | --- | --- |
| enabled | true | 总开关 |
| states.done | true | 完成时提醒 |
| states.error | true | 出错时提醒 |
| states.approval | true | 等待审批时提醒 |
| sound.enabled | true | 声音开关 |
| sound.kind | "beep" | beep 或 wav |
| sound.beepFreq | 880 | beep 基频（Hz） |
| sound.beepDurationMs | 300 | beep 时长（ms） |
| sound.wavPath | C:\Windows\Media\Windows Notify.wav | wav 模式播放的文件 |
| browserNotify | true | 浏览器通知开关 |
| pollIntervalMs | 1000 | 浏览器端轮询间隔（ms） |
| queueCap | 50 | 通知队列上限 |

通知权限

浏览器通知需要用户授权：页面首次点击时插件会自动请求 Notification 权限；也可以到 设置 → 常规 的 dsh-agent-alert 状态行点击"测试"按钮验证（会同时播放声音并闪烁标题）。

工作原理

- Node 端（lib/index.js）：监听 Agent 状态事件，通过子进程播放 PowerShell 声音，并把提醒事件写入 /dsh-alert/state 队列；
- 浏览器端（lib/client.js）：轮询 /dsh-alert/state，弹出系统通知、闪烁标题、播放页面提示音。

版本与许可

- CHANGELOG.md
- Apache-2.0

欢迎通过 Issues 反馈与贡献。