核心概念 · 开发文档 · Fellow

状态：Preview（概念指南）。 Interaction 的 Thread、Run、事件流与 Consent 可通过 Client SDK 使用。Host 与 Runtime 协议为 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 概念（Preview）

概念	定义	生命周期位置	当前入口
Application	使用 Fellow 公开 SDK 或协议构建、面向最终用户交付的智能应用	发起并呈现整个交互	应用模型
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 能力管理兼容风险。

边界

概念存在不代表对应 API 已发布。
包版本不能替代协议版本或 Host 能力发现。
Object 与 Control 协议仍为 Proposed，不属于当前可执行路径。
Mobile、Host Bridge 与统一 App Manifest 未稳定，不应写入生产兼容承诺。