在 DeepSeek Harness (DSH) 的開發與使用中，智能體常在後臺運行任務、等待人工審批或執行長時間流程。當瀏覽器標籤頁隱藏或關閉時，僅依賴瀏覽器 Notification API 的通知往往無法送達，導致重要任務被遺漏。
dsh-herald 通過讓 DSH 宿主進程直接向操作系統發送通知，解決了這一斷連問題。無論瀏覽器處於打開、隱藏還是關閉狀態，系統通知中心都能收到推送。
插件定位¶
dsh-herald 是一個聯網工具類插件，原名 dsh-task-notify 的深度定製版。由 bululuburuarua666 維護，採用 MIT 許可證。它爲 DSH 提供了三路投遞機制，將任務狀態推送到前端浮層、瀏覽器橫幅以及宿主系統通知中。
核心功能¶
三通道投遞¶
插件支持三種獨立的通知渠道：
1. 通道 A（頁內浮層）：在 DSH 工作區頁面內渲染的頂部浮層通知，帶有提示音，支持懸停暫停。
2. 通道 B（瀏覽器 OS 橫幅）：通過瀏覽器 Notification API 發出的系統級橫幅，需用戶授權。
3. 通道 C（宿主直髮系統通知）：由 DSH 宿主進程直接調用的系統通知（Windows 使用 PowerShell WinRT，macOS 使用 osascript，Linux 使用 notify-send）。這是該插件的核心能力，瀏覽器關閉時仍可送達。
防轟炸機制¶
爲了防止通知頻繁觸發導致系統卡頓，插件內置了限流邏輯：
* 最小發送間隔：1.2 秒
* 超時機制：5 秒內未發送則丟棄
* 重試策略：僅重試一次
安全與配置¶
- 注入安全：文本內容使用 base64(UTF-16LE) 編碼傳輸，標籤經過過濾，進程不使用 Shell 啓動。
- 高級面板：提供卡片式的通道設置界面，支持中英文雙語切換，包含狀態指示燈。
- 持久歷史：本地記錄 300 條通知歷史，數據存儲在
<profile>/data/task-notify/目錄下，配置與歷史記錄可跨版本保留。
安裝與啓用¶
環境要求¶
安裝前需確保系統已安裝 Node.js 和 pnpm。
安裝步驟¶
- 在終端執行以下命令安裝插件：
dsh plugin --profile web add dsh-herald
- 安裝完成後，必須重啓
dsh web進程。 - 在瀏覽器中硬刷新頁面（Ctrl+F5）以加載新插件。
使用方法¶
安裝並刷新頁面後，點擊頁面右上角的 🔔 鈴鐺 圖標展開抽屜。在抽屜中可以控制三個通道的開關並測試通知。
- 宿主直髮通知（通道 C）：無需額外權限，安裝後默認可用。
- 瀏覽器橫幅（通道 B）：需要點擊對應的“測試”按鈕，由瀏覽器彈窗請求授權。
- 通道聯動：當通道 C 開啓時，通道 B 會進入待機狀態（Standby），避免重複通知。
配置與注意事項¶
環境變量鎖定¶
在宿主環境變量中設置 DSH_TASK_NOTIFY_OS=0 或 1，可以鎖定通道 C 的行爲。設置後，宿主側的更改將覆蓋客戶端的設置。
生效時機¶
- 客戶端更改：在瀏覽器中調整開關或設置，需刷新頁面才能生效。
- 宿主更改：修改環境變量或配置文件，需重啓 DSH 宿主進程才能生效。
總結¶
dsh-herald 通過引入宿主進程直接通知能力，解決了 DSH 後臺任務與用戶交互的信息斷層問題。它提供了零運行時依賴的輕量級解決方案，適合需要在長時間運行任務中保持消息觸達的開發者。
- 插件目錄：dsh-herald
- 源碼地址：GitHub
