前言¶
在 DSH 桌面端跑长任务时，你往往切到别的窗口写代码或回消息。会话结束、报错或停在等你确认时，如果通知里只有「任务完成」、又配一段生硬的电子短音，很难判断是哪次会话、哪个工作区需要你回来。
社区里已有桌面通知类插件（例如 dsh-notify-desktop）把 Toast 接缝接对了；dsh-bing 在同一类场景上，把标题带上项目名、正文带上会话标题与摘要，并内置一套可试听、可切换的柔和提示音。下面按定位、能力、安装与配置说明用法。
这是什么¶
dsh-bing 是维护者 lsl1931 发布的 DSH 客户端插件：在 Windows 上为 DSH 桌面端提供带项目名的 Toast 通知，并在会话结束、出错或等待你确认时播放可选的「bing」提示音。插件当前版本 0.2.1，README 写明已在 DSH 桌面端 0.2.1-rc.2 / Windows 11 上实装；许可证为 MIT。
数据与偏好均在本机：偏好走渲染层 localStorage，自定义音效复制到 %LOCALAPPDATA%\dsh-bing\custom，不上传。
核心功能¶
通知内容与项目名¶
- 标题形态示例：项目名 · 已完成 / 出错了 / 等你确认 / 还在等你。
- 正文：真实会话标题 + 本轮摘要。
- 项目名解析顺序：重命名过的工作区标题 → cwd 最后一段 → 真实会话标题 → 回退为
DSH。
行为（相对参考插件的保留项）¶
README 说明本仓库保留了经 dsh-notify-desktop 验证过的行为：窗口有焦点时不打扰；点击通知把 DSH 窗口拉回前台；切回窗口立刻停声；服务级提问也能提醒。
点击通知时，宿主 Toast 的回包只有 dsh://open，因此不会跳转到具体会话。
内置音效¶
共 8 个柔和合成音（约 0.8–1.9 秒），四类场景各可选默认项；44.1kHz / 单声道 / 16-bit PCM，由 scripts/generate-sounds.mjs 生成。仓库不打包苹果/华为原声（版权原因）；若本机有正版文件，可在详情页导入。
| 名称 | 文件 | 场景 | 时长 |
|---|---|---|---|
| 极光 | sounds/01-aurora.wav | 完成（默认） | 1.8s |
| 木琴 | sounds/02-marimba.wav | 完成 | 1.3s |
| 卡林巴 | sounds/03-kalimba.wav | 完成 | 1.1s |
| 玻璃 | sounds/04-glass.wav | 等待（默认） | 1.5s |
| 气泡 | sounds/05-bubble.wav | 等待 | 0.8s |
| 低音 | sounds/06-low.wav | 出错（默认） | 1.0s |
| 回声 | sounds/07-descend.wav | 出错 | 1.3s |
| 花开 | sounds/08-bloom.wav | 催办（默认） | 1.9s |
可在插件详情页逐个试听，也可直接双击 sounds/*.wav。
配置入口¶
配置不在全局设置页，而在侧边栏 插件 → dsh-bing 详情页（plugins.bundle.config，key dsh-bing）。配置区包含：总开关、提示音、五类结束状态、三类等待确认、四类音效选择与试听、催办分钟数、测试通知、自定义音效导入/删除/缓存清理。
环境与安装¶
环境
- Windows 10 / 11
- DSH 桌面端 0.2.x（profile
desktop） - 普通用户安装插件不需要 Node；仓库已提交构建产物
lib/
从 GitHub 安装
将 <DSH 桌面端安装目录> 换成你本机路径后，在 PowerShell 中执行（DSH CLI 会把参数转给 pnpm）：
& "<DSH 桌面端安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "github:lsl1931/dsh-bing"
装完后完全退出并重启 DSH 桌面端。不要与 dsh-notify-desktop 同时启用，否则同一轮可能弹出两条通知。
本地开发若已有一份插件目录，可用链接安装（路径换成你的目录）：
& "<DSH 桌面端安装目录>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "link:<绝对路径>\dsh-bing"
典型用法¶
- 按上文命令安装并重启桌面端。
- 打开侧边栏 插件，进入 dsh-bing 详情页，打开总开关，按需为「完成 / 出错 / 等待 / 催办」选音效并点试听。
- 需要自定义音时，在详情页使用「添加音效…」，支持 wav/mp3 等；文件会复制到本机用户目录，原文件移动后不影响播放。
- 用详情页里的测试通知确认 Toast 与声音是否符合预期，再照常使用 DSH 会话。
经过上面的步骤，长任务在后台结束时，通知标题会带上项目名，便于你从多条会话里辨认。
适用场景与注意¶
适合谁
- 主要在 Windows 上使用 DSH 桌面端，希望会话结束或需要确认时有系统级 Toast，且标题能区分项目/工作区。
- 对默认电子短音不满意，想用内置柔和音或导入自己的音效。
限制与权限
- 仅 Windows：Toast 与
System.Media.SoundPlayer走 Windows 路径。 - 顶层插件列表卡片不展示配置，需进 dsh-bing 详情页。
- 插件随当前 DSH 进程权限运行；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的环境策略。
实现思路参考了 paleech0/dsh-notify-desktop 公开的行为与接缝说明；代码为本仓库独立实现。
