DeepSeek Harness(DSH)采用插件化架构。在智能体开发中,明确的反馈能帮助开发者快速定位任务状态。dsh-chime 复刻了 opencode 的任务完成提示音,通过内嵌音源提供完成、提问、错误三种声音,零外部依赖。
核心功能¶
- 内嵌音源:base64 打包原始 mp3,无需下载外部文件。
- 事件监听:监听
agent/status与tools/execute事件。 - 接口提供:提供
/chime/poll与/chime/debug接口。 - 三种音效:支持完成、提问、错误三种提示音。
安装与启用¶
在终端执行以下命令安装:
dsh plugin --profile web add dsh-chime
安装后重启 web 进程,插件会随 profile 自动装配。无需额外配置。
典型用法¶
安装后无需操作,提示音自动生效。若需调试或试听,可使用以下命令:
查看当前队列状态与最近历史:
curl http://127.0.0.1:3080/chime/debug
试听指定音效:
curl http://127.0.0.1:3080/chime/debug?play=done
可用的 play 参数为 done、question、error。
工作细节¶
- 触发时机:一轮回复结束触发完成音;出错结束触发错误音;提问工具(
ask_user_question)或计划提交工具(exit_plan_mode)开始执行时触发提问音。 - 作用范围:Host 级监听,所有 session(含子代理)完成都会响。
- 持久性:重启后有效,随 profile 自动装配。
注意事项¶
- 提问音在提问工具开始执行时触发,若使用非标准提问通道不会触发。
- 若觉得声音吵闹,可卸载插件:
dsh plugin --profile web remove dsh-chime。
该插件由 xiaxingtianxia2-glitch 维护,许可协议为 MIT。源码与文档位于 GitHub。