all-in-rag 菜谱知识库实战:英式司康(Scone)详细制作指南

原创2026-09-22 14:50:051,348 阅读
文章标签:教程人工智能大模型RAGEmbedding向量数据库提示工程本地部署

all-in-rag 菜谱知识库实战:英式司康(Scone)详细制作指南

本篇以 all-in-rag 项目 C8 章节「尝尝咸淡 RAG 系统」内置菜谱数据 data/C8/cook/dishes/dessert/英式司康/英式司康.md 为骨架,完整讲解这道快手下午茶点心的用料配比、制作流程与关键技巧,同时结合仓库中 code/C8 的源码(数据准备、分块、检索与生成模块)说明这类结构化 Markdown 菜谱在 RAG 知识库中是如何被解析、索引与检索的。读完本篇,你既能按配方独立做出蛋奶香气浓郁的司康,也能理解它在当前项目菜谱知识库中的结构化形态。

英式司康成品

英式司康(Scone)是非常简单快手的下午茶甜品,可以搭配果酱、茶与咖啡。成品以蛋奶香气为主轴风味,糖量适中不会过于甜腻。在 all-in-rag 的菜谱知识库中,它被归类为「甜品(dessert)」分类,难度标记为三颗星(★★★),对应仓库源码中的难度等级「中等」。

一、这道菜谱在项目知识库中的位置与角色

英式司康的菜谱文件位于仓库的菜谱知识库数据目录中,具体路径为 data/C8/cook/dishes/dessert/英式司康/英式司康.md。该目录是 C8 章节「RAG 系统实战」所构建的「尝尝咸淡」菜谱知识库的一部分,同目录下还包含菜品成品图片 英式司康.png。

从仓库源码 code/C8/rag_modules/data_preparation.py 的元数据增强逻辑可以看出,系统会依据文件路径自动为每道菜谱打上结构化标签:

  • 分类(category):从目录层级中的 dessert 映射为「甜品」。仓库中 CATEGORY_MAPPING 定义了完整映射关系,例如 meat_dish → 荤菜、vegetable_dish → 素菜、soup → 汤品、dessert → 甜品等;
  • 菜名(dish_name):取自文件名主干,即「英式司康」;
  • 难度(difficulty):通过正则 re.search(r'★+', content) 匹配正文中的星号数量映射为难度等级,其中 {5: '非常困难', 4: '困难', 3: '中等', 2: '简单', 1: '非常简单'}。本文档标注的 ★★★ 即对应「中等」。

也就是说,这份菜谱不仅是一份可执行的配方,还是 RAG 系统可直接检索、过滤、问答的数据样本——用户可以通过「推荐一道甜品」或「英式司康怎么做」等自然语言问题命中它。

二、必备原料与工具

制作英式司康需要以下原料与工具:

原料清单

  • 无盐黄油(推荐品牌总统,风味更佳)
  • 低筋面粉
  • 糖
  • 盐
  • 泡打粉
  • 鸡蛋
  • 淡奶油
  • 奶油奶酪(可选)

工具提示

  • 烤箱(用于烘烤)
  • 干净容器若干(混合干料、蛋奶液)
  • 擀面杖与案板(用于擀制面片)
  • 刀或模具(用于分切形状)
  • 刷子(用于在表面刷蛋液)

三、份量计算:一份的精确配比

每次制作前需要确定计划做几份。一份正好够 4-6 个人吃,适合作为下午茶分享或家庭聚会点心。

每份的完整用料配比如下:

原料 用量
无盐黄油 40g
低筋面粉 180g
糖 30g
盐 1g
泡打粉 5g
鸡蛋 1 个(约 50g)
淡奶油 45g
奶油奶酪 50g

需要注意的是,鸡蛋虽然按 1 个(约 50g)计量,但在实际操作中会将蛋液拆分为两部分使用:30g 用于混合面团,剩余约 20g 用于刷表面。因此备料时务必保证鸡蛋总量充足。

四、制作步骤详解

第 1 步:调制蛋奶混合液

将鸡蛋打散,称量出 30g 蛋液放入干净容器中,倒入全量淡奶油(45g)和奶油奶酪(50g),混合均匀。

技巧提示:如果奶油奶酪较硬难以混合,可以水浴加热至大约 40 度后再与其他液体混合,这样更容易搅拌顺滑。

第 2 步:混合干性原料

