概览
dsh-notify-say
源码级技术说明Desktop notifications for DSH Desktop that actually speak: Windows TTS out of the box (zero download), VOICEVOX voice packs optional, a selectable system-sound fallback, and an idle gate that waits for running subagents before saying the turn is done. Includes a settings-page GUI (sound source, per-event overrides, jump-back-to-session, cooldowns) and a self hot-reload for development.收起技术说明
Desktop notifications for DSH Desktop that actually speak: Windows TTS out of the box (zero download), VOICEVOX voice packs optional, a selectable system-sound fallback, and an idle gate that waits for running subagents before saying the turn is done. Includes a settings-page GUI (sound source, per-event overrides, jump-back-to-session, cooldowns) and a self hot-reload for development.
README / ZH
插件文档
目录摘要
Desktop notifications for DSH Desktop that actually speak: Windows TTS out of the box (zero download), VOICEVOX voice packs optional, a selectable system-sound fallback, and an idle gate that waits for running subagents before saying the turn is done. Includes a settings-page GUI (sound source, per-event overrides, jump-back-to-session, cooldowns) and a self hot-reload for development.
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **仅 Windows**（Toast = WinRT，播放 = MCI，调用 Windows PowerShell 5.1） - **跳会话依赖未文档化 API**（`uiWorkspace`），官方随时可能改；坏了会自动降级为"只唤起窗口" - `blocked`（回合被拦截）只用系统蜂鸣，不播失败语音 —— 语义是"被拦下"而非"失败" - **失败语音只覆盖部分音色**：选到未覆盖的音色时，会在同池内换一个音色播，不会哑掉、也不会播错语义 - **自重载是实验性功能，而且只有"点一次"**：设置页「高级设置 → 开发者选项」里有个 「重载现在生效」按钮，点一下尝试一次；**没有开关、不会自动监听文件**。 为什么改成这样：2026-10-18 实测「监听文件自动重载」会把宿主拖崩 —— 一次改 UI 期间 触发了 40 多次失败重载，每次销毁实例都会释放宿主仍在用的会话引用，最后渲染进程崩溃。 危险的不是"重载失败"，是"**反复**重载" - **自重载不能替代重启**：它只能重新导入「同一路径上的」代码。用 `dsh plugin update` 升级后，新版本装在 `.pnpm/<name>@<ver>/` 另一个路径，自重载做不到 —— 必须重启 DSH - **日语 13 个、中文 4 个音色的许可结论是条件性判断**（依据官方通用条款），不代表各权利人出具过专项授权 ---