前言¶

在 DSH 裏跑長任務時，常見的問題是任務結束後還要回到 dsh web 頁面確認狀態。切走窗口後，頁面裏的 spinner 或會話狀態並不總能第一時間提醒人。

dsh-notify 解決的就是這個場景：當 agent 不再運行時，自動彈 Windows 原生 Toast 通知；同時任務欄保留一個鯨魚托盤圖標，方便快速喚起 dsh web 頁面或退出後臺。

這是什麼¶

dsh-notify 是 Pasumao 發佈的 DSH 插件，npm 包名爲 dsh-notify，許可證爲 MIT。

它面向 Windows 10/11，要求 Node ≥ 22.5，資料標註實測於 DSH 0.1.1-rc.2。它主要解決兩個問題：

1、agent 停止運行時，通過 Windows 原生 Toast 提醒用戶；
2、通過系統托盤鯨魚圖標，提供喚起 dsh web 頁面或退出後臺的入口。

核心功能¶

Windows 原生 Toast 通知¶

當 agent 不再運行時，插件會自動彈系統通知。資料中列出的觸發狀態包括：

• 完成；
• 停止；
• 出錯；
• 達到輸出上限；
• 等你選擇；
• 會話關閉。

通知正文會標註「工作區 · 會話」，方便區分多個工作區或多個會話。

系統托盤鯨魚圖標¶

任務欄會常駐鯨魚圖標。右鍵菜單可以：

• 喚起 dsh web 頁面；
• 退出後臺。

托盤圖標由 tray 配置項控制，資料標註默認值爲 true。

防刷屏控制¶

插件提供兩個常用控制項：

• rootsOnly：默認 true，僅根會話通知，子代理不刷屏；
• cooldownMs：控制同一會話、同一類型兩次通知之間的最小間隔。

輕量安裝¶

資料稱該插件零運行時依賴、零構建，裝完即用。

package.json 中聲明瞭：

"peerDependencies": {
  "@deepseek-ai/cordis": "^4.0.1"
}

安裝與啓用¶

下面介紹三種安裝方式。

使用 npm 包名安裝¶

執行：

dsh plugin --profile web add dsh-notify

這一步會把 dsh-notify 安裝到指定的 web profile 中。

從 GitHub 倉庫安裝¶

執行：

dsh plugin --profile web add github:Pasumao/dsh-plugin-notify

這一步適合直接使用倉庫地址安裝插件。

源碼安裝¶

如果需要本地調試，可以克隆源碼：

git clone https://github.com/Pasumao/dsh-plugin-notify.git
cd dsh-plugin-notify
npm install

然後以 link: 方式掛載進 profile，包名保持 dsh-notify。

啓用驗證¶

安裝完成後，重啓 dsh web。任務欄出現鯨魚圖標，即表示插件已生效。

典型用法與自測¶

安裝後，可以先用項目腳本彈三條真實 Toast 做自測：

node scripts/test-harness.mjs

如果要調整通知行爲，可以在 profile 的 cordis.patch.yml 中按 id dsh-plugin-notify 覆蓋 config。

資料中列出的常用配置項如下：

• cooldownMs：默認 10000，表示同會話同類型兩次通知的最小間隔；
• rootsOnly：默認 true，僅根會話通知；
• tray：默認 true，托盤圖標開關；
• titlePrefix：默認 'dsh'，通知標題前綴。

適用場景與注意¶

適合以下場景：

• 跑 LLM 長生成、批處理等任務，想切走窗口，結束時由系統通知提醒；
• 多個工作區會話並行，希望靠「工作區 · 會話」標註區分結果；
• 需要在任務欄常駐一個入口，快速喚起 dsh web 頁面或退出後臺。

使用前注意：

• 該插件以當前 dsh 進程權限運行，安裝前建議檢查源碼、依賴與許可證；
• 通知依賴 Windows 通知設置與 PowerShell 通知權限，勿擾或專注助手可能阻止通知；
• 托盤圖標依賴 tray 配置，默認 true；若被覆蓋可能導致圖標不顯示；
• 資料稱代碼與文檔由 AI 輔助生成（DeepSeek Harness），並經過人工審查與實機驗證。

常見問題¶

收不到通知？¶

檢查 Windows「設置 → 系統 → 通知」是否允許 PowerShell 顯示通知，以及是否處於專注助手 / 勿擾時段。

只想根會話通知？¶

保持：

rootsOnly: true

需要觀察子代理時，再改爲：

rootsOnly: false

通知太頻繁？¶

調大 cooldownMs。資料給出的默認值爲 10000。

托盤圖標不見了？¶

先重啓 dsh web。仍沒有圖標時，檢查 tray 配置是否被覆蓋爲 false。

結尾¶

dsh-notify 的價值比較直接：把 agent 停止運行的事件變成 Windows 原生 Toast，並用常駐鯨魚圖標提供後臺入口。對需要在 Windows 上跑 DSH 長任務、但不想一直盯 dsh web 頁面的人，這是一個可直接安裝的 DSH 插件。

相關鏈接：

• GitHub：https://github.com/Pasumao/dsh-plugin-notify
• 目錄頁（插件線索）：https://www.skillhub.cn/plugins/Pasumao/dsh-plugin-notify