前言¶
在使用 DeepSeek Harness (DSH) 時，會話往往在後臺運行。當標籤頁處於非激活狀態時，很難通過肉眼判斷當前的會話狀態：是處於待機、運行中，還是正在等待用戶確認。dsh-web-icon-indicator 旨在解決這一信息不對稱問題，通過修改瀏覽器標籤頁的圖標（Favicon），將 DSH 的會話狀態實時映射到視覺反饋中。
插件簡介¶
該插件由 waknow 維護，基於 MIT 許可證開源。它利用單個 SVG 模板，在瀏覽器端動態生成不同顏色和動畫效果的圖標，從而無需依賴後端頻繁渲染，直接反映 DSH 會話的四種核心狀態：待機、運行中、提問和完成。
核心功能¶
-
狀態實時反映
插件會根據會話狀態更新瀏覽器標籤頁圖標。狀態優先級爲：提問 > 運行中 > 完成 > 待機。這意味着當出現需要用戶交互的情況（如提問或審批駐留）時，圖標會優先顯示爲“提問”狀態。 -
動態視覺反饋
通過單個 SVG 文件，插件在瀏覽器中動態重色與動畫。內置了六種效果，包括靜態、閃爍、呼吸、彩虹、心跳和彈跳。這些效果通過 JavaScript 驅動，因爲瀏覽器 Favicon 本身不支持 SVG CSS 動畫。 -
多代理計數顯示
當活躍代理數量超過 1 個時，圖標會從鯨魚圖案切換爲數字方塊，實時顯示活躍代理的數量（最高顯示 99+）。數字方塊會繼承當前狀態的顏色和動畫效果。 -
完全可配置
插件提供內置的設置 UI，用戶無需手動編輯 YAML 配置文件即可修改顏色、特效、週期和駐留時長。配置更改通常在 1 秒內實時應用到當前標籤頁。 -
後臺保護與恢復
針對瀏覽器標籤頁的隱藏特性，插件通過牆鍾回退機制保證動畫在後臺也能平滑播放。同時，插件具備自我修復能力，在 DSH 重啓或狀態變更時，能通過visibilitychange事件快速刷新狀態，確保切換回標籤頁時圖標狀態準確無誤。
安裝與依賴¶
安裝該插件需滿足以下環境條件：
- DSH 版本：需要 DSH ≥ 0.1.2-rc.1。
- 設置兼容性：支持現代版本（≥ 0.1.7-alpha.1）和遺留版本（≤ 0.1.6-alpha.1）的設置生成。
- 依賴項：依賴
@deepseek-ai/schemastery（版本 ^3.18.2）。
典型用法¶
啓用插件後，可以通過 DSH Web GUI 進行配置：
- 打開 DSH Web GUI，進入 設置/插件 菜單。
- 找到
dsh-web-icon-indicator插件並打開，點擊 配置 按鈕。 - 在配置頁面中，首先設置 默認圖標顏色（用於待機狀態）。
- 展開
running、asking等狀態行，分別設置對應的 特效（如閃爍）、顏色 和 週期。 - 設置 提問駐留 和 完成駐留 時長，決定狀態保持的時間。
適用場景與注意¶
該插件適合需要長時間監控 DSH 會話進度的場景，特別是在多代理協作或長時間運行的任務中，通過標籤頁圖標即可快速獲取狀態概覽。
注意事項：插件以當前 DSH 進程的權限運行，安裝前建議檢查其源碼與許可證。插件依賴特定的 DSH 版本和外部庫，確保環境符合要求後再進行部署。
結語¶
dsh-web-icon-indicator 是一個輕量級但實用的狀態監控工具，它將枯燥的後臺進程狀態轉化爲直觀的視覺信號，降低了多會話管理的心智負擔。更多細節與源碼可參考 GitHub 倉庫。
