状态：Preview（路径指南）。 当前可直接执行的主路径是
@fellow.work/client的 Interaction 能力与 React Web 接入。Mobile App Kit、统一 Host Bridge 为 Experimental；跨端 App Manifest 为 Proposed。
目标与适用场景
本页帮助外部开发者先选择可交付的入口，再进入对应指南。适用于新建智能应用、嵌入现有 Web 产品、连接业务系统，以及把已经验证的流程固化为可安装应用。
Desktop、Web、Mobile 是 Fellow Applications 产品线的官方参考应用和 SDK 验收面，不是 Developer Platform 的组成部分。第三方开发者不需要先采用这些官方应用，才能使用公开 SDK。
路径总览
| 目标 | 当前状态 | 前置条件 | 预计首次跑通 | 交付物 | 连续阅读 |
|---|---|---|---|---|---|
| Node / 服务端智能能力 | Preview | Node.js 20+、Gateway、服务端 fkey_… | 约 30 分钟 | 可创建 Thread、发起 Run、消费事件流的服务 | 快速开始 → Client SDK |
| 嵌入现有 Web / SaaS | Preview | Integration App、后端 token exchange、允许的 Origin | 约 1 小时 | 使用短期 Token 的 React Widget 或自定义界面 | 接入应用 → React App Kit |
| 连接企业数据或工具 | 依具体 Provider 而定 | 目标系统凭证、最小 Scope、明确副作用策略 | 依系统而定 | Connector 配置或 MCP Server | Connectors → MCP |
| 交付可安装的长期 HTTP 应用 | 部分落地 | 可运行 HTTP 应用、目标 Fellow Host | 依应用而定 | HARP runtime.kind: http 应用包 | Applications → HARP |
| 集成统一 Host 能力 | Experimental | 能力目录、授权与 Consent 设计 | 不建议设生产时限 | Host adapter 试验实现 | Host 集成 → AIOS 协议族 |
| 实现 Mobile App Kit 或跨端 Manifest | Experimental / Proposed | 参与接口验证与迁移准备 | 无稳定时限 | 原型或设计反馈 | 应用模型 → Developer Platform |
时间只表示准备条件满足后的首次技术验证，不是生产交付承诺。
推荐决策顺序
- 只需要模型与 Agent 运行结果： 从 headless Client SDK 开始。
- 需要嵌入浏览器产品： 在自己的后端保管
fkey_…，交换短期用户 Token，再使用 React 接入。 - 需要读取或写回外部系统： 评估 Connector 或 MCP；为写操作定义确认、幂等和审计。
- 需要脱离会话长期运行的专用 UI： 评估 HARP 当前已实现的 HTTP Runtime 子集。
- 需要文件、窗口、剪贴板等设备能力： 先做宿主侧能力设计和显式授权，不假定统一 Host Bridge 已稳定。
当前可执行路径
服务端或 Node
安装 @fellow.work/client，创建 Client、Thread 和 Run，并持续消费 SSE 事件直到终态。不要把只收到一段文本当作完整链路验证；还应处理错误、取消和资源释放。
浏览器与 React
在 Console 创建 Integration App，由你的后端使用 fkey_… 换取短期 access_token。浏览器只接收短期 Token，再挂载 @fellow.work/client/react 提供的组件。生产 Origin 必须与 allowed_origins 一致。
Mobile 与自定义 Host
目前没有可在本页承诺的稳定 Mobile App Kit、统一 Host Bridge 或 App Manifest API。可执行做法是：
- 复用已公开的 Interaction 契约和后端鉴权模式；
- 把平台相关能力封装在你自己的 adapter 后面；
- 对每项宿主能力做显式检测、默认拒绝和用户确认；
- 在稳定契约发布前，不把原型接口固化为公共兼容承诺。
边界
@fellow.work/client覆盖 Interaction 的 Thread、Run、SSE 与 Consent，不覆盖全部 AIOS 管理 API。- Desktop、Web、Mobile 是官方应用案例，不代表第三方可用能力清单。
- “Build once”指复用领域逻辑、公开协议和能力声明，不表示各端 UI 与设备能力无需适配。
- HARP 当前只部分实现 HTTP Runtime；规范目标不等于所有 Host 已完整支持。
- Proposed 能力仅用于设计讨论，不应进入生产计划或安装指引。