DeepSeek Harness 插件：dsh-task-sounds —— 任务完成与提问提示音

在使用 DeepSeek Harness (DSH) 进行 Agent 开发或测试时，长时间运行的任务往往难以通过视觉状态变化来实时追踪进度。本插件通过在特定交互节点触发提示音，提供了一种直观的听觉反馈机制。

是什么¶

dsh-task-sounds 是一个为 DSH Web UI 设计的轻量级插件，由用户 henrytang2011win-coder 维护。它利用浏览器原生的 Web Audio API 实时合成提示音，不依赖任何外部音频文件、网络请求或宿主进程，支持完全离线工作。

核心功能¶

• 对话完成提示：当 Agent 完成一轮对话时播放提示音。
• 提问提示音：当 Agent 向用户提问（包括问题、计划审查或审批）并等待输入时，播放 “ding-dong” 提示音。
• 零依赖合成：完全在浏览器端生成音频，无需素材、无需网络、无需宿主进程。
• 状态持久化：支持静音开关，静音状态保存在 localStorage 中，刷新页面后保持。
• 历史播放保护：加载历史消息或分页浏览时不会重复播放已处理节点的提示音。

安装与启用¶

执行以下命令安装插件：

dsh plugin --profile web add dsh-task-sounds

安装后重启 dsh web 进程即可生效。

典型用法¶

1. 重启 DSH Web 服务后，启动一个任务或让 Agent 自动运行。
2. 观察并聆听：
   • done：Agent 完成一轮对话时播放。
   • question：Agent 提出问题或需要审批时播放。
3. 点击会话头部工具栏中的 🔔 图标可静音，再次点击恢复。

注意事项与适用场景¶

• 浏览器自动播放策略：音频引擎需要在页面发生第一次鼠标点击或按键交互后才会解锁，因此初次操作后才能听到提示音。
• 纯客户端实现：插件客户端代码为纯 JavaScript，无需打包工具。
• 适用人群：适合需要在嘈杂环境中或通过听觉辅助监控 Agent 运行进度的开发者。

结尾¶

该插件以极小的体积解决了状态反馈缺失的问题，适合集成到 DSH 的日常开发流程中。更多技术细节与源码可参考 GitHub 仓库。