前言¶

在 DeepSeek Harness（DSH）里跑智能体时，一轮任务往往要几分钟甚至更久。人通常会切到别的窗口，等模型跑完或需要你点批准、回答问题时再回来看。没有 audible 反馈时，只能反复切回 DSH 确认状态。dsh-sound-cue 是 ITISlemon 维护的客户端插件：在对话框底部提供音效设置入口，在一轮结束、或出现需要你操作的内容时播放不同提示音，便于「离开屏幕、听声回来」。

下面介绍它的定位、能力与安装方式。安装命令与行为说明均来自插件仓库 README；社区目录页为 skillhub.cn 上的 dsh-sound-cue，与 DeepSeek / 幻方无官方从属关系，DSH 生态本身是「一切皆插件」的扩展方式。

这是什么¶

dsh-sound-cue（仓库 ITISlemon/dsh-sound-cue）面向 DSH Web UI：在对话 composer 下方挂载一个小铃铛 chip，点击后弹出浮动设置面板，用来开关总开关、选择完成音与「需要你注意」的提醒音、调节音量并试听。设置持久化在浏览器侧，键名为 dsh-sound-cue:settings。许可证为 MIT。

核心功能¶

插件区分两类音效，互不混用：

1. completion（完成）：每一轮对话结束时播放一次，可选内置 preset 或自定义音频。
2. attention（注意）：当有待你处理的内容（批准、提问、计划审阅等）时播放；默认是三音阶固定提示（批准偏低、提问偏高），也可换成内置 tone 或自定义文件，便于不看屏幕也能区分「跑完了」和「在等你」。

入口与面板：

• 铃铛 chip 挂在 composer 底部（slot：conversation.composer.dock / sound-cue，order 20）。
• 点击 chip 在上方打开浮动面板（由 frame 级 overlay 渲染，对话布局不会因此被顶开）。面板内有总开关、Keep listening on other pages（始终监听）、attention 开关、两套音色选择、音量、完成音与 attention 试听。点击面板外或按 Escape 关闭；视口高度不足时面板可滚动，滚动条常显。

始终监听：开启 Keep listening on other pages 后，音效由客户端全局 session 状态（running、pendingInteraction）驱动，在设置页、插件市场或其它面板打开时仍会响；此模式下 composer 上的 chip 不再单独触发完成音，避免同一轮响两次。对应无 UI 的常驻监听挂在 shell.overlay / sound-cue:resident（order 40），设置面板为 shell.overlay / sound-cue:popover（order 41）。

内置 tone：chime、bell、marimba、pop、ding，用 WebAudio 合成，包内不附带音频资源。

自定义音频：可为 completion 与 attention 分别选择任意 audio/* 文件，以 data URL 存入本浏览器 localStorage，单文件上限 3 MB。

面板开关一览：总开关、始终监听、attention 提醒；两套音色选择；音量；两种试听。

安装与启用¶

安装目标为某个 DSH profile：桌面应用常用 desktop，Web CLI 常用 web。以下命令与 README 一致（标签 v1.3.1）。

DSH 安装前会用 git ls-remote 检查 GitHub，因此需要本机已安装 Git：

dsh plugin --profile desktop add github:ITISlemon/dsh-sound-cue#v1.3.1

若无 Git，可改用 release 压缩包，跳过 Git 检查：

dsh plugin --profile desktop add https://github.com/ITISlemon/dsh-sound-cue/archive/refs/tags/v1.3.1.tar.gz

桌面应用也可在 Settings → Plugins 里用相同 spec 安装。安装完成后打开任意对话，composer 下方会出现铃铛 chip，即表示客户端脚本已注入（package.json 中 dsh.client.platform 为 web，immediately: true）。

典型用法¶

1. 安装插件并进入对话，点击 composer 下方的铃铛 chip。
2. 打开总开关，在面板里为 completion 选内置 tone 或上传本地音频，用预览确认音量。
3. 需要区分「跑完」和「在等你」时，打开 attention alert，为 attention 单独选音或保留默认三音阶提示，并试听 attention 预览。
4. 经常在设置或其它页面停留、仍希望听到状态变化时，开启 Keep listening on other pages。
5. 设置会自动写入 dsh-sound-cue:settings；换浏览器或清空站点数据后需重新配置自定义文件。

适用场景与注意¶

适合长时间让 DSH 智能体在后台跑任务、又希望用声音感知「一轮结束」或「需要点批准 / 答问题」的开发者。attention 与 completion 分离，比单一提示音更容易建立肌肉记忆。

使用前请注意：

• 插件在当前 DSH 客户端 / 浏览器环境中运行，自定义音频只存在本机 localStorage，不跨设备同步。
• 安装前建议浏览 GitHub 源码 与 LICENSE（MIT），确认符合你的安全与合规要求；插件以当前 dsh 进程及浏览器权限运行，上传的音频仅保存在本地。
• README 中的安装示例 pinned 为 v1.3.1；仓库 package.json 当前版本字段为 1.4.0，若需更新版本请以 release 标签与官方文档为准，勿自行拼接未在文档出现的 install spec。

开发方面：包为纯 ESM，无构建步骤；本地可将 profile 下的 node_modules/dsh-sound-cue 链到仓库目录，改 client.js 后无需重装。冒烟测试：node dev/smoke.test.mjs（Node.js 20+）。

结尾¶

dsh-sound-cue 用两种可配置的提示音，把「一轮跑完」和「需要你操作」从视觉上解放出来，适合配合 DSH 长时间 agent 会话使用。更多信息见 社区目录页 与 GitHub 仓库。