前言¶

在 DeepSeek Harness（DSH）里跑 Agent Teams 时，官方实验性 Web UI 插件 @deepseek-ai/dsh-experimental-client-ui-agent-team 会在对话顶栏挂上紧凑的花名册和任务板入口，适合在 Lead 会话里随手看一眼状态，但它并不是独立页面。

如果你需要长时间盯着一个或多个团队——同时看项目维度汇总、工作区卡片和成员协作关系——单靠顶栏入口往往不够直观。社区插件 dsh-agent-team-console（仓库 kkomia/dsh-agent-team-console）在保持只读的前提下，为 DSH Web UI 增加侧栏入口和一块完整主面板，把团队快照、流程图和任务摘要集中展示。下面介绍它的定位、能力与安装用法。

这是什么¶

dsh-agent-team-console 由维护者 kkomia 发布，在 SkillHub 社区目录中归类为「客户端」插件（目录页：https://www.skillhub.cn/plugins/kkomia/dsh-agent-team-console）。package.json 当前版本为 1.4.0，许可证 MIT。

README 明确说明：这是非官方社区插件，不属于 DeepSeek 官方包，也不替代官方实验性 Agent Teams bundle。它的契约是只读查看器——不会创建、修改或完成团队成员或任务；团队数据必须来自已挂载的官方 Agent Teams 服务。

一句话定位：通过同源 JSON 快照路由，在 DSH Web 里提供实时花名册、共享任务板视图与协作相关统计的可视化控制台（侧栏文案为「Team console」，中文界面显示「团队看板」）。

核心功能¶

以下能力均来自仓库 README 与 package.json 描述，插件为纯 DSH Web 插件：用户侧无需构建步骤、无 npm 依赖、不依赖外部服务。

侧栏与主面板¶

侧栏增加「团队看板」入口，主区域展示专用页面。面板挂载且标签页可见时每 2 秒轮询同源快照；标签页隐藏时暂停轮询，并提供手动刷新按钮。

项目筛选与状态条¶

当快照中存在多个项目（工作区）的活跃团队时，页头出现项目下拉框，默认为「All projects」（全项目），选择后仅客户端过滤状态条与团队列表，选择不会持久化。状态条一行五个芯片：进行中任务、运行中成员（运行数/总数）、当前筛选范围的 token 用量、阻塞任务（未就绪的 pending）、待处理任务；零值仍显示但样式弱化。

工作区卡片网格¶

每个活跃团队对应一张工作区卡片，排序为「活跃优先，再按最近活动」。折叠卡片展示状态点、项目名（无法解析时中文为「未分组」）、Lead 名称、工作/空闲环形图及轮次与 token 合计等；同一时间最多展开一张卡片，展开后占满整行，显示完整页头、流程图与任务摘要。默认展开第一个活跃团队；用户手动折叠的状态在轮询间保持。

自上而下的像素风流程图¶

展开卡片内的 SVG 数据流图：Lead 在顶部居中，队友在下方平衡多行排列（最多 8 个成员，超出显示「+N」）。Lead 到队友为向下弯曲的交接边（带动画虚线流向）；队友之间的消息边为弧线，粗细与消息量相关、透明度与新旧相关。成员以 10×12 模板的 SVG 矩形拼成确定性像素角色（无外链图片），Lead 有区分配色。悬停或聚焦节点可查看模型、轮次、步骤、token 分项、工作/空闲时间与消息进出摘要；若宿主暴露 uiWorkspace.openSession，点击节点可打开该成员会话。

任务摘要与其它行为¶

每个展开团队有一行任务摘要（进行中 / 待处理 / 阻塞计数），可展开查看进行中任务的单行列表（主题与负责人）；pending 与已完成仅以计数呈现。阻塞判定遵循 ready === false 的 pending 任务，进行中任务不会标为阻塞。面板不再渲染活动列表（快照仍可为 API 消费者保留有界 activity）。支持加载骨架、错误重试、轮询失败后「展示上次成功快照」提示、服务未挂载提示与空状态；文案经 DSH 客户端 locale 服务中英双语；样式仅使用 --dsw-* 主题 token，并支持减少动效偏好。

