在 DeepSeek Harness (DSH) 的使用場景中，如果 Agent 的回覆耗時較長，或者用戶正在處理其他任務，就可能出現錯過回覆的情況。dsh-desktop-notify 插件通過系統原生的 Toast 通知機制，在 AI 完成回覆時提供視覺反饋，無需保持 DSH 界面在前臺。
這是什麼¶
這是一個爲 DSH 客戶端提供桌面通知功能的插件。它由開發者 crazy-L118 維護，遵循 MIT 許可證。插件不依賴運行時環境，通過系統原生接口（Windows WinRT、macOS osascript、Linux notify-send）觸發通知。
核心功能¶
- 系統原生通知：AI 完成回覆時，彈出系統級通知。通知正文包含回覆摘要，並標註當前的工作區與會話信息。
- 設置入口：開關位於
dsh 設置→通用→「桌面完成通知」。 - 過濾機制：僅當主對話完成時觸發通知，子代理的後臺任務完成不會彈窗。
- HTTP 調用：支持通過 HTTP 接口將通知推送到多臺設備，實現跨端提醒。
安裝與啓用¶
安裝時必須顯式指定版本號 1.4.1，以確保安裝到最新版本。
dsh plugin --profile web add dsh-desktop-notify@1.4.1
安裝完成後，需要重啓 dsh web 進程以使插件生效。
典型用法：HTTP 調用¶
如果需要在不操作電腦時收到通知，可以配置 HTTP 推送通道。
- 準備服務：準備任意一個能接收 HTTP POST 請求的服務（可以是自建服務，也可以是兼容的第三方推送服務），獲取其接口地址與（可選）訪問令牌。
- 開啓開關：進入
dsh 設置→通用→「桌面完成通知」，打開開關。在下方會出現「HTTP 調用」選項，打開它。 - 添加設備：點擊
「添加設備」。填寫設備名稱、服務器地址與訪問令牌。可以繼續添加多臺設備，每臺均可獨立開關或刪除。 - 數據推送：離開電腦後，AI 每完成一輪迴復，插件會向所有啓用且填寫了地址的設備發送一條 POST 請求。請求體爲 JSON 格式，包含
title（標題）、body（回覆預覽）、token（訪問令牌）和icon（圖標地址）字段。
適用場景與注意¶
- 獨立通道：桌面通知與 HTTP 調用是兩條獨立通道。你可以只開啓桌面通知、只開啓 HTTP 調用，或兩者同時開啓。
- 並行發送：多臺設備的推送是並行進行的，其中任一臺失敗不會影響其他設備的接收。
- 安全存儲：訪問令牌保存在本地
~/.dsh/desktop-notify.json文件中，僅發送至你配置的服務器地址。 - 圖標配置：每臺設備的
icon字段默認使用插件內置的assets/dsh-icon.jpg。留空則不發送該字段，支持自定義 URL 或一鍵恢復默認。 - 非官方產品：本項目與 DeepSeek / 深度求索不存在隸屬、合作或官方背書關係。插件名使用官方推薦的 DSH 縮寫，但在描述中僅作引用。
總結¶
dsh-desktop-notify 爲 DSH 用戶提供了從被動查看到主動接收的體驗升級。它不僅能在本地提供即時反饋，還能通過 HTTP 機制將通知延伸至其他設備。所有配置均基於本地文件與接口調用，無需額外賬號體系。
