状态：概念指南。 Interaction Stable（≥ 0.6.0）；Control / Object / Case / Runtime Stable opt-in（≥ 0.6.1 / 0.6.3 / 0.6.4 / 0.6.5）；Host 为 Experimental；统一 App Manifest 为 Proposed。
目标与适用场景
本页面向第一次接入 Fellow 的外部开发者，用一条运行链路解释常用名词。读完后，你应能判断某项职责属于应用、SDK、Gateway、Runtime、Host，还是外部能力提供方。
一条最小链路
Application
│ @fellow.work/client
▼
Thread → Run → StreamEvent → 结果 / Consent
│
▼
Gateway → Runtime / Sandbox → Connector / MCP / Host当前可执行的起点是 Client SDK。图中的组件表示职责，不表示所有模块都已经有稳定、独立的公共 API。
Interaction 概念（Stable 子集）
| 概念 | 定义 | 生命周期位置 | 当前入口 |
|---|---|---|---|
| Application | 面向最终用户的软件：智能体应用用公开 SDK 构建；宿主应用按 HARP 安装 | 发起并呈现交互，或作为已安装产品独立运行 | 接入应用 · 应用模型 |
| Thread | 承载连续交互上下文的线程 | 在一个或多个 Run 之前创建 | client.createThread |
| Run | 在 Thread 中执行一次任务的运行单元 | 由输入开始，以成功、取消或错误等终态结束 | client.run |
| Event | Run 期间按流产生的增量事实 | 从 SSE 持续消费，客户端负责渲染与状态处理 | events 异步迭代器 |
| Consent | 对需要人工确认的动作进行批准或拒绝 | Run 暂停或等待监督时处理 | Client SDK 的 Consent 方法 |
Fellow StreamEvent SSE 是当前原生 wire；AG-UI 是界面语义 adapter，不替代原生 wire。应用应消费完整事件流，并处理终态、错误与可能的重复事件，而不是只拼接文本片段。
执行与宿主概念
| 概念 | 状态 | 定义与边界 |
|---|---|---|
| Gateway | 当前运行链路入口 | 负责认证、Thread / Run 请求和事件流入口；不等同于端侧 Host |
| Runtime | Experimental | 执行 Run、作业、沙箱 workload 或 HARP 生命周期的职责层；Client SDK 不直接包装其全部管理能力 |
| Sandbox | 依部署实现 | 隔离执行工作负载的环境；不能替代 Host 对用户设备能力的授权 |
| Host | Experimental | 提供文件、窗口、通知、剪贴板等宿主能力的一方；能力应默认拒绝并显式授权 |
| Host Bridge | Experimental | 应用与 Host 能力之间的 adapter 方向；当前不应假定存在统一稳定 API |
| App Manifest | Proposed | 描述跨端应用身份、入口和能力需求的目标抽象；尚不能作为已稳定的打包契约使用 |
不要把 HARP 的 harp.json 与 Proposed 的统一 App Manifest 混为一谈。前者是 HARP 包的清单；后者是 Developer Platform 的跨端路线能力。
扩展与应用形态
| 概念 | 定义 | 不是什么 |
|---|---|---|
| Connector | Fellow 对外部系统的受治理连接能力 | 不代表所有 Provider 都有相同成熟度 |
| MCP Server | 通过 MCP 向 Agent 暴露工具或数据的服务 | 不是可安装终端用户应用 |
| Skill | 告诉 Agent 如何完成一类任务的说明与资源 | 不是运行时，也不是长期应用进程 |
| HARP | 宿主应用的包与 Runtime ABI 约定；协议名，不是货架名 | 不等于 MCP Server、对话内 Widget，也不等于接入应用 |
HARP 当前产品实现覆盖 runtime.kind: http 的部分能力。规范中的预留 Runtime、Host API 和完整隔离要求不等于当前全部实现。
产品、协议与包名
- Fellow Developer Platform 是产品族：Core Clients、App Kits、Developer Tools 与 Delivery Tools。
- AIOS Protocol Suite 是按 Interaction、Host、Runtime 等职责拆分的协议族。
@fellow.work/client是 Interaction 在 TypeScript、Web、Node 环境中的参考实现，不是全部平台 API。- Desktop、Web、Mobile 属于 Applications，是官方参考应用和 SDK-first 验收面，不是 Developer Platform。
当前开发步骤
- 先用 快速开始建立 Client。
- 创建 Thread，并在其中发起 Run。
- 持续消费事件流，显式处理错误、取消与 Consent。
- 需要浏览器 UI 时，再接入 React App Kit。
- 只有确实需要设备能力时，才评估 Host 集成，并按 Experimental 能力管理兼容风险。
- 需要 workload 或 Case 时，在确认 Gateway 宣告
runtime.v1/case.v1后，阅读 Runtime 与 Case 并按 opt-in 环境试用。
边界
- 概念存在不代表对应 API 已发布或已 Stable。
- 包版本不能替代协议版本或 Host 能力发现；opt-in 协议必须核对
Fellow-Gateway-Capabilities。 - Case / Runtime 为 Stable wire 但 仍须 对应 capability 开关；均非默认 Interaction 路径。
- Mobile、Host Bridge 与统一 App Manifest 未稳定，不应写入生产兼容承诺。