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，弹出系统通知、闪烁标题、播放页面提示音。