前言¶

DeepSeek Harness (DSH) 依赖视觉反馈来传达状态，例如状态点或侧边栏标记。一旦切换窗口，你既看不见也听不见任何动静，而智能体可能正等待你的决策或任务已完成。该插件将“等待你”和“已完成”转化为声音信号，通过系统通知和标题栏标记，让你即使离开屏幕也能掌握进展，且在确认状态后不再打扰。

这是什么¶

这是一个 DeepSeek Harness (DSH) 原生风格的通知音效插件。它利用 Web Audio API 实时合成提示音（无需音频文件或网络请求），并集成系统级通知与标题栏标记。插件由开发者 BillCx330 维护，采用 MIT 许可证。安装后，它不会改变 DSH 的视觉设计系统，仅在需要时提供听觉反馈。

核心功能¶

1. 播放提示音：在等待决策、问题、计划审查或任务完成时播放提示音。支持审批与问题区分。
2. 后台通知：当你在其他窗口时，系统会在后台发送通知（内容为审批原因或问题本身），点击即可返回 DSH 窗口。
3. 标题栏标记：在任务栏标题显示“Waiting for you”或“Finished”标记。
4. 重复提醒：对于未处理的决策，可在 1/5/15/30 分钟后再次提醒，确认后停止。
5. 子代理静默：子代理（后台任务）默认静音，仅通知当前会话。
6. 静音时段：可设置静音时段（例如 22:00–08:00），跨午夜自动延续。
7. 声音自定义：内置九种提示音（Bell, Chime, Ding 等），支持上传自定义铃声（MP3/WAV/OGG，≤512KB），并支持音量控制。
8. 一键更新：在设置中检查 npm 版本并自动更新到插件自身目录，更新失败时支持回滚。

安装与启用¶

在终端中执行以下命令以安装插件：

dsh plugin --profile <your profile> add github:BillCx330/dsh-plugin-notify-sounds

安装完成后，需要在 DSH 中重启才能加载新插件。

典型用法¶

1. 设置声音：在 DSH 设置页面的“Sounds”选项卡中，选择内置音效或上传自定义铃声，调整音量。
2. 配置提醒：设置重复提醒的间隔时间（例如 5 分钟）和静音时段（例如 22:00 至次日 08:00）。
3. 使用场景：离开电脑去处理其他事务，DSH 运行智能体。当需要你决策时，系统会弹出通知并播放提示音；当你回来看到通知并点击后，提示音停止。

适用场景与注意¶

• 权限说明：插件随 DSH 进程运行，拥有 DSH 的权限。它仅读取会话状态并在本地播放声音，不向外部服务器发送数据，仅与 DSH 本身通信以触发窗口跳转。
• 手动配置：偏好设置存储在配置文件的 cordis.patch.yml 中。手动修改该文件时，数值必须符合架构定义（音量 0–100，预设 ID，HH:MM 格式的时间），否则插件可能拒绝加载。
• 更新机制：一键更新仅将新版本的文件写入插件自身目录，不会修改 DSH 的配置文件或删除旧文件（后续版本移除的文件会残留，需手动卸载）。

短结尾¶

该插件通过听觉反馈解决了 DSH 在多任务场景下的状态遗漏问题，同时保持了对本地资源和配置文件的安全性。更多信息可参考社区目录或 GitHub 仓库。