前言¶
DeepSeek Harness (DSH) 的 Web GUI 在處理長時間運行的任務或後臺會話時，用戶往往難以直觀感知輸出何時完成。dsh-ui-notify 插件通過播放嵌入式提示音，解決了這一信息不對稱的問題。它是一個純 Web 插件，不依賴宿主服務或工具註冊，直接作用於瀏覽器端的渲染層。
插件定位¶
這是一個由 xingke-seeker 維護的獨立 DSH 插件。它的核心作用是在會話輸出結束時，通過內置的提示音（Chime）通知用戶。所有設置均保存在瀏覽器的 localStorage 中，重啓頁面後依然生效。
核心功能¶
- 完成音效：當會話的輸出內容完成時，自動播放選定的提示音。
- 配置持久化：所有偏好設置（開關、音量、背景/前臺行爲）均保存在本地存儲中。
- 純 Web 實現：不註冊 Host 服務、工具或會話日誌條目，僅作爲 UI 組件存在。
- 靈活配置：支持通過 Settings（設置） -> General（常規） -> Notifications（通知） 行進行控制。可調節開關、選擇音效（內置 Chime 1-3）、設置音量（0-100%）以及選擇觸發範圍（僅背景會話或任意會話）。
安裝與啓用¶
該插件已發佈至 npm 倉庫，安裝前請確保 DSH 環境正確。
安裝¶
dsh plugin --profile web add dsh-ui-notify
安裝後，請重啓 Web Profile (dsh --profile web) 以加載插件元數據。無需執行構建步驟，發佈的 tarball 已包含編譯好的 lib/ 目錄。
更新¶
dsh plugin --profile web up dsh-ui-notify
典型用法¶
- 安裝完成後，在 DSH Web 界面打開 Settings。
- 進入 General 頁面。
- 找到 Notifications 行。
- 開啓 Enable reminders（默認開啓）。
- 根據需要調整音效和音量，並選擇觸發時機（默認爲 Background）。
適用場景與注意事項¶
- 瀏覽器限制：瀏覽器的自動播放策略要求必須有用戶手勢（點擊、觸摸等）才能解鎖音頻播放。如果插件在用戶沒有進行操作前嘗試播放，音頻會被靜音。
- 排隊機制：如果在音頻解鎖前有多個會話完成，未播放的聲音會被放入隊列，在用戶產生下一個手勢時依次播放。
- 獨立性：插件無官方背書，僅作爲社區插件存在。
總結¶
dsh-ui-notify 爲 DSH 的 Web 界面增加了一層聽覺反饋，適合需要在後臺長時間運行任務並希望即時獲知完成狀態的開發者。更多細節與源碼可參考 GitHub 倉庫。
