DeepSeek Harness 任务提示音插件 (task-chime)

在 DeepSeek Harness（DSH）的开发流程中，智能体运行时常常会遇到沙箱升级、受限文件操作等审批请求。如果用户处于其他窗口，这些请求容易被忽略，导致流程卡顿或状态不可见。DSH 插件化架构允许通过外部插件扩展行为。task-chime 旨在解决这一信息遗漏问题，通过听觉反馈确保开发者不会错过关键事件。

这是什么¶

task-chime 是一个为 DSH 设计的轻量级提示音插件。由 Abel-86 维护。它通过在 Web GUI 中播放本地音频文件，处理审批/权限请求和任务完成，确保开发者不会错过关键事件。

核心功能¶

权限确认提示音：在沙箱升级、受限文件操作等审批/权限请求时播放。
任务完成提示音：在 agent 回合结束时播放。
GUI 设置卡片：支持在 Web GUI 中自定义声音文件、音量（0-100）、启用/禁用及冷却间隔。
设置持久化：写入 $DSH_HOME/settings.yaml，支持热加载。
进程内播放：使用 Windows 原生 MCI 接口，不派生子进程。
跟随主题：UI 使用 --dsw-alias-* 主题变量。

安装与启用¶

执行官方安装命令：

    dsh plugin --profile web add task-chime

重启 dsh web 进程。
在浏览器中强制刷新页面（Ctrl+Shift+R）。

典型用法¶

安装后，通过以下方式配置：

Web GUI：进入设置 → 插件 → 插件配置 → DSH 任务提示音。
YAML 配置：直接编辑 $DSH_HOME/settings.yaml。

    task-chime:
      approvalSound: path/to/sound.mp3
      taskSound: path/to/sound.wav
      approvalEnabled: true
      taskEnabled: true
      approvalVolume: 100
      taskVolume: 100
      cooldownMs: 1500

调试：设置环境变量 TASK_CHIME_TRACE=D:/tmp/task-chime.log 以记录日志。

适用场景与注意¶

平台限制：仅支持 Windows 平台发声，非 Windows 平台会静默。
技术限制：必须使用同步 MCI 调用，禁止使用 mci.async。严禁派生 PowerShell 或 cmd 子进程播放声音。
开发注意：作为 bare-package 模块，修改代码后必须重启 dsh。若通过 file: 路径安装，修改源码需先 remove 再 add，因为安装是硬链接副本。

结尾¶

task-chime 提供了一种在 DSH 生态中通过听觉反馈增强智能体交互可靠性的机制。它通过避免子进程和严格遵循 Windows MCI 规范，确保了与宿主进程的稳定性。对于需要清晰确认智能体状态的开发者来说，这是一个实用的工具。