智能体看板 Denis-Tang/dsh-agent-board

Agent Board / 智能体看板

Agent Board / 智能体看板 — 一个 DeepSeek Harness UI 插件，在右侧边栏把当前会话的智能体渲染成实时两列卡片看板：主智能体在最上方，每个子代理按创建时间排在下面。它是标准 DSH bundle（dsh.bundle，bundle id dsh-agent-board），包含 Web Client 部分，无需构建步骤。

中文简介：在 DeepSeek Harness 右侧边栏中以两列卡片实时展示当前会话的主/子智能体：主 agent 在最上方，子 agent 按创建时间往下排；每个卡片显示状态、计划进度、Token、费用和运行时间。

每个智能体是一张紧凑卡片（「小方块」），带极简 1px 描边：

- 它负责的任务（委派标签，没有标签时用会话标题），
- 状态行左侧的智能体标签：主智能体卡片上显示 我，每个子代理卡片上显示一个简短的希腊神名或现代科学家名（宙斯、牛顿、居里……），
- 旁边的状态标签——RUN 带闪烁圆点，WAIT、DONE、IDLE、FAIL，外部任务显示 EXT，
- 基于待办计划的静态进度条（没有流动动画），
- 页脚显示当前 token、美元费用和实时时长。

你正在查看的会话保留一圈细蓝描边；不再有单独的「当前」徽标。当前会话本身是子代理时，图表会向上找到最顶层的可用父级，所以主智能体始终是屏幕上第一张卡片。

安装

直接从 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（桌面应用管理自己的配置档，所以命令行不会改动运行中应用的配置档）。安装后插件会出现在右侧边栏的 + 指南里；新标签页没有立即显示就刷新页面。

插件也在准备进入 dsh-market 目录，走的是 awesome-dsh-plugin。目录条目上线后，在 Plugins → Plugin Market 里搜索 Agent Board / 智能体看板。

仓库：Denis-Tang/dsh-agent-board。要求 DeepSeek Harness >=0.2.1-rc.1 <0.3.0；这个独立构建的版本是 1.0.0。

截图

带子代理卡片的 Agent Board

Agent Board 面板，含主智能体卡片和纸云插画

显示位置

视图位于右侧边栏：

- 右侧边栏的 + 指南列出 Agent Board 胶囊，可以从那里打开标签页。
- 侧边栏标签页是原生 sidebar.right.pane.tab 主体，采用紧凑布局，会话切换时它一直开在聊天旁边。

普通会话不会自动打开侧边栏。你从侧边栏 + 指南选中胶囊时它才打开。当会话处于屏幕，每新建一个子代理都会弹出侧边栏，并聚焦 Agent Board 标签页（若该列已折叠则展开），新分支无需手动点击即可显示。页面挂载时已存在的智能体不会触发这一行为，新智能体也只宣告自己一次。

布局

视图以 Chart 布局打开：在 Hermes 蓝的纸面画布上，是严格的两列卡片网格。主智能体的卡片独占第一行；之后每个子代理（无论层级多深）按创建时间填充下方的两卡行，因此从上往下读就是按时间读委派过程。一条纸白色（暖调米白）总线从主卡片底部引出，分叉到每张子代理卡片，让主从关系保持可见，又不必画出一棵与时间顺序相矛盾的完整树。新智能体追加在末尾，已有卡片不会跳动。

面板宽度绝不超出内容所需：卡片宽度跟随实测的面板宽度，因此宽侧边栏面板显示两列宽敞的卡片，默认右侧边栏则恰好保持两列窄卡片。卡片保持固定宽高比：列宽选定单一缩放系数，整张卡片——文字、内边距、边框和进度条——都按该系数等比缩放，因此更宽的面板产生的是按比例放大的卡片，而不只是更扁的卡片。卡片缩放被限制在侧边栏范围内（约 0.7×–1.9×）；当图表高于面板时，整体缩小（自动适配最低可到 30%，手动滚轮缩放保持在 35%–250%），让所有卡片留在视野内；用鼠标滚轮围绕光标缩放，双击背景重置平移和缩放。每张卡片分三行：顶部是状态行（智能体标签在前，然后是带闪烁圆点的状态标签），中间是左对齐的标题，用更深的蓝色垂直居中，底部边缘固定进度条（悬停时切换为 token、成本和运行时长）。三行共用卡片内容盒的左边缘，因此标签、标题和进度条从同一条竖线开始。

