团队协作
AgentHub 的协作能力把本地 Agent run 变成团队可见的工作流。本页说明 shared session、review、approval 和 integration entry 的产品边界。
协作产品面
| 产品面 | 角色 | 当前措辞 |
|---|---|---|
| Desktop | 本地操作者控制和 approval | 可预览本地链路 |
| Web | Hub-backed 团队工作台 | 预览/开发链路 |
| Hub Server | Session、project、device、routing、audit | 进行中 |
| Feishu/Lark | Bot、card、H5/workbench 入口 | 开发中 |
| Remote/Cloud Edge | 授权非本地执行目标 | 开发中 |
公开文档不能在 runtime 证据完成前暗示所有协作面都已生产可用。正确的说法是架构和本地预览链路已成型，完整的 Web + Hub + Edge 协作还在完成中。
Shared Session 模型
协作 session 应包含：
- TokenDance ID subject 和产品 session；
- project 或 workspace 上下文；
- 已选的 Agent Profile 和 runtime adapter；
- target Edge 和 workspace policy；
- transcript、tool event、diff、artifact 和 approval history；
- routing、permission、final state 的 audit event。
Desktop 可以承载本地执行视图。Web 可以承载 Hub-backed shared view。团队可见状态和授权应以 Hub 为来源。
Review 与 Approval 流程
AgentHub 应显式呈现 review 步骤：
- 用户或 integration 创建 task。
- Hub 记录 task 并解析 project authorization。
- Hub 路由到授权的 Edge target。
- Edge 启动 runtime adapter 并流式输出归一化 event。
- Desktop/Web 渲染 transcript、tool state、diff 和 artifact。
- 用户批准或拒绝写入、命令或发布动作。
- Hub 记录 final state 和 audit event。
如果某一步缺失，UI 应显示具体的 blocked 状态，而不是假装 run 仍在活跃。
团队角色
正式权限模型发布前，使用简单角色语言：
| 角色 | 常见能力 |
|---|---|
| Owner | 管理项目设置、成员、设备和 release gate |
| Maintainer | 启动 run、审查 diff、批准普通写入 |
| Reviewer | 查看 transcript、diff、artifact，评论或要求修改 |
| Operator | 在授权 Edge 上运行分配任务 |
| Viewer | 读取 shared state，但不能批准动作 |
TokenDance ID 认证后，授权仍属于产品本地。TokenDance ID 告诉 AgentHub 用户是谁；AgentHub 决定用户能做什么。
集成入口
外部入口应创建 Hub task，而不是绕过 Hub：
| 入口 | 必备边界 |
|---|---|
| 飞书/Lark bot | 校验 event signature、解析账号绑定、排队耗时任务 |
| 飞书/Lark card | 3 秒内响应，并异步继续 |
| Web request | 使用 Hub session 和产品授权 |
| Automation | 使用 scoped service identity 和 audit trail |
| Remote Edge route | 要求 target authorization 和 device proof |
飞书 OAuth、GitHub OAuth、Google OAuth 属于 TokenDance ID。产品侧 integration 应消费 TokenDance ID 身份和产品本地权限。
协作能力证据
文档或营销要把协作能力写成 live 前，应收集：
| Claim | Evidence |
|---|---|
| Shared transcript | 两个已认证客户端看到同一个 run state |
| Team approval | Approval action 记录 actor、action、target、result |
| Web routing | Web 通过 Hub 创建 task，不直连 Local Edge |
| Feishu task | Event 校验签名、解析绑定、创建 Hub task、快速响应 |
| Remote Edge | Hub 授权 target，Edge 执行 workspace policy，audit 捕获路由 |
证据缺失时，使用"进行中"或"开发中"。
失败状态
协作 UI 应暴露 blocked 状态：
- 用户未通过 TokenDance ID 登录；
- 缺少 project membership；
- Edge unavailable；
- runtime adapter unavailable；
- workspace policy blocked；
- approval required；
- integration binding missing；
- event queue delayed；
- route denied。
相关页面：Hub 与 Edge、工作流、飞书/Lark 集成、安全边界。