一、项目是什么Agent-Native 是 Builder.io 在 GitHub 上开源的一套 TypeScript 框架仓库定位是A framework for building agentic apps。它的目标不是再做一个单纯的 LLM 调用库而是构建“Agent 自主工作、配套 UI 展示和编辑、双方共享同一套业务能力”的应用。Agent 不需要通过截图、点击和操作 DOM 来调用自己的应用而是和 UI 一样调用同一个 action 层。项目地址https://github.com/BuilderIO/agent-native编程语言TypeScript许可证MIT文档站https://agent-native.com/docs二、核心设计三个 shared2.1 Shared actions共享动作每个业务能力都用defineAction定义一次。Agent 通过工具调用触发UI 通过 React Hook如useActionQuery触发HTTP、MCP、A2A 和 CLI 也能复用同一个实现。校验、权限和运行逻辑只维护一份。import { defineAction } from agent-native/core/action; import { z } from zod; export default defineAction({ description: Return a friendly greeting., schema: z.object({ name: z.string().default(world).describe(Name to greet), }), http: { method: GET }, run: async ({ name }) ({ message: Hello, ${name}! }), });2.2 Shared data共享数据Agent 写入的内容会出现在 UIUI 写入的内容也对 Agent 可见。README 明确提到生产环境可使用 PostgreSQL本地开发可以使用 PGlite。2.3 Shared application state共享应用状态Agent 在执行任务时可以获得当前页面、选中记录和当前视图等 UI 上下文避免它不了解用户正在处理什么。三、快速开始官方 README 给出的创建命令是npx --yes agent-native/corelatest create my-agent --standalone --template chat这条命令用于创建最小项目。实际接入业务时还需要按文档准备模型服务、数据库、外部工具、权限策略与部署环境。四、开源 Agent 示例README 展示了 9 类可以研究或二次开发的开源 Agent示例场景Clips会议、屏幕与语音记录Design生成和精修交互式设计Slides生成和编辑演示文稿Analytics自然语言问数与看板Calendar日程安排与预订Mail邮件优先级、草稿与跟进Assets品牌素材管理Content内容起草、整理与发布Plans图、线框与原型方案这些项目展示了“Agent UI”组合的实际场景但不能理解为所有业务都能不经配置直接上线。五、数据与基础设施数据库README 明确提到生产环境使用 PostgreSQL本地开发可使用 PGlite。LLM、SQL 数据库、工具与部署基础设施由使用者自行选择和维护。Action 可以同时暴露给 UI、Agent、HTTP、MCP、A2A 和 CLI但具体权限策略仍需应用自己设计。六、使用边界与注意事项它不会自动保证 Agent 安全授权、提示词注入防护和敏感操作审计仍需自行设计。它不是低代码平台复杂业务仍然需要编写 TypeScript。它不能替代威胁建模、专业安全测试、合规审查和上线流程。它更关注 Agent 与 UI 的整体应用框架不应简单理解为替代所有 LLM 编排工具。七、我是怎样发现这个项目的我是在整理 GitHub Trending 榜单时看到BuilderIO/agent-native的。核验时中文日榜页面把它列在第 1 位不过页面标注的数据时间是 9 月 22 日 08:00所以排名只适合作为发现线索。我参与整理了一个 GitHub Trending 中文阅读页页面提供每日、每周和每月榜单并集中展示项目简介、中文解读、语言、Stars、Forks 和周期新增 Stars。它适合先发现项目再回到 GitHub 深入阅读。这里也需要说明热度不等于质量中文解读不能替代 README、源码、Issues、Release 与许可证判断。八、相关链接项目仓库https://github.com/BuilderIO/agent-native官方文档https://agent-native.com/docsGitHub 中文热榜GitHub 今日热门项目排行榜 - github中文热榜