前言¶
DeepSeek Harness（DSH）插件生态允许为网页图形界面添加功能。在多会话切换或长时间运行任务时，错过关键提示（如需要审批、回答或发生错误）是常见痛点。本插件通过浏览器本地提供的 Web Audio API 和 Web Speech API，为 DSH 提供通知声音及中/英文语音提醒，支持审批、回答、完成、错误等场景的独立设置。
核心功能¶
插件主要包含以下能力：
- 五类提醒场景：支持审批、回答、完成、错误及卡住（实验性）五类场景。每类场景可独立配置音色、语音、音量与开关。
- 语音与通知：支持中英文语音播报及浏览器系统通知。若浏览器语音合成不可用，会自动降级为提示音。
- 设置页管理：提供侧栏设置页，支持总音量调节（0-200%）、音色选择（叮咚/低沉/轻点/警醒/语音/自定义/静音）及恢复默认设置。
- 多会话与重复提醒：支持多会话提醒切换与重复提醒间隔设置（10/20/30秒），适用于未处理事件。
- 数据持久化：设置持久化至 localStorage，刷新或重启后保留。
- 停滞检测：提供实验性的停滞检测功能（默认关闭），用于检测 Agent 长时间无进展的情况。
安装与启用¶
确保 DeepSeek Harness 版本为 0.1.2 或更新。使用以下命令安装插件：
dsh plugin --profile web add @machine-126/dsh-alert-sound
安装完成后，重启 dsh web，在侧栏找到“设置 → 提醒音”进行配置。
典型用法¶
- 配置提醒：在设置页顶部，先切换界面语言（自动/中文/English）。在“提醒音”区域，为每类通知类型配置音色、语音与音量。
- 使用语音功能：将某类通知类型切换为“语音”，浏览器将朗读具体内容（如“需要审批：write”或“发生错误：<原因>”）。
- 复位设置：若配置混乱，使用设置页底部的“恢复默认设置”功能可一键复位（通常会有二次确认）。
要求与注意事项¶
- 依赖版本：依赖 DeepSeek Harness 0.1.2 或更新版本。更早版本只能收到“完成/错误”提醒。
- 浏览器能力：依赖浏览器 Web Audio API（播放音色）及 Web Speech API（语音，可选）。
- 本地处理：所有数据处理在浏览器本地完成，不保存会话数据，不发起网络请求，不保存用户隐私数据。
结语¶
该插件通过声音和语音辅助，降低了错过重要会话状态的概率。更多细节与源码可参考项目主页。
- 项目主页：https://github.com/Machine-126/dsh-alert-sound
- 目录页：https://www.skillhub.cn/plugins/Machine-126/dsh-alert-sound
