Eve
概述
Eve 是 Vercel 于 2026 年发布的开源、文件系统优先（filesystem-first）智能体框架（公开预览阶段）。许多框架主要通过代码来定义智能体，而 Eve 的做法截然不同——它通过智能体目录根路径下的单一 instructions.md 文件来定义智能体：智能体的行为、语气和操作流程均写在纯 Markdown 中，而支撑能力（工具、子智能体、评测）则由周围的文件系统结构自动发现，无需手动注册。项目托管于 github.com/vercel/eve。
核心概念 / 架构 / 特性
- 文件系统优先的智能体定义：智能体即目录；
instructions.md 是其系统提示词与操作契约，无需任何代码入口点来描述智能体行为。
- 自动注册工具：放入智能体
tools/ 目录的任何工具，运行时均可自动发现并暴露给智能体，无需手动注册步骤。
- 持久化执行（Durable execution）：智能体运行过程会进行检查点（checkpoint），使长时间运行或多步骤任务在中断后可从断点恢复，而无需从头重启。
- 沙箱计算：工具执行默认运行于隔离的计算环境，将智能体驱动的代码执行与宿主进程分离。
- 审批（Approvals）：针对敏感或不可逆工具调用的内置人在回路（HITL）门控，可按工具粒度配置。
- 频道（Channels）：将智能体暴露到不同交互界面（如聊天、API）的连接层，无需改动智能体的核心定义。
- 链路追踪与评测：作为框架一等公民内置，而非通过第三方 SDK 外挂——每次运行均生成追踪记录，评测可与智能体并存定义，用于回归测试行为变化。
优势
- 倾向于以基础设施即代码（infrastructure-as-code）近似的文件化方式定义、版本化智能体行为的团队（
instructions.md + 目录约定便于在 Pull Request 中执行 diff 与审查）
- 需要持久化、可恢复执行，且不想额外搭建编排层的工作流
- 要求开箱即用的沙箱工具执行和人工审批门控，而非依赖外部插件的场景
局限
- 公开预览：项目较新，API 接口在稳定版发布前可能发生变化
- Vercel 生态亲和性：工具链与部署约定在 Vercel 托管环境下最为完善，尽管框架本身开源且支持自托管
- 文件系统约定绑定：Markdown + 目录的约定是一种强主张；习惯代码优先智能体定义（如 LangGraph 或 CrewAI）的团队需要适应不同的思维模型
与其他框架的对比
| 维度 |
Eve |
Flue |
LangChain / LangGraph |
CrewAI |
| 智能体定义 |
instructions.md + 文件系统 |
TypeScript 智能体文件 |
Python / TypeScript 代码 |
Python 代码（角色/crew） |
| 工具注册 |
从 tools/ 自动发现 |
显式 harness 配置 |
显式绑定 |
显式绑定 |
| 持久化执行 |
内置检查点 |
通过 Cloudflare Durable Objects / 自定义存储 |
通过 LangGraph store |
有限支持 |
| 沙箱计算 |
内置 |
虚拟（just-bash）+ 容器（Daytona） |
无 |
无 |
| 审批（HITL） |
内置 |
非一等公民 |
插件/自定义 |
非一等公民 |
| 成熟度 |
公开预览 |
实验性（约 3.8K stars） |
生产级 |
生产级 |
| 许可证 |
开源 |
Apache-2.0 |
MIT |
MIT |
最佳实践
| 挑战 / 场景 |
描述 |
解决方案 / 建议 |
| 指令蔓延 |
随着智能体职责扩大，单一 instructions.md 变得难以维护 |
保持指令聚焦；将不同职责拆分为子智能体，而非堆入一个庞大的指令文件 |
| 工具发现带来的意外 |
自动注册意味着任何放入 tools/ 的文件都会变成可调用工具 |
像审查显式工具注册一样，在代码审查中检查 tools/ 目录 |
| 审批疲劳 |
对过多工具调用设置审批门控会拖慢迭代速度 |
将审批保留给真正不可逆或敏感的操作；让只读或可逆工具无人值守运行 |
| 评测被当成事后补丁 |
因框架不强制要求，团队往往跳过评测编写 |
从第一天起就将评测定义视为智能体目录的一部分，与 instructions.md 并列管理 |
参见
参考资料