项目基本信息
| 属性 | 值 |
|---|---|
| Owner/Repo | BuilderIO/agent-native |
| 总⭐ | 6,048★ |
| 今日新增 | 607⭐（爆发型） |
| Fork | 551 |
| 语言 | TypeScript |
| 协议 | MIT |
| 主页 | agent-native.com |
核心定位
一句话描述: 一个 TypeScript 框架，用于构建「Agent工作 + 专用UI」深度融合的 agentic apps。
传统开发中，coding agents 有工具、文件、测试、预览等多模态上下文，但知识工作类 agents（知识管理、内容创作、数据分析等）往往只有一个文本框。
agent-native 的核心理念：为每个 capability 定义一次 action，这个 action 同时作为 Agent工具和 UI 代码调用的入口，实现「同一套逻辑、多端复用」。
核心技术架构
1. 统一 Action Layer（核心创新）
// actions/hello.ts
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 }) => {
return { message: `Hello, ${name}!` };
},
});设计精髓：
- 一次定义，七端生效：UI调用 / Agent工具 / HTTP / MCP / A2A / CLI — 同一action，覆盖所有 surface
- 类型安全：Zod schema 驱动验证，类型贯穿前后端
- 权限控制：统一认证和权限层
2. 共享数据层
Work done by the agent appears in the UI, and work done in the UI is available to the agent.
- PostgreSQL 生产级后端 + PGlite 本地开发（兼容 Nitro 任意 host）
- UI 和 Agent 读写同一数据库，无数据孤岛
3. 共享应用状态
Agent 接收相关 UI 状态（当前页面、选中记录、活动视图），实现真正的 context awareness，而非盲目操作。
4. 内置 App Gallery（开箱即用）
| App | 用途 |
|---|---|
| Clips | 会议/屏幕/语音录制与理解 |
| Design | 品牌设计生成与迭代 |
| Slides | 品牌演示文稿创建编辑 |
| Analytics | 数据问答与仪表盘 |
| Calendar | 时间查找与日程管理 |
| 邮件优先级排序与回复起草 | |
| Assets | 品牌媒体资产管理 |
| Content | 内容草稿、组织与发布 |
| Plans | 可视化计划（图表/线框图/原型） |
与 OpenClaw 的潜在协同
agent-native 的 action 驱动架构与 OpenClaw 的 Skills 体系有相似的设计哲学：
- Skills = OpenClaw 的能力单元（定义工具和执行逻辑）
- Actions = agent-native 的能力单元（同构地暴露给 Agent 和 UI）
可借鉴点：
- 同构 action 暴露：Skills 同时暴露给 Agent tool call 和 human-facing UI/API，无需两套实现
- PostgreSQL 持久化：OpenClaw 可考虑为 memory 模块引入 PG-backed storage
- 品牌 App Gallery：OpenClaw 未来可构建垂直场景的 App Gallery（电商、数据分析、内容创作等）
适用场景
- 需要人类监督的自动化工作流（人类在环审批）
- 多 Agent 协作空间（团队共享 workspace）
- 垂直领域 Copilot（金融、法律、医疗等需要强类型和数据隔离的场景）
- 需要 UI 可视化的 Agent 应用（不是纯 CLI）
可借鉴之处
- 同构设计思维：
能力只定义一次，在 Agent tool / UI / API / CLI 多端无差别复用。这与 OpenClaw Skills 的设计理念高度一致，可作为 Skills v2 接口标准化的参考。 - PostgreSQL 作为 Agent 工作空间：
结构化数据 + 向量检索结合，agent-native 用 PG 同时做事务存储和工作空间，适合电商场景的订单/库存/客服 Agent。 - 品牌 UI Layer：
每个 App 都有统一的设计系统brand coating，说明 agentic apps 的 UX 不是事后再补，而是架构一开始就设计进去。
阅读量：
95