@local/dsh-notify-toast
用于 DSH 任务完成、审批请求和代理问题的 Windows 桌面弹出卡片
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:fhghth/dsh-notify-toast#63ea7493e0447587bea50f63f622264c7dcb8cb1Notify Toast 以 @local/dsh-notify-toast 发布，当前版本为 1.0.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 插件：任务完成、需要权限审批、或 Agent 向你提问时，在屏幕右下角弹出一张置顶卡片。
它不使用 Windows 通知中心——卡片是一个真正的窗口，由一个常驻的 .NET/WinForms 进程绘制，所以 DSH 最小化或被其他窗口盖住时依然可见。
早期开发阶段：插件仍在迭代，配置项与行为可能变化，也可能出现破坏性改动。按 MIT 许可「按现状」提供，不附带任何担保，使用风险自负。
WS_EX_NOACTIVATE + WS_EX_TOOLWINDOW，你的前台应用不会被打断输入。.wav。| 项 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11 |
| DSH | 桌面版，>= 0.2.1-rc.3 |
| Shell | Windows PowerShell 5.1（powershell.exe） |
| 运行时 | .NET Framework 4.8（Windows 10/11 自带） |
插件仅支持 Windows：通知进程是 PowerShell + WinForms。
在 设置 → 插件 → 插件市场 里添加上面的索引地址，然后到「发现」页安装 桌面弹窗通知。
plugin_manager install_bundle target = <索引里给出的安装 spec>
或从源码目录：
plugin_manager install_bundle target = D:\path\to\dsh-notify-toast
安装后刷新页面，客户端半边才会加载。
| 卡片 | 触发条件 |
|---|---|
| ✓ 完成 | 回合以 completed 结束（子代理会话不弹），按 settleMs 去抖 |
| 🔒 审批 | 审批服务记录 approval/asked |
| ? 提问 | Agent 调用 ask_user_question |
| ! 失败 | 回合以 error / interrupted / blocked 结束（默认关闭） |
| 配置 | 默认 | 含义 |
|---|---|---|
enabled | true | 卡片总开关 |
notifyOnComplete / notifyOnApproval / notifyOnQuestion / notifyOnError | true / true / true / false | 分类开关 |
soundEnabled | true | 音效总开关 |
soundComplete / soundApproval / soundQuestion / soundError | 自带 WAV | 支持 sounds/*.wav、media:<系统音效名>、system:*、none |
width / height / scale | 400 / 104 / 1.0 | 卡片尺寸，按 DPI 缩放 |
durationMs / maxCards / gap / margin | 8000 / 4 / 8 / 16 | 停留时长与布局 |
position / screen | bottom-right / primary | 停靠位置与显示器 |
bgColor … accentQuestion | 白底黑字 | 颜色（设置页提供色盘） |
iconStyle | vector | vector / glyph / image |
settleMs / minIntervalMs | 1500 / 3000 | 完成去抖与同会话限流 |
clickToOpenSession | true | 点击跳回会话 |
idleExitMs | 900000 | 通知进程空闲多久后退出 |
debug | false | 调试日志 |
自定义音效支持绝对路径或相对插件目录的路径，所以 fork 可以自带 WAV。
approval/asked · tools/pre-execute(ask_user_question) · turn/end
│ Host 插件（index.js）
│ stdin/stdout 上的 NDJSON
▼
notifier 进程（PowerShell + WinForms，单实例）
│ 点击 → SetForegroundWindow + stdout 事件
▼
Host → SSE /dsh-notify/events → 客户端半边 → ctx.uiWorkspace.openSession()
Host 按需拉起唯一一个通知进程，展示期间保持常驻，空闲 idleExitMs 后退出；新实例启动时会结束旧实例，因此插件重载不会留下孤儿进程。
/dsh-notify/events、/dsh-notify/config、/dsh-notify/preview*）只监听 DSH 的回环地址。notifier.ps1 的完整命令行，不会误伤其它 shell）。link: 安装的残留：在 hoisted 模式下卸载 link: 装的插件，node_modules 里可能留下一个指向源码目录的 junction；不影响使用，切换安装方式前建议用 Get-Item <profile>\node_modules\@local\dsh-notify-toast -Force 确认一下。在 设置 → 插件 里禁用或移除该 bundle，通知进程会随插件一起退出。
A DSH plugin that shows topmost desktop cards (bottom-right) for task completion, approval requests and agent questions on Windows. It draws its own WinForms window instead of using the Windows notification center, never steals keyboard focus, and offers click-to-open-conversation, bundled sounds and a full settings page. Requires Windows 10/11 and DSH >= 0.2.1-rc.3. MIT licensed.
Early development: options and behaviour may change, including breaking changes. Provided "as is", without warranty of any kind.
MIT。自带的 sounds/*.wav 随本仓库分发；如该授权不适合你的再分发场景，请替换为自己的音频。