README
dsh-alert-sound
English | 中文
为 DeepSeek Harness (dsh) 网页图形界面提供通知声音提醒。当会话需要审批、需要回答、一轮输出完成、或出现错误时，插件播放不同的提示音并弹出悬浮提示——可选语音朗读。每类通知可单独设置音色/语音、启用开关与总音量，都在专属的设置页里配置。界面与语音支持中文 / English 切换。
关于本项目的开发：本插件由 @Machine-126 提出需求与测试验收；代码开发全程由 DeepSeek Harness（AI 编程代理）驱动完成。发现 bug 欢迎提 issue。
- 五类提醒，音色各异：需要审批 / 需要回答 / 输出完成 / 发生错误，外加实验性的「卡住」（默认关）。
- 可选语音（中/英文随界面语言）：把某类切到“语音”，即可用浏览器语音合成朗读；朗读语言跟随“界面语言”设置（中文
zh-CN/ Englishen-US）。若浏览器语音合成未能开始朗读，会自动改播该类的提示音，保证一定有声。 - 设置页（侧栏 → 提醒音）：总音量滑杆（0–200%）、每类启用开关、音色下拉（叮咚/低沉/轻点/警醒/语音/自定义/静音）、试听按钮，以及 “恢复默认设置”（带二次确认）。
- 后台也能响：首次用户手势自动解锁音频。
- 默认对所有会话提醒：多会话用户也能听到任何会话的审批/回答/出错/完成；可在设置切到“仅当前会话”。
- 语音播报具体内容：切到“语音”后会读出具体卡在哪（如“需要审批：write；写入文件 xxx”“需要回答：<问题>”“发生错误：<原因>”）。
- 阻断事件重复提醒：审批/提问未处理时，每隔一段时间再响一次（可设关/10/20/30 秒），直到处理；错误重复几次。
- 多语言（zh/en）：设置里可切“界面语言”（自动/中文/English）；设置页、悬浮提示、每类/音色名与语音朗读语言随之切换。
- 浏览器系统通知：开启后，提醒时在系统通知区也弹一条（后台也能看到）。
- 停滞检测（实验性，默认关）：Agent 长时间无进展时提醒；当前基于
updatedAt，可靠性待改进，故默认关闭。注意：只有把「停滞检测」打开，第 5 类「卡住」提醒才会触发。 - 设置持久化到
localStorage，刷新/重启保留；可一键恢复默认。
要求
- DeepSeek Harness
0.1.2或更新（dsh web）——审批/提问的检测依赖0.1.2引入的uiSession.pendingInteractions；更早版本只能收到“完成/错误”提醒。 - 支持 Web Audio 的浏览器（播放音色）；Web Speech 用于语音，可选、缺失时自动降级为提示音
安装
推荐用 npm 包（预构建安装、免构建授权，市场按下载量展示）：
dsh plugin --profile web add @machine-126/dsh-alert-sound
也可从 GitHub 安装（纯 JS 无构建，直接生效）：
dsh plugin --profile web add github:Machine-126/dsh-alert-sound
或从本地目录：
dsh plugin --profile web add ./dsh-alert-sound
重启 dsh web，然后打开 设置 → 提醒音 配置。
使用
安装后，打开 DSH 设置 → 提醒音，为每类通知设置音色/语音、启停与音量；顶部“界面语言”可在 自动 / 中文 / English 间切换；底部 “恢复默认设置” 可一键复位（会二次确认）。满足条件时自动提醒，无需其它操作。
通知类型与默认音色
| 类型 | 触发条件 | 默认音色 | 提示 |
|---|---|---|---|
| 需要审批 | uiSession.pendingInteractions 里该会话 kind === 'approval' |
警醒（方波三连） | 琥珀色 |
| 需要回答 | uiSession.pendingInteractions 里该会话 kind === 'question'（含 plan-review） |
轻点（双短音） | 紫色 |
| 输出完成 | 会话列表 running 由真→假 |
叮咚（上行双音） | 绿色 |
| 发生错误 | 运行中途出错（lastAgentError 变化） |
低沉（下行锯齿） | 红色 |
另有第 5 类 “卡住” 提醒（实验性，默认关闭，需先打开“停滞检测”），音色默认取“低沉（fault）”。
设置持久化
偏好保存在 localStorage 的 dsh-alert-sound.v1 键下（音量 + 每类 {enabled, sound} + 提醒范围/重复间隔/系统通知/朗读输出/停滞检测/悬浮提示/语音语速/勿扰时段/界面语言等），自定义音色单独存在 dsh-alert-sound.custom.v1。刷新页面与重启都会保留。
隐私
所有处理都在浏览器内完成。插件只在内存中读取：会话列表的 running / updatedAt；挂起交互 uiSession.pendingInteractions（审批/提问的类型，以及工具名、原因、问题文本）；会话快照的 lastAgentError（判定“失败”）；以及仅在开启“朗读输出”时读取会话视图里最后一条助手回复文本（用于朗读）。以上不保存、不外发。唯一持久化的数据是你自己的设置（localStorage 的 dsh-alert-sound.v1；自定义音色另存 dsh-alert-sound.custom.v1）。插件不发起任何网络请求、不向任何服务器发送数据、不用 analytics/telemetry，声音/语音通过浏览器本地的 Web Audio 和语音合成播放。
项目结构
├─ package.json # dsh.bundle + dsh.client（web 客户端插件）
├─ cordis.patch.yml # 组合补丁：插入一行插件（id = 包内 name）
└─ lib/
├─ index.mjs # 主机端（纯客户端插件，主机行为为最小占位）
└─ client.js # 客户端逻辑（__ModuleLoader__ 格式）
致谢（来源参考）
本插件的检测思路（监听会话列表的 running 与 uiSession.pendingInteractions 判定“审批/提问/完成”）参考了 dsh-session-notification（BSD-3-Clause）；“任务完成提示音”概念参考 dsh-chime（Apache-2.0）；打包结构 / web 客户端插件形态参考官方文档 docs/user/develop/basic/publish.md，以及 dsh-plugin-tts、dsh-status-rotator、dsh-web-ui-notify。
音色为原创设计（波形/频率为本插件自定），未照搬任何项目的音色常量；本插件源码为独立实现。发布时请保留本致谢并遵守对应开源许可。
许可
MIT
更多「集成与分享」插件
dsh-notification
作者 omdsh-dev
DeepSeek Harness 桌面通知插件，任务完成时提醒，可按结果与关键词规则控制。
dsh-open-in-vscode
作者 omdsh-dev
从 DSH Web 界面直接以 VS Code 打开工作区目录。
fn-os-apps
作者 tnnevol
飞牛 fnOS 应用 Monorepo
dsh-lark-bot
作者 plutokeating
DeepSeek Harness (dsh) 接入飞书/Lark bot，扫码即用：流式卡片、项目工作区、并行任务、多角色 Agent、跨会话通知、对话内模型/密钥管理与安全网守护（dsh 崩溃后飞书仍可自救）。A scan-to-connect bridge bot connecting DeepSeek Harness (dsh) into Feishu/Lark: streaming cards, workspaces, parallel tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian.