M2 第七波：当前分支上下文检查点

日期：2026-07-29

本轮结果

本轮完成了长分支上下文主链：运行时按实际 LAPP 模型预算编排 prompt schema v3；超出预算时使用当前选中的同一个模型生成玩家安全的滚动摘要；摘要与来源指纹组成非权威检查点，并在最终回合成功时与新故事节点原子提交。历史不会为了适配窗口而被静默截断。

这套机制适用于普通继续与重生成。它不引入导演 Agent、独立摘要模型、向量记忆库或跨分支记忆。

SQLite schema v3

新增 context_checkpoints 缓存表，以不可变的故事节点作为 host，保存覆盖范围、 prompt / checkpoint schema 版本、稳定前缀哈希、摘要和叙事来源哈希。
schema v1 与 v2 数据库都能迁移至 v3；迁移不会修改故事节点、线路头、物化状态或活动线路。
Memory 与 SQLite Store 使用同一检查点语义：只沿目标节点的 parent_id 祖先链查找最近的可达检查点，兄弟分支和其他故事不可见。
缓存行的类型、版本、大小、规范 SHA-256、host 和覆盖范围都会被校验。损坏或未知版本的行被当作可重建的 cache miss，并继续查找更早的有效祖先；权威祖先链损坏仍是硬错误。
删除全部检查点不会改变节点、线路、状态哈希或 PlayerView。
内存和 SQLite 后端均覆盖 500 节点祖先链读取与检查点查找，长线路不再受界面层 200 节点展示限制。

缓存友好的 prompt schema v3

模型输入固定分成三段：

stable_prefix
branch_context
  checkpoint?
  raw_tail[]
dynamic_tail

stable_prefix 只包含角色、Persona、剧情模块、绑定世界书的版本来源及稳定安全规则；资源未变化时保持字节一致，便于供应商前缀缓存命中。
branch_context 使用一个已验证的祖先检查点加最近原文；至少保留最新的已提交节点，节拍文本不会被截断。
dynamic_tail 保留本轮输入、实际触发的世界书条目、剧情事件、可见状态与重生成的固定定性结果，不允许被摘要替代。
输入预算来自当前 LAPP 模型的 context_window 和 max_output_tokens；缺失元数据使用显式标记的保守回退。输出、system、工具 schema、消息 framing、一次隐藏检定续调用与安全余量都会先从窗口中扣除。
完整请求在发给 provider 前再次预检。动态尾部、固定部分或单个历史节点本身无法容纳时会失败关闭，而不是删字、截断或越过模型窗口。
V1 每次玩家行动最多进行一次隐藏检定；这使为工具调用及其续写保留的预算存在明确上界。初始请求会明确提示该限制，检定结果返回后以及重生成回合只向模型暴露 submit_turn_plan，不会再提供第二次检定工具。
可继续的候选节点会在 begin_commit 前，以提交后的状态、同一资源编译器和同一模型预算验证一次最小“下一轮继续”上下文。即使回复满足静态字段上限，只要它作为强制保留的最新原文会让下一轮无法编排，本轮就整体失败且不移动线路头。

同模型滚动摘要

压缩复用当前 TurnPlan provider 的同一 LAPP executor、模型、调用闸门和 TurnControl，不会暗中切换模型或绕过供应商配置。
每次摘要请求都是新的单用途会话，只开放一个严格的 submit_context_summary 工具；正常文本、额外工具调用、未知字段、空白或超大摘要都会被拒绝。
首次加载超长分支时按有界块滚动摘要；后续压缩把上一个自包含摘要与新增的连续节点一起压成新的自包含摘要，不在 prompt 中嵌套摘要链。
摘要来源仅包含当前根到覆盖节点路径上的实际玩家输入、公开场景、角色视觉状态和已提交演出节拍。
精确关系值、骰点和难度、状态 delta、NPC 私物和私密知识、未触发世界书、未选择建议、兄弟分支、凭据、原始供应商响应与推理过程都不进入摘要请求。
摘要分类由运行时固定为 non_authoritative_narrative；模型只能提供文本，摘要不能作为规则触发、状态恢复或判定事实来源。

原子提交与中断边界

压缩发生在模型生成正式 TurnPlan 之前。生成的检查点先停留在内存中，不会立即写库。
普通回合使用 append_node_with_checkpoint，重生成使用 append_regenerated_node_with_checkpoint；节点、物化状态、线路头与待提交检查点在同一 Store 原子操作中落库。
检查点必须 host 在提交前的历史头上，并与该祖先链的覆盖范围一致。陈旧线路、错误故事、无效范围或状态不一致都会使整次写入失败，节点与检查点均不落库。
取消或超时可发生在摘要、正式模型调用或最终提交边界之前。只要中断先于 begin_commit，待提交检查点与故事节点都会被丢弃，线路头保持不变。
一旦 begin_commit 成功，取消不再与写入竞争；调用方接收该原子提交的确定结果。
重生成继续复用原玩家行动、权威 delta、隐藏检定与终局状态；检查点只覆盖待替换节点的父路径，旧节点及旧分支保持不可变。

验证

Rust workspace：215 项测试通过。
- Contracts：1。
- Domain：5。
- Engine：21。
- Runtime：106。
- Store：65。
- Tauri 后端：17。
cargo clippy --workspace --all-targets -- -D warnings：通过。
Web：5 个测试文件 / 29 项测试、TypeScript 严格检查与生产构建通过。
契约：25 份 JSON Schema 与 TypeScript DTO 无漂移。

测试覆盖包括预算边界、prompt schema v3 编排、同模型严格摘要工具、滚动与增量摘要、检查点哈希和失效、兄弟分支隔离、schema v1 / v2 迁移、缓存删除、500 节点祖先链、节点与检查点原子提交、压缩后取消不移动线路头、隐藏检定工具单次暴露，以及合法但会阻断后续上下文的超长回复在提交前被拒绝。

尚未关闭

尚未使用用户实际 LAPP profile、Vault 凭据和在线模型完成端到端调用；本报告不宣称在线 LAPP 冒烟通过。
本轮没有完成窗口截图或人工视觉检查；本报告不宣称视觉验收通过。
Gitea SSH 推送在当前执行环境中仍未验证；本轮成果当前只能视为本地工作树状态，不能宣称已经同步到远端。

6.6 KiB Raw Blame History Unescape Escape