将低筋面粉(180g)、盐(1g)、糖(30g)、泡打粉(5g)放入另一个干净容器中,充分混合均匀。泡打粉要与其他粉类搅拌均匀,避免局部集中导致成品蓬松不均。

第 3 步:搓入黄油

将黄油切成小块,放入干性混合物中,用手将黄油捏入混合物中,直至呈现粗玉米粉质地。这一步是司康松软口感的关键——黄油颗粒越均匀,烘烤时形成的层次越明显。注意全程尽量保持黄油低温,避免过度揉捏导致黄油融化。

第 4 步:混合成团

将第一步调好的蛋奶混合液倒入上一步得到的粉油混合物中,搅拌接近均匀后,叠压成均匀面团。这里强调的是「叠压」而非「揉面」,过度揉搓会激活面粉筋性,使司康变硬、失去松软口感。

第 5 步:擀片与分切

将面团放到案板上,擀成 1.5cm 厚的面片,用刀或者模具分切成合适的形状。

第 6 步:刷蛋液

用刷子蘸取剩余的 20g 蛋液,均匀刷在司康表面。蛋液能让成品烘烤后呈现漂亮的焦糖色泽。

第 7 步:烘烤

烤箱预热 180 度,烤制 27 分钟。烤至表面金黄、内部熟透即可出炉,趁温热食用风味最佳。

五、附加技巧:最省事的造型方案

最简单的分切方案是:擀成圆形面皮,用刀切成 6 个扇形。这样既不需要额外购置模具,又能保证大小均匀、形状规整,是家庭制作的推荐做法。

六、从菜谱到 RAG 检索:这份文档在系统里的完整链路

理解这份菜谱的数据形态,有助于理解整个 C8 知识库的运行原理。从源码看,文档入库的完整链路如下:

  1. 加载:DataPreparationModule.load_documents() 会递归扫描 data/C8/cook 下的所有 .md 文件(见 data_preparation.py),并对每个文件生成基于相对路径的确定性 MD5 parent_id,同时按路径与星号规则增强 category、dish_name、difficulty 元数据;
  2. 分块:chunk_documents() 使用 MarkdownHeaderTextSplitter 按 # / ## / ### 标题层级进行结构感知分块(见 data_preparation.py),并保留标题(strip_headers=False)。因此本文档会被拆分为「菜名(#)」「必备原料和工具(##)」「计算(##)」「操作(##)」「附加内容(##)」等多个子块,每个子块继承父文档的 parent_id,形成父子映射;
  3. 索引:IndexConstructionModule 使用 BAAI/bge-small-zh-v1.5 嵌入模型将子块向量化并构建 FAISS 索引(见 index_construction.py);
  4. 检索:RetrievalOptimizationModule 通过向量检索 + BM25 的混合检索与 RRF 重排召回相关子块(见 retrieval_optimization.py),随后经 get_parent_documents() 依据 parent_id 还原出完整的父文档(即整份菜谱),保证 LLM 拿到的上下文是完整的「英式司康.md」内容;
  5. 生成:GenerationIntegrationModule 依据查询路由(list / detail / general)选择回答模式。若用户问「英式司康怎么做」,路由为 detail,将走分步骤指导提示词(见 generation_integration.py),输出的回答结构正是本菜谱文档结构的延伸。

因此,本篇展示的这份 Markdown 菜谱,本身就是 RAG 全流程(数据准备 → 分块 → 索引 → 检索 → 生成)可直接落地的输入样例。相关配置(数据路径、嵌入模型、top_k、温度等)均可在 code/C8/config.py 中查看与修改。

七、常见问题排查

  • 司康口感偏硬:多为面团揉搓过度或黄油融化,注意叠压成团、保持黄油低温;
  • 表面不上色:检查刷蛋液是否均匀、烤箱是否真正预热到 180 度;
  • 内部不熟/外部过焦:不同烤箱温控存在差异,可适当降低温度并延长烤制时间,以表面金黄为准。

八、总结

英式司康是一道用料简单、步骤清晰、容错率高的入门级西点。本文从原料配比、操作细节到技巧提示,完整呈现了 data/C8/cook/dishes/dessert/英式司康/英式司康.md 的全部内容,并结合 all-in-rag 的 C8 源码解释了这份结构化菜谱在 RAG 知识库中从加载、分块、索引到检索生成的全过程。无论你是想按方做一份下午茶点心,还是希望理解菜谱数据在 RAG 系统中的组织方式,这份文档都是一份可以直接上手、可以直接引用的参考。

登录后查看全文
all-in-rag