前言¶

在 DeepSeek Harness Web 中，子代理的運行狀態往往分散在會話樹中，手動追蹤活躍實例、查看實時輸出或對多個會話進行歸檔操作較爲繁瑣。此插件旨在通過一個集中的、可搜索的面板來解決這個問題，讓開發者能夠在一個視圖中管理所有子代理。

插件介紹¶

dsh-subagent-workspace-ui 是一個由 miuzel 開發的 Web 客戶端插件。它向對話頭部操作行添加了一個“子代理管理”按鈕，點擊後打開一個可搜索的面板，用於顯示 DSH 客戶端運行時當前發現的所有子代理。

該插件遵循 MIT 許可證。

安裝與啓用¶

在 Web 配置文件中安裝該包：

dsh plugin --profile web add dsh-subagent-workspace-ui

安裝完成後，重啓現有的 dsh web 進程，並刷新 http://127.0.0.1:3080 以加載插件。

核心功能¶

插件提供以下能力：

1. 視圖與導航

   • 頭部顯示緊湊的標題欄觸發器，展示活躍子代理數量和活動狀態點，無需打開面板即可感知。
   • 默認顯示當前工作區和當前會話的子代理，切換時自動更新。

2. 搜索與過濾

   • 支持按名稱、標題、工作區名稱搜索。使用 id: 前綴可僅搜索會話 ID（例如 id: graph:g-a92e1406）。
   • 支持按會話、工作區、類型進行分組，或按最近活動、名稱、類型排序。
   • 提供分類標籤（如全部、其他、審查、測試等），一次性子代理帶有 ⚡ 一次性 徽章。

3. 子代理控制

   • 支持對單個子代理進行暫停、繼續操作。
   • 支持一鍵暫停活躍子代理組。
   • 支持批量操作：歸檔、恢復、全選、基於時間的批量選擇（支持 1000 條以內）。

4. 實時信息

   • 活躍的子代理會聚在頂部可摺疊區域。
   • 顯示每個運行子代理的最新兩行實時輸出、工具調用、上下文注入和命令狀態。
   • 通過狀態指示器展示結束狀態：正常結束顯示綠色空心環，異常結束（停止/錯誤/阻塞等）顯示紅色實心點。

注意事項¶

• 無需編譯標誌：發佈的包包含預構建的 lib/，安裝時不需要 --allow-build 標誌。
• UI 適配：插件包含 cordis.patch.yml，用於覆蓋默認的 conversation.session.header.lineage，同時保留標準 ui-subagent 插件啓用，並提供側邊欄導航入口。
• 過濾機制：過濾和隱藏功能是插件本地的。被隱藏的子代理僅從列表中移除，不會刪除 DSH 會話或工作區文件。