前言¶
DSH 擴展裏，agent 跑完長任務或出錯後，常見問題是“人不在電腦前怎麼辦”。dsh-plugin-notify 解決的是通知出口：讓 agent 主動通過桌面通知、中文語音播報或系統提示音聯繫你。它由 huguangyu666 維護，MIT 許可，面向 Windows 本機環境，要求 Windows + PowerShell 5.1+（系統自帶）。
這是什麼¶
dsh-plugin-notify 是一個 DeepSeek Harness（DSH）插件，核心是“通知出口”：
- agent 主動通知你
- 會話出錯時自動提醒
- 回合結束後進入確認窗口，超時未互動則中文語音呼叫
核心功能¶
注入主動通知規則¶
插件會自動往所有 agent 的系統提示詞注入主動通知規則。agent 在長任務完成、出錯或需要你注意時，可以調用：
notify_user
notify_user 工具¶
notify_user 支持：
- 自由傳入
message - 不寫
message時按scene使用默認文案
自動兜底¶
這部分不依賴模型自覺：
- 會話回合出錯：自動語音 + 桌面通知
- 回合結束：自動桌面通知
- 確認窗口內超時未互動：中文語音呼叫
手動通知¶
插件提供：
/notify
用於手動發送通知。
通知通道¶
支持以下通道：
toast
speak
sound
both
其中：
toast：桌面通知speak：中文語音播報sound：系統提示音both：語音 + 桌面通知
音效¶
支持 4 種合成音效：
炸裂
勝利
警報
清脆
配置¶
可通過 dsh 設置面板、環境變量或配置文件調整通知行爲與文案模板。可調整的環境變量包括：
DSH_NOTIFY_DEFAULT_MODE
DSH_NOTIFY_INJECT_PROMPT
DSH_NOTIFY_ON_TURN_END
DSH_NOTIFY_CALL_DELAY_SECONDS
DSH_NOTIFY_TEMPLATE_DONE
安裝與啓用¶
先執行安裝命令：
dsh plugin --profile web add dsh-plugin-notify
該命令把 dsh-plugin-notify 加到 web profile。插件要求 Windows + PowerShell 5.1+（系統自帶）。
典型用法¶
讓 agent 主動通知¶
直接跟 agent 說：
- “做完這個任務通知我”
- “出錯時叫我”
它會調用 notify_user 工具。
手動通知¶
/notify 任務完成了
/notify --speak 快回來看看結果
/notify --sound 提醒
測試¶
瀏覽器打開：
/notify
選擇模式並點發送。“演示：任務完成叫你”可用於一鍵體驗完整場景。
適用場景與注意¶
適合在 Windows 上使用 DSH，並希望 agent 在長任務完成、出錯或需要人工介入時主動提醒你的場景。
注意：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 許可證：MIT。
- 運行環境：
Windows + PowerShell 5.1+（系統自帶）。 - 語音播報在後臺子進程執行，等待播完才返回。
- 通知串行執行，超時 120 秒。
- “音量增強”在給定資料中同時出現“默認關閉”和“默認開啓”的表述，本文不把它作爲確定默認值；使用前應檢查本地配置或源碼。
鏈接¶
- GitHub 倉庫：
https://github.com/huguangyu666/dsh-plugin-notify - 社區列表：本文只保留已確認的分類信息：
awesome-dsh-plugin的Notifications & Integrations列表；獨立目錄頁 URL 未確認，因此不補充未覈實地址。
