前言¶
在 DeepSeek Harness（DSH）裏跑 agent，往往要盯一輪會話什麼時候從 running 變回空閒。人離開屏幕時，只能靠偶爾切回窗口確認。社區插件 dsh-complete-chime 在 Web GUI 裏監聽會話狀態，在一輪任務真正結束時播放合成提示音，並可選用系統 TTS 和 Windows 通知。插件零依賴、零構建，聲音由 Web Audio 現場合成，設置落在本機。下面介紹它做什麼、怎麼裝、怎麼用，以及使用時要注意什麼。
這是什麼¶
dsh-complete-chime 是維護者 423324324 發佈的 DSH 插件，在 SkillHub 目錄 中歸類爲「趣味換裝」。源碼與說明見 GitHub 倉庫，當前 package 版本爲 1.0.0，MIT 許可，要求 Node ^22.19.0 || >=24.0.0。
一句話：agent 一輪跑完時響鈴、放短旋律、可選念一句「任務完成了」、可選彈系統通知；子代理默認不響，可配置。
什麼時候會響¶
- 一輪任務結束：當前會話的
running從true變爲false時響一次。 - 子代理：subagent 跑完默認不響；在設置裏可打開「子代理完成也提醒」。
- 前臺策略：默認只在窗口不在前臺時提醒（最小化、切到其他應用、頁面不可見）。若希望無論是否在看不都響，關閉「只在窗口不在前臺時提醒」。
- 多會話同時完成：900ms 冷卻，同一時間只響一次，避免連環播放。
核心功能與設置¶
設置入口在 DSH Web GUI：設置 → 完成提示音（與其他插件設置項在同一列表）。
| 設置項 | 說明 |
|---|---|
| 啓用提示音 | 總開關 |
| 提示音 | chime（三音叮咚，默認）、ding、bell、music（上行琶音）、alarm（鬧鐘）、custom（本地上傳） |
| 音量 | 0–100 |
| 試聽 | 立即播放當前選中聲音 |
| 只在窗口不在前臺時提醒 | 默認開啓 |
| 語音播報 | 系統 TTS，文案可改（默認「任務完成了」） |
| 系統通知 | Windows 通知（會請求通知權限） |
| 子代理完成也提醒 | 默認關閉 |
| 自定義音樂 | 本地音頻（mp3/wav/ogg 等，上限 12MB），存瀏覽器 IndexedDB，不上傳服務器 |
改動立即生效，並寫入宿主側 ~/.dsh/dsh-complete-chime/settings.json；localStorage 僅用於首屏快速回填和宿主不可達時的兜底。DSH 桌面端每次啓動可能用隨機端口，頁面 origin 會變，因此需要宿主側持久化。
實現上，宿主入口 lib/index.js 提供 GET/PUT /api/dsh-complete-chime/settings；客戶端 lib/client.js 訂閱 ctx.sessions.list 檢測 running 變化，用 Web Audio 合成鈴聲，並在首次用戶點擊/按鍵時解鎖 AudioContext，以符合瀏覽器自動播放策略。
安裝與啓用¶
插件以本地目錄形式安裝。在 DSH 桌面端可用的終端裏執行（路徑需改成你機器上的插件目錄）：
dsh plugin --profile desktop add file:C:\Users\dd\Documents\deepseek-harness\default-workspace\dsh-complete-chime
安裝後關閉 DSH 桌面端再重新打開（profile 裏的 bundle 僅在啓動時裝載；僅 Ctrl+R 刷新頁面不夠）。啓動後打開 設置，列表中應出現「完成提示音」，點「試聽」能聽到聲音即表示裝載成功。
官方 README 還給出手動安裝步驟（pnpm 不可用時）：複製目錄到 C:\Users\dd\.dsh\profiles\desktop\node_modules\dsh-complete-chime，在對應 package.json 的 dependencies 與 dsh.profile.bundles 中登記，再重啓桌面端。具體路徑以 README 爲準。
卸載：
dsh plugin --profile desktop remove dsh-complete-chime
宿主側 ~/.dsh/dsh-complete-chime/settings.json 不會隨卸載自動刪除，需自行清理目錄。
典型用法¶
- 按上文安裝並重啓 DSH 桌面端。
- 進入 設置 → 完成提示音，保持「啓用提示音」開啓，選擇
chime或其他音色，點「試聽」確認音量。 - 若經常在別的窗口工作，保持「只在窗口不在前臺時提醒」開啓；若需要每次結束都響，關閉該項。
- 需要話音提醒時打開「語音播報」並修改文案；需要系統欄通知時打開「系統通知」並授予權限。
- 跑一輪 agent 任務，待
running結束且窗口不在前臺（若按默認策略），應聽到提示音。
倉庫內可用 Node 跑單元測試（不依賴瀏覽器）：
node test/run.mjs
node test/host.mjs
適用場景與注意¶
適合誰：長時間在 DSH Web GUI 裏跑 agent、又不想一直盯進度條的開發者；希望任務結束時有輕量聽覺或通知反饋的場景。
已知限制（來自 README）：
- 僅在 GUI 頁面開着時工作；關閉整個 DSH 窗口不會響；若要後臺常駐提醒，需依賴系統級通知等其它方案。
- TTS 音色取決於 Windows 已安裝的中文語音包。
- 未提供「預計完成時間」「重複鬧鐘」等功能。
安全與權限：插件隨當前 DSH 進程與你在本機加載的代碼運行。安裝前請自行閱讀 源碼 與 MIT 許可證；自定義音樂僅存在本地 IndexedDB，設置經迴環 API 寫入 ~/.dsh/dsh-complete-chime/settings.json，接口帶有同源與 body 大小等圍欄。
DSH 生態強調「一切皆插件」；SkillHub 爲社區目錄，與 DeepSeek、幻方無官方從屬關係。
結尾¶
dsh-complete-chime 用會話 running 狀態驅動零依賴 Web Audio 提示，並把設置同步到宿主文件，適配桌面端隨機端口。需要進一步瞭解參數與原理時，以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/423324324/dsh-complete-chime
- GitHub：https://github.com/423324324/dsh-complete-chime
