背景
Console Web 当前有 14 个菜单项,全部使用工程术语(GAgents, Primitives, Topology, Mission Control),没有产品逻辑。CEO 判断:"完全没逻辑,东西都挤在一起。"
经过 Office Hours → CEO Review → Eng Review,产出了完整的产品设计方案。
产品设计文档
核心方案
Console Web — "你的 AI 团队"
Scope = Team。 一个 Scope 下所有 GAgent 组成一个 AI 团队。
双层架构(SaaS + Cloud Platform):
```
Teams(SaaS 风格): 我的团队 | 组建团队
──────────────────────────────────────────
Platform(云平台风格): Governance | Services | Topology | Deployments
```
- Teams 层面向业务用户,SaaS 产品体验
- Platform 层面向管理员,云平台管理后台体验
路由重组:
| 新路由 |
对应当前 |
/teams (首页) |
/scopes/overview |
/teams/:scopeId (详情) |
新建,组合 topology + events + members |
| Governance / Services / Topology / Deployments |
保留在 Platform 层 |
| 其他 12 个路由 |
hideInMenu + redirect |
团队详情页 Tabs: 概览 | 事件拓扑(XYFlow) | 事件流(EventEnvelope) | 成员 | 连接器 | 高级编辑(→Studio)
Studio — 团队构建器
Studio 针对 Scope 工作,是团队的构建/编辑工具:
- 从一级导航移除,改为从团队详情"高级编辑"进入
- 术语重映射:Workflows → 行为定义, Roles → Agent 角色, Connectors → 集成, Executions → 测试运行
- 保留全部现有能力(XYFlow/Monaco/SSE 执行)
关键认知
- Agent 通信 = EventEnvelope 事件协议(树状传播),不是文本群聊
- Governance = 平台级服务发现与治理层,不是团队规则。归入 Platform 层
- Chat = 辅助工具(创建辅助 + 测试对话),不是一级导航
- 零后端变更:所有需要的 API 已存在(scopesApi, runtimeGAgentApi, runtimeActorsApi, scopeRuntimeApi)
数据源映射
| 前端需求 |
现有 API |
| 团队列表 |
scopesApi.listScopes() |
| 团队成员 |
runtimeGAgentApi.listActors(scopeId) |
| 事件拓扑 |
runtimeActorsApi.getActorGraphEnriched() |
| 事件流 |
scopeRuntimeApi.getServiceRunAudit() |
实施文件清单
config/routes.ts — 路由重组 + hideInMenu + redirect
src/app.tsx — postMenuData 菜单分组改为 Teams + Platform
src/pages/scopes/overview/ — 标签改为"我的团队"
src/pages/teams/ (新建) — 团队详情页,组合 topology + events + members Tab
src/layouts/MainLayout.tsx — 导航分组调整
- 各页面组件 — UI 标签术语替换
分工
| 角色 |
人员 |
职责 |
| 前端实施 |
@potter-sun |
路由重组、页面重构、术语替换、团队详情页开发 |
| 后端支持 |
@eanzhao |
API 确认、数据源对接、Scope/GAgent 层级查询支持 |
| 架构验收 |
@louis-li |
确保符合 CLAUDE.md 架构约束、读写分离、投影链路正确性 |
验收标准
背景
Console Web 当前有 14 个菜单项,全部使用工程术语(GAgents, Primitives, Topology, Mission Control),没有产品逻辑。CEO 判断:"完全没逻辑,东西都挤在一起。"
经过 Office Hours → CEO Review → Eng Review,产出了完整的产品设计方案。
产品设计文档
docs/designs/2026-04-08-console-web-ai-teams.mddocs/designs/2026-04-08-studio-redesign.md核心方案
Console Web — "你的 AI 团队"
Scope = Team。 一个 Scope 下所有 GAgent 组成一个 AI 团队。
双层架构(SaaS + Cloud Platform):
```
Teams(SaaS 风格): 我的团队 | 组建团队
──────────────────────────────────────────
Platform(云平台风格): Governance | Services | Topology | Deployments
```
路由重组:
/teams(首页)/scopes/overview/teams/:scopeId(详情)团队详情页 Tabs: 概览 | 事件拓扑(XYFlow) | 事件流(EventEnvelope) | 成员 | 连接器 | 高级编辑(→Studio)
Studio — 团队构建器
Studio 针对 Scope 工作,是团队的构建/编辑工具:
关键认知
数据源映射
scopesApi.listScopes()runtimeGAgentApi.listActors(scopeId)runtimeActorsApi.getActorGraphEnriched()scopeRuntimeApi.getServiceRunAudit()实施文件清单
config/routes.ts— 路由重组 + hideInMenu + redirectsrc/app.tsx— postMenuData 菜单分组改为 Teams + Platformsrc/pages/scopes/overview/— 标签改为"我的团队"src/pages/teams/(新建) — 团队详情页,组合 topology + events + members Tabsrc/layouts/MainLayout.tsx— 导航分组调整分工
验收标准