前言¶
在多智能体协作的会话中，子任务、分支执行和资源消耗分散在多次对话轮次里，容易看不清整体进度和各节点的状态。常见做法是在对话历史中来回跳转，或者依赖外部工具统计，缺乏统一的视图。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 仓库。
