前言¶
在使用 DeepSeek Harness（DSH）處理長任務時，用戶經常需要切換窗口、最小化界面或處理其他事務。如果此時任務完成，用戶可能會錯過進度提示。dsh-away-notify 插件旨在解決這一問題：它只在用戶離開 DSH 界面且任務完成時，才向 Windows 發送系統通知，避免干擾當前操作。
核心功能¶
- 只在離開界面時通知：檢測頁面可見性狀態，僅當用戶離開界面時觸發通知。
- 任務完成檢測：監聽代理狀態變化，當任務狀態從運行轉爲空閒時觸發。
- Windows 原生通知：使用 PowerShell 和 WinRT API，在系統右下角彈出標準 Toast 提示。
- 設置卡片集成：在 DSH 的設置界面提供總開關和測試按鈕。
- 可配置：支持通過配置文件和設置卡片調整通知行爲。
安裝與啓用¶
通過官方命令安裝插件：
dsh plugin --profile web add dsh-away-notify
安裝完成後，需重啓 dsh web 服務以使插件生效。
配置¶
插件的配置文件位於 ~/.dsh/plugins/away-notify.json。默認配置如下：
{
"enabled": true,
"includeSubagents": false
}
| 配置項 | 默認值 | 說明 |
|---|---|---|
enabled |
true |
總開關。關閉後停止所有通知。 |
includeSubagents |
false |
是否在子代理會話完成時也發送通知。 |
測試與日誌¶
- 設置卡片測試：在 DSH 設置界面的設置卡片中點擊“測試”按鈕。
- 命令行測試：
Invoke-RestMethod -Method Post http://127.0.0.1:3080/away-notify/test
日誌文件保存在 %TEMP%\dsh-away-notify\notify.log，用於排查問題。
注意事項¶
- 環境依賴：需安裝 Node.js 版本 >= 20。
- 生效方式：Client bundle 需要拷貝到
node_modules目錄才能生效。 - 重啓要求：修改配置或代碼後需重啓
dsh web。
結尾¶
dsh-away-notify 是一個專注於特定場景（任務完成通知）的輕量級 DSH 插件。它通過 Windows 原生通知機制，確保你在處理其他事務時不會錯過 DSH 的任務結果。
