dsh-approval-chime
DSH 审批提示音插件：DSH 向你申请权限的那一刻响一声，音量、音色、开关都在**「设置 → 通知提醒」里调。
内置风铃 / 铃铛 / 蜂鸣三种现场合成音色，可导入本地音频当音色，还能按会话独立**设置。
它完全不参与审批瀑布：不注册任何 approval/request 监听，内置审批面板的决策路径一个字节都没变。
它只做一件事——在审批请求出现时发声。
安装
# 默认 profile（不需要 PATH 里有 git）
dsh plugin add https://codeload.github.com/Cloudto1/dsh-approval-chime/tar.gz/refs/heads/main
# 或者用 git spec（需要 PATH 里有 git）
dsh plugin add github:Cloudto1/dsh-approval-chime
# 指定 profile
dsh plugin --profile web add <上面任一条 spec>
装完重启 DSH。随后：
- 「设置 → 通知提醒」出现本插件的分区页 —— 这说明装载成功；
- 触发一次审批请求，应当听到一声。
dsh plugin add 会把参数原样转发给该 profile 目录里的 pnpm；成功后 DSH 按「已安装依赖」
重算 dsh.profile.bundles。本包在 package.json 里声明了 dsh.bundle.patch，这正是它能被
dsh plugin add 安装的原因。
功能
- 审批响一声 —— 只在审批请求出现时发声，不改变审批行为。
- 三种内置音色 —— 风铃
chime / 铃铛 bell / 蜂鸣 beep，全部为 WebAudio 现场合成，不加载任何音频文件。
- 导入本地音频当音色 —— 分区页「音色」右侧的「导入音频」；上限 5 MB、最多 50 个。
音频字节落在插件目录，名册（顺序、显示名）随设置文档走。
- 按会话独立（rev-10）—— 每个会话标题行有一个小铃铛：点一下只静音这个会话（静音时那道斜杠
从左到右画出来，取消时反向扫走，240 ms）；铃铛旁的箭头可给该会话单独指定音色与音量（默认跟随全局）。
多个会话同时待审批时各响各的（同一批按快照顺序逐个响、相邻 180 ms），不再合并成一声。
- 试听与恢复默认 —— 恢复默认只重置
enabled / volume / tone，不动 custom
（导入的文件是素材库，不是一项偏好）。
- 无声环境自证 —— 分区页显示已触发次数与上次触发时间，静音时也能确知"它到底有没有在工作"。
设置项
命名空间 approval-chime，落盘在 $DSH_HOME/settings.yaml 的 approval-chime: 段，改完立即生效。
| 字段 | 类型 / 范围 | 默认 | 含义 |
|---|
enabled | boolean | true | 关闭后任何声音都不产生（含试听）；审批触发路径连 AudioContext 都不创建 |
volume | number 0..100 | 70 | 主增益 = volume / 100 × 0.6；0 时不发声 |
tone | chime | bell | beep | custom:<uuid> | chime | 音色。前三个现场合成，custom: 前缀指向一个已导入的文件 |
custom | [{ id, name }] | [] | 已导入的音色名册。顺序即含义：按导入先后排列，渲染时排在三个内置音色之前 |
每个会话的静音与音色/音量覆盖不进设置文档、不进浏览器存储，而是写在插件自己的文件
<DSH_HOME>/approval-chime/sessions.json（原子写、上限 200 个会话、按 updatedAt 淘汰）。
已知边界
- 请用
http://127.0.0.1:3080 验收。 非 loopback 页面（远程浏览器）下，平台只把写入留在内存，
该模式下分区页渲染为空（导航行仍在）。
- 「试听」会先解锁音频上下文：这是刻意的——让你第一次点击就解除浏览器的自动播放限制。它同样遵循
enabled / volume，静音时不发声。
- 本插件不尊重系统「减少动效」偏好（rev-20 起的有意取舍）：会话铃铛的静音斜杠（240 ms）、
铃铛旁箭头的转动（160 ms）与设置页开关的过渡，在任何环境下都按各自的常量播放，没有例外。
顶层诊断
reduceMotion() 保留，但它只报告"本页是否命中 (prefers-reduced-motion: reduce)"，
不改变任何行为。
- 分区页在非 loopback 时为空、
custom: 音色在文件缺失时的表现等更细的边界，见下方手册的 §9。
开发与验证
四套 headless harness，不需要浏览器、不需要 DSH、不需要装包：
node verify/host-half.test.mjs # 124 项
node verify/client-half.test.mjs # 442 项
node verify/waterfall.test.mjs # 22 项
node verify/custom-audio.test.mjs # 75 项
当前为 663 项断言全绿（124 + 442 + 22 + 75），各 exit 0。
verify/waterfall.test.mjs 用静态 + 运行时 + 真 cordis 对照实验三重证明「审批瀑布零注册」。
verify-independent/ 是独立验证层（另一套探针与变异表，与上面四套不共享代码），
原始日志归档在同目录的 _raw/。
文档索引
许可
MIT © 2026 Cloudto1
