前言¶
在 DeepSeek Harness 里跑 Agent 任务时，会话往往在后台执行，完成、失败或报错并不一定会立刻被注意到。若只靠盯着界面或刷新会话列表，容易漏掉结束时刻。下面介绍的 dsh-sound-notify（维护者 ZhiHui6）是归类为客户端的 Harness bundle：在任务完成、任务失败、错误提示三类事件发生时播放提示音，并支持九种内置合成音效、自定义音频与设置页实时预览。配置写在浏览器本地，跟随当前浏览器配置档案。
这是什么¶
dsh-sound-notify 在 Harness Web 客户端侧监听已有会话列表，按规则触发播放，不替代 Harness 本身的通知机制，而是在你离开窗口或并行多会话时补一层可听见的反馈。插件以 bundle 形式安装进 Harness 配置档案，对该档案下的会话生效，而不是装进某个普通项目目录。
核心功能¶
三类独立事件¶
- 任务完成：会话曾处于运行中，随后停止且未按失败规则处理时触发。
- 任务失败：上述会话在停止时报告了代理错误。
- 错误提示：会话处于空闲时，单独到达的代理错误会直接触发此类提示音。
提示音带防抖：一批会话同时结束只会响一声，避免连续齐鸣。
内置与自定义音效¶
九种内置音效由 Web Audio API 实时合成，不下载外部音频文件。英文名与 README 一致：Chime、Marimba、Soft pad、Beep、Ding、Deep tone、Rising、Falling、Alarm；中文界面下对应 README 中的译名（如清脆铃声、马林巴、柔和铺底等）。
可从本机添加任意音频文件作为自定义音效，单个文件上限 1.5 MB，以 data URL 形式保存在浏览器中；添加后会出现在每个事件的下拉菜单里。
设置与预览¶
- 音量调节、总开关。
- 选项：是否包含子代理（sub-agent）会话。
- 在设置页可即时预览任意音效，也可播放测试音。
配置保存在浏览器 local storage，跟随当前浏览器配置档案。
安装与启用¶
需要 DeepSeek Harness 0.2.0 或更高版本（package.json 中 dsh.compatibility.dsh 为 >=0.2.0，且 profiles 含 web）。
这是 Harness bundle，安装结果会写入配置档案中的链接，重启后仍有效，并对该档案下所有会话可用。
在 DeepSeek Harness 中让 Agent 从仓库安装，README 给出的表述如下：
安装 https://github.com/ZhiHui6/dsh-sound-notify 这个 bundle
英文 README 等价表述为：让 Agent 安装 bundle，地址为 https://github.com/ZhiHui6/dsh-sound-notify。
若已有本地 bundle 目录，也可让 Agent 调用 plugin_manager，action 为 install_bundle，target 指向该目录（具体目录路径以你本机为准）。
安装后无需单独「启用项目级插件」；客户端侧 bundle 会按 package.json 中 dsh.client.immediately: true 注入 Web 客户端。
典型用法¶
- 完成上述安装后，在 Harness 窗口内至少点击或按键一次，以满足浏览器「先有一次用户交互才允许播放音频」的策略。
- 打开 设置 → 声音提示（英文界面为 Settings → Sound notifications）。该分节位于内置设置项之后、插件市场之前。
- 打开总开关，为「任务完成」「任务失败」「错误提示」分别选择内置或自定义音效，调节音量；按需开启或关闭「包含子代理会话」。
- 在设置页预览或播放测试音，确认音量与音色合适。
- 正常运行 Agent 任务；客户端会根据会话列表变化自动播放对应提示音。
适用场景与注意¶
适合：长时间跑任务、多会话并行、需要离开页面时仍能听见结束或失败信号的使用者。
权限与信任：插件以当前 Harness / 浏览器会话的客户端能力运行；自定义音效仅写入本机浏览器存储。安装前可在 GitHub 仓库 查看源码与 MIT 许可证（package.json 版本 1.0.0）。
使用注意（来自 README）：
- 首次播放前必须在页面内有一次点击或按键。
- 自定义音效受 1.5 MB 与浏览器存储容量限制；若写入失败，可删除部分自定义音效后重试。
DeepSeek Harness 生态强调「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-sound-notify 用三种事件、九种内置合成音与可选自定义文件，把任务结束与错误变成可听反馈，并集中在「设置 → 声音提示」中配置。进一步了解可访问目录页与仓库：
- 目录页：https://www.skillhub.cn/plugins/ZhiHui6/dsh-sound-notify
- GitHub：https://github.com/ZhiHui6/dsh-sound-notify
