前言¶
在 DSH 生態中，智能體開發往往依賴控制台日誌或隱式狀態來確認任務進展。dsh-task-capsule 是一個客戶端插件，旨在把“正在跑什麼任務、跑完沒有”的狀態固定在 Web UI 上。由 wzn16 維護，它從 dsh-dock 提取了最常用的功能，專注於任務追蹤與通知，而不重複處理 token 統計。
核心功能¶
插件提供兩個主要組件：
- 任務膠囊：常駐在會話 header。使用顏色區分狀態：運行中、等待確認、已結束、出錯。點擊膠囊跳轉會話；多個任務時顯示下拉列表。
- 任務通知卡：任務完成、出錯或等待確認時，在頁內彈出通知卡片。卡片包含跳轉按鈕。支持 WebAudio 提示音（無音頻文件）和可選的系統通知。
安裝與啓用¶
安裝需要將插件以本地鏈接形式加入 profile 依賴。
# 1. 克隆倉庫到本地任意位置
git clone https://github.com/wzn16/dsh-task-capsule.git
cd dsh-task-capsule
# 2. 安裝運行時依賴（僅 @deepseek-ai/schemastery 一個）
pnpm install
# 3. profile 依賴加入本地鏈接（路徑換成你自己的克隆位置）
cd ~/Library/Application\ Support/dsh-desktop/harness/profiles/web
pnpm add "link:/path/to/dsh-task-capsule"
# 4. 重啓 DSH Desktop（刷新瀏覽器不夠）
配置與使用¶
在插件設置區調整通知行爲。打開「系統通知」開關時會觸發系統授權彈窗（拒絕也不影響頁內通知卡）。
- 測試通知：未授權時點「請求授權並測試」會彈出系統授權彈窗，允許後自動發送測試通知；已授權時點「發測試通知」直接驗證鏈路。
- 配置項：包括完成通知、出錯通知、等待確認通知、停留時長（默認 8000ms，0 爲常駐直到手動關閉）、系統通知、前臺時也推系統通知、提示音（WebAudio 合成音色）。
注意事項¶
- Token 統計交給 DSH 自帶會話統計條，不重複做。
- 提示音使用 WebAudio 合成。
- 系統通知差異：macOS 的 tag 去重由 Electron 提供僅在 Windows / Linux 生效，macOS 上每條通知獨立展示。
- 前臺時也推系統通知默認關閉。
- 安裝需要 profile 依賴加入本地鏈接。
總結¶
該插件從 dsh-dock 提取精簡而成，專注於任務狀態可視化與通知。適合需要清晰掌握多會話任務進度的開發者。
