docs(v2): C08 Prompt Cache 横切 · 勘误保留 · 零差异存档

[luyao618]

判定档：勘误保留（YAO-109）

结论

逐条核对 v1-07 (docs/07-Prompt-Cache.md, 817 行) 全部 file:line 引用 vs claude-code-cli@290fdc9481a70612bc5823aa4ed225c52c52aad3 —— 零勘误事实点。

正文 0 diff，仅在第 3 行引言追加 （源码冻结：commit 290fdc9481a70612bc5823aa4ed225c52c52aad3） 完成 spec §2 要求的章节级 source_commit 冻结。

风格双亲（R-1）

• docs/04-System-Prompt-工程.md（同属第二篇 · 内核章，开篇的"为什么单独讲 X？" + 分段叙事节奏）
• docs/06-上下文管理.md（横切章先例，三大模块串联 + Mermaid 流程图比例）

段落统计（R-2）

• 保留 v1 段落：全部（817 行正文，0 改写、0 新增）
• 改写：0
• 新增：0（引言内嵌入 commit sha，属 frontmatter 冻结，不计入正文）

N（保留）≫ M+K（改写+新增）= 0，符合勘误保留档的统计基线。

完整核对清单（v1 → 290fdc9）

引用	v1 位置	源码现状
claude.ts:358-374 getCacheControl	§1.2	358-374 ✓
claude.ts:393-434 should1hCacheTTL	§1.3	393-434 ✓
claude.ts:1225-1229 globalCacheStrategy	§2.2	1225-1229 ✓
claude.ts:1235-1245 toolToAPISchema 调用	§1.1	1235-1245 ✓
claude.ts:1388 遗留注释 toolSchemas marker	§1.1	1388 ✓
claude.ts:3063-3106 addCacheBreakpoints	§1.1	3063 起 ✓
claude.ts:3084-3089 skipCacheWrite	§4.8	3084 注释 + 3089 代码 ✓
claude.ts:3141-3208 cache_edits 注入	§3.3	3141-3208 ✓
claude.ts:3213-3237 buildSystemPromptBlocks	§1.1	3213-3237 ✓
claude.ts:117-132 latch 导入	§5.2	117-132 ✓
utils/api.ts:129 cacheControl 选项	§1.1	129 ✓
utils/api.ts:139-209 toolToAPISchema 主体	§5.3	139-209 ✓
utils/api.ts:321-435 splitSysPromptPrefix	§2.2	321 起 ✓
prompts.ts:114-115 DYNAMIC_BOUNDARY	§2.1	114-115 ✓
prompts.ts:568-577 boundary 插入点	§2.1	573 ∈ 范围 ✓
systemPromptSections.ts:20-38	§2.3	20-38 ✓
systemPromptSections.ts:43-58 resolve	§2.3	43-58 ✓
systemPromptSections.ts:60-68 clear	§5.2	60-68 ✓
microCompact.ts:100-118 pin*	§3.3	100-118 ✓
microCompact.ts:253-293 microcompactMessages	§3.2	253-293 ✓
microCompact.ts:305-399 cachedMicrocompactPath	§3.2	305-399 ✓
microCompact.ts:446-529 maybeTimeBasedMicrocompact	§3.2	446-528 ✓
forkedAgent.ts:46-68 CacheSafeParams	§4.2	46-68 ✓
forkedAgent.ts:70-81 save/getLastCacheSafeParams	§4.3	70-81 ✓
forkedAgent.ts:389-403 contentReplacementState clone	§4.6	389-403 ✓
forkedAgent.ts:489-556 runForkedAgent	§4.4	489-556 ✓
toolResultStorage.ts:399-412 cloneContentReplacementState	§4.6	399-412 ✓
forkSubagent.ts:44-71 FORK_AGENT	§4.5	44-70 ✓
forkSubagent.ts:91-93 FORK_PLACEHOLDER_RESULT	§4.7	90-92 ✓ (±1 行可忽略)
forkSubagent.ts:95-105 byte-identical comment	§4.7	95-105 ✓
promptCacheBreakDetection.ts:247-430 recordPromptState	§5.1	247 起 ✓
logging.ts:46 GlobalCacheStrategy	§2.2	46 ✓

§5.1 的 12 维度变化矩阵也与 promptCacheBreakDetection.ts:72-83 完全对齐。

Manifest diff 摘要

• source_commit 章节级冻结：未冻结 → 290fdc9481a70612bc5823aa4ed225c52c52aad3
• 锚点矩阵：无变更（所有引用 file:line 与源码一致）

Merge 纪律

按 spec §4 与本 issue §0.4：不要 merge，等尧哥本人手动合。