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）的桌面提醒插件：它监听智能体运行状态，在以下三种时刻提醒你回到页面：

提醒方式

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（包根目录）所有字段均可省略，缺省值如下：

通知权限

浏览器通知需要用户授权：页面首次点击时插件会自动请求 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 反馈与贡献。