English | 中文

dsh-sound-plugin

还在为必须一直盯着 AI 干活而发愁吗？装上这个插件，你只管在后台刷视频、忙别的——AI 结束工作后、或是停下来向你提问需要回答时，会自动响起提示音通知你。

这是为 DeepSeek Harness（DSH）Web UI 打造的插件：纯客户端，提示音由 Web Audio 实时合成，无需任何音频文件，也不产生额外网络请求或模型调用。

功能特性

• 🔔 整轮响应结束提醒 —— 以当前会话 running 状态 true→false 边沿为信号，完成 / 错误 / max-tokens / 停止 均会触发，播放上行琶音"ta-da"。
• 💬 提问等待提醒 —— AI 用 ask_user_question 提问（含计划审批）停下来等你回答时，播放与完成音不同的双音"叮"，一听就知道该去回答了。
• 🤖 子代理感知 —— 后台子代理仍在运行时不会误响；只有整个任务（含所有子代理）真正完成才播放。
• 🎛️ 按浏览器控制 —— 无需改代码，通过 localStorage 即可静音、调音量，或只在标签页隐藏时响。
• 🔊 零资源依赖 —— 提示音全部由 Web Audio 合成，无音频文件、无网络请求。
• 🖱️ 自动处理自动播放策略 —— 首次用户手势时预热 AudioContext，无需手动点按解锁声音。
• 🧹 自动清理 —— 插件卸载 / HMR 时自动释放全部订阅与事件监听。

安装

前置要求

• 已安装 DeepSeek Harness（dsh 命令可用）
• pnpm（dsh plugin 依赖它管理插件）

步骤

# 1. 把插件安装进 web profile（从 npm 安装）
dsh plugin --profile web add dsh-sound-plugin

# 2. 重启 web UI 使插件集合生效（客户端模块元数据按名缓存，重启后生效）
dsh web

本地开发时，也可以在插件源码目录下安装本地副本（改动即时生效，不必重新发版）：

dsh plugin --profile web add ./dsh-sound-plugin

卸载：

dsh plugin --profile web remove dsh-sound-plugin

使用 / 配置

插件默认开启，无需任何配置。客户端模块不携带行配置，因此提供两档控制：

• 改代码：修改 client.js 顶部的 DEFAULTS 常量（enabled / volume / hiddenOnly）。
• 按浏览器覆盖：在浏览器的 DevTools Console 中执行：

localStorage.setItem("dsh-sound.enabled",    "false");  // 静音
localStorage.setItem("dsh-sound.volume",     "0.25");   // 音量 0..1
localStorage.setItem("dsh-sound.hiddenOnly", "true");   // 仅在标签页隐藏时响

行为说明

• 只监听当前会话（侧边栏选中的会话）的响应结束；切换会话自动跟随。正在运行时切到已完成的历史对话不会误响——只有保持选中的会话结束才响。
• 两种提示音：AI 提问等你回答时响双音"叮"（question），整轮真正完成时响上行琶音"ta-da"（done）。
• 错误 / max-tokens / 停止结束同样会响完成音。
• 子代理（含后台子代理）的中间等待不响；打开历史会话不响；切到已经在等待提问的会话也不响。
• 修改 client.js 后无需重启 dsh web，刷新页面（建议 Ctrl+F5）即可生效；只有增删插件才需要重启。

工作原理

• 插件由 Node 半身（index.js，空 apply，仅用于让插件出现在 Host 的 Loader 中）与浏览器半身（client.js，经 dsh.client 声明被发现）组成。
• 浏览器半身订阅两个 store，分别取两个信号：
  • 完成信号：当前会话在会话列表快照里的 running 位 true→false 边沿 —— 与客户端运行时侧边栏的"完成"提醒同源，任何结束方式都恰好触发一次，播放"done"提示音。
  • 提问信号：当前会话在 ctx.uiSession.pendingInteractions 里出现 kind 为 "question" / "plan-review" 的条目（由 ui-user-questions 在 user-questions/request 请求到达时发布）—— 提问等待期间 agent 循环暂停工具调用、running 保持 true，所以只有这个上升沿能告诉你"该去回答了"，播放"question"提示音。插件审批（ui-approval 发布的 "approval"）不响。
• 子代理门控：当 running 翻 false 时，若会话仍有运行中的子代理后代（origin: 'subagent' + parentId 链），则静默等待，直到整个任务真正完成。

许可证

MIT