DeepSeek Harness（DSH）常用於讓智能體在後臺運行任務。在處理其他工作或刷視頻時，開發者很難時刻盯着界面。這款插件通過聲音提醒，在 AI 結束工作或需要你輸入時發出提示。
這是 jedzqer 開發的一款 DSH 客戶端插件。它通過 Web Audio 合成音效，在 AI 結束工作或向你提問時發出提示音，無需外部音頻文件。
核心功能¶
插件提供以下能力：
- 整輪響應結束提醒：以當前會話
running狀態 true→false 邊沿爲信號，完成、錯誤、max-tokens 或停止均會觸發，播放上行琶音 “ta-da”。 - 提問等待提醒：AI 停下來等待你回答時，播放雙音 “叮”，與完成音區分。
- 子代理感知：後臺子代理仍在運行時不會誤響；只有整個任務真正完成才播放。
- 按瀏覽器控制：通過
localStorage即可靜音、調音量，或只在標籤頁隱藏時響。 - 零資源依賴：提示音全部由 Web Audio 合成，無音頻文件、無網絡請求。
- 自動處理自動播放策略：首次用戶手勢時預熱
AudioContext，無需手動點按解鎖聲音。 - 自動清理：插件卸載 / HMR 時自動釋放全部訂閱與事件監聽。
安裝與啓用¶
安裝步驟如下：
# 1. 把插件安裝進 web profile
dsh plugin --profile web add dsh-sound-plugin
# 2. 重啓 web UI 使插件集合生效
dsh web
插件默認開啓，無需任何配置。
典型用法與配置¶
代碼級配置¶
如需調整默認行爲，修改 client.js 頂部的 DEFAULTS 常量。支持配置項包括 enabled、volume、hiddenOnly。
修改 client.js 後無需重啓 dsh web，刷新頁面（建議 Ctrl+F5）即可生效；只有增刪插件才需要重啓。
瀏覽器級覆蓋¶
在瀏覽器 DevTools Console 中執行以下命令：
// 靜音
localStorage.setItem("dsh-sound.enabled", "false");
// 音量 0..1
localStorage.setItem("dsh-sound.volume", "0.25");
// 僅在標籤頁隱藏時響
localStorage.setItem("dsh-sound.hiddenOnly", "true");
行爲說明¶
- 會話監聽範圍：只監聽當前會話（側邊欄選中的會話）的響應結束；切換會話自動跟隨。正在運行時切到已完成的歷史對話不會誤響——只有保持選中的會話結束才響。
- 提示音區分：
- 提問等待：雙音 “叮”。
- 整輪完成：上行琶音 “ta-da”。
- 觸發條件：錯誤 / max-tokens / 停止結束同樣會響完成音。
- 子代理門控：子代理（含後臺子代理）的中間等待不響；打開歷史會話不響；切到已經在等待提問的會話也不響。
技術實現¶
插件由 Node 半身（index.js，空 apply，僅用於讓插件出現在 Host 的 Loader 中）與瀏覽器半身（client.js，經 dsh.client 聲明被發現）組成。
生態背景¶
DSH 理念是「一切皆插件」，該插件託管於社區獨立站點。安裝前建議檢查源碼與許可證。
- 插件目錄頁：dsh-sound-plugin
- 源碼倉庫：jedzqer/dsh-sound-plugin
