dsh-wsl-notify: 在 WSL 中通過 Windows 彈窗通知任務狀態

前言¶

在 Windows 環境下開發 DeepSeek Harness (DSH) 智能體時，經常需要將長任務在 WSL 中後臺運行。任務結束後，通過瀏覽器標籤頁去確認狀態不夠直觀。dsh-wsl-notify 插件可以解決這個問題，它允許智能體在 WSL 中執行完任務後，直接在 Windows 端彈出提示框。

插件簡介¶

dsh-wsl-notify 是 DeepSeek Harness 的一個工具插件，名爲 win_notify。它屬於 dsh-wsl-kit 套件的一部分。插件版本爲 0.1.1，主要功能是從 WSL 代理中向 Windows 系統發送通知。

核心功能¶

Windows MessageBox 通知：默認通過 Windows 原生消息框提示。
Toast 回退機制：如果 MessageBox 失敗，會自動降級使用系統托盤氣球提示。
可配置參數：支持自定義標題、正文內容、通知模式以及超時時間。

安裝與啓用¶

通過 DSH 命令行安裝該插件：

dsh plugin --profile web add github:173787247/dsh-wsl-notify

配置與用法¶

安裝後，可以在配置文件中設置以下參數：

- id: dsh-wsl-notify
  name: dsh-wsl-notify
  config:
    timeoutMs: 30000
    maxLen: 500

默認行爲：
- 標題：DSH
- 正文：Task finished.

通知模式：
- messagebox：阻塞式彈窗，直到用戶關閉。
- toast：非阻塞式氣球提示。

適用場景與注意¶

適用場景：適合需要在後臺運行任務，且希望任務完成後立即獲知結果的場景。
阻塞行爲：messagebox 模式會阻塞當前進程，直到彈窗被用戶手動關閉。請勿在需要長時間後臺處理的任務中使用。
內容安全：消息內容不應包含敏感信息或密鑰。
模型依賴：該插件不負責模型配置，使用時需確保在 ~/.dsh/settings.yaml 中正確配置 deepseek-flash 模型 ID。

總結¶

dsh-wsl-notify 是連接 WSL 任務執行與 Windows 桌面反饋的輕量級工具。對於習慣在 Windows 上開發但需要調用 WSL 環境的開發者，它能有效減少查看終端的頻率。更多細節和源碼，請參考 GitHub 倉庫。