AgentHub 文档
AgentHub 把 AI Agent 变成群聊里的队友。 不用再一个人盯着终端日志，你可以在聊天里给 Agent 下任务，看它干活，审查它的改动。就像飞书或微信里多了一个会写代码、会查资料、会整理文档的同事。
你可以用桌面应用连本机跑 Agent，也可以在浏览器里和团队一起指挥 Agent 干活，或者手机上随时看一眼进度。三种客户端共享同一套工作台，界面一致，切设备不掉上下文。
NOTE
AgentHub 正在积极开发中。官网和文档已对外公开；Desktop 本地执行链路可预览；Web 协作界面可预览；Mobile 客户端推进中；飞书/Lark 集成和 Remote Edge 仍在开发。
从这里开始
如果你是第一次了解 AgentHub，先按自己的角色选一条路径：
| 读者 | 优先阅读 | 你会了解到 |
|---|---|---|
| 想评估产品的人 | 产品状态 -> 对比分析 -> 路线图 | 哪些能力已经可用，AgentHub 作为 IM 式协作平台跟 CLI 工具有什么不同 |
| 想本地尝试的人 | 安装与本地环境 -> Desktop 使用手册 -> 快速上手 | 在自己的电脑上跑通 Desktop -> Local Edge -> 执行引擎的全链路 |
| 想接入新执行引擎的人 | Agent Profile -> Run 生命周期 -> 适配器契约 -> API 与事件 | 怎么把自己的执行引擎对接到 AgentHub 的消息、审批和变更审查体系 |
| 团队负责人 | 团队协作 -> Hub 与 Edge -> Web 工作台 -> 飞书/Lark 集成 | 怎么在团队里用聊天管 Agent 任务、做审查、收 IM 通知 |
| 发布负责人 | 安全边界 -> 运维 Runbook -> 部署 -> 发布检查 | 上线前要校验的文档、视觉、SEO 和发布话术 |
完整推荐阅读顺序：
- 核心概念：先理解 Desktop、Web、Mobile、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 准备和 docs 发布。
- Desktop 使用手册：理解本地工作台、runtime 选择、diff 审查、审批和 QA 证据。
- Desktop UI 参考：检查布局、run 状态、选择器、diff 面板、动效和截图 QA。
- 配置：接入真实凭据前，先确认本地、Hub/Web、runtime profile 和 secret 的归属。
- 身份与登录：确认 TokenDance ID 登录、callback、浏览器状态和授权边界。
- 系统架构：理解 5 层架构：Shared UI -> Platform Adapter -> Edge/Hub -> AgentAdapter -> Runtime CLI。
- Hub 与 Edge：确认协作/执行拆分、路由、事件契约和集成入口边界。
- Web 工作台：理解 Hub-backed IM 式 Web 界面、本地文件边界、审查流程和证据。
- Agent Profile：定义 profile metadata、capability、approval policy 和 adapter 边界。
- 团队协作：映射 IM 式群聊、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 准备和 docs 发布配方 | 持续更新 |
| 安装与本地环境 | 工作站设置、runtime CLI 准备、本地端口（5173/5174/5177）、校验和初次故障分流 | 持续更新 |
| Desktop 使用手册 | Tauri 2 Desktop 界面地图、runtime 控制、diff 审查、审批、主题/语言证据 | 持续更新 |
| Desktop UI 参考 | 布局模型、run 状态、选择器、runtime picker、diff 面板、动效和截图 QA | 持续更新 |
| 快速上手 | Desktop + Web 本地预览、配置、运行第一条 Agent 任务 | 可预览 |
| 配置 | Local Edge、Hub/Web、runtime profile 和 secret 归属 | 持续更新 |
| 身份与登录 | TokenDance ID 登录流程、callback、浏览器状态、授权边界和 UI 规则 | 持续更新 |
| 系统架构 | 5 层架构、Hub、Edge、Desktop、Web、Mobile、Runtime adapter 和事件流 | 可预览 |
| Hub 与 Edge | Hub/Edge 职责拆分、路由、事件契约和集成入口 | 持续更新 |
| Web 工作台 | Hub-backed IM 式 Web 界面、本地文件边界、审查流程、UI 状态和证据 | 推进中 |
| Agent Profile | Profile 模型、capability 词汇、选择规则、approval policy 和 adapter 边界 | 契约成型 |
| 团队协作 | IM 式群聊、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 把这个过程搬进了群聊。把 AI Agent 拉进群，发消息就是给任务，聊天窗口就是工作台。Agent 干了什么、改了什么文件、需要你审批什么，全在聊天流里，团队成员都能看到。
目前的产品形态：
- AgentHub Desktop（Tauri 2 原生应用）：本地工作台，适合个人在本机跑 Agent 任务。连接 Local Edge 执行引擎，渲染共享工作台界面。
- AgentHub Web（浏览器应用）：团队协作入口。和 Desktop 共享同一套工作台界面，团队成员在这里审查 Agent 的产出、回溯历史记录。
- AgentHub Mobile（iOS / Android App）：移动端聊天工作台，适合在手机上审查任务、创建新任务。
- Hub Server：管理账号、项目、消息、团队协作和审计记录的核心服务。
- Edge Server：管理工作区、任务生命周期、执行引擎注册和产出物（diff、文件、预览）的执行层服务。
- Runtime adapter：对接真实 AI 执行引擎的适配层，支持 Claude Code、Codex、OpenCode。
AgentHub 的核心思路是：让 Agent 的工作透明化。谁发起的任务、哪个引擎执行的、改了什么、请求了哪些审批、产出了什么结果，你和你的团队都能在聊天界面里看得一清二楚。
当前能做什么
已经可以本地跑通和预览：
- Desktop 连 Local Edge，驱动 Claude Code、Codex 或 OpenCode 执行任务，在工作台里看到 Agent 的消息、改动的文件和产出的内容。
- Web 作为团队协作界面运行，和 Desktop 共享同一套工作台，团队成员可以在浏览器里审查 Agent 的工作。
- Edge Server 已具备执行引擎注册、任务生命周期管理和本地执行能力。
- Hub Server 已具备身份认证、团队协作、消息路由的开发链路。
仍在推进或开发中：
- Mobile 客户端：iOS/Android 聊天工作台框架已搭建，本地 workspace 和 runtime 控制尚未接入。
- 飞书/Lark 生产级集成：事件入口、卡片回调、账号绑定流程在开发中。
- Remote / Cloud Edge：远端执行节点的设备证明和路由调度尚未完成。
- Contacts、Docs、Tasks、Projects、Settings 等数据库驱动界面。
- 完整的 Web + Hub + Edge 生产级端到端验证。
- 公开的第三方 Adapter SDK 和生态提交流程。
页面上标注”可预览”或”开发中”的，就是对应能力的真实状态。
身份与登录
TokenDance ID 是 AgentHub 的统一身份体系。Hub Server 通过 OIDC PKCE 协议完成登录验证。AgentHub 的产品权限由 Hub Server 签发和管理。
下一步
继续阅读 核心概念，用 工作流 判断自己的场景，然后按 快速上手 跑通本地路径。
在 GitHub 编辑此页