all-in-rag 菜谱知识库实战:英式司康(Scone)详细制作指南
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 知识库的运行原理。从源码看,文档入库的完整链路如下:
- 加载:
DataPreparationModule.load_documents()会递归扫描data/C8/cook下的所有.md文件(见 data_preparation.py),并对每个文件生成基于相对路径的确定性 MD5parent_id,同时按路径与星号规则增强 category、dish_name、difficulty 元数据; - 分块:
chunk_documents()使用MarkdownHeaderTextSplitter按#/##/###标题层级进行结构感知分块(见 data_preparation.py),并保留标题(strip_headers=False)。因此本文档会被拆分为「菜名(#)」「必备原料和工具(##)」「计算(##)」「操作(##)」「附加内容(##)」等多个子块,每个子块继承父文档的parent_id,形成父子映射; - 索引:
IndexConstructionModule使用BAAI/bge-small-zh-v1.5嵌入模型将子块向量化并构建 FAISS 索引(见 index_construction.py); - 检索:
RetrievalOptimizationModule通过向量检索 + BM25 的混合检索与 RRF 重排召回相关子块(见 retrieval_optimization.py),随后经get_parent_documents()依据parent_id还原出完整的父文档(即整份菜谱),保证 LLM 拿到的上下文是完整的「英式司康.md」内容; - 生成:
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 系统中的组织方式,这份文档都是一份可以直接上手、可以直接引用的参考。
