components/ 定义"有哪些能力接口"。回忆 Day 01——这里只有接口，实现在 eino-ext。组件类别常量在 components/types.go:66：

每个组件子目录都有相同的四个文件——记住这个规律，读任何组件都一样：

components/model/interface.go。泛型基座 BaseModel[M]（:36）就两个方法——正好对应 Day 03 的"非流"和"流"：

type BaseModel[M messageType] interface {
    Generate(ctx, input []M, opts ...Option) (M, error)                    // 阻塞，返回完整响应
    Stream(ctx, input []M, opts ...Option) (*schema.StreamReader[M], error) // 返回流
}
type BaseChatModel = BaseModel[*schema.Message]   // :71 最常用的别名

工具绑定有两个版本（重要区别）：

• ChatModel（:80，已废弃）：BindTools() 原地修改实例——并发不安全。
• ToolCallingChatModel（:99，推荐）：WithTools() 返回新实例——可安全共享一个 base model 派生多个带不同工具集的变体。

components/tool/interface.go。工具接口分层——按“要不要执行、要不要流式、要不要多模态”逐级加：

// 朴素想法：一个接口，能拿描述、能执行，齐活
type Tool interface {
    Info() ToolInfo            // 我是什么
    Run(args string) string    // 执行
}

type BaseTool interface {          // :32 只告诉模型"我是什么"
    Info(ctx) (*schema.ToolInfo, error)   // 返回工具描述（Day 03 的 ToolInfo）
}
type InvokableTool interface {     // :42 加"同步执行"
    BaseTool
    InvokableRun(ctx, argumentsInJSON string, opts) (string, error)  // 入参JSON字符串→出参字符串
}
type StreamableTool interface {    // :53 加"流式执行"
    BaseTool
    StreamableRun(...) (*schema.StreamReader[string], error)
}
// 还有 EnhancedInvokableTool / EnhancedStreamableTool（:67/:76）：多模态版，出参可含图片/音视频

components/prompt/interface.go:43：

type ChatTemplate interface {
    Format(ctx, vs map[string]any, opts) ([]*schema.Message, error)  // 变量 map → 消息列表
}

它把"模板 + 变量"渲染成消息列表（复用 Day 03 讲的 Message.Format + 三种模板语法）。默认实现 DefaultChatTemplate 配 FromMessages + MessagesPlaceholder 构造。在编排里通常排在 ChatModel 之前——先拼提示词，再喂给模型。

RAG（检索增强生成）= 调模型前先从知识库检索相关资料塞进提示词。Eino 用三个组件配合：

RAG 建库前的“数据准备”阶段（components/document/）：

• Loader（interface.go:43）：Load(ctx, src Source) ([]*Document, error)——从文件/URL 读原始内容成 Document。
• Transformer（interface.go:53）：Transform(ctx, src []*Document) ([]*Document, error)——切分/过滤/合并/重排（约定保留并合并已有 MetaData）。
• Parser（parser/interface.go:34）：Parse(ctx, reader) ([]*Document, error)——把原始字节按格式解析成 Document（通常配在 Loader 上，不直接调）。

你翻遍 components/ 也找不到"真能调 OpenAI 的代码"——因为实现全在 eino-ext。核心框架里每个组件目录只有接口 + 选项 + 回调结构。

还有两个横切接口（types.go）：Typer.GetType()（给组件起可读类型名，可视化调试用）、Checker.IsCallbacksEnabled()（组件声明"我自己管回调，框架别自动包"，Day 16 用）。

✋ 动手：对着真实接口读一遍

# 1. ChatModel 接口（L03）
sed -n '36,110p' components/model/interface.go

# 2. Tool 四层接口（L04）
sed -n '32,80p' components/tool/interface.go

# 3. RAG 三件套（L06）
sed -n '37,50p' components/embedding/interface.go
sed -n '38,50p' components/indexer/interface.go
sed -n '48,52p' components/retriever/interface.go

# 4. 组件类别常量 + 横切接口（L01/L08）
sed -n '29,90p' components/types.go