前言¶
在 DeepSeek Harness 裏跑 Agent 任務時，會話往往在後臺執行，完成、失敗或報錯並不一定會立刻被注意到。若只靠盯着界面或刷新會話列表，容易漏掉結束時刻。下面介紹的 dsh-sound-notify（維護者 ZhiHui6）是歸類爲客戶端的 Harness bundle：在任務完成、任務失敗、錯誤提示三類事件發生時播放提示音，並支持九種內置合成音效、自定義音頻與設置頁實時預覽。配置寫在瀏覽器本地，跟隨當前瀏覽器配置檔案。
這是什麼¶
dsh-sound-notify 在 Harness Web 客戶端側監聽已有會話列表，按規則觸發播放，不替代 Harness 本身的通知機制，而是在你離開窗口或並行多會話時補一層可聽見的反饋。插件以 bundle 形式安裝進 Harness 配置檔案，對該檔案下的會話生效，而不是裝進某個普通項目目錄。
核心功能¶
三類獨立事件¶
- 任務完成：會話曾處於運行中，隨後停止且未按失敗規則處理時觸發。
- 任務失敗：上述會話在停止時報告了代理錯誤。
- 錯誤提示：會話處於空閒時，單獨到達的代理錯誤會直接觸發此類提示音。
提示音帶防抖：一批會話同時結束只會響一聲，避免連續齊鳴。
內置與自定義音效¶
九種內置音效由 Web Audio API 實時合成，不下載外部音頻文件。英文名與 README 一致：Chime、Marimba、Soft pad、Beep、Ding、Deep tone、Rising、Falling、Alarm；中文界面下對應 README 中的譯名（如清脆鈴聲、馬林巴、柔和鋪底等）。
可從本機添加任意音頻文件作爲自定義音效，單個文件上限 1.5 MB，以 data URL 形式保存在瀏覽器中；添加後會出現在每個事件的下拉菜單裏。
設置與預覽¶
- 音量調節、總開關。
- 選項：是否包含子代理（sub-agent）會話。
- 在設置頁可即時預覽任意音效，也可播放測試音。
配置保存在瀏覽器 local storage，跟隨當前瀏覽器配置檔案。
安裝與啓用¶
需要 DeepSeek Harness 0.2.0 或更高版本（package.json 中 dsh.compatibility.dsh 爲 >=0.2.0，且 profiles 含 web）。
這是 Harness bundle，安裝結果會寫入配置檔案中的鏈接，重啓後仍有效，並對該檔案下所有會話可用。
在 DeepSeek Harness 中讓 Agent 從倉庫安裝，README 給出的表述如下：
安裝 https://github.com/ZhiHui6/dsh-sound-notify 這個 bundle
英文 README 等價表述爲：讓 Agent 安裝 bundle，地址爲 https://github.com/ZhiHui6/dsh-sound-notify。
若已有本地 bundle 目錄，也可讓 Agent 調用 plugin_manager，action 爲 install_bundle，target 指向該目錄（具體目錄路徑以你本機爲準）。
安裝後無需單獨「啓用項目級插件」；客戶端側 bundle 會按 package.json 中 dsh.client.immediately: true 注入 Web 客戶端。
典型用法¶
- 完成上述安裝後，在 Harness 窗口內至少點擊或按鍵一次，以滿足瀏覽器「先有一次用戶交互才允許播放音頻」的策略。
- 打開 設置 → 聲音提示（英文界面爲 Settings → Sound notifications）。該分節位於內置設置項之後、插件市場之前。
- 打開總開關，爲「任務完成」「任務失敗」「錯誤提示」分別選擇內置或自定義音效，調節音量；按需開啓或關閉「包含子代理會話」。
- 在設置頁預覽或播放測試音，確認音量與音色合適。
- 正常運行 Agent 任務；客戶端會根據會話列表變化自動播放對應提示音。
適用場景與注意¶
適合：長時間跑任務、多會話並行、需要離開頁面時仍能聽見結束或失敗信號的使用者。
權限與信任：插件以當前 Harness / 瀏覽器會話的客戶端能力運行；自定義音效僅寫入本機瀏覽器存儲。安裝前可在 GitHub 倉庫 查看源碼與 MIT 許可證（package.json 版本 1.0.0）。
使用注意（來自 README）：
- 首次播放前必須在頁面內有一次點擊或按鍵。
- 自定義音效受 1.5 MB 與瀏覽器存儲容量限制；若寫入失敗，可刪除部分自定義音效後重試。
DeepSeek Harness 生態強調「一切皆插件」；社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-sound-notify 用三種事件、九種內置合成音與可選自定義文件，把任務結束與錯誤變成可聽反饋，並集中在「設置 → 聲音提示」中配置。進一步瞭解可訪問目錄頁與倉庫：
- 目錄頁：https://www.skillhub.cn/plugins/ZhiHui6/dsh-sound-notify
- GitHub：https://github.com/ZhiHui6/dsh-sound-notify
