Astravia
开发者

07 / 开发者

选择开发与集成路径

根据宿主边界选择插件、主题、SDK、RPC 或 CLI，避免为简单需求引入过重集成。

READ / 带走

  1. 先选最窄、最稳定的入口
  2. 提示词不是插件，外部工具不是桌面扩展
  3. 跨包只走公开 exports

Astravia 提供从内容能力到完整宿主集成的多层扩展面。先根据目标选择最窄、最稳定的入口，再阅读对应合同。

Astravia 插件工作台同时展示移动预览和电子表格预览
插件可以进入工作区、文件和消息界面；SDK 与 RPC 则用于在自己的宿主中运行 Agent。

入口选择

SKILL

技能

让 Agent 遵循领域流程。运行边界是 Markdown 指令和可选脚本。

MCP

连接器

连接外部工具或数据。运行边界是 STDIO 或 HTTP 工具服务。

PLUGIN

插件

扩展 Astravia 桌面 UI 和 Agent。运行边界是插件宿主与权限模型。

THEME

主题

改变桌面视觉和主题页面。运行边界是受策展管理的主题模块。

SDK

进程内 SDK

在 TypeScript 进程中嵌入 Agent。同进程、类型化 Session API。

RPC

子进程 RPC

从非 TS 宿主或隔离进程驱动 Agent。stdin/stdout NDJSON。

CLI

命令行

从脚本执行一次任务。独立命令进程，text / json 输出。

决策原则

  1. 只有提示和步骤时使用 Skill，不要创建插件。
  2. 只需要外部工具协议时使用 MCP，不要依赖桌面内部实现。
  3. 需要 Astravia UI、文件预览、消息卡片或宿主动作时使用 Plugin。
  4. 自己拥有进程生命周期且使用 TypeScript 时优先 SDK。
  5. 需要语言无关、故障隔离或 sidecar 时使用 RPC。

主题模块能力参考

理解 appearance、component、region、page、runtime、host hook 和主题存储的职责边界。

使用 Coding Agent SDK

在 TypeScript 进程内创建 Agent 会话、订阅事件、发送任务并正确关闭资源。

本页内容

入口选择决策原则