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 規範，確保了與宿主進程的穩定性。對於需要清晰確認智能體狀態的開發者來說，這是一個實用的工具。