前言¶
用 DeepSeek Harness（DSH）跑长任务时，往往要等一轮对话或工具调用结束才知道结果；审批、追问若没盯窗口，容易错过。系统通知可以补一部分，但辨识度一般，和日常 IM 提示音也不一致。dsh-qq-sounds 在 DSH 完成工作、需要放权限或需要你回答等节点播放声音：完成时用 QQ 好友消息那种「滴滴」，需要处理时用 QQ 系统消息提示；可直接读本机 QQ 安装目录下的音效，未装 QQ 时回落到包内仿 QQ 合成音。
这是什么¶
dsh-qq-sounds 是 DSH 的客户端（web）插件，维护者为 GeXiubinHelloWorld，仓库 GeXiubinHelloWorld/dsh-qq-sounds，在 SkillHub 目录中归类为「客户端」。它监听 DSH 会话事件，在浏览器侧播放音频，并在设置页提供 QQ 音效目录检测、四类事件独立配置和可选系统通知。当前 npm 包版本为 1.0.8，MIT 许可证，要求 Node >= 22；适用 DSH 0.2.1+ 的 web / desktop profile。
核心功能¶
下面按触发时机说明默认行为（可在设置里逐项改掉）。
| 时机 | 默认音效 |
|---|---|
任务完成（turn/end · completed） |
QQ 好友消息 msg.wav |
需要审批 / 放权限（approval/asked） |
QQ 系统消息 system.wav，未处理会按间隔重复响 |
需要你回答问题（ask_user_question） |
QQ 系统消息 system.wav，未处理会按间隔重复响 |
任务出错（turn/end · error） |
内置「下行低鸣」（默认关闭） |
音效来源有两条路。Windows 下会按注册表卸载项与常见路径自动探测 QQ 安装目录，读取 Misc\Sound\Classic\*.wav；也可手填目录、环境变量 DSH_QQ_DIR，或为某类事件指定任意本机音频。本机没有 QQ 或探测失败时，使用随包分发的仿 QQ 合成音（好友消息 / 系统提示），不打包腾讯版权素材，只在你本机按路径读取已安装的 QQ 音效文件。
审批与提问未处理时，默认约 25–30 秒重复一次，最多 4–6 次；你点击页面、切回窗口或达到次数上限后停止。「只在 DSH 不在前台时响」默认关闭，因此在后台或切到别的标签页仍会响；需要少打扰时可打开该选项，并配置静音时段（支持跨午夜）与总音量 0–100%。可选同时弹出系统通知（需浏览器通知权限）、在窗口标题前加待处理标记。配置写入 ~/.dsh/qq-sounds/config.json，可用 DSH_QQ_SOUNDS_DATA 换目录。
设计上有三条明确约束：异常不阻止 DSH 启动（最坏情况是插件不响）；零运行时依赖，不改动、替换其他已装插件；默认配置装完重启即可听到完成与审批类提示。
安装与启用¶
推荐在 DSH 界面安装。左侧栏打开 插件 → 添加插件，粘贴包名：
dsh-qq-sounds
装完后重启 DSH（bundle 列表仅在启动时加载，无法热插）。进入 设置 → QQ 提醒音，点「重新检测」确认 QQ 音效目录，试听「完成」与「审批」即可。
命令行安装时，profile 一般为 web 或 desktop（对应 ~/.dsh/profiles/ 下目录名）：
dsh plugin --profile <你的 profile> add dsh-qq-sounds
从 GitHub 源码添加：
dsh plugin --profile <你的 profile> add github:GeXiubinHelloWorld/dsh-qq-sounds
上述命令均装完后需重启 DSH。
典型用法¶
经过上面的安装步骤后，按下面顺序做一次自检。
- 重启 DSH 后打开 设置 → QQ 提醒音，顶部应出现「音频已解锁」；若未解锁，先在页面任意处点击一次（浏览器需用户交互后才允许播放）。
- 在「QQ 音效目录」中确认已列出
...\Misc\Sound\Classic及「已找到 N 个音效」；可点试听msg、system核对音色。 - 发起一轮会正常结束的任务，应听到完成提示；在需要审批或回答问题的会话中，应听到系统类提示，长时间不处理会重复提醒。
- 按需调整四类事件的启用、音效下拉（QQ 五种、内置七种、自定义路径或静音）、重复间隔（5–600 秒）与最多次数（1–50 次）。
工作原理简述：宿主进程订阅 session/event，过滤后写入内存环形日志，并注册仅本机回环的 /api/qq-sounds/* 路由；设置页所在浏览器约每 1.2 秒轮询新事件并播放，故可能有约一秒量级的延迟，属预期行为。
适用场景与注意¶
适合长时间挂着 DSH、希望用熟悉提示音区分「做完了」和「需要你操作」的用户。macOS / Linux 不做 Windows 注册表探测，找不到 QQ 目录时用内置合成音，功能仍可用。
安装前请自行查看仓库源码与 MIT 许可证；插件以当前 DSH 进程权限读取本机音频，HTTP 接口只接受 127.0.0.1 / ::1，且仅允许白名单扩展名、≤4MB 的文件，不发起外网请求。多开 GUI 窗口时各窗口可能各响一声；DSH 退出后由页面播放的声音会停止。QQ 音效版权归腾讯，插件不复制分发 QQ 音频文件。
若完全没声音，可依次检查：是否有过页面点击、总开关、静音时段、是否误开「只在 DSH 不在前台时响」、Windows 音量合成器中 DeepSeek Harness 的输出设备与音量。
结尾¶
dsh-qq-sounds 用 QQ 风格提示音标记 DSH 任务完成与待你审批、回答的节点，默认可用、可细调且尽量不拖累宿主。目录页：https://www.skillhub.cn/plugins/GeXiubinHelloWorld/dsh-qq-sounds；源码与文档：https://github.com/GeXiubinHelloWorld/dsh-qq-sounds。
