概览
dsh-helper
DSH task notifier plugin: pops Windows toast notifications when an agent session finishes, errors, needs confirmation, or asks for approval. Self-registers the required AppUserModelID shortcut so notifications are delivered even when the app is not focused.
README / ZH
插件文档
目录摘要
DSH task notifier plugin: pops Windows toast notifications when an agent session finishes, errors, needs confirmation, or asks for approval. Self-registers the required AppUserModelID shortcut so notifications are delivered even when the app is not focused.
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- 通知面向 Windows（PowerShell WinRT Toast）。在 macOS/Linux 上插件仍会加载，但通知和音效都是静默空操作。 - 音效走 PowerShell + WPF MediaPlayer；不可用时退回 `System.Media.SoundPlayer`（仅支持 wav，且音量设置不生效）。 - 若 Windows「专注助手 / 勿扰」开启，通知可能被拦截。 - **投递身份（0.5.0 起自动处理）**：Windows 要求桌面程序在开始菜单有一条携带 `System.AppUserModel.ID` 的快捷方式，否则 toast 会被**间歇性静默丢弃**（尤其当有前台窗口时），表现为「焦点不在本应用就收不到通知」。插件启动时会自动幂等补齐这条快捷方式（`%APPDATA%\Microsoft\Windows\Start Menu\Programs\dsh-helper.lnk`），无需手动操作、也无需管理员权限。 - 快捷方式若被清理软件删除，下次启动 DSH 会自动重建。