前言¶
在使用 DeepSeek Harness（DSH）進行智能體開發時，對話通常在瀏覽器或終端中運行。當任務在後臺執行時，開發者容易錯過關鍵狀態變更，如任務異常終止或需要用戶確認的環節。dsh-niao-message 插件將 DSH 的事件流直接映射到 macOS 通知中心，確保在「異常終止」、「需要你操作」、「正常完成」三個關鍵節點觸發系統橫幅，並提供點擊直達應用的能力。
這是什麼¶
這是一個由 dsh-niao 維護的 macOS 系統通知插件。它監聽 DSH 的內部事件，在特定場景下調用 terminal-notifier 向系統發送通知。其核心價值在於將 DSH 的狀態反饋從瀏覽器/終端延伸到系統桌面，並在用戶切回 DSH 頁面時自動清空通知，避免干擾。
核心功能¶
- 三大通知組獨立配置：針對「異常終止」、「需要你操作」、「正常完成」三個場景分別設置開關、提示音和標題/消息模板。
- 點擊橫幅直達應用：點擊通知橫幅可執行
open -a命令（或 Bundle ID）打開指定應用，支持自動掃描本機 DSH 桌面應用與瀏覽器。 - 零輪詢、自動清空：利用瀏覽器頁籤的
visibilitychange和focus事件監聽。當切回 DSH 頁面時，通知自動消失，無後臺常駐開銷。 - 通知節流與去重：內置 3 秒節流機制，並支持基於文件標記的去重邏輯（標記文件 + 過期時間），防止重複打擾。
- 零手動安裝：插件內置 macOS 通知二進制（arm64 版本），Intel Mac 會自動回退使用
node-notifier自帶版本，無需手動安裝系統工具。 - 可視化設置面板：在 DSH 設置彈窗中提供「通知管理」頁面，支持即時編輯模板和測試通知。
安裝與啓用¶
安裝時需要指定 DSH 的 profile（例如 web）。
dsh plugin --profile web add dsh-niao-message
安裝完成後，需重啓 dsh web 進程使插件生效。
典型用法¶
安裝後，進入 DSH 設置彈窗（左下角 ⚙️），左側會出現「通知管理」頁面。
- 測試通知：在設置面板中點擊「測試通知」，通知中心會出現測試橫幅。
- 配置覆蓋：插件的配置優先級爲：插件默認值 < 補丁層 (
cordis.patch.yml) < 設置面板保存的配置文件。如需手動修改，可編輯~/.dsh/dsh-niao-message.config.json。 - 自動清空：在 DSH 頁面觸發一條通知後，切換到其他應用或頁籤，再切回 DSH 頁面，之前的通知會自動消失。
適用場景與注意¶
- 平臺限制：僅支持 macOS 平臺。點擊行爲、通知發送、應用掃描均依賴
terminal-notifier、open命令等 macOS 專屬機制。 - 依賴項：依賴
@deepseek-ai/schemastery和node-notifier。 - 權限與安全：插件以當前 DSH 進程的權限運行。在使用前，建議檢查插件源碼與許可證（MIT）。
- 配置優先級：修改設置面板的配置會持久化到
~/.dsh/dsh-niao-message.config.json，覆蓋插件默認值和補丁層配置。
結語¶
dsh-niao-message 通過將 DSH 的運行狀態無縫集成到 macOS 通知中心，解決了後臺任務狀態感知的問題。其零輪詢的設計和自動清空機制，保證了通知功能既及時又輕量。
