dsh-plugin-winnotify：DeepSeek Harness 的 Windows 原生 Toast 通知

前言¶

DeepSeek Harness（DSH）採用插件化架構，所有功能均通過插件擴展。在使用 web profile 運行時，系統消息通常僅在瀏覽器頁面內顯示。dsh-plugin-winnotify 插件通過橋接機制，將 DSH 的關鍵事件（如審批、異常、任務狀態變更）轉換爲 Windows 原生的系統 Toast 通知。這能讓開發者在切換窗口或使用其他應用時，也能及時響應來自智能體的請求或異常信息。

插件概況¶

名稱：dsh-plugin-winnotify
維護者：Maple-Bamboo-Team
許可證：MIT
核心價值：將 DSH 的 Web 消息流映射爲 Windows 原生桌面通知，確保關鍵事件不遺漏。

環境要求¶

安裝前需滿足以下條件：
* 操作系統：Windows 10 或 Windows 11
* 運行環境：已安裝的 DeepSeek Harness (dsh)
* Node.js 版本：22.19 或更高版本

安裝¶

在 PowerShell 中執行以下命令進行安裝：

dsh plugin --profile web add https://codeload.github.com/Maple-Bamboo-Team/dsh-plugin-winnotify/tar.gz/refs/heads/main --ignore-scripts

安裝完成後，需重啓 dsh web 進程並刷新瀏覽器頁面以加載插件。

通知內容¶

插件會根據事件類型生成不同的通知。通知標題爲對應的對話名。

事件類型	通知正文示例
審批 / 權限提升	等待處理：寫入文件——需要工作區外的寫入權限
提問	等待回答：狀態探測——是否繼續？
異常	未經處理的異常：具體內容
任務完成	任務已完成
任務中斷	任務中斷：執行已取消

插件啓動時，還會根據當前時段發送問候和一言（Yiyan）。若獲取一言失敗，將顯示固定文本：「不誘於譽，不恐於誹。」

點擊通知會直接打開對應的會話。

配置¶

插件通過 profile 的 cordis.patch.yml 進行配置。默認情況下，以下選項均開啓：welcome、approval、question、error、completed、interrupted 和 sound。

例如，若要關閉啓動時的問候和聲音提示，可配置如下：

- id: winnotify
  config:
    welcome: false
    sound: false

卸載與清理¶

若需卸載插件，請執行：

dsh plugin --profile web remove dsh-plugin-winnotify

卸載後需重啓 dsh 服務生效。若需清除系統通知來源和圖標，需在本地插件目錄（通常爲 ~/.dsh/plugins/dsh-plugin-winnotify）運行：

npm run unregister

開發與測試¶

插件的源碼位於 GitHub 倉庫。如需參與開發或本地測試，可執行以下命令：

npm ci
npm run check
npm test
npm pack

npm test 會先執行構建，再運行單元測試。提交源碼前應一併提交更新後的 lib/ 目錄。若需預覽系統通知效果，可運行：

npm run preview

結語¶

dsh-plugin-winnotify 通過原生 Toast 通知，解決了 DSH 在桌面端運行時消息被動查看的問題。該插件遵循 MIT 許可證，圖標資源取自 DeepSeek Harness 官方項目。更多細節可參考插件目錄或 GitHub 倉庫。