气泡完成音 cccchensy/dsh-bubble

气泡提示音

dsh-bubble —— 一个 DeepSeek Harness 插件：每完成一整个任务、输出停止后，冒一串「咕噜」气泡提示音。

✨ 它做什么

仿 GPT 桌面版的「回答完成提示音」：不打扰，但让你立刻知道这一轮真的跑完了。

不是通用的 ding，而是一串气泡的声音：低沉圆润的「咕噜」→ 两枚上浮气泡 → 水润的 C5–E5–G5 琶音 → 一点轻水花，约 1.05 秒，温暖、圆润、不刺耳。全部由 numpy 程序合成，无任何外部采样。

🔊 马上试听

- 🎧 音频文件：assets/bubble-chime.wav（1.05 s，mono 44.1 kHz）
- 📈 波形与测量：docs/bubble-card.png
- 📐 合成参数与设计：assets/DESIGN.md · 生成脚本：assets/synthesize.py

🎯 行为规则

| 场景 | 行为 |
| 一个会话从「运行中」变为「空闲」——整轮任务结束、输出停止（含期间所有多步工具调用） | 响一次 |
| 子代理 / Agent Teams 子会话逐个结束 | 不响；整队只在主任务收尾时响一次，不会连环炸 |
| 多个会话几乎同时完成 | 700 ms 去重，只响一次 |
| 切到别的会话、停留在设置或插件页 | 照常响（监听挂在页面级浮层，与当前面板无关） |
| 页面刚打开、还没交互过 | 遵守浏览器自动播放策略；第一次点击或打字后音频解锁，之后每次都响 |
| 点击输入框下方的小泡泡按钮 | 静音 / 恢复（带斜线 = 已静音），状态记在 localStorage |

📦 安装

前置：DeepSeek Harness（测试于 Desktop 0.2.1-rc.3 的 Web 界面）、Node.js ≥ 20、pnpm；需要 git。

方式一：直接从 GitHub 安装

dsh plugin --profile <你的 profile> add github:cccchensy/dsh-bubble

dsh plugin 会把参数转交给 pnpm；如果当前 pnpm 不接受 github: 短写，改用方式二。

方式二：克隆后按本地目录安装

git clone https://github.com/cccchensy/dsh-bubble.git
dsh plugin --profile <你的 profile> add link:<克隆目录的绝对路径>

方式三：让 DSH 自己装（桌面版最省事）

把下面这段发给任意一个 DSH 会话：

帮我安装这个 DSH 插件：
1. 把 https://github.com/cccchensy/dsh-bubble 克隆到本地任意目录；
2. 用你的插件安装能力把这个目录作为 bundle 安装到当前 profile；
3. 装完提醒我按 Ctrl+Shift+R 硬刷新浏览器。

装完之后

1. 硬刷新浏览器（Ctrl/Cmd + Shift + R）：浏览器只在启动时加载客户端模块；
2. 在 DSH 的 Plugins 页面确认 dsh-bubble 已启用（默认安装即启用）；
3. 随便发一条消息、等它跑完——任务结束时就会「咕噜咕噜」冒泡。

卸载：在 Plugins 页面停用或移除该 bundle 即可；音频与代码都随包移除，不写任何会话数据。

⚙️ 它是怎么工作的

很小的一个 client-only bundle（Host 半为空实现，不写 Session 事件、不注册模型工具、不发网络请求）：

- 完成检测：订阅客户端 Remote 的 api-session/status 事件，并读取会话列表的状态源（ctx.sessions.list）作为兜底；某个会话 running: true → false 时触发一次。
- 子代理过滤：会话列表行带 origin 字段，origin === 'subagent' 的行只记录状态、永不触发。
- 防误报：挂载时先用当前状态播种（重载页面不会为历史完成补响），并对极短时间内的多次完成做 700 ms 去重。
- 播放：WAV 以 data URI 内嵌在 lib/client.js（无网络请求），首次解码进 AudioBuffer；AudioContext 在第一次用户手势时解锁；Web Audio 不可用时回退到 元素。
- UI 注册：shell.overlay 里挂一个不绘制的监听条目；conversation.composer.dock 里挂静音按钮，样式只使用宿主主题 token。

