安装
npx eve@latest init my-agent适合谁
这份技能适合想用「文件系统优先」方式搭持久化 AI 代理的人:核心能力放在约定位置,项目更容易检查、扩展和运行。它也适合准备在本机新建一个代理目录、并能接受官方初始化命令副作用的人。
它不适合只想在对话里临时试一句、却不想在磁盘上新建项目的人。官方起步命令会创建目录、安装依赖、初始化 Git,并启动交互式终端界面。若你还不能运行 npx,或不能接受这些写入与界面启动,先停在阅读说明,不要执行初始化。
官方仓库见 https://github.com/vercel/eve 请只按该页已写出的命令操作。当前处于测试阶段,行为可能变化。
3 分钟完成第一次尝试
只走官方写出的这一条起步路径。
前置条件:本机可以运行 npx,当前工作目录允许新建文件夹,并且你明确同意一次本地初始化。先确认:执行后会新建 my-agent 目录、安装依赖、初始化 Git,并启动交互式终端界面。若你还不想写磁盘或打开该界面,不要运行下面的命令。
安装位置:在你准备放新项目的目录打开终端,确认上述副作用后执行:
npx eve@latest init my-agent
低风险核对:命令结束后,不要急着改业务逻辑。先在新目录里打开 instructions.md,核对该文件是否存在,以及注释是否仍写着它是必需的、始终生效的系统提示。这是只读检查。
成功信号:出现名为 my-agent 的新目录,依赖已经装上,Git 已初始化,交互式终端界面被拉起,并且能看到必需的 instructions.md。若目录没出现或该文件缺失,不要自行补其他安装器,回到官方页面核对命令原文。
使用案例
案例一:从零搭一个可检查的代理项目。官方命令 npx eve@latest init my-agent 会创建 my-agent 目录、安装依赖、初始化 Git,并启动交互式终端界面。适合想先有一份约定目录结构、再往里放能力的人。动手前先确认当前目录没有同名文件夹;若原文没有写出如何跳过界面或跳过 Git,就不要假设存在这类开关。
案例二:检查并理解始终生效的系统提示。原文给出的典型结构里,instructions.md 被标成必需,并且是始终生效的系统提示。适合初始化完成后、先只读打开该文件、确认代理默认指令放在哪里的人。文件系统优先意味着你用普通文件就能检查;原文没有写出其他提示文件的必填关系时,不要自行补全目录职责。
使用边界
eve 目前处于测试阶段,并受 Vercel 测试条款约束,接口与行为可能变化。条款页是 https://vercel.com/docs/release-phases/public-beta-agreement 请以该页为准。
起步命令只有一条被原文写出:npx eve@latest init my-agent。不要编造未出现的安装器。该命令会写目录、装依赖、初始化 Git 并打开终端界面,因此不适合只想做纯说明核对、却拒绝任何本地写入的场景。
原文把 eve 写成文件系统优先的持久化 AI 代理框架,核心能力放在约定位置。它没有列出可用客户端名单,也没有写出如何接到未点名的编程助手。instructions.md 被标为必需的系统提示,但完整目录树、部署方式和密钥配置原文没有展开,不要补。