dsh-chime

dsh-chime

_{本项目由 dsh创造模式 + Deepseek-V4-Flash0731 独立完成}

English | 中文

这是什么

为 DeepSeek Harness 复刻 opencode 的任务完成提示音：一轮对话完成、向你提问、 或一轮出错结束时播放清脆提示音。三个音效均为 opencode 官方仓库的原始 mp3 无损内嵌（base64 打包在 client 中），插件完全自包含、零外部依赖。

工作原理

1. host 半（Cordis bundle entry）监听 agent/status（一轮 running → idle 即完成，出错轮播错误音）与 tools/execute（ask_user_question 提问工具 开始执行即入队提问音），按需入队音效；
2. webServer 路由：/chime/poll 提供待播队列，/chime/debug 提供状态与 试听入口；
3. client 半（浏览器）每 250ms 轮询 /chime/poll，用 Audio 播放内嵌 base64 音源。

音效

音效	触发时机	音源（opencode 原始）
完成音	一轮回复结束	bip-bop-01.mp3
提问音	提问弹窗出现瞬间 / 计划提交待审	yup-01.mp3
错误音	一轮出错结束	nope-03.mp3

安装

dsh plugin --profile web add dsh-chime

或从 GitHub 源安装（等同内容）：

dsh plugin --profile web add github:xiaxingtianxia2-glitch/dsh-chime

装完重启 web（client 通道启动时扫描装配）。本插件为 host 级监听—— 所有 agent/会话（含子代理）完成都会响。

使用

无需操作，自动生效。试听与排查：

curl http://127.0.0.1:3080/chime/debug

{"pendingCount":0,"recent":["question","done"],"runningCount":1}

字段含义：recent 最近入队历史；pendingCount 待播放队列长度（client 每 250ms 取走）；runningCount 当前 live agent 数。

试听指定音效：

curl http://127.0.0.1:3080/chime/debug?play=done      # done | question | error

常见问题

• 没声音？ 先确认系统音量与浏览器标签页未被静音；再访问 /chime/debug?play=done 试听——若入队但没播，刷新页面重载 client 播放器。
• 子代理完成也响？ 会——host 级监听所有 agent，与 opencode 一致（所有 session 都响）。若觉得吵可卸载插件： dsh plugin --profile web remove dsh-chime。
• 提问音不响？ 提问音在提问工具开始执行时触发（弹窗出现瞬间）， 计划待审音在 exit_plan_mode 工具开始执行时触发。若使用非标准提问/计划 通道（不经过这两个工具）不会触发。
• 重启后还有效吗？ 有效——bundle 插件随 profile 自动装配，重启即生效。

许可证

MIT