准备环境Eve 当前要求 Node.js 24 或更高版本。先确认版本node -v如果低于 24可以用nvm切换nvm install 24 nvm use 24还需要准备一个 Vercel AI Gateway API Key。第一篇先走全套 Vercel 方案不处理自定义 OpenAI-Compatible Provider。模型切换、自定义 base URL、API key 和上下文窗口预算会放到下一篇展开。用eve init创建项目进入系列仓库的样例目录cd example执行npx evelatest init 01-first-agenteve init会做几件事创建01-first-agent/目录写入最小 Agent 文件安装依赖生成内置 Eve channel初始化本地开发所需配置。创建完成后进入项目cd 01-first-agent本文最终整理后的核心结构大致是example/01-first-agent/ package.json tsconfig.json .env.example agent/ agent.ts instructions.md channels/ eve.ts这里最值得先记住的是agent/目录。Eve 的设计是一个目录就是一个 Agent 的 authored surface。模型配置、系统提示词、工具、技能、子 Agent、渠道、定时任务都会逐步放在这个目录下面。先看package.jsoneve init会写好常用脚本{ scripts: { build: eve build, dev: eve dev, start: eve start, typecheck: tsc } }这一篇主要用两个命令npm run dev npm exec -- eve infonpm run dev会启动 Eve 本地开发 TUI也就是我们用来聊天的 CLI 界面。eve info不启动聊天界面只检查 Eve 是否正确发现了项目里的 Agent 文件。后续目录越来越多时这个命令会很有用。配置第一个 Agent打开agent/agent.ts改成下面这样import { defineAgent } from eve; const defaultGatewayModelId minimax/minimax-m3; export default defineAgent({ model: process.env.EVE_GATEWAY_MODEL_ID ?? defaultGatewayModelId, modelContextWindowTokens: 200_000, });defineAgent是 Agent 的运行配置入口。这里先只做两件事第一指定模型。字符串形式的模型 ID 会通过 Vercel AI Gateway 路由。为了方便调整我们允许用环境变量EVE_GATEWAY_MODEL_ID覆盖默认模型。第二显式写了modelContextWindowTokens。这是一个很现实的 beta 细节如果 Eve 当前还没有拿到某个 Gateway 模型的上下文窗口元数据构建时可能会提示无法编译 compaction 配置。显式声明上下文窗口可以让样例先稳定跑起来。正式项目里这个值应该按所选模型的真实上下文窗口调整。下一篇接入自定义 Provider 时我们会把模型配置、上下文窗口、token 预算和失败边界一起讲清楚。编写 instructions接下来改agent/instructions.md。它是 Agent 的 always-on system prompt。Eve 会把这份内容放进每一轮模型调用里所以它适合写稳定身份、长期规则和行为边界不适合塞一整套临时工作流程。这一篇先写一个很小的 SpringForAll 内容运营助手# SpringForAll Content Assistant You are the first content operations assistant for the SpringForAll community. Your mission is to help maintain a Chinese technical community for Java and Spring developers. ## Responsibilities - Explain what you can do for SpringForAll content operations. - Help brainstorm Java, Spring, Spring AI, Spring Cloud, JVM, backend engineering, and developer tooling topics. - Turn vague topic ideas into practical article angles, outlines, and follow-up questions. - Keep answers practical and useful for engineers. - Ask for human confirmation before treating any content as publish-ready. ## Current limits - You do not have skills yet. - You do not have subagents yet. - You do not have custom tools yet. - You do not publish content automatically. - You should not claim to have checked live sources unless the user provides them in the conversation. ## Output style - Write in concise Chinese by default. - Use Markdown when structure helps.我会刻意在早期 instructions 里写清楚限制。这不是给 Agent 降能力而是让它知道当前阶段的边界它现在只是一个基础聊天 Agent还没有搜索工具、内容工作流、审稿 checklist也没有自动发布能力。如果一开始就让它表现得像完整内容团队后面加 skills、subagents 和 sandbox 时读者反而看不清每一步到底解决了什么问题。