公开架构
生态架构
TokenDance 产品族的公开分层、凭据边界和产品协作关系。
为什么需要这页
组织官网面对的是第一次接触 TokenDance 的读者。它需要说明每个产品扮演什么角色、哪些边界可以公开、哪些实现细节应该留在产品仓库或私有运维文档中。
这页不是内部拓扑图，也不是部署 runbook。它只描述公开产品架构：入口、身份、模型 API、Agent 工作台、实验项目和治理文档如何配合。
公开分层
| 层级 | 公开角色 | 主要产品 | 公开承诺 |
|---|---|---|---|
| 品牌与导航 | 解释 TokenDance 是什么，并把读者带到正确产品 | tokendance-org | 产品矩阵、公开 docs、SEO/llms 入口 |
| 协作工作台 | 让多个 Agent 在桌面端和 Web 协作 | AgentHub | 官网、文档、Desktop-first 方向、Hub-backed Web 边界 |
| 模型 API | 提供 OpenAI-compatible 模型 API 入口 | TokenDance Gateway | API 入口已上线；key、额度、错误和状态体验持续产品化 |
| 统一身份 | 集中管理登录、第三方 provider 和 OIDC | TokenDance ID | 产品登录的身份权威；授权仍由各产品本地完成 |
| 实验与验证 | 验证 CLI、聊天、事件流和 Agent 交互想法 | TokenDanceCode / TokenDanceChat | 低承诺实验和演示，不替代正式产品线 |
凭据和会话边界
| 场景 | 应该使用 | 不应该使用 |
|---|---|---|
| 浏览官网和文档 | 匿名访问；可选 TokenDance ID 低风险个性化 | 模型 API key 或管理密钥 |
| 登录产品 | TokenDance ID OIDC + 产品本地 session | 业务产品直连 GitHub/Google/Feishu OAuth |
| 调用模型 API | TokenDance API key + https://api.vectorcontrol.tech/v1 | TokenDance ID access token |
| AgentHub 运行任务 | Hub/Edge/adapter 管理的 runtime 配置 | Web 页面直接读取本机文件或启动本地 CLI |
| 部署和运维 | 私有 server workspace 和 operator secret store | 公开 README、llms.txt、issue 或截图 |
产品如何协作
- tokendance-org 是品牌入口和产品矩阵，不承载每个产品的完整实现文档。
- AgentHub 是多 Agent 协作产品线，可以通过受控 adapter 或服务端配置使用 Gateway，但不把模型 key 存在 Web 前端。
- TokenDance Gateway 服务 Agent、CLI、应用和自动化工作负载；TokenDance ID 只负责登录身份，不负责模型 API 鉴权。
- TokenDanceCode 可以沉淀 CLI Agent 的事件、工具和交互经验，未来可反馈给 AgentHub runtime adapter 设计。
- TokenDanceChat 是实时交互和事件流验证场，公开说明应保持演示/验证语气。
公开文档不包含
- 生产主机、SSH alias、nginx web-root、备份目录和回滚命令。
- 真实 provider key、TokenDance API key、admin token、client secret 或私有日志。
- 未发布管理后台的截图、内部数据库路径、用户数据或支持流程细节。
- 把 roadmap 功能写成稳定 SLA 的营销承诺。