dsh-plugin-busy-workspace:高亮並置頂活躍工作區的 DSH 插件

前言

在 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 插件形式運行。安裝步驟如下:

  1. 獲取插件源碼。可以通過 Git 克隆或下載 ZIP 包。
  2. 將插件文件放入 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 進程使其生效。

典型用法

  1. 並行工作區管理:當你同時啓動三個工作區的智能體時,持有“等待”或“運行中”會話的工作區會自動浮動到列表頂部。
  2. 狀態識別:快速掃視側邊欄,通過顏色條和色相即可區分當前的狀態分佈,無需閱讀具體文本。
  3. 任務追蹤:如果你啓動了一個任務去查資料,打開它查看結果後,它不會從列表中消失,而是變爲綠色淡色狀態,等待你處理下一個任務。
  4. 完成通知:當長時間運行的會話突然完成時,你會看到該行閃爍綠色脈衝,提醒你任務結束。

注意事項

  • 權限要求:該插件以當前 DSH 進程的權限運行,安裝前建議檢查源碼以確保符合安全要求。
  • 許可證:插件採用 MIT 許可證,允許自由使用和修改。
  • 依賴關係:確保本地環境已安裝兼容版本的 DeepSeek Harness 和 Cordis 插件框架。
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