路线图
本页描述 AgentHub 能力的公开状态。这里刻意保守：只有实现、测试、文档和可见验证证据齐全后，能力才会标为 stable。
当前主线
当前公开主线是：
- AgentHub Home 和 docs 是已公开的产品入口。
- Desktop、Web、Hub Server、Edge Server、runtime adapter 都是活跃开发面。
- Local Desktop -> Local Edge -> runtime adapter preview 是最小可用验证链路。
- Feishu/Lark、Remote/Cloud Edge、完整 Web + Hub + Edge 路由在 runtime 证据完整前仍属于开发中。
里程碑
| 里程碑 | 目标 | 公开状态 | 当前证据 | 下一状态缺口 |
|---|---|---|---|---|
| M1 Local Pipeline | Desktop UI -> Edge -> mock run -> events | 可预览 | 本地预览链路、Desktop mock、文档和 smoke 形状已存在 | 持续保持截图和 run-event 证据对齐最新 Desktop UI |
| M2 Edge Persistence | Run state、artifact、diff、event fanout | 进行中 | Run 生命周期、artifact/diff 和 event contract 已文档化 | 需要持久化证明、replay 行为和失败态测试 |
| M3 Runtime Adapters | Claude Code、Codex、OpenCode、自定义 adapter contract | 契约已定 | Adapter event 词汇、profile 边界和示例契约已存在 | 需要公开包边界、兼容策略和真实 runtime conformance 测试 |
| M4 Hub/Web Collaboration | Project、device、Hub session、Web routing、audit | 进行中 | Hub/Web 职责拆分和 Web Workbench 边界已文档化 | 需要 Web + Hub + authorized Edge 路由证据和 audit 截图 |
| M5 IM Integration | 飞书/Lark 消息、卡片、H5/工作台、绑定闭环 | 开发中 | 集成边界、webhook 形状和 TokenDance ID 归属已文档化 | 需要生产入口证明、队列处理、卡片动作和绑定失败覆盖 |
| M6 Remote/Cloud Edge | 设备证明、relay/provisioning、远程 workspace policy | 开发中 | 产品边界和所需证据已定义 | 需要设备身份、目标授权、relay/provisioning、workspace policy 和审计证据 |
每个里程碑升级前都应带四个公开安全字段：owner 仓库或子系统、最新证据类型、缺失证明、下一步验证动作。私有部署路径、服务器清单和回滚步骤不在本页范围内。
里程碑验收清单
| 里程碑 | 最小验收 | 失败态必须覆盖 |
|---|---|---|
| M1 Local Pipeline | Desktop 能连接 Local Edge，mock run 输出结构化 event、transcript、diff/file 或 artifact | Edge 离线、runtime 不可用、workspace 未授权 |
| M2 Edge Persistence | run/event/artifact 可查询、可 replay，刷新 UI 不丢关键状态 | event schema 无效、artifact 缺失、timeout/cancelled |
| M3 Runtime Adapters | 每个 runtime 至少有 conformance 样例、错误码映射和权限映射 | CLI 未安装、未登录、输出无法解析、权限被拒绝 |
| M4 Hub/Web Collaboration | TokenDance ID -> Hub session -> project/device -> authorized Edge target -> audit 链路可复查 | 未登录、无项目权限、target offline、unauthorized target |
| M5 IM Integration | Feishu/Lark event/card -> queue -> Hub task/action -> 用户可见状态 | callback 超时、账号未绑定、重复事件、卡片 action 失败 |
| M6 Remote/Cloud Edge | device proof、relay/provisioning、workspace allowlist、target authorization 和 audit 同时成立 | relay 失败、设备身份过期、workspace 拒绝、审计缺失 |
这些验收不要求所有能力一次完成，但每次公开状态升级都必须指向对应证据。只完成 UI 不能提升后端状态；只完成 API 也不能提升用户可见状态。
功能状态
| 能力 | 状态 | 说明 |
|---|---|---|
| 公开官网 | 已上线 | 产品定位、docs、SEO、llms.txt |
| 文档系统 | 已上线，继续扩展 | 双语 MDX、sidebar、search、TOC、metadata |
| TokenDance ID 入口 | 已接入官网个性化 | 不是 Hub API 授权 |
| Desktop preview | 可预览 | 本地验证界面 |
| Local Edge | 本地链路可预览 | 需要 workspace allowlist 和 runtime profile |
| Runtime adapter | 契约已定 | 公开第三方 SDK 包尚未稳定 |
| Hub Server | 进行中 | 管理 project、device、session、routing、audit |
| Web workbench | 进行中 | Hub-backed 协作界面 |
| Feishu/Lark | 开发中 | 协作入口，不是产品登录 |
| Remote/Cloud Edge | 开发中 | 尚不是稳定公开功能 |
尚未稳定
不要把以下能力写成已经可用：
- Feishu/Lark 生产事件入口、异步队列、卡片 schema 和绑定流；
- Remote/Cloud Edge provisioning 和 device proof；
- 完整 Web + Hub + Edge 生产级 E2E 路由；
- Contacts、Docs、Tasks、Projects、Settings 等数据库驱动 workbench 页面；
- 公开第三方 Adapter SDK 包和提交流程。
文档策略
文档状态词需要精确：
- 已上线：公开站点或用户可见 surface 已发布。
- 可预览：可以按文档在本地运行，并有验证步骤。
- 契约已定：实现方向清楚，但公开 SDK/import path 未稳定。
- 进行中：已有实现，但未达到发布状态。
- 开发中：规划或进行中，不承诺可用。
能力状态推进时，在同一个 PR 里更新所属 docs 页面与搜索索引；如路由变化，同步 sitemap/llms；并更新 changelog。
近期文档重点
当前文档优先级不是增加更多空页面，而是把现有页面补成可执行手册：
- 让 Quickstart、Installation、Desktop、Run Lifecycle 和 Adapters 能共同跑通本地预览链路。
- 让 Hub/Web、Collaboration、Feishu/Lark 明确说明哪些是开发中能力，以及缺什么证据。
- 让 API、错误码、event envelope、approval gate 和 secret 边界可以被实现者复用。
- 让 Design System、Visual QA、Release Checklist 和 Deployment 形成发布闭环。
- 让 FAQ、Troubleshooting 和 Product Status 能回答公开用户最常见的“现在到底能不能用”。
证据节奏
状态更新使用绝对日期。有效的路线图更新要说明变了什么、验证了什么，以及还缺什么证据才能写更强的公开说法。避免使用“最近”“马上”这类相对时间，因为公开文档会很快过期。
Issue、PR 或 release note 推荐带这些字段：
| 字段 | 示例形状 |
|---|---|
| Owner | AgentHub Desktop、Edge Server、Hub Server、Integration Gateway |
| Evidence | 测试输出、截图集、event trace、route smoke、API contract check |
| Missing proof | persistence replay、permission denial state、Web routing audit、queue retry |
| Last verified | 2026-06-09 |
| Public wording | 可预览、契约已定、进行中、开发中 |