搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

vercel/eve

开发工具

一个以文件系统为编排入口的 TypeScript 框架,用目录结构定义 AI Agent 的指令、工具、技能、渠道和定时任务。

5,970
665
TypeScript
Apache-2.0
创建于 5 个月前

项目介绍

eve 是 Vercel 推出的、以文件系统为首要编排入口的持久化 AI Agent 框架。它把 Agent 的核心能力放在固定目录里,而不是塞进复杂配置:agent/ 下的 instructions.md 是常驻系统提示词,agent.ts 可选地配置模型和运行时,tools/ 存放模型可调用的带类型函数,skills/ 存放按需加载的流程说明,channels/ 接入 HTTP、Slack、Discord 等消息渠道,schedules/ 定义周期性 cron 任务。这样的结构让项目更容易被检查、扩展和运维。

它面向希望用代码和 Markdown 定义 Agent、先在本地跑通、之后直接部署的 TypeScript/JavaScript 开发者。模型通过 AI Gateway 的模型 ID 指定。

快速使用

用 CLI 新建 Agent:

npx eve@latest init my-agent

该命令会创建 my-agent 目录、安装依赖、初始化 Git,并启动交互式终端界面。脚手架默认使用 openai/gpt-6-luna-fast 和高推理强度,可通过 --model 换模型,用 --reasoning 显式设置推理强度。要接入已有项目,在该项目目录执行 npx eve@latest init .。

生成的 agent/instructions.md 即系统提示词。工具是一个 TypeScript 文件,导出 defineTool,包含描述、Zod 输入 schema 和 execute 函数,例如返回 { city, condition: "Sunny", temperatureF: 72 } 的模拟 get_weather.ts。模型在 agent/agent.ts 中通过 defineAgent({ model, reasoning }) 设置。修改完成后执行 npm run dev 即可启动 Agent。

要添加网页聊天,先运行 npx eve link,再运行 npx eve add channel/web,选择托管布局并用 Vercel 登录,为项目团队成员开通认证;准备发布时运行 npx eve deploy。本地开发不需要浏览器登录。权限和恢复流程见 Web Chat 配置指南。

使用约束

框架基于 TypeScript,CLI 初始化会创建项目、安装依赖并初始化 Git;Agent 需按文档给出的 agent/ 目录结构组织,不能随意改名。网页聊天和部署流程依赖关联 Vercel 项目并为团队成员做认证,因此该渠道与 Vercel 绑定,并非独立方案。npm 包内自带文档(node_modules/eve/docs),便于编程 Agent 在本地查阅。

项目采用 Apache-2.0 许可证。安全问题应按 SECURITY.md 私下报告,不要开公开 issue;贡献流程见 CONTRIBUTING.md 和 GitHub Discussions。

HotRepo 点评

在 2026-11-18 的 TypeScript 日榜上,eve 记录为 5,958 星、665 fork,当日新增 38 星,在该榜的最好名次是第 15。这只是单次快照,能说明当天的榜单位置,不能据此判断趋势。对读者的实际意义在于:它的价值来自明确的 agent/ 目录约定,以及从 npx eve@latest init 到跑起一个 Agent 的短路径,而不是抽象的「框架」定位;已经在用 Vercel 的团队集成最顺,想避开 Vercel 的团队则需先权衡部署和网页聊天的绑定关系。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. cordiverse/cordis一个用 TypeScript 编写、面向运行时插件组合与依赖注入的元框架,适合构建可动态替换插件的 Node.js 应用。TypeScript9,687
  2. vercel/ai用一套 TypeScript API 调用多家大模型,并把模型接入前端界面和智能体。TypeScript27,500
  3. vuejs/vue渐进式 JavaScript 前端框架,用于构建用户界面;Vue 2 已停止维护。TypeScript212,509
  4. mastra-ai/mastra面向 TypeScript 开发者的 AI 应用与 Agent 框架,内置模型路由、工作流、记忆、RAG、评测与可观测性。TypeScript29,561