AgentHub 文档
AgentHub 是 TokenDance 的多 Agent 工程协作产品线。它将 AgentHub Desktop、Web 工作台、Hub Server、Edge Server 和 Agent Runtime adapter 连接起来，让 Claude Code、Codex、OpenCode 等编码 Agent 进入团队可见的工作流程。
当前状态
AgentHub 开发中中。官网和文档站已公开；Desktop + Local Edge 是可预览的本地路径；Hub Server 和 Web 工作台进行中；Feishu/Lark 生产集成、Remote/Cloud Edge、完整 Web + Hub + Edge 路由和部分数据库驱动界面仍在开发中。
从这里开始
如果你第一次了解 AgentHub，先按自己的角色选择一条路径，再按完整顺序补齐上下文。
| 读者 | 优先阅读 | 读完应得到什么 |
|---|---|---|
| 产品评估者 | 产品状态 -> 对比分析 -> 路线图 | 判断哪些能力已上线、哪些只是预览，以及 AgentHub 为什么不是另一个 CLI |
| 本地使用者 | 安装与本地环境 -> Desktop 使用手册 -> 快速上手 | 安全跑通最小的 Desktop -> Local Edge -> Runtime adapter 路径 |
| Runtime 接入者 | Agent Profile -> Run 生命周期 -> 适配器契约 -> API 与事件 | 将一个 runtime 映射到事件、审批、diff 和 artifact 模型 |
| 团队/流程负责人 | 团队协作 -> Hub 与 Edge -> Web 工作台 -> 飞书/Lark 集成 | 规划共享 session、Web 审查、Hub 路由、IM 入口和证据 |
| 发布负责人 | 安全边界 -> 运维 Runbook -> 部署 -> 发布检查 | 校验文档、视觉 QA、SEO、公开发现文件和安全发布口径 |
完整推荐阅读顺序：
- 核心概念：先理解 Desktop、Web、Hub、Edge、Agent Profile、Runtime adapter、Run、Event 的关系。
- 产品状态：区分已上线、可预览、契约已定、进行中和开发中能力。
- 快速上手：在本地启动最小链路，确认 Desktop、Local Edge 和 Runtime adapter 能协同工作。
- 安装与本地环境：准备 Git、Go、Node.js、pnpm、Local Edge、Desktop 和安全的 runtime 链路。
- 术语表：统一产品、runtime、身份、集成和发布术语。
- 工作流：将本地运行、可审查 diff、团队协作、飞书/Lark、adapter 和发布流程映射到具体证据。
- 使用 Cookbook：按配方执行只读审查、可审查 diff、adapter 对比、失败 run 排查、团队任务准备、飞书/Lark 准备和文档发布。
- Desktop 使用手册：理解本地工作台、runtime 选择、diff 审查、审批和 QA 证据。
- Desktop UI 参考：检查布局、run 状态、选择器、diff 面板、动效和截图 QA。
- 配置：接入真实凭据前，先确认本地、Hub/Web、runtime profile 和 secret 的归属。
- 身份与登录：确认 TokenDance ID 登录、callback、浏览器状态和授权边界。
- 系统架构：理解 Hub / Edge / Desktop / Web 的职责边界。
- Hub 与 Edge：确认协作/执行拆分、路由、事件契约和集成入口边界。
- Web 工作台：理解 Hub-backed Web 界面、本地文件边界、审查流程和证据。
- Agent Profile：定义 profile metadata、capability、approval policy 和 adapter 边界。
- 团队协作：映射 shared session、团队角色、approval、集成入口和证据。
- Run 生命周期：确认 run 状态、event envelope、approval gate、artifact、diff 和 failure code。
- API 与事件：查看 REST、WebSocket event、runtime adapter contract 的公开边界。
- FAQ：回答产品、设置、身份、runtime、集成和发布常见问题。
- 设计系统：遵守 TokenDance Blue、Desktop mock、图标、动效和视觉 QA 规则。
- 部署：使用静态导出、线上 smoke 和旧页面排查指南。
文档分块
| 分块 | 说明 | 状态 |
|---|---|---|
| 核心概念 | 术语、产品形态、交付状态和能力边界 | 持续更新 |
| 产品状态 | 已上线、可预览、契约已定、进行中和开发中能力地图 | 持续更新 |
| 术语表 | 产品、runtime、身份、集成和发布术语 | 持续更新 |
| 工作流 | 本地运行、diff 审查、协作、飞书/Lark、adapter 和发布流程 | 持续更新 |
| 使用 Cookbook | 只读审查、diff 审查、adapter 对比、失败 run 排查、团队任务、飞书/Lark 准备和文档发布配方 | 持续更新 |
| 安装与本地环境 | 工作站设置、runtime CLI 准备、本地端口、校验和初次故障分流 | 持续更新 |
| Desktop 使用手册 | Desktop 界面地图、runtime 控制、diff 审查、审批、主题/语言证据 | 持续更新 |
| Desktop UI 参考 | 布局模型、run 状态、选择器、runtime picker、diff 面板、动效和截图 QA | 持续更新 |
| 快速上手 | 本地预览、配置、运行第一条 Agent 任务 | 可预览 |
| 配置 | Local Edge、Hub/Web、runtime profile 和 secret 归属 | 持续更新 |
| 身份与登录 | TokenDance ID 登录流程、callback、浏览器状态、授权边界和 UI 规则 | 持续更新 |
| 系统架构 | Hub、Edge、Desktop、Web、Runtime adapter 和事件流 | 可预览 |
| Hub 与 Edge | Hub/Edge 职责拆分、路由、事件契约和集成入口 | 持续更新 |
| Web 工作台 | Hub-backed Web 界面、本地文件边界、审查流程、UI 状态和证据 | 进行中 |
| Agent Profile | Profile 模型、capability 词汇、选择规则、approval policy 和 adapter 边界 | 契约已定 |
| 团队协作 | Shared session、review/approval flow、团队角色、集成入口和证据 | 进行中 |
| Run 生命周期 | Run 状态机、event envelope、approval gate、artifact、diff metadata 和 failure code | 契约已定 |
| 适配器契约 | Claude Code、Codex、OpenCode 与自定义 adapter 的契约说明 | 契约已定，公开 SDK 未稳定 |
| API 与事件 | Hub API、Edge API、WebSocket event、adapter event 的边界 | 开发中 |
| 飞书/Lark 集成 | 机器人、事件、卡片、H5/工作台、TokenDance ID 绑定 | 开发中 |
| 安全边界 | TokenDance ID、Hub 本地权限、secret、沙箱和审计 | 持续更新 |
| 运维 Runbook | 公开站点检查、docs route 发布门禁、视觉 QA、smoke 和故障分流 | 持续更新 |
| 部署 | 发布源、本地构建、静态导出、线上 smoke 和旧页面排查 | 持续更新 |
| 排障指南 | 启动、登录、Runtime、飞书、静态站点问题排查 | 持续更新 |
| FAQ | 产品、设置、身份、runtime、集成、文档和发布问题 | 持续更新 |
| 发布检查 | 文档、SEO、视觉 QA、安全和部署门禁 | 持续更新 |
| 路线图 | 能力状态和保守发布口径 | 持续更新 |
| 设计系统 | TokenDance Blue、组件规则、Desktop mock、动效、图标和视觉 QA 指南 | 持续更新 |
| 对比分析 | 与 CLI、聊天 UI、单 Agent 工具的定位差异 | 持续更新 |
| 更新日志 | 公开文档和产品站的重要变化 | 持续更新 |
AgentHub 是什么？
传统 AI 编程工具通常运行在个人终端里：一个人发起任务、一个人看日志、一个人决定结果是否可用。AgentHub 为这类任务提供共享状态、审查步骤和可复查的团队记录。
在当前设计里：
- AgentHub Desktop 是本地工作台，连接 Local Edge，适合个人开发和本机执行。
- AgentHub Web 是 Hub 驱动的协作工作台，面向多端、团队、IM 和远程协作。
- Hub Server 管理身份会话、项目、设备、IM 入口、同步和审计。
- Edge Server 管理 workspace、run lifecycle、runtime adapter、diff、artifact 和 preview event。
- Runtime adapter 承载 Claude Code、Codex、OpenCode 等真实执行引擎。
AgentHub 是一个受控工作台，用来呈现 Agent 工作的关键状态：谁发起了任务、哪个 runtime 执行、改了哪些文件、请求了哪些审批、产出了什么记录，以及后续能否复查。
当前能力边界
已经可以按文档描述的方向开发和预览：
- Desktop 连接 Local Edge，并通过 mock / Claude Code / Codex / OpenCode preset 验证执行链路。
- Web 工作台可以作为 Hub-only 预览面，不直接启动本地 CLI，也不绕过 Hub 直连 Local Edge。
- Edge Server 已具备 Runtime adapter 结构和本地执行边界。
- Hub Server 已具备 OIDC code exchange、Hub session、设备/任务路由等开发链路。
仍在开发或接线中的能力：
- Feishu/Lark 生产事件入口、卡片 schema、异步队列和账号绑定流程。
- Remote/Cloud Edge、设备证明、workspace allowlist 和 relay/provisioning。
- Contacts、Docs、Tasks、Projects、Settings 等数据库驱动界面。
- 完整 Web + Hub + Edge 路由的生产级 E2E 验证。
- 公开第三方 Adapter SDK 包和生态提交流程。
如果页面写的是“可预览”或“开发中”，就按字面理解。公开文档的目标是让贡献者和早期用户理解系统方向，同时避免把尚未通用可用的能力写成正式上线。
身份与登录
TokenDance ID 是 AgentHub 的身份权威。AgentHub 不直接实现 GitHub、Google 或飞书等第三方登录，也不把飞书 OAuth 当作产品登录。Hub Server 可以发行 AgentHub 本地会话并做产品权限判断；Desktop/Web 的低风险个性化不能当作 Hub API 授权边界。