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 等待审批 | 有操作需要你在页面确认 |

提醒方式

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 反馈与贡献。