eino/
├── schema/        # Day 03：Message、StreamReader、Document
├── components/    # Day 04：各组件接口（model/tool/prompt/retriever...）
├── compose/       # Day 06-10：编排引擎（chain/graph/workflow/runnable/channel）
├── adk/           # Day 11-14：智能体套件（agent/runner/session/chatmodel）
├── flow/          # Day 15：现成 Agent（agent/react）
├── callbacks/     # Day 16：回调系统
└── internal/      # 内部实现（generic/callbacks/...）
# 实现在另一个仓库：eino-ext/（Day 19）

go test ./...                    # 跑所有测试
go test ./compose/...            # 只跑编排引擎的测试
go test -run TestChain ./compose # 跑名字含 TestChain 的
go test -race ./compose/...      # ★ 带竞态检测（流式/并发多，强烈建议）
go test -cover ./...             # 看覆盖率

测试 Agent 逻辑时不想真调 OpenAI（慢、花钱、不稳定）。做法：自己实现一个假的 ChatModel——它满足 Day 04 接口，返回你预设的响应：

type fakeModel struct{ reply *schema.Message }
func (f *fakeModel) Generate(ctx, msgs []*schema.Message, _ ...) (*schema.Message, error) {
    return f.reply, nil          // 直接返回预设回答，不调任何 API
}
func (f *fakeModel) Stream(...) (*schema.StreamReader[*schema.Message], error) { ... }
func (f *fakeModel) WithTools(...) (model.ToolCallingChatModel, error) { return f, nil }
// 测试里把 fakeModel 塞进 Agent，验证编排逻辑对不对

• 挂日志回调（Day 16）：给每个节点的 OnStart/OnEnd 打印输入输出，看数据在图里怎么流、哪一步变形了。这是排查编排问题的第一手段。
• 看 Compile 报错（Day 09/18）：类型对不上、节点连接非法，Compile 就报错，仔细读错误信息里的节点名和类型。
• 先用 Invoke 再上 Stream：调试逻辑时先用非流式 Invoke（拿完整结果好断点），逻辑对了再换 Stream。
• MaxSteps 报错：如果报 ErrExceedMaxSteps，多半是模型陷入循环——检查工具是否总是"没给模型想要的结果"导致它反复调。

• 选模型：从 eino-ext 拿一个 ChatModel（Day 19），配好 APIKey
• 写工具：用 InferTool 把业务函数变成 Tool（Day 04/19）
• 写系统提示词 Instruction（定 Agent 的角色和行为准则）
• 建 Agent：NewChatModelAgent 组装模型+工具+提示（Day 12）
• 需要多 Agent？用 Agent-as-Tool 组 Supervisor（Day 13）
• 有敏感操作？在工具里加 Interrupt，配持久化 CheckPointStore（Day 14）
• 挂可观测：日志/监控/追踪 callback（Day 16）
• 用 Runner.Query 驱动，for 循环消费事件流（Day 11）
• 写测试：用 fakeModel mock，go test -race（本日）

• 流读了两次 / 忘了 Copy（Day 17）：StreamReader 只能消费一次，多方要读先 Copy，用完 defer Close。
• 一个非流节点冻结全链（Day 06/17）：链路里插了个"只要完整值"的节点，流式优势就断在那——尽量让流贯通到最后。
• 类型对不上（Day 18）：相邻节点上游 O ≠ 下游 I，Compile 报错，检查类型参数。
• 死循环 MaxSteps（Day 09）：设合理上限，且保证工具能真正推进对话。
• State 并发（Day 09）：跨节点共享状态一定用 ProcessState（内部加锁），别自己裸读写。
• 中断没持久化（Day 14）：生产环境 CheckPoint 必须存 Redis/DB，存内存重启就丢。

单步走查：一句"北京今天天气如何？"是怎么穿过这四条主线的（跟踪一个具体输入走到尾）：

🚀 下一步建议

• 动手写：照 L05 清单，用 eino-ext 搭一个你自己的小 Agent（比如"查天气+发邮件"助手）。
• 读 examples：Eino 官方 examples 仓库有大量完整示例，现在你都能看懂了。
• 读 *_test.go：每个测试都是活的用法文档。
• 横向对比：接下来本系列还会讲 OpenHands、CrewAI、LangGraph 等——对比它们和 Eino 的设计异同，你会理解得更深。