dsh-approval-chime

中文 | English

人工介入与任务完成的提示音/通知插件：需要你审批、回答问题，或后台任务跑完时，用不同的声音提醒你；离开页面时还会弹系统通知，不再错过等待。

功能

| 事件 | 声音 | 系统通知（仅页面不在前台时） | |------|------|---------| | 人工审批到达（如沙箱提权） | 双音叮咚 | 「待审批 · 会话标题」 | | 提问到达（等待你回答） | 短促单音 | 「待回答 · 会话标题」 | | 任务完成 | 上升三连音 | 「标题 · 运行完成」 |

• 徽标：输入框上方工具行右端显示全局待处理计数，点击跳转到对应会话
• 不打扰：页面在前台时只响声音 + 徽标，不弹系统通知；切走页面才弹
• 与自动审核联动：dsh-auto-reviewer 自动放行的调用不响铃，只有真正需要你介入的请求才提醒
• 设置持久化于 DSH settings 域，重启后保留

安装

dsh plugin --profile web add dsh-approval-chime

dsh 自动完成安装与挂载，重启 DSH 生效。

聚合安装（推荐）：dsh plugin --profile web add dsh-pi-kit 全家桶，此插件随之一并挂载。未安装聚合设置壳时，设置会自动以独立卡片形态出现。

使用

设置位于「设置 → 插件 → 插件配置」：

| 设置 | 说明 | |------|------| | 提示音开关 | 静音所有声音（徽标与系统通知不受影响） | | 完成提醒语义 | background：仅后台会话响完成音（默认）；all：所有会话都响 | | 系统通知授权 | 浏览器通知权限开关 | | 试听 | 三种音色各提供试听按钮 |

已知局限

• plan-review 类交互暂不触发提示音（后续版本跟进）
• 多标签页同时打开时声音会在各标签重复（系统通知经 tag 互替不会重复）
• 任务以错误结束时当前也播放完成音（后续区分失败音）

开发者

pnpm install
pnpm -C packages/approval-chime test
pnpm -C packages/approval-chime typecheck
pnpm -C packages/approval-chime build

本插件只注册 Client Slot，通过 DSH 审批缝机制感知待处理事件；Host 半边仅承载 settings 域持久化。

License

MIT