https://tangxusc.github.io/categories/eve/ Recent content in eve on 苏连云的博客 Hugo -- gohugo.io en-us Thu, 22 Oct 2026 10:00:00 +0800 https://tangxusc.github.io/2026/10/eve-tutorial/ Thu, 22 Oct 2026 10:00:00 +0800 https://tangxusc.github.io/2026/10/eve-tutorial/ <p>这套教程是 <a href="https://eve.dev">eve</a> 的中文教程，只有文档，没有可执行代码。18 章正文加 3 个附录，从 <code>eve init</code> 讲到上线。</p> https://tangxusc.github.io/2026/10/eve-appendix-c-env-and-secrets/ Thu, 22 Oct 2026 09:21:00 +0800 https://tangxusc.github.io/2026/10/eve-appendix-c-env-and-secrets/ <blockquote> <p><code>process.env</code> 只在<strong>应用运行时</strong>存在且可信。它会在三个地方骗你：编译期就被读掉、沙箱里根本没有、浏览器里根本不存在。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-appendix-b-events-and-cli/ Thu, 22 Oct 2026 09:20:00 +0800 https://tangxusc.github.io/2026/10/eve-appendix-b-events-and-cli/ 完整事件表、CLI 命令、HTTP 路由。写客户端、排查事件流、核对某个字段时对着这张表看。 https://tangxusc.github.io/2026/10/eve-appendix-a-glossary/ Thu, 22 Oct 2026 09:19:00 +0800 https://tangxusc.github.io/2026/10/eve-appendix-a-glossary/ 概念对照、目录速查、常见错误码。读不懂某个词、找不到某个文件、看到一个陌生状态码时先查这里。 https://tangxusc.github.io/2026/10/eve-18-advanced-and-production/ Thu, 22 Oct 2026 09:18:00 +0800 https://tangxusc.github.io/2026/10/eve-18-advanced-and-production/ <blockquote> <p>这一章把散落在前面的进阶能力收在一起，然后给一份能逐条打勾的上线清单。清单比概念重要。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-17-frontend-and-deploy/ Thu, 22 Oct 2026 09:17:00 +0800 https://tangxusc.github.io/2026/10/eve-17-frontend-and-deploy/ <blockquote> <p>前端只需要一个 hook；部署只需要两条命令——但鉴权和模型凭据必须自己配，因为默认策略在生产环境一律拒绝。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-16-evals/ Thu, 22 Oct 2026 09:16:00 +0800 https://tangxusc.github.io/2026/10/eve-16-evals/ <blockquote> <p>评测用真实会话跑 agent 并打分。它跑的是用户会打到的同一套 HTTP 接口，所以一个通过的评测意味着「agent 启动了、接受了请求、给出了你断言的结果」。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-15-schedules-and-hooks/ Thu, 22 Oct 2026 09:15:00 +0800 https://tangxusc.github.io/2026/10/eve-15-schedules-and-hooks/ <blockquote> <p>定时任务让 agent 自己开工，钩子让你在 agent 干活时旁观并记录。前者是「主动」，后者是「被动」，两者都不经过用户消息。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-14-channels/ Thu, 22 Oct 2026 09:14:00 +0800 https://tangxusc.github.io/2026/10/eve-14-channels/ <blockquote> <p>通道决定 agent 在哪里和用户见面，也决定「谁在说话」。同一份 agent 代码可以同时挂到 HTTP、Slack、Discord、Telegram。这一章讲默认 HTTP 通道的鉴权，以及怎么接 Slack、写自定义通道。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-13-connections/ Thu, 22 Oct 2026 09:13:00 +0800 https://tangxusc.github.io/2026/10/eve-13-connections/ <blockquote> <p>连接把外部服务的能力交给模型，但不把 URL 和 token 交给模型。模型用 <code>eve__search</code> 找到工具，用 <code>eve__tool</code> 调用，凭据由 eve 在应用侧注入。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-12-subagents/ Thu, 22 Oct 2026 09:12:00 +0800 https://tangxusc.github.io/2026/10/eve-12-subagents/ <blockquote> <p>子代理是「另一个上下文里的 agent」。它的工作历史不会污染主对话，只把结论回传。三种形态：内置的根副本、声明的专家、远程部署。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-11-human-in-the-loop/ Thu, 22 Oct 2026 09:11:00 +0800 https://tangxusc.github.io/2026/10/eve-11-human-in-the-loop/ <blockquote> <p>两种停顿：工具要人批准（approval），模型要人回答（question）。两者共用同一套「暂停 → 停泊 → 恢复」协议，turn 不会断，<code>turnId</code> 不变。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-10-durability/ Thu, 22 Oct 2026 09:10:00 +0800 https://tangxusc.github.io/2026/10/eve-10-durability/ <blockquote> <p>一次 turn 可能跑几分钟，进程会重启，部署会滚动，人可能隔三天才点「批准」。eve 的答案是：把 turn 切成可提交的边界，每个边界落盘，恢复时从最后一个边界继续。这一章讲清楚切在哪、落什么、什么会重跑、以及为什么这些设计不能反过来。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-09-sessions-and-streaming/ Thu, 22 Oct 2026 09:09:00 +0800 https://tangxusc.github.io/2026/10/eve-09-sessions-and-streaming/ <blockquote> <p>每个 eve 应用都暴露同一套 HTTP API：建会话、发消息、看事件流、取消、清空、压缩、重置。这一章讲清协议本身，以及怎么用 TypeScript 客户端而不是手搓 POST。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-08-state-and-memory/ Thu, 22 Oct 2026 09:08:00 +0800 https://tangxusc.github.io/2026/10/eve-08-state-and-memory/ <blockquote> <p><code>defineState</code> 是<strong>会话内</strong>的工作数据，模型看不见，会话结束就没了。memory 槽是<strong>跨会话</strong>的事实，每轮自动召回，模型看得见。选错不是丢数据，就是泄漏数据。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-07-skills/ Thu, 22 Oct 2026 09:07:00 +0800 https://tangxusc.github.io/2026/10/eve-07-skills/ <blockquote> <p>技能是按需加载的 Markdown 流程。平时只占一行描述，模型需要时才把全文拉进上下文。它不增加任何执行能力——只增加「怎么做」。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-06-context-control/ Thu, 22 Oct 2026 09:06:00 +0800 https://tangxusc.github.io/2026/10/eve-06-context-control/ <blockquote> <p>agent 的行为问题和账单问题，八成出在上下文。这一章讲清楚什么内容该放哪一层、什么时候该压缩、怎么设上限。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-05-sandbox/ Thu, 22 Oct 2026 09:05:00 +0800 https://tangxusc.github.io/2026/10/eve-05-sandbox/ <blockquote> <p>每个 agent 有且只有一个沙箱，根目录是 <code>/workspace</code>。模型能在这里跑命令、读写文件，但看不到你的任何密钥。这一章讲怎么配置它、怎么用它、以及什么情况下它并不安全。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-04-tools/ Thu, 22 Oct 2026 09:04:00 +0800 https://tangxusc.github.io/2026/10/eve-04-tools/ <blockquote> <p>工具是 eve 里唯一能执行你自己代码的原语。文件名是工具名，<code>inputSchema</code> 是接口契约，<code>execute</code> 是你自己的代码。这一章把 <code>defineTool</code> 的每个字段讲透。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-03-project-anatomy/ Thu, 22 Oct 2026 09:03:00 +0800 https://tangxusc.github.io/2026/10/eve-03-project-anatomy/ <blockquote> <p>路径决定名字，文件名决定能力。这一章把 <code>agent/</code> 下每个槽位的语义、命名规则、覆盖机制讲清楚。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-02-hello-agent/ Thu, 22 Oct 2026 09:02:00 +0800 https://tangxusc.github.io/2026/10/eve-02-hello-agent/ <blockquote> <p>一条命令建项目，一个 Markdown 文件定义人格，一个 <code>npm run dev</code> 开始对话。本章结束时你会有一个能回答问题的值班助手。</p> </blockquote> https://tangxusc.github.io/2026/10/eve-01-what-is-eve/ Thu, 22 Oct 2026 09:01:00 +0800 https://tangxusc.github.io/2026/10/eve-01-what-is-eve/ <blockquote> <p>eve 是一个「文件系统即配置」的 agent 框架。你写能力，它跑循环；你声明文件，它负责持久化、沙箱、审批和多渠道。</p> </blockquote>