前言¶
在 DeepSeek Harness (DSH) 的 Web 環境中，智能體執行任務時，用戶往往正在做其他事情，難以第一時間察覺任務結束。dsh-turn-chime 插件利用 DSH 的渲染插槽機制，在智能體回合結束時自動播放提示音，幫助用戶快速捕捉任務完成信號。
核心功能¶
該插件專注於解決“任務完成無感”的問題，主要包含以下能力：
* 任務完成後播放提示音。
* 提供設置頁，支持開關提示音、調節音量。
* 支持上傳自定義音頻文件，格式包括 MP3、WAV、OGG、M4A。
* 內置兩音鈴聲合成功能。
* 三重觸發保險機制：新鮮度窗口（60 秒）、頁面穩定窗口（3 秒）、去重機制（200 條上限）。
* 設置與音頻存儲在宿主端，支持跨瀏覽器持久化。
* 隱私保護：不讀取憑據、不訪問外網、不修改 DSH 內核。
安裝與啓用¶
安裝前需確保環境滿足要求：Node.js ≥ 20, pnpm ≥ 10。
使用官方 CLI 安裝：
dsh plugin --profile web add dsh-turn-chime@latest
安裝完成後，必須重啓 dsh web 進程，並在瀏覽器中執行硬刷新（Ctrl/Cmd+Shift+R）以加載最新代碼。
配置與使用¶
插件安裝後，在 DSH 設置頁中找到“提示音”相關選項。
- 開關與音量：在設置頁開啓提示音，拖動音量滑塊調節至合適大小。
- 試聽：點擊“試聽”按鈕確認當前音量下的播放效果。
- 自定義音頻：點擊“上傳音頻”選擇本地文件，支持最大 8 MB 的音頻文件。上傳後自動生效。
- 恢復默認：如需使用內置鈴聲，可在設置頁點擊“恢復內置”。
插件會將配置文件與音頻文件存儲在宿主端的 ~/.dsh/turn-chime/ 目錄下。
工作原理與限制¶
- 觸發機制：插件註冊在 DSH 的
conversation.chat.assistant-actions插槽上，通過渲染一個隱形條目（渲染null）來標記任務完成時刻。 - 保險機制：爲了防止干擾，設置了三道保險：只有 60 秒內的新鮮回合會響、剛打開頁面 3 秒內的渲染不算、同一回合最多響一次。
- 生效範圍：提示音僅對當前打開的會話生效。任務失敗或中斷時也會播放提示音，目前不區分成功與失敗狀態。
- 瀏覽器限制：由於瀏覽器自動播放策略，首次使用需在頁面上有一次交互（點擊或按鍵）以解鎖音頻權限，之後任務完成即可自動播放。
結語¶
dsh-turn-chime 是一個輕量級的 DSH Web 插件，它利用官方公開的渲染插槽，在不侵入內核的前提下提供了任務完成的聽覺反饋。適合需要清晰感知智能體執行進度的開發者使用。