🎼 声音设计

| 层 | 内容 |
| 1 | 圆润低鸣「咕噜」：130 → 78 Hz 正弦 + 二次谐波，约 0.3 s 衰减，5 Hz 缓慢摆动 |
| 2 | 轻微水花：700–2400 Hz 带通白噪，65 ms，低电平 |
| 3 | 两枚上浮气泡：480 → 760 Hz、620 → 980 Hz，各 90 ms，6 Hz 颤音 |
| 4 | 水润琶音：C5 523.25 → E5 659.25 → G5 783.99 Hz，间隔 90 ms，±3 音分 / 6.5 Hz 颤音 |
| 5 | 收尾高音水花：1046 → 1568 Hz，70 ms，很轻 |

测得：1.0500 s，mono 44.1 kHz / 16-bit，峰值 −1.0 dBFS，RMS −13.4 dBFS，无 DC、无削波、首尾样本为 0，SHA-256 f95c11f3…2068；能量集中在 80–200 Hz 与 500–1200 Hz，3 kHz 以上几乎为零（不刺耳）。

🛠 开发

node scripts/build.mjs # 校验 WAV → 内嵌 data URI → 生成 lib/client.js
node scripts/verify.mjs # 结构 + 行为自检（manifest/patch/WAV/注册/响铃/静音/去重/兜底）

python assets/synthesize.py # 重新生成 WAV（确定性，哈希不变）
python docs/make-hero.py # 重新生成 README 波形图

dsh-bubble/
├─ package.json # dsh.bundle.patch + dsh.client 清单 ├─ cordis.patch.yml # 一行 Host 条目（Host 端无行为） ├─ index.js # Host 半：空 apply ├─ src/client.template.js # 浏览器半源码（音频占位符） ├─ lib/client.js # 构建产物：内嵌 WAV 的浏览器半 ├─ scripts/ # build.mjs / verify.mjs ├─ assets/ # bubble-chime.wav · synthesize.py · DESIGN.md ├─ docs/ # bubble-card.png · make-hero.py ├─ locale/ # 中英文插件管理页标题与描述 └─ icon.svg # 原创气泡图标

验证状态（2026-10-29）：node scripts/verify.mjs 全绿；独立只读审计 PASS；在 DSH Desktop 0.2.1-rc.3 中实机确认两个 slot 条目 active。限制：智能体无法「听」音频，音色请以试听文件为准。

✅ 兼容性与已知限制

- 测试环境：DSH Desktop 0.2.1-rc.3（Web 界面），Windows；0.1.x 未验证。
- 只在页面打开时播放；浏览器最小化/后台标签仍可发声，但页面关闭时不会响。
- 首次交互前受自动播放策略限制（这是浏览器规则，不是插件行为）。
- 已停止/被用户取消的任务同样算「输出停止」，会响一声（如需区分可在 src/client.template.js 的 fireCompletion 里扩展）。

🌐 English

一个很小的 DeepSeek Harness 插件：整个任务结束、输出停止时，播放一段原创的气泡音效。它监听客户端会话列表（api-session/status + ctx.sessions.list），忽略子代理来源的会话，对连续触发去重，然后播放内置的 1.05 s WAV（以 data URI 内嵌，经 Web Audio 解码一次）。输入框下方有个小气泡按钮，点一下即可静音。

dsh plugin --profile <profile> add github:cccchensy/dsh-bubble
or: git clone … && dsh plugin --profile <profile> add link:<absolute path>

然后强制刷新浏览器（Ctrl/Cmd + Shift + R）。MIT 许可；提示音为程序合成的原创音频。

📄 License

MIT © 2026 cccchensy. 提示音为程序合成原创音频，随仓库以同一许可提供。