前言¶
DeepSeek Harness（DSH）在执行某些操作（如工具调用审批或计划复核）时，需要人工介入。如果用户不盯着界面，很容易错过这些请求。dsh-sound-alert 插件通过监听本机 DSH 实例的请求事件，在需要审批或选择时发出声音提示并弹出系统通知，帮助用户在处理其他事务时也能及时响应。
这是什么¶
这是一个由 zhangDSK-Xu 维护的 DSH 插件，核心功能是响一声提示音并弹出系统通知。
当 DSH 需要你授权（审批策略为 ask）或让你做选择（ask_user_question、计划复核）时，插件会立即响应。它不改变任何授权结果，只是旁听事件并提醒用户，确保不会遗漏重要的交互请求。
核心功能¶
- 声音与通知：响一声提示音并弹出系统通知。通知统一设为
silent，声音由插件负责，避免重复。 - Web Audio 合成：使用 Web Audio API 合成 5 种音色，无需加载音频文件。音色包括：叮、叮咚（默认）、三连升调、铃铛、急促警报。
- 铃铛 UI：界面右下角常驻一个半透明的铃铛图标。点一下可开关声音；点旁边的 ▾ 或右键可打开设置面板；按住铃铛可拖动到任意角落，松手自动吸附。
- 重复提醒：未处理时按间隔重复提醒（默认 5 秒），最多重复 10 次。达到次数上限或页面有任何操作时立即停止。
- 标题闪烁：未处理时，页面标题前会自动加上
🔔。 - 多实例监听：插件默认监听本页实例以及
http://127.0.0.1:3080、http://127.0.0.1:19387。来自其它实例的通知会在正文末尾标出来源（例如来自 127.0.0.1:3080）。 - 完全透明：插件只是旁听，不改变任何授权结果；卸载后行为与安装前完全一致。
安装与启用¶
前提：已安装 DSH（Harness）。
安装方式¶
- 通过界面安装：
在 DSH 设置 → 插件中，将下面的仓库地址填入安装输入框：
github:zhangDSK-Xu/dsh-sound-alert
- 通过命令行安装（
web为默认 Web 界面 profile，请根据实际情况替换）：
dsh plugin --profile web add github:zhangDSK-Xu/dsh-sound-alert
注意：桌面端 profile 无法使用 dsh plugin 命令操作，只能通过界面安装。
卸载¶
dsh plugin --profile web remove dsh-sound-alert
典型用法¶
安装完成后，插件会自动运行。以下为常见操作：
- 开关声音：点击右下角的铃铛图标。
- 打开设置：点击铃铛旁边的 ▾ 或右键铃铛。
- 调整位置：按住铃铛图标拖动，松手后会自动吸附到最近的角落（右下、左下、右上、左上）。
- 测试提醒：在设置面板中可以手动发送一条测试提醒，或通过命令行手动触发：
Invoke-WebRequest http://127.0.0.1:3080/dsh-sound-alert/test.json -Method POST -UseBasicParsing
适用场景与注意¶
- 适用场景：适合需要长时间运行 DSH 进程，且希望在不盯着屏幕的情况下，也能及时响应授权或选择请求的用户。
- 浏览器自动播放限制：浏览器策略要求页面必须先有一次用户交互才允许出声。插件会在你第一次点击或按键后“补响”这一次提醒。即使没出声，系统通知与标题闪烁仍会出现。
- 专注模式干扰：Windows 的专注助手/勿扰模式会静音系统通知（不弹横幅，但会进通知中心）。
- 多标签页行为：如果打开多个浏览器标签页，每个标签页都会各自响一次。
- 必须保持页面打开：必须至少有一个加载过插件的页面处于打开状态，插件才会工作。
结尾¶
dsh-sound-alert 提供了一种非侵入式的提醒方式，通过声音和通知让 DSH 的交互流程更加透明。它不改变核心逻辑，只是作为听觉的延伸，确保在多任务处理时不会遗漏关键的审批或选择步骤。
插件目录：dsh-sound-alert - SkillHub
源码仓库：zhangDSK-Xu/dsh-sound-alert
