前言¶
在 DeepSeek Harness（DSH）里跑长任务时，主智能体或子智能体可能在后台持续工作，而你需要切到其他窗口处理别的事。等到模型写完一整轮回复，或界面弹出「待审批」「向用户提问」时，若没有任何提醒，很容易错过介入时机。社区插件 dsh-sound-plugin（维护者 dev-rookiestar）在客户端侧监听相关事件，通过系统默认音频设备播放短提示音，把「该回来看一眼 DSH」这件事变成可听见的信号。下面介绍它的定位、能力与安装方式。
这是什么¶
dsh-sound-plugin 是 DeepSeek Harness 的客户端类插件：在 AI 完成回复和/或出现待审批 / 用户提问时播放系统提示音。两项能力在 Settings → General 里各自独立开关，可按需只开其一。
插件托管于 GitHub 仓库 dev-rookiestar/dsh-sound-plugin，目录页见 skillhub.cn。社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」的思路，本插件即其中一例。
核心功能¶
根据仓库 README，插件当前提供两类提示音（均可单独关闭）：
-
Completion sound（完成提示音）
监听agent/status，在主回合及所有子智能体均进入 idle 后播放一次。 -
Approval reminder（审批 / 提问提醒）
监听会话事件流中的approval/asked，以及ask_user_question工具调用，在需要用户审批或回答时播放。
提示音为内存中生成的「叮咚」WAV，不随仓库附带独立音频文件，经系统命令播放到默认输出设备。
环境与依赖¶
- DeepSeek Harness：
>=0.2.0 <0.3.0（开发与测试版本为0.2.1-rc.3）。 - 播放方式（由插件按平台调用系统能力）：
- Windows：PowerShell
System.Media.SoundPlayer（系统自带）。 - macOS：
afplay（系统自带）。 - Linux：
paplay（PulseAudio / PipeWire）。若本机没有paplay，需安装pulseaudio-utils。
package.json 标明插件面向 web 客户端，并在 Settings → General 注入配置项（@deepseek-ai/dsh-client-ui-settings-general）。
安装与启用¶
安装前请将 <name> 换成你的 profile 名称。Profile 是 DSH 下彼此独立的命名环境（插件与设置分目录存放于 ~/.dsh/profiles/<name>），类似浏览器多配置文件。
常用 profile 名称：
- Desktop 桌面应用：
desktop（须先退出桌面应用——该 profile 仅由 Electron 应用管理）。 - Web 应用：
web。 - 或任意自定义名，例如
my-profile。
官方安装命令如下（勿省略 --profile）：
# GitHub 简写
dsh plugin --profile <name> add github:dev-rookiestar/dsh-sound-plugin
# 或完整 git URL
dsh plugin --profile <name> add git+https://github.com/dev-rookiestar/dsh-sound-plugin.git
安装完成后重启 DSH（或重新加载该 profile），打开 Settings → General，即可看到上述两个开关并按需启用。
典型用法¶
- 按上一节命令把插件安装到实际使用的 profile（Web 用
web，桌面用desktop）。 - 重启或 reload profile 后进入 Settings → General。
- 打开「完成回复提示音」和/或「待审批 / 提问提醒」。
- 发起一次会触发子智能体或审批流的任务；在 Linux 上若无声，先确认
paplay可用且默认音频设备正常。
除设置项外，README 未描述额外 CLI 或配置文件字段；行为由插件内事件监听与系统播放命令完成。
适用场景与注意¶
适合：长时间让 DSH 在后台跑任务、又不想一直盯着界面，但仍需在「整轮回复结束」或「需要点批准 / 回答问题」时尽快回到客户端的用户。
注意：
- 插件以当前 DSH 进程权限运行，安装前应自行查看源码与 MIT 许可证，确认符合你的安全与合规要求。
- 版本与 DSH 主版本绑定在
0.2.x区间；升级 DSH 到0.3.0及以上前，需对照仓库是否更新engines.dsh范围。 - Linux 依赖
paplay，无图形/无音频会话的环境可能无法出声。
结尾¶
dsh-sound-plugin 用两条可选的系统提示音，把「回复已完成」和「等你审批或作答」从纯视觉状态变成可听见的回调，适合在多任务并行使用 DSH 时减少漏看。更多信息见目录页 skillhub.cn/plugins/dev-rookiestar/dsh-sound-plugin 与 GitHub dev-rookiestar/dsh-sound-plugin。
