dsh-client-ui-turn-chime

DSH(DeepSeek Harness)Web 客户端插件:AI 回复真正结束时在浏览器播放一声双音"叮咚"提示音,无需盯着屏幕等待回复结束。

"真正结束"= 会话 running 由 true 变 false,且该会话没有任何仍在运行的后代子代理。 协调者类预设(如 coordinator)里主模型常先派发一批后台子代理、随即停止生成去等回报,这种"暂停等待"不再误响:提示音会挂起,等子代理全部结束、主会话空闲时补响一次。

特性

• 双音提示音(C6→G6)由 Web Audio 实时合成,不依赖任何音频文件
• 通过标准 props 的 useSession 订阅会话快照,监听 running 由 true 变 false 的瞬间
• 子代理门控(v0.3.0):回复完成时若当前会话仍有运行中的后代子代理,则不响并挂起;子代理全部结束且主会话空闲时补响一次(有子代理在跑就绝不响,不会响第二次)
• 子代理统计取标准 props 的 useSessions(SessionListState.byId:每个会话的 parentId / origin / running),沿 parentId 上溯,覆盖孙代理等任意深度;只计 running,已结束(inactive/ready)的子代理不拦截
• 无子代理的普通会话行为与 v0.2.0 完全一致
• 不渲染任何可见 UI,无侵入
• 页面卸载时自动释放音频上下文
• 退化安全(标准 props 契约变化时):缺 useSession → 停止渲染并告警一次(不抛错交给座位错误边界静默吞掉);缺 useSessions → 退回 v0.2.0 的"回复完成即响"
• 已知边界:子代理会话在摘要表里缺行时计 0,同样退回"回复完成即响"(表现是可能提前响一次,不是不响);挂起期间切换会话或刷新页面会丢弃未决状态,本轮不再补响(挂起状态按会话实例隔离,不跨重挂)

使用

安装并注册后,AI 回复结束即自动播放提示音,无其他配置。

安装

在 DSH profile 目录(例如 ~/.dsh/profiles/web/)下:

1. 添加依赖:

   // package.json
   {
     "dependencies": {
       "dsh-client-ui-turn-chime": "github:liuyun847/dsh-client-ui-turn-chime"
     }
   }
   

   然后 pnpm install(或 npm install)。

2. 在 cordis.patch.yml 中注册插件行:

   - insert:
       - id: turn-chime
         name: 'dsh-client-ui-turn-chime'
   

3. 重启 dsh web,刷新页面后生效。

工作原理

v0.3.0 起判定为"回复完成 + 无运行中子代理";v0.2.0 起使用标准 props 的 useSession(适配 DSH 0.1.2-rc.1 slots 契约)。 提示音播放依赖浏览器 AudioContext,需用户交互后解锁。

• 通过 dsh.client 声明(见 package.json)注册为浏览器端插件。
• 在 conversation.composer.dock 座位注册一个不渲染 UI 的监听组件:用会话标准 props useSession 订阅 running 与 sessionId,用全局 useSessions 读取会话列表快照 byId。
• 活跃子代理数 = byId 中 origin === 'subagent' && running === true、且沿 parentId 上溯能命中当前会话 id 的行数(上溯规则与官方 dsh-client-ui-subagent 页头谱系的 indexSubagentDescendants 一致,只取 running 口径;dsh-client-ui-workspace 会话树也用这份摘要)。带环保护;inactive/ready 的子代理不计入。
• 判定状态机(单个 effect,保证最多响一次):
  • running 由 true 变 false 且活跃子代理数为 0 → 立即响;
  • running 由 true 变 false 但仍有子代理在跑 → 挂起(pending),不响;
  • 挂起后,只要"主会话空闲(running === false)且活跃子代理数归零" → 补响一次(覆盖"子代理结束唤醒父会话"与"父会话未被唤醒、子代理直接结束"两条路径)。
• 适配 DSH 0.1.2-rc.1 起的 slots 契约:旧版依赖座位 owner 注入的 session 快照(InputZone 时代)已移除,新版组件直接使用标准 hook,会话切换时随绑定自动重挂、不会误报。
• 双音由 AudioContext 实时合成(C6 1046.5Hz → G6 1568Hz),失败时静默降级,不影响使用。

生效方式(开发时)

• 本包以 plugins/dsh-client-ui-turn-chime/ 为活源,运行时加载 node_modules/dsh-client-ui-turn-chime/ 下的 file: 拷贝(二者独立), 改活源后必须把 lib/、package.json、README.md、tests/ 同步到副本。
• DSH 默认挂载 @deepseek-ai/dsh-client-hmr(500 ms stat 轮询图内 bundle): 写入副本的 lib/client.js 后,运行中的页面会原地重载本插件,无需重启 dsh web、无需刷新页面;控制台可见 [turn-chime] v0.3.0 已加载 确认。
• 若 HMR 未生效(未挂载或监听失败),再重启 dsh web 并刷新页面。

开发

# 纯函数单测(活跃子代理计数):注入 window/react 桩后加载 client.js 取 __test 导出
node tests/descendants.test.mjs

# 语法检查
node --check lib/client.js

License

MIT