源码解析 on 苏连云的博客

eve 中文教程 · 第 29 章 world：检查点存在哪、怎么恢复

Fri, 23 Oct 2026 09:10:00 +0800

一句话结论：world 是 eve 对 workflow 引擎的存储抽象。安装时做三件事：校验版本兼容、包一层 stranded 保护、启动。部署交接时最危险的不是崩溃，是新版本重放旧版本留下的 run。

Fri, 23 Oct 2026 09:09:00 +0800

一句话结论：auth 不是中间件，是一个按顺序试的函数数组。全部返回空才 401，抛错则按错误里带的 Response 拒绝。

Fri, 23 Oct 2026 09:08:00 +0800

一句话结论：defineChannel 把「路由表 + adapter + 事件处理器」打成一个带哨兵的对象。平台通道不特殊，只是路由更多、事件处理器更厚、状态更复杂。

Fri, 23 Oct 2026 09:07:00 +0800

一句话结论：eveChannel() 返回的不是一个 handler，是一张 23 条路由的表加一层统一的鉴权包装。其中 12 条给调用方用，11 条是内部回调和兼容路径。

Fri, 23 Oct 2026 09:06:00 +0800

一句话结论：eve 不用 AI SDK 的自动循环。每次模型调用是一个 step，工具执行完就结束，下一轮模型调用是新 step。这就是「每步一次模型调用」的全部含义。

Fri, 23 Oct 2026 09:05:00 +0800

一句话结论：step 不是「函数调用」，是「检查点边界」。step 内的代码在崩溃恢复时会重跑，step 之间的不会。这是 eve 里唯一必须记住的语义。

Fri, 23 Oct 2026 09:04:00 +0800

一句话结论：编译产物是名词，runtime 负责把名词变成动词——给每个声明挂回真实的函数。挂不回去的，就是运行时错误。

Fri, 23 Oct 2026 09:03:00 +0800

一句话结论：编译不是「把文件转成另一种格式」，是四层候选按优先级合并——赢家写进产物，输家记作 shadowed。你的 tools/bash.ts 能覆盖框架默认工具，靠的就是这张优先级表。

Fri, 23 Oct 2026 09:02:00 +0800

一句话结论：文件名不是「约定」，是一张精确的分类表加一组正则。文件没被识别，九成是撞了表里的某一条——而且失败方式是静默的。

Fri, 23 Oct 2026 09:01:00 +0800

一句话结论：eve 不是薄封装。它在进 commander 之前先检查 Node 版本、按需重编译自己；eve dev 会 fork 一个 detached 子进程跑服务器，然后用 IPC 而不是信号管理这个子进程的生死。

Fri, 23 Oct 2026 09:00:00 +0800

一句话结论：eve 的代码按「执行时机」分层，不按功能分层。找代码先问「这段什么时候跑」，比按目录翻快十倍。