DSH 运行时，任务完成、等待输入或失败时，插件会在桌面右下角弹出原生通知，并伴随音效。这解决了 AI 在后台等待确认时，用户因切换窗口而错过提示的问题。
功能说明¶
插件支持三类核心事件：任务完成、等待输入和任务失败。通知内容包含项目名、Git 分支、耗时、Token 和结果摘要，方便用户快速判断是否需要返回查看。
交互与防打扰¶
- 防轰炸：同类事件在 10 秒窗口内自动合并为一条通知。
- 渐进强提醒：等待输入类事件在 5 分钟未处理时，会自动升级重发。
- 防打扰机制：检测 DSH 窗口是否在前台，全屏状态下静默事件，支持按时间表设置勿扰时段（等待输入类事件默认豁免）。
扩展能力¶
- 音效：提供成功、等待、失败三套内置音效。
- 手机推送：支持 Bark、ntfy 和自定义 Webhook，等待输入和失败事件可推送到手机。
- 其他：支持历史记录与统计浮卡、关键词监听、TTS 语音播报以及 Agent 主动通知。
安装¶
通过官方命令安装：
dsh plugin --profile web add dsh-plugin-desktop-notice
典型用法¶
安装后，可以通过以下方式测试通知功能：
# 浏览器访问
http://127.0.0.1:3080/desktop-notice/test?kind=waiting
# npm 脚本
npm run notify:test -- waiting
# PowerShell
irm "http://127.0.0.1:3080/desktop-notice/test?kind=error"
平台支持与注意事项¶
- Windows：需在系统设置中开启应用通知权限。横幅显示可能受 AUMID 匹配或专注助手设置影响。
- macOS：首次使用需要授权系统通知权限。
- Linux：依赖系统自带的
notify-send命令。 - 无桌面环境：在服务器或 WSL 环境下，插件会自动禁用弹窗与音效，仅保留日志。
