Reasonix · 第 6 章 ★ Prefix-cache 友好的上下文维护
文档摘要
Reasonix · 第 6 章 ★ Prefix-cache 友好的上下文维护 章节摘要:本章是全书高潮(★),深潜 Reasonix 的灵魂——prefix-cache 友好的上下文维护。REASONIX.md 明确规定"Cache-first:系统提示前缀(base prompt+tools+memory)必须字节稳定以保持 DeepSeek prefix cache 命中,永不 mid-session 修改——ride the turn tail"。boot 负责系统提示装配(缓存稳定前缀);control.
Reasonix · 第 6 章 ★ Prefix-cache 友好的上下文维护
章节摘要:本章是全书高潮(★),深潜 Reasonix 的灵魂——prefix-cache 友好的上下文维护。REASONIX.md 明确规定"Cache-first:系统提示前缀(base prompt+tools+memory)必须字节稳定以保持 DeepSeek prefix cache 命中,永不 mid-session 修改——ride the turn tail"。boot 负责系统提示装配(缓存稳定前缀);control.Compose 实现尾部追加;compact 做上下文压缩;snip/prune 旧工具输出先裁剪再摘要;cache_shape 维护缓存形态;Context Engine v2 做分层记忆检索。这是把"LLM 推理优化"做成"系统工程"的极佳案例。本章共 3 节,前置依赖为第 1-5 章。
契约坐标
学习目标
- 理解 DeepSeek prefix cache 与"字节稳定前缀"的关系。
- 读懂 REASONIX.md "Cache-first" 契约。
- 理解 boot 系统提示装配。
- 读懂 control.Compose "ride the turn tail"。
- 理解 compact/snip/prune/cache_shape。
子章节导航
01 Cache-first 契约与 boot 系统提示装配 ★
DeepSeek prefix cache原理(相同前缀复用KV缓存降成本);REASONIX.md Cache-first契约(前缀字节稳定永不mid-session改);internal/boot系统提示装配(base prompt+tools schema+memory=缓存稳定前缀);为什么前缀必须字节稳定(任何字节变化导致缓存miss重新计算);cache-impact PR元数据规范(Cache-impact/Cache-guard)。
02 control.Compose 与 ride the turn tail ★
control.Compose(组装请求时新信息追加到turn tail尾部不破坏前缀);"ride the turn tail"哲学(每turn的新对话/工具输出/记忆note都追加尾部,前缀不变);这样DeepSeek的prefix cache每turn都能命中前缀只重算尾部;对比"前缀变化"的代价(全量重算);这是Reasonix压低长会话token成本的核心机制。
03 compact/snip/prune 与 Context Engine v2 ★
compact上下文压缩(会话过长时摘要旧对话);snip/prune旧工具输出先裁剪再摘要(大段工具输出先snip裁剪到关键再prune精简最后才compact摘要——直接摘要大输出会丢失结构);cache_shape缓存形态(维护哪些在缓存哪些被压缩);Context Engine v2分层记忆检索(SESSION_MEMORY_RETRIEVAL:session记忆/项目记忆/全局记忆分层检索注入);memory包(type/scope分类);skill技能系统。
前置知识与后续延伸
前置:第1-5章(尤其第5章harness loop的Compose)。后续:第7章扩展体系(插件也能影响系统提示)。