DSH(DeepSeek Harness)在處理任務調度、智能體交互和審批流程時,需要持續的狀態反饋。傳統的日誌輸出或簡單的系統通知往往無法滿足即時交互的需求。zeta987/dsh-notify-zeta 是一個社區插件,它爲 DSH 提供了一個內置的通知中心,並支持通過原生 Windows 彈窗(WPF)實現單選、多選、文本輸入和一次性審批。
功能概述¶
該插件主要包含以下能力:
-
DSH 內置通知中心
打開 Settings → Zeta Notify,可以查看最近的通知記錄,按未讀狀態或類型進行過濾,標記爲已讀,或清除歷史記錄。 -
交互式 Windows 卡片
插件利用 Windows 的 WPF 和 PowerShell,原生彈出窗口而非簡單的系統通知氣泡。支持:- 單選、多選和自由文本輸入。
- 一鍵允許或拒絕操作。
這些卡片在瀏覽器標籤頁關閉的情況下依然有效,前提是 DSH 進程在 Windows 主機上保持運行。
-
雙通道通知
- 原生通道:直接調用 Windows 卡片,適合需要操作確認的場景。
- 瀏覽器通道:調用瀏覽器的系統通知 API,需在 HTTPS 或迴環地址環境下,並獲得瀏覽器權限。
-
精細化的控制
提供了 14 個事件開關(包括任務完成、錯誤、中斷、審批、計劃審查等),可控制聲音、內容預覽,以及是否在當前會話中屏蔽普通通知。 -
語言跟隨
界面和通知文本自動跟隨 DSH 的運行語言(英語或繁體中文)。配置項language設爲auto時跟隨 DSH,設爲zh或en時固定語言。 -
內置測試工具
Settings 頁面提供安全測試按鈕,可模擬瀏覽器通知、原生卡片、問題和審批卡片,無需運行真實工具或調用模型。
安裝與啓用¶
插件使用 MIT 許可證,由社區維護。安裝前請確保 DSH 已安裝並初始化了 web 配置文件。
npx @deepseek-ai/dsh plugin --profile web add dsh-notify-zeta
安裝完成後,必須重啓 DSH 進程並刷新瀏覽器頁面,然後進入 Settings → Zeta Notify 進行激活和配置。
使用說明¶
-
查看通知
進入通知中心,查看最近的通知記錄。系統默認保留最近 200 條記錄在內存中。 -
測試通知
點擊瀏覽器和原生測試按鈕,驗證通知是否正常送達。瀏覽器聲音需在頁面交互後播放,原生卡片則依賴 Windows 主機上的 DSH 進程。 -
配置選項
- 事件開關:根據需要啓用或禁用 14 種特定事件的通知。
- 語言設置:在插件配置行中修改
language字段(默認auto)。 - 預覽控制:關閉內容預覽會隱藏普通通知的詳情,但交互式卡片仍會顯示完整內容。
-
審批與回答
當收到審批或問題卡片時,插件會綁定具體的會話、原始智能體和請求。如果原生卡片不可用或失敗,DSH 會回退到標準的審批對話框。
系統要求與注意事項¶
- Node.js 版本:必須安裝 Node.js 22.19.0 或更高版本。
- 操作系統:原生 Windows 卡片功能僅支持 Windows 10 或 11。插件依賴 Windows 自帶的 PowerShell 5.1 和 WPF,無需額外安裝 .NET。
- 瀏覽器通知:若使用瀏覽器通知渠道,頁面必須通過 HTTPS 或迴環地址訪問,且需授予瀏覽器對該源的權限。
- 隱私與安全:插件不包含遙測、外部推送傳輸或 Webhook 功能。設置以
zeta-notify.settings.前綴保存在當前 DSH 配置文件中。重啓 DSH 會清除內存中的歷史記錄。 - 兼容性:DSH 版本需滿足插件要求(通常爲 0.1.5-rc.1 以上)。DSH 開發預覽 API 可能有變化,其他版本可能存在兼容性問題。
總結¶
zeta987/dsh-notify-zeta 通過引入原生 Windows 交互層和中心化的通知管理,解決了 DSH 在長時間運行任務中狀態反饋和人工干預的痛點。它是一個輕量級、無外部依賴的社區插件,適合需要在 Windows 環境下深度集成審批流程的開發者。
- 源碼倉庫: https://github.com/zeta987/dsh-notify-zeta
- 插件目錄: https://www.skillhub.cn/plugins/zeta987/dsh-notify-zeta