回合结束提示音 falling-ts/dsh-web-ding

dsh-web-ding

一个 DSH Cordis 插件，在 agent 完成（运行至空闲）的瞬间，在浏览器中播放一声 “ding”。该声音完全由前端 JavaScript（Web Audio API）合成——Node/Host 端从不播放音频，也不使用 Windows/系统通知。

按照 dsh-force-compact 的架构构建：一个纯监听器的 Host 半部分 + 一个浏览器客户端半部分，通过官方 settings/document-updated 镜像通道连接。

它的作用

| 层 | 发生什么 |
| Host（index.js + src/） | 监听 agent/status 的空闲转换（所有回合完成，包括子 agent，在下一个人类回合之前；从未运行过的新空闲会话，以及重复的空闲 tick，保持静默）。将 { phase:'done', at, sessionId, title } 发布到 falling-ts-web-ding settings 命名空间——title 在此处从官方 sessionProjections 的 title 单元读取，因此浏览器无需再去获取它。从不发出音频，从不调用操作系统。 |
| Browser（web/client.js） | 通过 configForms 实时镜像该命名空间。在严格更新的 done 信号上，它使用 Web Audio API 合成一声短促的 ding（三个正弦振荡器 + 指数衰减包络），并通过标签页播放——同时，在右下角弹出一个 Win11 风格的 toast。点击 toast 会滑出一个通知抽屉，列出每一条回合结束消息（保存在浏览器 localStorage 中，上限 100 条，按信号 at 去重），支持逐条删除和一键清空。一切都停留在前端：没有后端音频，没有操作系统通知。 |

安装

dsh plugin --profile web add github:falling-ts/dsh-web-ding

要求 web 应用附带客户端 bundle（package.json 中的 dsh.client 声明会自动完成这一点）。

配置（falling-ts-web-ding 命名空间，存储在 profile 的 cordis.patch.yml 中）

两个独立的块，各自有自己的开关和自己的音调：

Block 1 — 弹出用户选择 (question popup ding) — 当 harness 在浏览器中弹出用户问题选择器时播放。检测在客户端基于 DOM 进行（QuestionComposer 的 [data-question-key] 锚点）：Host 半部分看不到问题框架，因此这个块完全在浏览器端。

| 字段 | 类型 | 默认值 | 含义 |
| questionEnabled | boolean | true | 问题弹窗 ding 的开关。 |
| questionVolume | number 0..1 | 0.7 | Web Audio 播放增益。 |
| questionFreq | number 80..4000 | 880 | ding 的基频（Hz）。 |
| questionDecayMs | number 100..4000 | 900 | 音调衰减时长（ms）。 |

Block 2 — 回合结束 (turn-end ding) — 经典的 agent/status 空闲转换音调。Host 观察 agent/status；在空闲转换时（所有回合完成，包括子 agent，在下一个人类回合之前；从未运行过的新会话并且重复的空闲 tick 保持静默）它会发布 done 信号。

| 字段 | 类型 | 默认值 | 含义 |
| turnEndEnabled | boolean | true | 回合结束提示音的开关（关闭时 Host 跳过发布）。 |
| turnEndVolume | number 0..1 | 0.7 | Web Audio 播放增益。 |
| turnEndFreq | number 80..4000 | 880 | 提示音的基频（Hz）。 |
| turnEndDecayMs | number 100..4000 | 900 | 音调衰减时长（ms）。 |

除了铃声之外，每个回合结束还会在右下角弹出一个 toast（Win11 风格， 6 秒后自动消失）。点击它会打开右侧通知抽屉：最近 100 条回合结束消息保存在浏览器的 localStorage 中（键为 falling-ts-web-ding.notify.v1），每一行都可以单独删除，还有一个“全部删除”按钮可以清空全部。消息日志仅存在于前端——Host 从不读取或写入它。

你也可以在 设置 → 提示音配置 面板中调整这两个区块，每个区块都有自己的开关和自己的“试听”（预览）按钮。

浏览器自动播放策略

浏览器会阻止音频，直到用户进行手势操作。客户端会在首次指针/键盘交互时（以及在预览按钮上）预热 AudioContext，所以：与页面交互一次（或按下试听），你就会在每个 agent 回合结束时听到提示音。后台标签页中的音频上下文可能会被浏览器自身挂起——请保持标签页可见以听到音调。

开发

mount as a dev overlay (plain JS, no build step)
dsh web --patch $(pwd)/cordis.patch.yml # if supported by your CLI
or install from a local path
dsh plugin --profile web add /path/to/dsh-web-ding

参见 AGENTS.md 了解该插件自身的规则（纯 Host 监听器，无后端音频，无操作系统通知，仅通过获准的设置镜像通道发送到浏览器）。

截图

设置页面：提示音配置 区块，两个区块各自带有自己的开关和音调

设置页面：提示音配置 区块——“弹出用户选择”和“回合结束”区块，各自带有自己的开关、音量、频率和衰减时长，全部可实时编辑，无需重启，每个都带有一个 试听（预览）按钮来预热浏览器 AudioContext。

许可证

MIT