dsh-task-toast：DeepSeek Harness 狀態提示插件

前言¶

DeepSeek Harness (DSH) 提供了插件化擴展能力。在使用 agent 進行開發或調試時，狀態反饋（如任務完成、報錯、需要授權或回答）往往分散在對話流或後臺日誌中。dsh-task-toast 插件將這些狀態統一聚合顯示在頁面右上角，提供直觀的視覺反饋。

插件簡介¶

dsh-task-toast 是一個純客戶端插件，旨在將 agent 的運行狀態可視化。它沿用了 dsh-theme-endfield 的設計語言，不依賴任何構建步驟，直接通過命令安裝即可使用。

核心功能¶

• 右上角狀態提示板：在頁面右上角顯示 agent 狀態。
• 支持的狀態類型：
  • 完成 (COMPLETE)
  • 出錯 (ERROR)
  • 會話打不開 (UNOPENED)
  • 有子 agent 在跑 (SUBAGENT)
  • 待授權 (APPROVAL)
  • 待回答 (QUESTION)
• 交互與視覺：
  • 持有狀態時顯示完整提示板，超時或處理後收起爲細邊。
  • 鼠標懸停在細邊上可重新展開提示板。
  • 視覺風格沿用 Endfield 設計語言。
• 多通道通知：
  • 頁內提示板：始終顯示。
  • 系統通知：當用戶未直接查看 DSH 時觸發。
  • 標題欄前綴：在任務欄/標籤頁顯示狀態標記。

安裝與啓用¶

插件無需構建，直接通過 DSH 命令行安裝。

安裝¶

dsh plugin --profile web add github:jgao9906-droid/dsh-task-toast

安裝後需要重啓或重新加載 web profile 才能生效。

開發調試¶

如需修改源碼並立即生效，可使用 link: 方式：

dsh plugin --profile web add link:<你 clone 下來的路徑>

卸載¶

dsh plugin --profile web rm dsh-task-toast

注意事項¶

• 瀏覽器權限：首次使用時，需要在瀏覽器中授權通知權限。授權後記在 localStorage 中，除非權限被拒絕，否則不會重複詢問。
• 版本兼容：插件依賴 DSH 版本 0.1.5-rc.x。
• 平臺兼容：
  • 支持普通瀏覽器環境。
  • 支持 DSH Desktop (Tauri 殼) 環境。在 Tauri 上，宿主會修正可見性狀態。
• 系統行爲：
  • 在 Windows 上，系統通知的顯示時長由系統設置決定（設置 > 系統 > 通知），插件無法控制。
  • 在 DSH Desktop (Tauri) 上，授權通知的詢問界面不會出現，由宿主直接接管。

總結¶

dsh-task-toast 提供了一個零依賴、無構建步驟的狀態反饋方案。它通過右上角的狀態板和系統通知，確保開發者或用戶能及時掌握 agent 的運行情況，包括瞬時的完成/錯誤以及需要人工介入的授權與提問。對於需要高度關注 agent 狀態的開發者而言，這是一個實用的輔助工具。

• GitHub: https://github.com/jgao9906-droid/dsh-task-toast
• 目錄頁: https://www.skillhub.cn/plugins/jgao9906-droid/dsh-task-toast