Developer Docs

文档首页
概述选择开发路径SDK Quickstart核心概念示例与官方应用案例

开发文档

Fellow Developer Platform

Fellow SDK Platform 的产品边界、当前能力、跨端开发路径与 SDK-first 原则。

Fellow Developer Platform 是构建、调试、测试、发布和维护智能应用的开发工具族。它不是单个 npm 包，也不把 AIOS 的所有协议合并成一个万能 SDK。

产品组成

层职责当前状态
Core Clients按协议职责消费稳定 wire@fellow.work/client 已覆盖 Interaction 的 Thread / Run / SSE / Consent
App KitsReact、Mobile、Host Bridge、App ManifestReact 接入已落地；其余按路线逐步交付
Developer ToolsCLI、模板、模拟 Gateway、调试器、fixtures、conformance部分能力处于规划或建设阶段
Delivery Tools构建、签名、兼容检查、Registry、发布与观测规划阶段

当前可用路径

  1. 通过 选择开发路径确认应用形态，再按 SDK Quickstart创建 Thread、发起 Run 并消费事件流。
  2. 通过 Integration App 建立应用身份与浏览器短期凭证。
  3. 使用 React App Kit或嵌入指南在 Web 应用中集成组件或 Headless Client。
  4. 使用 Connectors、MCP和 Skills接入业务能力。
  5. 将适合长期运行的成果封装为 HARP 应用。

SDK-first 原则

  • Desktop、Web、Mobile 与第三方应用使用同一公开协议和 SDK/adapter。
  • 官方产品不得依赖第三方不可获得的 Gateway 私有接口。
  • 每项新能力至少由一个官方应用端完成集成验收。
  • 平台能力差异通过 discovery 和明确错误表达，不按包版本或平台名称猜测。
  • Proposed、Experimental、Preview、Stable 必须明确区分。

跨端应用模型

同一智能应用应复用领域逻辑、协议契约和能力声明，端侧只实现必要的 UI 与 Host adapter：

应用领域逻辑 + App Manifest
          │
      Fellow SDK
          │
Desktop / Web / Mobile / 客户宿主
          │
 AIOS Gateway / Runtime / Console

当前稳定接入面以 Interaction Core Client 为主。App Manifest、统一 Host/Runtime adapter 和完整跨端 capability discovery 仍按产品路线推进，不应在生产设计中假定已经全部可用。

下一步