前言¶
DeepSeek Harness (DSH) 在後臺運行時，用戶容易忽略任務完成狀態。現有的通知機制或窗口內 DOM 更新在切出窗口時不夠直觀。dsh-done-badge 插件利用 Windows 原生任務欄接口，在窗口最小化或離開期間，持續在任務欄圖標上顯示任務完成數量。
插件定位¶
本插件由 SkuraSshly 維護，採用 MIT 許可證。它解決的核心問題是：在用戶離開 DSH 窗口時，如何通過系統原生 UI 反饋後臺任務完成情況。
核心功能¶
- 離開期間任務完成 → 任務欄角標持續顯示，數量實時累積。
- 子代理會話不計入：一個任務啓動多個子代理只 +1。
- 切回主界面 → 角標保留 2 秒讓人看清，然後消失，不再冒出。
- 串行更新隊列：角標不會因 PowerShell 完成亂序而留下舊值。
- 零依賴：只使用系統自帶 PowerShell，無需安裝任何運行時。
安裝與啓用¶
通過 CLI 安裝：
dsh plugin --profile web add dsh-done-badge
安裝後重啓 DSH Web 或桌面應用即可生效。
使用示例¶
- 發消息 → 最小化/切走 DSH。
- 後臺每完成一個任務，任務欄 DSH 圖標出現紅色數字角標（完成幾個顯示幾，持續顯示）。
- 切回主界面 → 角標保留約 2 秒後消失、計數清零。
工作原理與注意事項¶
插件通過監聽 session/event 的 turn/end 事件進行統計。服務端經過串行隊列調用 assets/badge.ps1（零依賴腳本），利用 Windows 原生 ITaskbarList3::SetOverlayIcon 接口更新任務欄。
定位主窗口時依賴窗口標題 Deepseek Harness Desktop。如果任務欄角標未出現，可檢查以下日誌：
* %TEMP%\dsh-done-badge-helper.log：助手調用記錄（含窗口句柄）。
* %TEMP%\dsh-done-badge-events.log：事件鏈日誌（自動輪轉 1MB）。
注意事項：
* 僅支持 Windows 任務欄角標。macOS 暫不支持原生角標，僅窗口內 DOM 角標。
* 零依賴，僅使用系統自帶 PowerShell。
* 串行更新隊列確保角標不會因 PowerShell 完成亂序而留下舊值。
總結¶
dsh-done-badge 爲 DSH 提供了原生的後臺任務反饋能力。配合 GitHub 源碼（https://github.com/SkuraSshly/dsh-done-badge）可進一步查看實現細節。
