AppKit

AppKit 是 AgentOS 里几乎所有应用接入的起点。
它负责 app bundle 注册、Bearer token 获取，以及事件订阅能力。

它解决什么问题

对于开发者来说，AppKit 主要解决三件事：

• 标识“当前是谁在接入 AgentOS”
• 给当前 app 发放访问其他模块所需的 Bearer token
• 建立 app 级别的 SSE 事件订阅

什么时候你一定会碰到 AppKit

• 你要注册 app bundle
• 你要获取 apiKey / Bearer token
• 你要访问 modelkit、agentkit、ragkit、cronkit、authkit、discoverykit、transferkit 等需要鉴权的模块
• 你要接收 welcome、callApp 等 App 级事件

核心能力

Bundle 注册

注册入口通常是：

• SDK：sdk.agentos.registerBundle(...)
• HTTP：POST /appkit/register

注册后会返回：

• bundleId
• appGroupId
• token

其中 token 就是后续访问受保护模块时使用的 Bearer token。

Token 与鉴权

很多开发者第一次接入时最关心的是：apiKey 从哪里来？

在 AgentOS 里，它通常来自 AppKit 注册结果：

• OpenAI 兼容接入里的 apiKey = registerBundle 返回的 token
• 直接访问 agentkit / ragkit / cronkit / toolkit / authkit / discoverykit / transferkit 时，也需要这个 Bearer token

SSE 订阅

AppKit 还提供应用级 SSE 订阅，用于接收：

• welcome
• callApp
• 连接状态变化

如果你的应用需要后台通知、宿主协作或系统事件桥接，这部分就很关键。

适合什么场景

• 任何需要正式注册成 AgentOS app 的客户端
• 需要统一 token 管理的应用
• 需要 app 级事件订阅的应用

不适合把它当成什么

AppKit 不是：

• 聊天模型调用层
• Agent 编排层
• RAG 服务层
• 定时任务层

它更像所有这些能力的“接入入口”。

下一步看什么

• 如果你要直接调用模型：看 ModelKit
• 如果你要让平台帮你组 Agent：看 AgentKit
• 如果你要做知识库：看 RagKit
• 如果你要做定时任务：看 CronKit
• 如果你要获取用户身份授权：看 AuthKit
• 如果你要发现附近设备：看 DiscoveryKit
• 如果你要跨设备传文件：看 TransferKit