Harness 工程 · 第 7 章 上下文工程

Harness 工程 · 第 7 章 上下文工程

章节摘要：3.3 节立了供料的骨架（五层清单、三板斧、assemble_context 策略函数），本章把它长成完整的器官。7.1 讲窗口预算与优先级分配：窗口是零和游戏——常驻层（系统提示、工具 schema）先扣，输出预留 20% 不能动，剩下的按优先级在动态层间分配；优先级的工程形态是驱逐顺序（谁先丢）：陈旧工具结果最先丢，任务目标、当前计划与红线约束打上 pinned 标记永不丢。7.2 讲压缩与摘要：水位线触发（软压缩 / 硬截断两档），丢什么保什么有清单，摘要不是"缩写"而是重构成结构化任务简报——并诚实交代压缩的风险（灾难性遗忘、二次压缩漂移）。7.3 讲分层记忆：会话内（messages + 引用化）、跨会话（项目约定、会话存档、用户偏好）、知识库（检索式外存）三层各自的介质、读写时机与失效方式。本章是"同一个模型，供料好坏差出档位"（社区共识）这句话的工程兑现。

学习目标

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

1. 为一类具体任务写出窗口预算表与驱逐顺序。
2. 说出 pinned 清单里必须有哪些东西、为什么。
3. 设计水位线触发的水压缩流程与结构化任务简报。
4. 列出压缩的三个风险及对应缓解。
5. 画出三层记忆的介质 / 写入 / 读取 / 失效对照表。
6. 判断一个团队"该不该上知识库"，并给出判据。

核心概念速览

（文字流程图）
C ──▶ "分层记忆（7.3）·会话内 / 跨会话 / 知识库"
S ──▶ "供料：assemble_context()"
"分层记忆（7.3）·会话内 / 跨会话 / 知识库" ──▶ "供料：assemble_context()"
​

一句话金句：上下文不是容器而是流量——重要的不是窗口多大，而是此刻流过模型的每一个 token 都经过审计。

💡 一个承接点：第 3.3 节立的是"每步重新供料"的时机观与接口约定，本章补的是预算的算法（7.1）、历史变形术（7.2）与跨会话生命周期（7.3）——三节合起来才是完整的 assemble_context 策略族。

子章节导航

7.1 窗口预算与优先级分配

预算表与常驻税；输出预留；驱逐顺序；pinned 清单；budget.py。

7.2 压缩与摘要：何时丢、丢什么

水位线两档触发；丢/保清单；结构化任务简报；压缩三风险；compactor.py。

7.3 分层记忆：会话内、跨会话与知识库

三层对照；跨会话记忆条目与遗忘；引用化推广为知识库；记忆的坑；memory.py。

子章节之间的逻辑关系

7.1 预算与驱逐（空间维度：每一步怎么装满）
   │  装不下了 ↓
7.2 压缩与摘要（时间维度：装不下的历史怎么办）
   │  这个会话之外 ↓
7.3 分层记忆（生命周期维度：跨会话还记得什么）
​

三节共用一个隐含原则：丢东西之前先问"丢了它，模型的哪个能力会受损"——7.1 用驱逐顺序回答，7.2 用保丢清单回答，7.3 用记忆失效方式回答。

前置知识与后续延伸

前置知识：第 3.3 节（五层清单 L1~L5、三板斧、assemble_context 接口——本章是其完整版）；第 4.2 节（工具路由——L3 常驻税的节税手段）；第 2.1 节（CLAUDE.md 与 compaction 的产品形态）。

为后续奠定基础：7.1 的预算与 7.2 的压缩是第 10.2 节 mini-harness 上下文模块的蓝本；7.2 的"压缩前后"挂载点将在第 8.3 节 hook 执行点全景中出现；压缩的经济价值在第 9.3 节 token 账本里用钱算一遍——上下文工程同时是质量工程与成本工程。