上下文工程 · 第 5 章 检索式上下文

上下文工程 · 第 5 章 检索式上下文

章节摘要：记忆讲"沉淀下来反复使用"，素材相反——总量最大、增长最快、时效最短的四成分（1.2 节），它的供给哲学是四个字：按需供给。Anthropic 称之为 just-in-time 检索：与其把整份文档预装进窗口，不如在需要的那一刻取回相关的片段（官方）。5.1 讲两种按需供给形态：通用场景的 RAG（按查询取片段）与编码场景的 repo map（先给一张常驻的仓库地图，再按需读具体文件）——并算清按需对预装的账：预装付的是每轮全价重付的复利成本（1.1 节），按需付的是一跳检索延迟与检索质量风险，供给决策是权衡不是信仰。5.2 讲取回之后的四件事：选（k 由预算倒推、去重、分数阈值）、摆（与 2.2 节位置效应联动——最相关片段放首尾）、标（编号 + 来源 + 时间戳）、约束（输出契约要求引用编号、空检索有兜底，防捏造）。检索与重排的实现纵深由《语义代码检索》第 5、6 章承担，本章管决策层。

学习目标

阅读完本章，你应当能够：

1. 算清"预装整份文档"与"按需取片段"两本账，为一类任务做供给决策。
2. 说出 RAG 的三条供给纪律与 repo map 的"地图而非领土"原理。
3. 用预算倒推确定单轮检索的 k，并执行去重与阈值过滤。
4. 按"最相关放首尾、中部装低熵"组装一组检索片段。
5. 写出防捏造的引用契约（编号真实存在、可机器校验、空检索兜底）。
6. 说明素材区与指令区的权威性差异，以及注入风险的工程缓解。

核心概念速览

（文字流程图）
J ──▶ "RAG（5.1）·查询 → 检索 top-k → 注入"
J ──▶ "repo map（5.1）·常驻地图 + 按需读取文件"
"RAG（5.1）·查询 → 检索 top-k → 注入" ──▶ "组装四件事（5.2）·选（预算倒推）· 摆（位置效应）·标（编号+来源）· 约束（引用契约）"
"repo map（5.1）·常驻地图 + 按需读取文件" ──▶ "组装四件事（5.2）·选（预算倒推）· 摆（位置效应）·标（编号+来源）· 约束（引用契约）"
​

一句话金句：素材的正确姿势是"用时才取、用完即走"——预装整本手册是仓库思维，按需取两页才是预算思维。

💡 本章与第 4 章是动态层的两翼：记忆求"沉淀"，素材求"新鲜"；跨会话记忆越攒越值钱，检索片段却在下一轮就该被驱逐（4.1 节口诀：库里的是记忆，窗口里的是素材）。两章共用 2.1 节的预算表——素材通常拿最大份额，也最容易失控。

子章节导航

5.1 RAG 与 repo map：按需供给

预装 vs 按需的两本账；RAG 的供给纪律；repo map 与 agentic 检索；按需供给的代价与兜底。
本节回答"素材从哪来、什么时候来"。

5.2 片段组装与引用约束

片段选择（k 倒推、去重、阈值）；组装顺序与位置效应联动；片段格式化；引用契约防捏造；注入风险的工程缓解。
本节回答"取回来的片段怎么变成能答题的上下文"。

子章节之间的逻辑关系

5.1 按需供给（进什么：RAG / repo map 两种取材形态）
   │  片段到手了，问"怎么变成能答题的窗口" ↓
5.2 组装与约束（怎么摆：选 · 摆 · 标 · 约束 四件事）
   │  动态层的供给齐全了 ↓
第 6 章 压缩与可观测（装不下时的重构，与出事后的定位）
​

5.1 管进货，5.2 管上架——先决定取什么、何时取，再决定摆哪里、怎么标、怎么约束。两节合成素材成分的完整供给链；链路的出口（组装顺序）直接复用 2.2 节的位置推论，是全书"装配 = 分配 × 驱逐 × 排序"公式在素材上的落地。

前置知识与后续延伸

前置知识：1.1 节注意力稀释与"塞满不等于用好"（按需供给的动机）；1.2 节素材行的属性（时效最短、用完即逐）；2.1 节预算表（素材配额倒推 k）；2.2 节位置效应（组装顺序的理论依据）。

为后续奠定基础：5.2 的引用契约是 3.1 节"输出契约可校验"在素材场景的深化；本章的素材供给是 7.2 节客服案例预算表里最大一行（素材约 45%）；检索质量的评测与索引工程不在本书范围，深潜见《语义代码检索》——第 5 章讲重排（本章"摆"的实现层），第 6 章讲 repo map 与 agentic 检索（本章 5.1 的实现层），均为纯文字互引。