2026 年 9 月 3 日,Vercel 的 Agent 框架 Eve 发布 0.50.0 版本。这个开源项目在 GitHub 上已有 4.9k stars,被 31,191 个仓库依赖。Eve 的核心设计只有一句话:文件系统就是 Agent 的创作接口——Agent 的每一项能力都放在约定好的目录位置,用普通文件来定义。

Eve 是什么

Eve 是 Vercel 开源的持久化 Agent 构建框架(仓库 vercel/eve),采用 Apache-2.0 许可,当前处于 beta 阶段,适用 Vercel 公开 beta 条款。框架用 TypeScript 编写(占比 96.6%),通过 npm 包 eve 分发,完整文档内置在包内,编码 Agent 可以直接读取 node_modules/eve/docs,无需联网查文档。

一个 Agent 就是一组文件

Eve 里 Agent 项目的结构固定,核心能力都放在 agent/ 目录下:

  • instructions.md:常驻系统提示,必需文件,定义角色与行为基线
  • agent.ts:模型与运行时配置,可选
  • tools/:模型可调用的类型化函数,一个文件一个工具
  • skills/:按需加载的操作过程,用 Markdown 编写
  • channels/:消息渠道接入,支持 HTTP、Slack、Discord
  • schedules/:定时任务,支持周期性的 cron 作业

这套结构把 Agent 的能力配置从代码深处搬到文件表面:检查一个 Agent 能做什么,直接看目录;扩展能力,往对应目录加一个文件。

快速上手

一条命令创建项目:

npx eve@latest init my-agent

命令会创建 my-agent 目录、安装依赖、初始化 Git,并启动交互式终端界面。要指定模型,加 --model 参数,例如 --model openai/gpt-5.6-terra;要给已有项目添加 Eve,直接在项目目录执行 npx eve@latest init .。

生成的项目自带最小示例:在 agent/instructions.md 写一句角色设定,在 agent/tools/get_weather.ts 写一个返回模拟天气的函数,在 agent/agent.ts 选定模型,然后运行 npm run dev,一个能对话的 Agent 就运行起来了。这套骨架已经是一个能工作的 Agent,之后按需加入人工确认、子 Agent 和定时任务。

这个设计解决什么问题

多数 Agent 框架把模型配置、工具注册、提示词分散在代码与配置文件里,项目一复杂就难以检查。Eve 用文件系统做约定:提示词、工具、技能各有固定位置,格式简单,项目变大后依然可以逐文件审查。这也是 filesystem-first 的含义:先有文件,再有行为。

当前状态

Eve 迭代速度很快:截至 0.50.0 已有 171 个 release、1,201 次提交、74 位贡献者,最新提交日期为 2026 年 9 月 3 日。框架仍处于 beta 阶段,API 与行为可能在正式版前调整。

适合谁用

Eve 适合两类人:想快速搭建持久化 Agent 的开发者,一条 npx 命令即可起步;需要团队协作维护 Agent 的团队,因为 Agent 的全部定义就是一组可审查、可纳入版本管理的文件。上手门槛是 Node.js 环境和模型 API 密钥。想了解文件系统优先这个新范式的开发者,直接跑一遍官方快速开始,比读任何介绍都直观。