前言¶
在 DeepSeek Harness 里跑带子 agent 的会话时，主 agent 会不断委派子任务，子 agent 按创建顺序在后台并行或串行执行。默认界面以对话流为主，要弄清「当前有哪些 agent、各自状态、计划进度和 Token 消耗」，往往要在会话树或多处面板之间切换。
Agent Board（智能体看板）是维护者 Denis-Tang 提供的 客户端 UI 插件（bundle id dsh-agent-board），在右侧边栏用两列卡片把当前会话的主 agent 与全部子 agent 摊开显示。它是 agent-trees 方向的独立 fork，只读客户端已有的会话投影，不向 Host 写事件、也不注册 Host 路由。
这是什么¶
Agent Board 是一个标准 DSH bundle（含 Web Client 半部，无构建步骤），在 DeepSeek Harness 右侧边栏 以 Chart 布局渲染「主 agent 在上、子 agent 按创建时间向下排」的两列卡片看板。
每个 agent 对应一张紧凑卡片，展示：
- 任务标题（委派标签；无标签时用会话标题）
- 状态标签：
RUN（带点闪烁）、WAIT、DONE、IDLE、FAIL、EXT（外部任务） - 基于 todo 计划的静态进度条（无流动动画）
- 页脚：当前 Token、USD 费用、运行时长（悬停进度条区域可查看）
主 agent 卡片左侧固定显示「我」；子 agent 从固定名字池（希腊神祇 / 现代科学家等短名，如宙斯、牛顿、居里）中分配。当前正在查看的会话卡片保留细蓝描边；若当前会话本身是子 agent，视图会向上追溯到最顶层父会话，保证屏幕上第一张卡片始终是主 agent。
插件版本 1.0.0，许可证 MIT，要求 DeepSeek Harness >=0.2.1-rc.1 <0.3.0。
核心功能¶
右侧边栏入口与自动展开¶
- 右侧边栏
+引导 中列出 Agent Board 胶囊，可手动打开该标签页。 - 标签页类型为
sidebar.right.pane.tab，与聊天并列，切换会话时仍保持打开。 - 普通会话 不会 自动打开侧边栏；新创建的子 agent 会弹出侧边栏并聚焦 Agent Board（若列已折叠会展开），便于看到新分支。页面加载时已存在的 agent 不会触发；每个新 agent 只通知一次。
Chart 布局与交互¶
- 两列卡片网格：主 agent 独占第一行；所有子 agent（不论嵌套深度）按创建时间填满下方两行一组的格子，自上而下即委派时间线。
- 主卡片底部有纸白色「总线」分支连到各子 agent 卡片，表达主从关系而不画完整树（避免与时间序冲突）；新 agent 追加在末尾，已有卡片不跳动。
- 面板宽度随内容；卡片固定宽高比，列宽决定统一缩放（约 0.7×–1.9×）。图表高于面板时可整体缩小（自动适配最低约 30%，滚轮缩放 35%–250%）；滚轮以光标为中心缩放，双击背景重置平移与缩放。
- 按住拖拽（卡片或空白处）平移整图；空白处单击可折叠/展开全部子 agent 卡片；单击卡片（无位移）打开 agent 或切换树。
- 背景层为纸面/粒子云装饰，
AGENT BOARD字标与刷新按钮位于头部。
数据来源（只读）¶
插件为 Client-only，读取客户端可见投影，不写入会话事件：
| 投影 | 用途 |
|---|---|
subagentCatalog |
父子拓扑、委派模式、任务标签 |
subagentTiming |
末轮完成情况、 settled/active 时长 |
tokenUsage |
各 agent Token 合计 |
costUsage |
Token 分桶与 USD 费用（需挂载 dsh-cost-meter 时） |
todos |
各 agent 任务进度（使用 todo_write 时） |
会话摘要（useSessions().byId）提供标题、运行状态、blank、父链接；useSessionStatus 提供实时状态图。
进度与状态规则（摘要）¶
- 有 todo 列表时：进度为
(completed + 0.5 × in_progress) / total，卡片显示done/total。 - 运行中且无计划：静态空轨 labelled
无计划，RUN标签闪烁。 - 已结束且末轮正常完成：
DONE，100%。 - todo 已全部完成亦视为 100%，即使 timing 尚未 settle。
- 已结束子 agent 末轮未完成：
FAIL，进度条保持实际 todo 或无计划。 - 空白未启动：
WAIT，0%。 - 外部任务（
mode: "external"）：进度中性，标注「外部」。 - 主 agent 在轮次间隙 idle 时显示
IDLE，不会因空闲标为FAIL；每轮开始会清空 todo 投影，在新计划写入前显示无计划，并保留上次观察到的计划。
安装与启用¶
CLI 从 GitHub 直接安装（无需 npm 包）：
dsh plugin --profile <your-profile> add github:Denis-Tang/dsh-agent-board
DSH Desktop：打开侧边栏 Plugins → Add plugin（或 Install a third-party plugin），粘贴 github:Denis-Tang/dsh-agent-board（桌面应用自行管理 profile，CLI 不会改动正在运行的应用 profile）。安装后插件出现在右侧边栏 + 引导 中；若新标签未出现，刷新页面。
插件亦在通过 awesome-dsh-plugin 准备进入 dsh-market 目录；目录条目上线后可在 Plugins → Plugin Market 搜索 Agent Board / 智能体看板。
典型用法¶
- 按上文命令或 Desktop 流程安装插件。
- 打开带子 agent 的 DSH 会话，在右侧边栏
+中选择 Agent Board 打开看板。 - 委派新的子 agent 时，侧边栏会自动展开并聚焦看板，新卡片出现在时间线末尾。
- 需要总览 Token/费用时，确保环境中已挂载
dsh-cost-meter，卡片页脚与悬停信息才会反映 USD 成本。 - 子 agent 使用
todo_write时，卡片进度条与done/total会随计划更新；主 agent 每轮开始会清空 todo 投影直至写入新计划。
适用场景与注意¶
适合：需要在同一会话里并行或串行跑多个 sub-agent 的开发者；希望在一屏内对照状态、计划进度、Token 与费用，而不反复点会话树的用户。
注意：
- 插件在 当前 DSH 进程/客户端 权限下运行，安装前请阅读 Denis-Tang/dsh-agent-board 源码与 MIT 许可证。
- 仅客户端 UI，依赖 DSH 暴露的 session 投影；Host 未提供或版本不匹配时，卡片信息可能不完整。
- 社区目录页（如 skillhub.cn 插件条目）为独立生态站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」思路，Market 条目以实际上线为准。
结尾¶
Agent Board 把当前会话的主 agent 与子 agent 收成右侧边栏的两列卡片看板：状态、计划、Token、费用与时长一卡可见，新子 agent 创建时会自动把看板推到前台。需要安装命令与交互细节时，以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/Denis-Tang/dsh-agent-board
- GitHub：https://github.com/Denis-Tang/dsh-agent-board
