前言¶
在多智能體協作的會話中，子任務、分支執行和資源消耗分散在多次對話輪次裏，容易看不清整體進度和各節點的狀態。常見做法是在對話歷史中來回跳轉，或者依賴外部工具統計，缺乏統一的視圖。DeepSeek Harness（DSH）通過插槽和投影機制爲插件提供會話狀態，Agent Trees / 智能體樹就是在此基礎上構建的 UI 插件：它把當前會話中的智能體拓撲渲染爲一張實時更新的多叉樹，在對話頁和右側邊欄中提供統一的概覽。
是什麼¶
Agent Trees / 智能體樹是一個 DSH 客戶端插件（dsh.bundle），將當前會話的智能體工作流以多叉樹形式展示，默認採用自上而下的圖表佈局。插件無需構建步驟，直接通過 DSH 的 Web Client 插槽注入。每個智能體以卡片形式呈現，包含任務名稱、狀態指示器、優先級徽章、進度條以及底部的 Token、費用、角色和運行時長等數據。當前會話高亮顯示；如果當前會話本身是子智能體，樹會向上追溯到可用父節點並標記當前智能體。
核心功能¶
工作流樹形展示¶
插件在兩個位置提供視圖：
- 對話頁：在“Chat”“Trajectory”等視圖旁增加“Agent Trees / 智能體樹”標籤頁，通過
conversation.view客戶端插槽注入。 - 右側邊欄：在對話標題欄旁顯示樹圖標，點擊可打開或聚焦右側邊欄的“Agent Trees”標籤頁；邊欄的“+”指引列表中也提供該膠囊入口。
視圖支持兩種佈局：
- 圖表：自上而下的組織圖，卡片圓角，曲線連接，畫布自動填充剩餘高度。在畫布背景拖動可平移，鼠標滾輪以光標爲中心縮放（35%–250%），雙擊背景重置平移與縮放。畫布提示顯示當前縮放比例。卡片底部的圓形箭頭可摺疊分支，圖表會即時重排。
- 列表：縮進的樹形列表，展開/摺疊通過行左側或卡片底部的箭頭控制。
卡片信息¶
每個智能體卡片包含：
- 任務：優先級標籤（P0–P3）+ 任務名稱（優先級前綴在顯示時移除）。
- 狀態指示器：運行時顯示旋轉加載器，成功顯示綠色圓點，失敗顯示紅色圓點，未開始顯示灰色圓點。
- 進度條：基於
todos投影計算，進度公式爲(completed + 0.5 × in_progress) / total，顯示done/total；無計劃時顯示“無計劃”並保持靜態。 - 底部信息：當前 Token 數、USD 費用（需
dsh-cost-meter掛載）、角色（主/子智能體）、實時運行時長。
優先級規則¶
默認優先級按深度：根節點爲 P0，直接子節點爲 P1，孫節點爲 P2，更深層爲 P3。通過委託標籤的前綴（如 [P0]、P1:、P0 -）可覆蓋默認值。
數據來源¶
插件爲純客戶端插件，讀取現有的客戶端可見投影，不寫入會話事件或註冊 Host 路由：
| Projection | 用途 |
|---|---|
subagentCatalog |
父→子拓撲、委託模式、任務標籤 |
subagentTiming |
上一次回合完成時間、已 settled/active 時長 |
tokenUsage |
每個智能體的 Token 總量 |
costUsage |
每個智能體的 Token 桶與 USD 費用（當 dsh-cost-meter 掛載時） |
todos |
每個智能體的任務進度（當智能體使用 todo_write 時） |
useSessions().byId |
會話摘要：標題、運行狀態、blank、父鏈接 |
useSessionStatus |
實時狀態映射 |
投影通過 DSH 的正常客戶端 store 更新，拓撲、狀態、todo、時長和 Token 數都會實時刷新。運行時任何智能體在運行，會以一秒時鐘刷新其時長顯示。
安裝與啓用¶
插件已通過 awesome-dsh-plugin 準備好 dsh-market 目錄條目，未來可在設置 → 插件市場搜索“Agent Trees / 智能體樹”安裝。當前可直接從倉庫安裝：
dsh plugin --profile web add github:xiezouqu12/agent-trees
在 DSH Desktop 中，通過設置 → 插件安裝即可，桌面應用擁有自己的 profile，CLI 不會改變正在運行的 app 的 profile。
插件依賴 DSH 版本 >=0.2.1-rc.1 <0.3.0，與 0.2.1-rc.2 測試通過。
典型用法¶
安裝後，在對話頁或右側邊欄中打開“Agent Trees / 智能體樹”視圖：
- 在對話頁，切換到“Agent Trees / 智能體樹”標籤頁。
- 或在對話標題欄點擊樹圖標，聚焦右側邊欄的“Agent Trees”標籤頁。
- 使用頂部佈局圖標在“圖表”和“列表”之間切換。
- 在圖表中拖動背景平移，滾動縮放，雙擊重置。
- 點擊卡片打開該智能體的對話（當前卡片不可點）。
- 使用鍵盤方向鍵在卡片間移動，左右鍵展開/摺疊，Home/End 跳轉首尾，Enter/Space 打開。
適用場景與注意¶
Agent Trees / 智能體樹適合需要在對話中持續觀察多智能體協作進度、資源和狀態的場景。它以客戶端視圖的形式呈現，依賴 DSH 提供的投影數據，不改變會話事件流。
安裝前建議查看源碼與許可證（MIT），確保與當前 DSH 版本兼容。插件爲客戶端插件，運行在當前 DSH 進程權限內。
結語¶
Agent Trees / 智能體樹通過統一的樹形視圖，將多智能體的工作流、狀態與資源消耗集中展示，減少在對話歷史中跳轉的成本。它是 DSH 生態中“一切皆插件”理念的體現，便於開發者快速定位執行路徑與瓶頸。更多細節可參見目錄頁與 GitHub 倉庫。