纸面/粒子云图案是覆盖整个面板的图层：它铺在页眉、字标和每张卡片之后，四边留出相同的呼吸边距。蓝色 AGENT BOARD 字标浮在云上（带柔和纸面光晕以保持可读），页眉里旧的三方块标志已移除，刷新按钮紧挨字标。

在任意位置按住拖动——卡片上或空白背景上——即可平移整张图表：每张卡片和连接线一起移动，图形不会散架。普通点击（不移动）仍会打开智能体或切换树。平移状态会一直保留，直到你双击背景或切换会话。点击空白画布折叠所有子代理卡片；再次点击恢复整张图表。没有单卡折叠箭头。

数据如何推导

插件只在客户端运行，读取客户端已有的会话投影——不写入任何会话事件，也不注册 Host 路由：

| 投影 | 用途 |
| subagentCatalog | 父 → 子拓扑、委派模式、任务标签 |
| subagentTiming | 最后一轮完成情况、已结算/活跃时长 |
| tokenUsage | 每个智能体的 token 总量 |
| costUsage | 每个智能体的 token 分桶与美元成本（挂载 dsh-cost-meter 时） |
| todos | 每个智能体的任务进度，前提是该智能体用过 todo_write |

会话摘要（useSessions().byId）提供标题、运行状态、blank 和父链接。useSessionStatus 提供实时状态映射。

进度规则

1. 智能体有 todo 列表时，进度为 (completed + 0.5 × in_progress) / total，卡片显示 done/total。
2. 运行中的智能体没有 todo 计划时，显示一条静态空轨道，标注 无计划；闪烁的 RUN 标签表示它正在运行。轨道不流动、不做动画。
3. 已结束的智能体，若最近一个已关闭轮次已完成，显示 100% 和绿色 DONE 标签。
4. 已结束的智能体，若 todo 列表全部完成，同样显示 100%，即使计时投影尚未结算。
5. 已结束的子代理，若最近一个已关闭轮次未完成，显示红色 FAIL 标签；进度条停在它实际的 todo 进度，没有计划时显示 无计划。
6. 空白、尚未启动的智能体显示 0% 和灰色 WAIT 标签。
7. 外部任务（mode: "external"）没有本地会话，进度条呈中性，标注「外部」。
8. 主智能体不会因为轮次之间空闲就变成 FAIL：它显示灰色 IDLE 标签。FAIL 只留给未完成就结束的子代理。主智能体的 todo 投影在每轮开始时清空，所以卡片在新计划写入前显示 无计划；它会保留上一次观察到的计划。

命名规则

- 主智能体的卡片始终显示 我，从不取个人名字。
- 每个子代理从固定的混合名字池里取一个短名，池中共 80 个希腊神祇和现代科学家（宙斯、牛顿、赫拉、爱因斯坦、……）。名字按整棵树的子级创建时间分配，所以第一个子代理是 宙斯，第二个是 牛顿，依此类推。
- 名字由创建时间戳推导，所以会话的目录加载完成后名字就固定了：后出现的智能体取下一个名字，已有卡片保留自己的名字。80 个名字用完后，名字加数字后缀（宙斯2、 牛顿2、……）。

排序

卡片不再显示序号或优先级。主智能体始终在第一行，其余卡片按创建时间排列，每行两张，每张卡片上的智能体标签承载身份信息，不再用深度标签。

交互

- 点击卡片打开该智能体的对话；你正在查看的会话卡片（通常是主智能体）不可点击，保留一圈细蓝色描边。
- 刷新按钮位于页头 AGENT BOARD 字标旁边。
- 用鼠标滚轮围绕光标缩放；双击背景可重置平移和缩放。
- 在任意位置拖动都能平移整张图。按住卡片和按住空白背景会启动同一种手势；所有卡片和连接线一起移动，图形不会散开。指针移动几个像素后，按住就变成拖动，松开时不会打开智能体，也不会折叠或展开树；没有移动的点击仍会打开对话（在卡片上）或折叠、展开图表（在背景上）。平移在松开后仍然保留，双击背景或切换会话可重置。
- 点击空白画布可折叠所有子代理卡片；再次点击可展开图表。
- 刷新按钮会重新读取每个可见智能体的投影。
- 图表上方没有摘要/统计条：卡片本身承载状态、进度、token、成本和运行时长，所以面板打开后直接就是图表。也没有进度卡片、搜索栏、筛选行或图例。
- 键盘：ArrowUp / ArrowDown 在卡片间移动，ArrowRight / ArrowLeft 展开或折叠，Home / End 跳到两端，Enter / Space 打开。

