前言¶

DeepSeek Harness (DSH) web 客戶端允許在瀏覽器標籤頁中運行會話。當標籤頁被切換到後臺時，你無法直接看到當前會話的狀態，必須重新切換回來才能確認。dsh-favicon-status 插件通過修改瀏覽器標籤頁的 Favicon 圖標，將後臺會話的狀態可視化：它會根據會話列表投影中的狀態，繪製一個帶有旋轉動畫的圓環，讓你在不需要點擊標籤頁的情況下就能掌握後臺任務進展。

插件簡介¶

這是一個僅運行在瀏覽器端的 DSH web 插件，用於後臺標籤頁的狀態指示。

• 維護者：bf185003
• 許可證：MIT
• 核心功能：從會話列表投影中讀取狀態，將文檔的 Favicon 繪製爲分段圓環，並帶有旋轉動畫。
• 模型交互：無。插件不涉及模型調用、提示詞組裝或 KV Cache。
• 客戶端要求：DSH web 客戶端版本需 >= 0.1.6-alpha.2。該版本提供了 ctx.uiSession.sessionStatus 接口，用於獲取會話狀態快照。

安裝與啓用¶

插件通過 DSH 插件命令安裝。安裝後需要重啓 dsh web 服務以使配置生效。

1. 執行安裝命令：

    dsh plugin --profile web add dsh-favicon-status

2. 重啓 dsh web 服務以加載新的插件配置。

核心行爲¶

插件安裝並運行後，瀏覽器標籤頁的 Favicon 會根據當前會話狀態發生變化：

• 藍色（運行中）：當有會話正在執行時，圓環爲藍色且處於旋轉狀態。
• 琥珀色（等待中）：當會話等待用戶交互（如審批、計劃審查）時，圓環爲琥珀色。
• 綠色（已完成）：當會話在後臺完成時，圓環爲綠色。
• 恢復原狀：當沒有會話處於上述三種狀態時，Favicon 恢復爲文檔原本的圖標。

圓環具有固定的 30° 後滯缺口，即使在後臺標籤頁被縮放到 16px 時，旋轉的視覺效果依然清晰可見。當混合狀態存在時，圓環會按比例分割，但顏色順序固定（運行、等待、完成），確保可讀性。

限制與注意事項¶

• 後臺標籤頁節流：瀏覽器會對後臺標籤頁的 setInterval 進行節流（Chrome 中約爲 1 Hz），因此圓環的旋轉動畫在後臺看起來是跳動的，而非平滑流暢。
• 完成狀態可見窗口：綠色（完成）狀態僅在標籤頁處於後臺時可見，且僅維持一段默認時間（30 秒，可通過配置 doneVisibleMs 調整）。一旦標籤頁變爲前臺，該狀態即被清除。
• 狀態聚合：插件反映的是會話快照的聚合狀態，而非單個任務的詳細狀態。多圖標 Manifest 或 apple-touch-icon 不被支持，插件僅處理文檔的第一個 rel~="icon" 鏈接。

結語¶

dsh-favicon-status 爲 DSH web 用戶提供了一個輕量級的視覺反饋機制，利用瀏覽器原生能力展示後臺任務狀態，無需任何模型層面的開銷。

• 目錄：https://www.skillhub.cn/plugins/bf185003/dsh-favicon-status
• 源碼：https://github.com/bf185003/dsh-favicon-status