AI Feeds
开源项目

agent-native

agent-native

开源框架，用于构建 agent 与 UI 深度绑定的原生应用，agent 和 UI 共享同一数据库和状态，支持实时多人协作。亮点在于它让 agent 不再是聊天框里的孤岛，而是能直接操作应用界面、跨 app 联动，并提供多种产品形态（headless、rich chat、whole app）。已内置 A2A、MCP 等协议，可对接 Claude Code、Cursor 等编码 agent，附带 Calendar、Slides 等可 fork 的完整模板，MIT 许可，上手成本低。

README

Agent-Native

你拥有完全所有权的开源 agentic 应用框架

不必在丰富的用户界面和自主 agent 之间做选择。每个 Agent-Native 应用二者兼具。

Agent 与 UI——完全连通

agent 和 UI 是同一系统的平等公民。每个动作都是双向的——点击操作或通过指令实现。

Agents and UIs fully connected

  • 一切同步——Agent 和 UI 共享同一个数据库和状态。任一侧的更改会立即在另一侧显示。
  • 实时多人协作——人类和 agent 同时在同一文档中协作：CRDT 合并、实时存在（光标、选择环、谁在哪个幻灯片上），agent 作为一流的对等编辑器。适用于任何 SQL 数据库和任何主机，包括 serverless。
  • 上下文感知——Agent 知道你在看什么。选中文本，按 Cmd+I，然后告诉它要做什么。
  • 按用户的工作空间——技能、记忆、指令、子 agent 和 MCP 服务器——基于 SQL 存储，每个用户可定制。拥有 Claude-Code 级别的灵活性，SaaS 级别的经济性。
  • Agent 调用 Agent——从任何应用标记另一个 agent。它们通过 A2A 相互发现，并在整个技术栈中采取行动。
  • 可复用的集成——在 Dispatch 中连接一次提供商，将秘密值保存在 vault 中，然后授权 Brain、Analytics、Mail、Dispatch 等应用访问共享的账户元数据和凭证引用。
  • 三种形态——将同一个 agent 构建为无头 API、丰富的聊天体验，或是一个 agent 和 UI 保持同步的完整应用。
  • 自我改进的应用——你的应用会自动变得更好。Agent 可以随时间添加功能、修复错误、完善 UI。
  • 任何数据库，任何主机——任何 Drizzle 支持的 SQL 数据库。任何 Nitro 支持的主机目标。无锁定。
  • 引入你需要的 agent 界面——兼容 MCP 的主机可以调用你的应用，编码 agent 可以安装技能，原生聊天渲染可复用的应用输出，自带的 agent runtime 可以流式传入 Agent-Native 聊天外壳。

用于 agent-native 应用的框架

Agent-Native 是一个开源框架，用于构建能够在真实应用内部行动（而不仅仅是在旁边聊天）的健壮 agent。

它为你提供了产品级 agentic 软件的原语：共享动作、基于 SQL 的状态、身份、工具、技能、任务、可观测性和协同工作的 UI 界面。

后端无关：自带数据库、托管提供商、模型栈和应用代码。

// 一个动作同时驱动 UI、agent、HTTP、MCP、A2A 和 CLI。
export default defineAction({
  schema: z.object({
    emailId: z.string(),
    body: z.string(),
  }),
  run: async ({ emailId, body }) => {
    await db.insert(replies).values({ emailId, body });
  },
});
  • 动作（Actions）——一次性定义工作。在 UI、agent、API、MCP、A2A 和 CLI 中使用。
  • Agent 运行时（Runtime）——聊天、工具、技能、记忆、任务、可观测性和交接一起提供。
  • 后端无关——接入任何 Drizzle 支持的 SQL 数据库和兼容 Nitro 的主机。

一个 agent，三种产品形态

Agent-Native 原语让你可以选择围绕 agent 放置多少 UI，而无需重建 agent 契约：

形态 你交付的内容 底层相同的原语
无头（Headless） 通过代码、CLI、HTTP、MCP 或 A2A 调用 agent 和动作。 defineAction、认证、技能、记忆、任务、可观测性
富聊天（Rich chat） 一个独立或嵌入的聊天，带有原生表格、图表、审批、设置流程和工具结果。 共享聊天运行时、自带运行时适配器、动作声明的原生渲染器
完整应用（Whole app） 一个完整的 SaaS/产品 UI，聊天可以从中心开始，移动到侧边栏，并与应用状态保持同步。 SQL 状态、动作、上下文感知、深度链接、实时同步

协议随框架一同提供，而不是作为每个功能的单独集成。目前这意味着 A2A、MCP、MCP Apps、标准远程 MCP OAuth、MCP 客户端、HTTP/CLI 动作调用、原生聊天组件、AgentChatRuntime 适配器、标准 OpenAI、AG-UI、Claude Agent SDK、Vercel AI SDK 聊天运行时连接器以及深度链接都挂载在同一个动作表面上。ACP 最合适的理解是编码 agent/编辑器互操作性协议，而不是通用的自带应用聊天运行时。

