核心概念
本页用最简洁的方式解释 AgentHub 的关键概念。读完你能理解：产品长什么样、Agent 怎么跑起来的、哪些能力已经可用。
产品形态
AgentHub 是一个把 AI Agent 当队友用的协作平台。你把它加到群聊里，它就像群里的一个成员。给 Agent 发消息就是派任务，聊天窗口就是工作台。
| 形态 | 是什么 | 当前状态 |
|---|---|---|
| AgentHub Desktop | Tauri 2 原生桌面应用，本地工作台，连接本机执行引擎 | 可本地预览 |
| AgentHub Web | 浏览器端应用，和 Desktop 界面一致，团队共用，由 Hub 服务支撑协作 | 可预览 |
| AgentHub Mobile | iOS/Android 聊天工作台，手机端审查和创建任务 | 推进中 |
| Hub Server | Go 服务：管理账号、团队、项目、消息和审计 | 可本地开发 |
| Edge Server | Go 服务：管理执行环境、任务生命周期、执行引擎注册和产出物 | 可本地开发 |
| 飞书/Lark 入口 | 机器人消息、事件订阅、卡片回调、H5/工作台 | 正在开发 |
Agent Profile 与 Runtime Adapter
Agent Profile 是你在群里看到的 Agent 名片。比如”代码审查 Agent""文档 Agent""实现 Agent”。Profile 定义了 Agent 的名字、能做什么、权限范围、默认用哪个模型。
Runtime Adapter 是 Edge Server 里真正干活的东西——它把 Claude Code、Codex、OpenCode 这些执行引擎接到 AgentHub 里来。一个 Profile 可以绑定一个 Adapter，但它们是两层不同的东西。
这样分层的好处是：团队看 Agent 名片就知道该找谁，至于背后跑的是 Claude Code 还是 Codex，交给 Edge 去操心。
Hub 与 Edge
Hub 和 Edge 各管一摊，边界很清楚：
- Hub Server 管人：账号、团队、项目、消息、IM 入口、跨端同步、权限、审计记录。
- Edge Server 管执行：工作区、任务进程、文件读写、执行引擎注册、产出物（diff、文件、预览）。
- Desktop 默认连 Local Edge，本机执行不需要 Hub 登录。
- Web 和 Mobile 通过 Hub 协作，不直接操作本机命令行，也不绕过 Hub 直连 Local Edge。
Session、Task、Run、Event
这些东西把”Agent 在后台跑了一段”变成了团队可查阅的工作记录：
- Session：一次协作上下文，可以从 Desktop、Web、Mobile 或 IM 会话发起。
- Task：你给 Agent 派的具体活儿，比如”审查这个 PR""整理文档""修复测试”。
- Run：某个 Agent 对 Task 的一次实际执行。一个 Task 可以有多次 Run。
- Event：Run 生命周期中的结构化事件，比如运行开始、Agent 输出了一段消息、执行了某个工具、请求了审批、运行完成。
你看到的聊天界面里，Agent 的一条条消息和它引用的文件变更，就是由这些 Event 渲染出来的。
一次请求怎么流动
本地链路（Desktop 直连）：
你 -> Desktop -> Local Edge -> 执行引擎注册表 -> 实际 CLI 进程
<- 消息和产出物回流 <-团队链路（走 Hub）：
你 / Web / Mobile / IM -> Hub Server -> 已授权的 Edge -> 执行引擎注册表
| |
| -> 工作区策略 / 审批 / 产出物
-> 会话 / 团队 / 项目 / 审计Desktop 本地预览直连 Local Edge；Web、Mobile 和 IM 入口需要经过 Hub 的身份、项目和授权。
谁拥有哪类数据
| 数据 | 归属方 | 公开文档里的处理方式 |
|---|---|---|
| 账号身份、登录凭证 | TokenDance ID + Hub Server（PKCE） | 只说明身份边界，不暴露真实 token |
| 项目、团队、任务、审计记录 | Hub Server | 描述资源模型和错误码，不暴露私有数据库路径 |
| 工作区路径、文件预览、diff、产出物 | Edge Server | 用相对路径和示例，避免本机绝对路径 |
| 执行引擎原始输出 | Runtime adapter | 默认转为结构化消息；原始附件脱敏处理 |
| 飞书/Lark 事件和卡片动作 | 集成网关 + Hub | 只含紧凑 id/action，不放完整提示词或私密文件 |
这样划分能避免把登录凭据、API key、本地鉴权和 IM 事件搅在一张凭据面上。
例子：一次文档审查任务
假设你让 Agent 帮你审查文档，在 AgentHub 里的流程是这样的：
- 你打开群聊，docs-agent 已经在群里了。
- 你发消息：“审查 README，给我最小的改进建议。”
- Desktop 请求 Local Edge 创建一个只读任务。
- Edge 从执行引擎注册表中启动一个引擎（Claude Code、Codex 或 OpenCode）。
- 引擎的输出被转成聊天消息和产出引用（文件列表、diff、建议）。
- 你在工作台里看到 Agent 的完整思考过程、改了什么、产出了什么。
- 如果任务要写文件、跑 shell、commit 或发布，会进入审批环节——得你点头才执行。
NOTE
这个例子描述的是本地预览链路。团队 Web、Mobile、飞书/Lark 或 Remote Edge 还需要额外的 Hub 会话、目标授权和审计。
当前交付状态
已经可以本地跑通和预览：
- Desktop -> Local Edge -> 执行引擎的全链路，使用共享工作台。
- Web -> Hub 的 IM 式协作，与 Desktop 共享同一套工作台界面。
- Claude Code、Codex、OpenCode 已在 Edge 中注册为可用引擎。
- Hub Server 的身份认证、团队协作和消息路由本地开发链路。
- 三个客户端共享的消息和证据引用格式。
推进中：
- Mobile 客户端，IM 式聊天工作台框架。
- Desktop、Web、Mobile 三端的完整团队协作工作流。
正在开发：
- 飞书/Lark 生产级事件入口、卡片回调、H5/工作台和账号绑定闭环。
- Remote / Cloud Edge、设备证明、路由调度和工作区白名单。
- Contacts、Docs、Tasks、Projects、Settings 等数据库驱动界面。
- 完整的 Web + Hub + Edge 生产级端到端验证。