D
dsh-alert
deepvite/dsh-alert
Desktop alerts for DeepSeek agent states: browser Windows notifications plus PowerShell sounds.
安装
dsh plugin --profile web add github:deepvite/dsh-alertREADME
dsh-agent-alert
DeepSeek Harness 任务状态提醒插件：当智能体任务完成、出错或等待审批时，弹出 Windows 浏览器通知并播放提示音。 Desktop alert plugin for DeepSeek Harness: pops a Windows browser notification and plays a sound when the agent finishes a task, errors out, or awaits approval.
中文 | English
这是什么
dsh-agent-alert 是 DeepSeek Harness（DSH）的桌面提醒插件：它监听智能体运行状态，在以下三种时刻提醒你回到页面：
| 状态 | 通知标题 | 说明 |
|---|---|---|
| 回答完成 | DeepSeek 回答完成 | 一次回答已完成，可以回来继续操作 |
| 出错 | DeepSeek 出错 | 任务异常（附加错误信息） |
| 等待审批 | DeepSeek 等待审批 | 有操作需要你在页面确认 |
提醒方式
- 浏览器通知：Windows 系统通知（
Notification），点击可聚焦回页面； - 标题闪烁：标签页标题短暂加上 "BELL …" 前缀；
- 页面提示音：Web Audio 双音哔声（可选）；
- 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，弹出系统通知、闪烁标题、播放页面提示音。
版本与许可
欢迎通过 Issues 反馈与贡献。