前言¶
在 Windows 上使用 DeepSeek Harness（DSH）時，窗口最小化或切到後臺後，很難一眼看出又有幾條對話已經跑完、尚未點開。系統任務欄圖標本身也不會像 Teams、Codex 那樣顯示未讀數字。若還要在每次重啓 Harness 後重新拖窗口、記尺寸，日常開發會更分散注意力。下面介紹的 DSH Taskbar Badge（倉庫 HUHUhim/dsh-taskbar-badge）是社區維護者 HUHUhim 發佈的客戶端類插件：在任務欄 DSH 圖標上疊加藍色數字角標，並在關閉後下次啓動時恢復窗口大小、位置與最大化狀態。
這是什麼¶
插件在 package.json 中的描述爲：Windows taskbar unread badge and window-bounds restore for DeepSeek Harness。當前版本 0.1.0，許可證 MIT。分類爲客戶端；僅 Windows 10 / Windows 11 上生效，其它平臺插件會加載但不執行任何邏輯。
核心功能¶
經 README 覈實，能力包括：
- 任務欄未讀角標：在 DSH 任務欄圖標上顯示藍色數字，類似常見應用的 unread badge。
- 計數規則：統計已完成且未讀的 DSH 對話；子 agent 會話與已歸檔會話不計入。
- 後臺可用：DSH 最小化、在後臺運行，或側欄摺疊時，角標仍可更新。
- 打開即消未讀：進入對應對話後，該條未讀計數清除。
- 窗口邊界恢復：記住上次關閉時的窗口矩形與是否最大化，Harness 重啓後寫回；恢復時會限制在當前顯示器工作區內。
- 隨 Harness 啓動：由插件 host 半在啓動時拉起輔助進程，不寫入 Windows「啓動」文件夾。
運行依賴：支持插件 bundle（dsh.bundle）的 DSH 桌面構建；輔助程序爲小型 .NET 可執行文件，需 .NET Framework 4.x（Windows 10/11 自帶）。
工作原理（簡述）¶
包分爲兩半：
- Client 半（
client.js）：無 UI 的客戶端插件，監聽 session store，在有 N 條已完成未讀會話時，把文檔標題寫成[N]前綴。 - Host 半（
index.js，經cordis.patch.yml注入）：Harness 啓動時運行bin/dsh-taskbar-badge.exe。
輔助程序優先從 DSH 窗口標題讀取 [N]；若無前綴，則通過 Windows UI Automation 統計側欄中已完成行作爲後備。約每 800 ms 調用 ITaskbarList3.SetOverlayIcon 生成 24×24 角標。窗口位置使用 GetWindowPlacement / SetWindowPlacement，常態矩形保存在 %LOCALAPPDATA%\DSH\window-bounds.txt。
隱私方面：無網絡、無遙測；僅讀窗口標題及（後備路徑下）側欄狀態行；本地寫入日誌與邊界文件（見下文「注意」）。
安裝與啓用¶
插件市場¶
上架後可在 DSH → Plugins → Plugin Market 搜索 DSH Taskbar Badge 安裝，安裝後需完全退出並重啓 Harness（僅刷新頁面不夠，bundle 在啓動時組裝）。
從 GitHub 添加¶
在 DSH → Plugins → Add plugin 中填寫：
HUHUhim/dsh-taskbar-badge
也可粘貼完整倉庫地址：
https://github.com/HUHUhim/dsh-taskbar-badge
然後完全退出並重啓 Harness。
若曾使用本地開發版，請先卸載 dsh-taskbar-badge-bridge，否則會與同一 helper 重複運行第二個標題監視器。
重啓後，當其它對話在後臺完成時，任務欄圖標應出現藍色數字角標。
典型用法¶
插件無單獨配置面板；安裝並重啓後即工作。
- 保持 DSH 在任務欄運行，另開或等待會話在後臺完成。
- 觀察任務欄 DSH 圖標上的數字角標。
- 在 Harness 中打開對應對話，角標對應該會話的未讀應減少。
- 調整窗口大小與位置後正常關閉 DSH；下次啓動應恢復到上次邊界（含最大化狀態）。
輔助程序與 bridge 日誌、窗口邊界文件位於 %LOCALAPPDATA%\DSH\：taskbar-badge.log、taskbar-badge-bridge.log、window-bounds.txt。首次運行未簽名的 dsh-taskbar-badge.exe 時，Windows SmartScreen 可能提示；完整 C# 源碼在 bin/dsh-taskbar-badge.cs，可用倉庫內腳本本地重編譯：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\build-helper.ps1
適用場景與注意¶
適合：主要在 Windows 上長時間跑 DSH、常最小化窗口、需要任務欄級「有幾條新完成對話」提醒，並希望重啓後窗口布局不變的開發者。
注意：
- 插件與 helper 以當前 DSH 進程權限運行；安裝前建議瀏覽倉庫源碼與 MIT 許可證，確認可接受本地讀寫與 UI Automation 行爲。
- 僅 Windows；Node 引擎要求
>=20（見 package.json）。 - 卸載：從 DSH 插件列表移除 dsh-taskbar-badge → 退出 Harness → 結束殘留的
dsh-taskbar-badge.exe→ 可選刪除上述本地日誌與window-bounds.txt。無需清理「啓動」文件夾。
DSH 生態強調「一切皆插件」；社區目錄站點（如 SkillHub）與 DeepSeek / 幻方無官方從屬關係，本文安裝路徑以 README 爲準。
結尾¶
DSH Taskbar Badge 把「後臺完成的未讀對話」映射到 Windows 任務欄角標，並順帶解決 Harness 重啓後的窗口幾何恢復，對桌面端長時間並行多會話的場景很實用。
- 目錄頁：https://www.skillhub.cn/plugins/HUHUhim/dsh-taskbar-badge
- GitHub：https://github.com/HUHUhim/dsh-taskbar-badge