安装与启用¶

环境要求（README「Requirements and compatibility」）：

• DSH Web UI（桌面应用或 Web profile）。开发与测试针对 DSH 0.2.1-rc.2；engines.dsh 为 >=0.2.1-rc.2 <0.3.0-0。
• 同一 profile 必须已挂载官方实验性 Agent Teams bundle；未挂载时面板显示明确提示，而非崩溃。
• 轮次、token、工作/空闲时间依赖可选的 sessionStats 与 tokenUsage 投影；缺失时仍显示图，统计位显示为占位。
• 示例使用 desktop profile，若你使用 web 等名称请替换。

插件以当前 dsh 进程权限运行；安装前请自行审阅源码与 MIT 许可证，确认符合你的安全与合规要求。

从应用插件页安装¶

1. 在 DSH 桌面应用中打开 Plugins。
2. 选择 Add plugin。
3. 粘贴 github:kkomia/dsh-agent-team-console（npm 发布后也可使用 dsh-agent-team-console），确认安装。
4. 重启应用以加载宿主侧 HTTP 路由，再打开 Web UI。

从命令行安装¶

GitHub 源（README 标明当前可用）：

dsh plugin --profile desktop add github:kkomia/dsh-agent-team-console

npm registry（README 注明包发布后可用）：

dsh plugin --profile desktop add dsh-agent-team-console

通过 GitHub 安装需要网络、Git 以及 DSH 插件管理器已使用的 pnpm；仓库无构建步骤，安装即为拷贝包文件。

激活¶

宿主半部在 DSH 宿主进程启动时注册 HTTP 路由，因此安装或升级后需重启桌面应用；若 Web UI 已打开，再刷新页面。若仅客户端资源变更且宿主未变，刷新页面即可。

典型用法¶

安装并重启后，在侧栏选择 Team console（团队看板）。面板会立即加载当前快照，随后在可见期间每 2 秒自动刷新。

1. 读页头：标题与副标题、项目筛选（若适用）、有成员运行时的 live 指示、上次成功更新时间、手动刷新按钮。
2. 用状态条：快速扫一眼当前筛选范围内的进行中任务、运行成员、token、阻塞与待处理数量。
3. 点工作区卡片：展开目标团队，查看像素风流程图与任务摘要；需要时在图上悬停查看成员明细，或在支持时点击进入会话。
4. 按项目收窄：多项目并存时在下拉框选择单一项目，状态条 token 合计与卡片列表同步收窄（不保存，重新进入面板会回到「全项目」）。

官方实验性顶栏 UI 仍可在 Lead 对话内做快捷操作；本插件专注独立页面的长时间观测，两者互补而非替代。

适用场景与注意¶

适合谁：在同一 DSH profile 中长期运行 Agent Teams，需要项目级汇总、多团队卡片对比、以及 Lead/队友交接与消息关系的可视化，且接受只读、不通过本插件改任务或成员状态的场景。

务必注意：

• 不提供 Agent Teams 服务本身，必须先挂载官方实验 bundle。
• 只读：与官方实验 UI 的只读契约一致，不能替代团队编排或任务操作入口。
• 社区插件与 SkillHub 目录均与 DeepSeek / 幻方无官方从属关系，勿当作官方应用商店条目。
• 依赖 DSH 版本区间 >=0.2.1-rc.2 <0.3.0-0，升级 DSH 主版本前请核对 engines.dsh。

结尾¶

dsh-agent-team-console 把 Agent Teams 的快照读成一块可长期打开的 Web 控制台：状态条、工作区网格、像素风流程图与任务摘要同一屏呈现，并严格保持只读。若要安装或查看更新说明，可访问 SkillHub 目录页 https://www.skillhub.cn/plugins/kkomia/dsh-agent-team-console 与 GitHub 仓库 https://github.com/kkomia/dsh-agent-team-console。