description: "使用并驱动实验性 Web Agent Teams roster、共享任务板与 teammate 导航面板，包括通过 Team 写入桥执行的浏览器任务编辑。" kind: "package-reference"

@qilin-agent/experimental-client-ui-agent-team

English | 中文

概述

本包向 Web 会话页头添加 Agent Teams action，让用户检查当前 roster、在右侧边栏打开 Team 标签页，并导航到 teammate 会话。标签页从共享 Session store 读取 Lead Session 的 agentTeam 投影，并通过 Host 上的 agentTeams 写入桥编辑任务：创建、编辑、完成、重新打开、删除与改派以类型化 wire action 发出，并以 Lead 权限执行。普通 child history 导航继续使用稳定的 addressed-subagent 路径。通过实验性 Agent Teams Web profile 选择本包。这个 projection 不扩展稳定 API Proxy、不存储 Team 状态，也不注册面向模型的输入。

目录

• 使用本包
• 理解实现
• 进一步探索
• 模型体验
• 已知限制与延期工作
• 开发备注

使用本包

本包提供 Agent Teams 的 Client plugin。当前没有任何已交付 bundle 挂载它；自定义 Web profile 可在稳定 Web bundle 与 Host-side Agent Teams profile 之后挂载 /client export。root Host export 不执行行为，本包也没有用户配置字段。

检查并导航 roster

面板从共享 Session store 展示 Lead Session 的 roster 与任务板。面板保持打开时，任务和成员更新会直接出现。打开面板不发起投影请求。会话或 Session 列表正在加载时，面板显示加载提示；加载结束后仍无 Team 值时，显示不可用提示。

Roster 行展示持久名称与阶段。provisioning 和 running 成员使用共享 ongoing loading，inactive 成员使用人物图标，failed 成员使用 error 红点。实时 Session 状态提供运行活动；共享 modelSelection 投影在可用时提供模型。当前会话带有“当前会话”标签且不可选择。在 teammate 会话中选择 Lead 会直接打开 Lead Session。选择 active teammate 会打开其普通 continuable 子会话地址。Host 在打开历史时校验 parent、child 与 mode；后续人类提示词使用同一 addressed-subagent 会话。

查看任务板

可开始的 pending 任务使用 idle 灰点，被依赖阻塞的 pending 任务使用 warning 橙点，in-progress 任务使用 ongoing loading，completed 任务使用 done 绿点。

任务板展示任务标识、负责人、依赖、就绪状态、提示性写入范围与重叠警告。分区标题显示成员与任务数量；空任务板显示简短描述，只有一名成员且无任务时采用单列面板。当投影报告某条持久 Team 记录被拒绝时，标签页在最后有效的 roster 与任务上方显示该失败。

从浏览器编辑任务

工具栏刷新当前查看会话的投影并打开创建表单。创建与编辑表单接收主题、描述、阻塞任务 id 与提示性写入范围；两个文本都非空之前提交保持禁用，列表中的重复值会折叠为一项。每张任务卡片为 in-progress 任务提供完成、为 completed 任务提供重新打开、两步确认的删除，以及覆盖 active 成员与“未指派”选项的负责人选择器。每个控件都通过 agentTeams 桥以 Lead 权限发出一条类型化 wire action，因此 teammate 会话的写入落在 Lead Session 上。

一条写入在途时页面锁定其控件并显示 busy 提示。stale-revision 拒绝会记录冲突提示并刷新任务板，让下一次尝试从已提交的 revision 出发；其他拒绝会记录 wire 诊断。提示会保留到被关闭为止，并且打开的表单会保持在提示旁，让已输入的内容在提交失败后得以保留。切换会话会重置页面状态。

理解实现

Client export 通过 Cordis effect 注册 locale dictionary、一个 conversation-header slot 与右侧边栏的 Team 标签页；它为写入桥挂载 agentTeams Remote namespace。Dispose plugin fiber 会移除这些 registration 并撤回该 namespace。

面板渲染在会话容器外，并保持在视口范围内。成员卡片在静止、选中和悬停状态下均使用共享 elevation 描边绘制轮廓。悬停触发按钮 150ms 后打开面板；指针离开触发按钮和面板后，经过 120ms 宽限关闭。点击触发按钮会固定面板并将焦点移入其中。点击外部或按 Escape 可关闭面板；仅当焦点原本位于面板内时，Escape 才将焦点返回触发按钮。页头较窄时触发按钮折叠为图标，只响应点击打开。组件从 useSessions、useSessionStatus 与 useSession 座位派生每一行：Lead 身份来自当前 Session 的 subagent address，Team 视图来自 projectionsBySession[lead].values.agentTeam，成员活动来自 Session 状态并以列表摘要为后备，model 来自 projectionsBySession[member].values.modelSelection.next。每个 roster 行只选择自己的运行状态。唯一的注入回调通过当前与目标 Session 的 id 打开 roster Session。切换会话会关闭面板并清除导航失败。

| 文件 | 职责 | |---|---| | src/client/mount.ts | locale、标签页、导航、slot 与 Remote namespace registration | | src/client/TeamAction.tsx | 由投影派生的 roster 与任务板 popover 及面板交互状态 | | src/client/TeamBody.tsx | 右侧边栏 Team 页：roster、任务板、表单、提示与 busy 状态 | | src/client/team-writes.ts | agentTeams namespace 之上的写入 face，处理冲突与拒绝 | | src/client/team-page-store.ts | 页面 busy 与提示状态 | | src/client/team-model.ts | 纯 roster、任务板与表单辅助 | | src/client/definition.tsx | 侧边栏标签页注册与 guide 条目 | | src/client/locales.ts | 中英文 panel 与页面文案 | | src/index.ts | 不执行行为的 Host entry |

进一步探索

• Agent Teams service——权威 roster、task 与投影行为。
• 会话 UI——稳定 header slot 与 addressed-subagent 导航表层。
• 实验性包——孵化状态与发布规则。

模型体验

无直接影响，因为该浏览器 projection 不注册面向模型的输入。

KV Cache 影响

无直接影响；Team 工具与普通会话提交负责后续任何模型可见用途。

已知限制与延期工作

• 没有 mailbox timeline——投影视图只承载 roster 与任务；不显示 peer 消息。
• 晚启用插件 — 在已经打开的会话中启用 Agent Teams 后，需要刷新页面才能接收其 Team 投影。
• 模型可用性 — 仅当共享 store 包含该成员的持久选择或请求时才显示模型。冷缓存中缺少的值会保持缺失，直到正常 Session 加载或实时更新提供它们。
• 普通 child continuation——导航后发送的人类消息使用稳定 addressed-subagent 提示词路径，而不是 Team peer mailbox。
• 没有 lifecycle 或 workspace control——panel 不能 spawn、rename、delete 或 interrupt teammate，write scope 仍只是提示性 metadata。
• claim 与 release 仍归模型所有——浏览器只通过编辑、完成、重新打开、删除与改派修改任务；claim 与 release 仍是 Team agent 工具操作，任务板没有拖拽排序与活动流。

开发备注

无。