关于完整的决策指南——无头、内置 agent 上富聊天、你自己 agent 上富聊天、嵌入式 sidecar 或完整应用——请参阅 Agent 界面。

要将 Claude、ChatGPT、Codex、Cursor、OpenCode、GitHub Copilot / VS Code 或其他 MCP 主机连接到你的托管应用，请参阅 外部 Agent 指南。

通过一个技能试用

还不想搭整个应用？用一条命令给 Claude Code、Codex、Cursor、Pi、OpenCode、GitHub Copilot / VS Code 以及类似 agent 添加可视化规划和 PR 总结：

npx @agent-native/core@latest skills add visual-plan

你会得到两个斜杠命令，它们能升级你的 agent 规划和工作报告的方式：

  • /visual-plan——在 agent 写代码之前，它打开一个结构化的、可审查的计划文档，而不是一堵文字墙：内联图表、UI 线框和原型、逐文件实现地图，以及你可以评论和批准的注释。
  • /visual-recap——变更落地后，它将 PR 或 git diff 转为高层次的视觉总结：以 grounded before/after 块呈现的 schema、API 和文件变更，附带可分享的审查链接，而不是滚动查看原始 diff。

更多技能和本地安装请参阅 技能指南。

模板

从一个功能完整的模板开始。每个模板都是一个完整、100% 免费且开源的 SaaS 应用——可克隆而非脚手架——除了你拥有代码并且可以自定义一切。

日历

Calendar template

Agent-Native Google Calendar、Calendly

管理事件，与 Google Calendar 同步，并通过 AI 排期共享公开预约页面。

内容

Content template

用于 MDX 的开源 Obsidian

编辑本地 Markdown/MDX 文件，生成丰富的交互式自定义块，并通过 agent 起草、重写或发布。

计划

Plans template

编码 agent 的可视化计划模式

安装 /visual-plan 和 /visual-recap，让你的编码 agent 在构建之前先计划，在变更落地后总结——通过图表、线框、注释和审查链接进行高层级代码审查。

幻灯片

Slides template

Agent-Native Google Slides、Pitch

通过提示或点击生成并编辑基于 React 的演示文稿。

分析

Analytics template

Agent-Native Amplitude、Mixpanel

连接分析数据源，通过提示生成真实图表，构建可复用的仪表板。共享工作空间连接可以提供提供商凭证，而分析仍拥有指标、真相源选择和已保存的分析。

剪辑

Clips template

Agent-Native Loom

录制屏幕并自动生成转录，获得可分享的链接，以及一个能按需总结、添加字幕和编辑剪辑的 agent。

每个模板都是完整可克隆的 SaaS——fork 它，通过 agent 自定义，拥有它。在连接你自己的数据源之前，先用示例数据试用。

在 agent-native.com/templates 查看完整模板库。

快速开始

一条命令即可 fork 模板并开始本地构建。

npx @agent-native/core@latest create my-platform
cd my-platform
pnpm install
pnpm dev

CLI 会显示一个多选选择器，你可以在一个工作空间中包含任意多个模板。选择 Mail + Calendar + Forms，你会获得三个应用，一次就配置好认证并共享。或者浏览 模板库 查看在线演示。

想要单个应用，不要 monorepo？使用 --standalone：

npx @agent-native/core@latest create my-app --standalone --template mail

工作空间（Monorepo）

工作空间是 agent-native 项目的默认形态。每个应用位于 apps/ 下，packages/shared/ 可用于少量的代码、指令、技能或品牌标识，这些应真正应用于每个应用。

my-platform/
├── package.json                   # 声明 `agent-native.workspaceCore`
├── pnpm-workspace.yaml
├── .env                           # 共享密钥：ANTHROPIC_API_KEY、BUILDER_PRIVATE_KEY、A2A_SECRET、...
├── packages/
│   └── shared/                    # 可选共享自定义代码
└── apps/
    ├── mail/
    ├── calendar/
    └── forms/

之后添加另一个应用：

npx @agent-native/core@latest add-app notes --template content

将所有应用部署到同一个源：

npx @agent-native/core@latest deploy
# https://your-agents.com/mail/*       → mail
# https://your-agents.com/calendar/*   → calendar
# https://your-agents.com/forms/*      → forms

同源部署意味着跨应用共享登录会话和零配置跨应用 A2A——从日历的 agent 聊天中标记 @mail 即可工作（无需 JWT 签名，无需 CORS）。完整细节请查看 agent-native.com/docs/multi-app-workspace。

两全其美

SaaS 工具 原始 AI Agent 内部工具 Agent-Native
UI 精致但僵化 无 质量参差不齐 完整 UI，fork 即用
AI 附加功能 强大 连接松散 Agent 优先，集成
可定制性 不能 指令和技能 完整但维护成本高 Agent 会修改应用
所有权 租用 部分属于你 你拥有代码 你拥有代码

社区

加入 Discord 提问、分享你的构建并获得帮助。

文档

完整文档请访问 agent-native.com。

许可证

MIT

开源项目BuilderIO2026-06-19原文

相关内容