在 DeepSeek Harness (DSH) 中进行对话开发时，有时需要明确感知对话回合的结束时刻。dsh-complete-chime 插件通过在回合结束时播放短提示音，解决了这一需求。
是什么¶
dsh-complete-chime 是一个由 Whale-Zhang 维护的 DeepSeek Harness 插件。它遵循 MIT 许可证，支持在对话回合结束时播放短提示音，同时覆盖网页端与桌面端。
安装与启用¶
使用前需确保已安装 DeepSeek Harness。安装命令如下：
dsh plugin --profile web add github:Whale-Zhang/dsh-complete-chime
dsh plugin --profile desktop add github:Whale-Zhang/dsh-complete-chime
安装完成后，需重启对应的 profile 才能生效。
核心功能¶
该插件主要提供以下能力：
- 播放提示音：在对话回合真正结束时播放短提示音（非手动停止、非刷新回放）。
- 多会话支持：支持网页端与桌面端。多会话并行时，每完成一个会话回合即响一次，互不干扰，当前正在查看的会话也会触发提示音。
- 内置音色：提供三种内置提示音：铃声、叮咚、钟声。
- 子代理控制：子代理会话默认不响。
- 自定义音频：支持上传自定义音频（支持 mp3/wav 格式），最大文件大小限制为 2MB。
配置方法¶
进入 设置 → 插件 → 插件配置，找到「对话完成提示音」选项。
展开该选项后，可以进行以下操作：
- 启用/关闭：通过开关控制提示音功能。
- 音色与音量：选择内置音色或调整音量大小。
- 试听：预览当前设置的提示音。
- 上传自定义音频：上传或更换自定义提示音文件。
注意事项¶
- 文件路径：自定义音频文件默认存储在
$DSH_HOME/complete-chime/（通常为~/.dsh/complete-chime/）。 - 文件限制：上传的自定义文件必须是真实音频，且大小不能超过 2MB。
- 自动播放限制：若浏览器拦截自动播放，需在页面上点击一次以解锁音频。切回前台时会尝试恢复
AudioContext以确保提示音正常播放。
总结¶
dsh-complete-chime 为 DSH 用户提供了清晰的多轮对话反馈机制。通过简单的配置，即可在对话结束时获得听觉确认，适合需要明确感知对话进度的场景。