投影更新通过常规的 Client store 到达，因此拓扑、状态、待办、时长和 token 计数都会实时更新。只要有智能体在运行，一秒一次的时钟就会刷新时长。

兼容性

基于 DeepSeek Harness 0.2.1-rc.3 构建并测试。包中声明 engines.dsh: >=0.2.1-rc.1 <0.3.0。
它只依赖 Web Client 插槽接口和标准会话钩子：

- sidebar.right.pane.tab 插槽，带 sessionId、useSessions、useSessionStatus、useProjection('todos')（可选，回退到投影 store）
- ctx.sidebarRightTabs.register（标签页类型）和 ctx.get('sidebarRight')（打开/聚焦）
- conversation.session.header.utilities（一个不可见的辅助项，在创建子代理时打开标签页）
- ctx.sessions.refreshProjections
- ctx.uiWorkspace.openSession
- ctx.locale 和 ctx.slots

没有以模块方式导入任何 Harness Client 包；React 来自浏览器模块表。

文件

| 文件 | 用途 |
| index.js | 宿主侧（仅元数据） |
| client.js | 浏览器模块：视图、双列看板、卡片、样式、语言字典 |
| cordis.patch.yml | 插入 dsh-agent-board 行 |
| locale/en.json、locale/zh.json | 插件管理器显示元数据 |
| fonts/ | 内嵌的 Collapse 字标和 JetBrains Mono 网页字体 |
| icon.svg | 原创图标 |
| screenshot-main.png、screenshot-sidebar.png | 市场截图 |
| screenshots.json | dsh-market 截图清单 |
| assets/icon.png | 市场磁贴图标（512×512 PNG） |
| marketplace/dsh-agent-board.yml | 为 awesome-dsh-plugin 目录准备的条目 |
| LICENSE | MIT |

说明与限制

- 看板反映的是 Client 投影 store 已知的内容。一个尚未能通过父级的 subagentCatalog 访问（例如外部任务，没有父级持有的 catalog 事实），就无法显示为本地子级。
- 外部任务没有本地执行状态；它们显示为普通卡片，没有可打开的本地会话。
- 运行中的智能体没有待办列表时，进度条是一条静态空轨道，标注为 无计划；卡片绝不凭空编造百分比。
- 插件不会仅因为主会话空闲就把它标记为「已完成」；完成状态始终跟随最后一个关闭的回合，或全部完成的待办列表。

Development

插件没有构建步骤。编辑 client.js（一个浏览器模块，通过 window.__ModuleLoader__ 注册），让 DSH HMR 重新加载它，或者刷新页面。运行 node --check client.js 做语法检查。宿主侧 index.js 是一个空操作的元数据模块；bundle 补丁负责插入客户端行。

上游与致谢 / Upstream and acknowledgements

Agent Board 是一个独立、更名的分支，基于上游项目 xiezouqu12/agent-trees，依据 MIT License 使用并修改。原始看板概念、双栏布局、交互模型和纸云视觉设计归功于上游作者；本仓库只重命名插件、独立维护，并加入自己的文档和图标素材。

License

MIT © 2026 xiezouqu12（上游作品）；修改部分 © 2026 Denis-Tang。
见 LICENSE。

Credits

全面板背景是一张 1-bit 抖动印刷的希腊大理石头像，来自 The Metropolitan Museum of Art（CC0 / 公有领域，藏品 Marble head of a goddess），离线用 Floyd–Steinberg 抖动转换，并以 Hermes 蓝墨水印在暖色纸张上（单一主题，无深色模式）。无缝纸点平铺让点阵在任意侧栏宽度下都保持覆盖，几条宽度不均的宽波浪点带以非线性速度漂移、呼吸，宽度随时间变化。

内置的 Collapse 字标字体和 JetBrains Mono Web 字体依据 SIL Open Font License 1.1 分发；完整许可证文本见 fonts/OFL.txt。