dsh-chime

<p align="center">_{<i>本项目由 dsh创造模式 + Deepseek-V4-Flash0731 独立完成</i>}</p>

[English](README.en.md) | 中文

这是什么

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

工作原理

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

音效

安装

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":["done","question"],"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](LICENSE)