DeepSeek Harness（DSH）常用于让智能体在后台运行任务。在处理其他工作或刷视频时，开发者很难时刻盯着界面。这款插件通过声音提醒，在 AI 结束工作或需要你输入时发出提示。
这是 jedzqer 开发的一款 DSH 客户端插件。它通过 Web Audio 合成音效，在 AI 结束工作或向你提问时发出提示音，无需外部音频文件。
核心功能¶
插件提供以下能力：
- 整轮响应结束提醒：以当前会话
running状态 true→false 边沿为信号，完成、错误、max-tokens 或停止均会触发，播放上行琶音 “ta-da”。 - 提问等待提醒：AI 停下来等待你回答时，播放双音 “叮”，与完成音区分。
- 子代理感知：后台子代理仍在运行时不会误响；只有整个任务真正完成才播放。
- 按浏览器控制：通过
localStorage即可静音、调音量，或只在标签页隐藏时响。 - 零资源依赖：提示音全部由 Web Audio 合成，无音频文件、无网络请求。
- 自动处理自动播放策略：首次用户手势时预热
AudioContext，无需手动点按解锁声音。 - 自动清理：插件卸载 / HMR 时自动释放全部订阅与事件监听。
安装与启用¶
安装步骤如下：
# 1. 把插件安装进 web profile
dsh plugin --profile web add dsh-sound-plugin
# 2. 重启 web UI 使插件集合生效
dsh web
插件默认开启，无需任何配置。
典型用法与配置¶
代码级配置¶
如需调整默认行为，修改 client.js 顶部的 DEFAULTS 常量。支持配置项包括 enabled、volume、hiddenOnly。
修改 client.js 后无需重启 dsh web，刷新页面（建议 Ctrl+F5）即可生效；只有增删插件才需要重启。
浏览器级覆盖¶
在浏览器 DevTools Console 中执行以下命令：
// 静音
localStorage.setItem("dsh-sound.enabled", "false");
// 音量 0..1
localStorage.setItem("dsh-sound.volume", "0.25");
// 仅在标签页隐藏时响
localStorage.setItem("dsh-sound.hiddenOnly", "true");
行为说明¶
- 会话监听范围：只监听当前会话（侧边栏选中的会话）的响应结束；切换会话自动跟随。正在运行时切到已完成的历史对话不会误响——只有保持选中的会话结束才响。
- 提示音区分：
- 提问等待：双音 “叮”。
- 整轮完成：上行琶音 “ta-da”。
- 触发条件：错误 / max-tokens / 停止结束同样会响完成音。
- 子代理门控：子代理（含后台子代理）的中间等待不响；打开历史会话不响；切到已经在等待提问的会话也不响。
技术实现¶
插件由 Node 半身（index.js，空 apply，仅用于让插件出现在 Host 的 Loader 中）与浏览器半身（client.js，经 dsh.client 声明被发现）组成。
生态背景¶
DSH 理念是「一切皆插件」，该插件托管于社区独立站点。安装前建议检查源码与许可证。
- 插件目录页：dsh-sound-plugin
- 源码仓库：jedzqer/dsh-sound-plugin
