前言¶
在 DeepSeek Harness (DSH) 中並行運行多個智能體時,側邊欄會迅速變成同質化行的牆壁。每個工作區頭部和會話行的渲染方式完全相同,唯一的信號僅是一個需要費力尋找的 10 像素圓點。
這種設計導致幾個具體的痛點:無法確認哪個工作區正在執行任務、忙碌的工作區因操作其他項而沉底、會話完成後無法及時察覺,以及低對比度的狀態點在非近距離查看時難以辨識。
該插件旨在回答兩個核心問題:當前正在運行什麼 以及 我啓動的任務去哪了。它通過視覺權重和排序邏輯,將注意力集中在活躍會話上。
插件定位¶
這是一個 DeepSeek Harness (DSH) Web GUI 插件,由 baifagg 維護,開源協議爲 MIT。
它的核心作用是在 DSH 側邊欄中高亮運行中的會話,並將持有活躍會話的工作區置頂。它提供了一套基於“注意力階段”的視覺體系,並完全適配當前主題,無需手動配置顏色。
核心能力¶
1. 5 個注意力階段與排序¶
插件將所有會話劃分爲五個注意力階段,並按緊迫性從高到低排序:
- 等待:需要用戶審批、計劃審查或回答。顯示爲琥珀色,置頂第一位。
- 運行中:正在活躍的會話。顯示爲藍色,帶有子代理數量芯片。
- 完成-未讀:已結束但未打開查看。顯示爲綠色,置頂保持 8 小時。
- 已見:已打開但未離開的會話。顯示爲綠色(淡色),保持置頂直到用戶切換選擇 15 分鐘後。
- 中斷:運行超過 6 小時但無新輸出。顯示爲紅色,僅標記不置頂。
2. 主題自適應設計¶
插件不包含硬編碼的顏色值。它完全依賴 DSH 主題定義的 CSS 變量(Tokens):
- 運行:使用
--dsw-static-deepseek-450 - 等待:使用
--dsw-alias-state-warn-primary - 完成/已見:使用
--dsw-alias-state-success-primary - 中斷:使用
--dsw-alias-state-error-primary - 選中行:使用插件定義的紫色(混合
--bw-running和--bw-interrupted),不借用狀態顏色。
這種設計確保了插件在默認淺色/深色主題以及 Catppuccin、Nord 等社區主題包下均能正確顯示。
3. 完成狀態的持久化¶
這是插件的重要邏輯修正。官方 done 狀態對應 completionUnread(已完成且未讀)。如果邏輯簡單地將“未讀”轉爲“已讀”即移除高亮,會導致用戶在打開會話時,正在閱讀的行突然消失。
插件採用“衰減而非驟停”的策略:
- 打開一個“完成-未讀”的會話,它變爲“已見”,並保持置頂。
- 只要用戶仍在該行上停留,它就不會消失。
- 一旦用戶切換選擇,開始 15 分鐘的“已見”倒計時。
- 未打開的“完成-未讀”狀態會保持 8 小時,足以覆蓋午休時段。
4. 視覺反饋¶
- 子代理:不使用顏色區分,而是渲染爲一個小型計數芯片。
- 完成脈衝:當會話真正結束時,行會有一個短促的綠色 settle 脈衝,通知用戶任務已完成。
- 指示器:每行左側有 3px 的彩色條,以及對應色相的色環和表面色。
安裝方式¶
該插件以 DSH 插件形式運行。安裝步驟如下:
- 獲取插件源碼。可以通過 Git 克隆或下載 ZIP 包。
- 將插件文件放入 DSH 的插件目錄中。
# 示例:通過 Git 克隆到 DSH 目錄(請根據實際環境調整路徑)
git clone https://github.com/baifagg/dsh-plugin-busy-workspace.git /path/to/your/dsh/plugins/dsh-plugin-busy-workspace
插件依賴 @deepseek-ai/cordis 和 @deepseek-ai/dsh(版本需滿足 package.json 中的約束),安裝後需重啓 DSH 進程使其生效。
典型用法¶
- 並行工作區管理:當你同時啓動三個工作區的智能體時,持有“等待”或“運行中”會話的工作區會自動浮動到列表頂部。
- 狀態識別:快速掃視側邊欄,通過顏色條和色相即可區分當前的狀態分佈,無需閱讀具體文本。
- 任務追蹤:如果你啓動了一個任務去查資料,打開它查看結果後,它不會從列表中消失,而是變爲綠色淡色狀態,等待你處理下一個任務。
- 完成通知:當長時間運行的會話突然完成時,你會看到該行閃爍綠色脈衝,提醒你任務結束。
注意事項¶
- 權限要求:該插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼以確保符合安全要求。
- 許可證:插件採用 MIT 許可證,允許自由使用和修改。
- 依賴關係:確保本地環境已安裝兼容版本的 DeepSeek Harness 和 Cordis 插件框架。