description: "使用并排查实验性 Web Agent Teams roster、共享任务板与 teammate 导航面板。" kind: "package-reference"

@x1a0f3n9/dsh-experimental-client-ui-agent-team

English | 中文

概述

本包向 Web 会话页头添加 Agent Teams action，让用户检查当前 roster、管理共享任务板并导航到 teammate 会话。它通过生成的 ctx.remote.agentTeams contribution 读取权威 Team 状态，并让普通 child history 导航继续使用稳定的 addressed-subagent 路径。通过公开发布的实验性 Agent Teams Web profile 选择本包。这个浏览器 projection 不扩展稳定 API Proxy、不存储 Team 状态，也不注册面向模型的输入。

目录

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

使用本包

在稳定 Web bundle 与 Host-side Agent Teams profile 之后，通过 @x1a0f3n9/dsh-experimental-agent-team-web-profile 安装本包。Web Client loader 挂载 /client export；root Host export 不执行行为，本包也没有用户配置字段。

检查并导航 roster

打开 panel 会调用 agentTeams/view。Roster row 展示持久 name、运行时 status、model 与 diagnostics。选择健康 teammate 时，系统刷新既有直接 child catalog，并打开普通的 { parentSessionId, childSessionId, mode: 'continuable' } address。History 与后续人类提示词继续使用稳定 addressed-subagent 会话路径；本包不会添加 Team 专用 address 字段。

管理任务板

任务板展示 task identity、owner、blocker、readiness、提示性 write scope 与重叠 warning。用户可以通过 agentTeams/createTask 与 agentTeams/updateTask 创建、编辑、分配或取消分配、完成、重开和删除任务。每次 update 都发送当前显示的 revision，create 或 update rejection 都保留为显式 business result。

理解实现

Client export 挂载来自 @x1a0f3n9/dsh-experimental-agent-team/remote 的生成的 ctx.remote.agentTeams contribution，然后通过 Cordis effect 注册 locale dictionary 与一个 conversation-header slot。Dispose plugin fiber 会移除这两项 registration。

开始 create 或 update 会让更早的 refresh 失效。成功后会重新读取完整 Team view，使每个 task 的派生字段保持最新。team-task-conflict 结果仅在重新读取成功后显示状态陈旧提示；如果重新读取失败，则改为显示重新读取错误。由于 Team 服务把任务文本或 scope 编辑与 dependency 修改公开为独立 action，两者使用两个连续的 compare-and-set mutation。

| 文件 | 职责 | |---|---| | src/client/mount.ts | 生成的 Remote、locale、导航与 slot registration | | src/client/TeamAction.tsx | Roster 与任务板交互状态 | | src/client/locales.ts | 中英文 panel 文案 | | src/index.ts | 不执行行为的 Host entry |

进一步探索

• Agent Teams Web profile——挂载本 Client plugin 的公开 opt-in bundle。
• Agent Teams service——权威 roster、task 与 Remote 行为。
• 会话 UI——稳定 header slot 与 addressed-subagent 导航表层。
• 实验性包——孵化状态与发布规则。

模型体验

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

KV Cache 影响

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

已知限制与延期工作

• Snapshot refresh——panel 会在打开、显式 refresh 与 mutation 后刷新；它没有实时事件订阅或 mailbox timeline。
• 普通 child continuation——导航后发送的人类消息使用稳定 addressed-subagent 提示词路径，而不是 Team peer mailbox。
• 没有 lifecycle 或 workspace control——panel 不能 spawn、rename、delete 或 interrupt teammate，write scope 仍只是提示性 metadata。

开发备注

无。

运行时不变式： 不发布伴生入口。RPC 是权威来源，本包只持有一个可释放的 slot 注册。