按需驱动的来源准备后续工作¶

这是对 #1902 的后续工作，叠加在 #1953 中的来源/语义评估工作之上。 本分支新增了来源交付与教学记录保护机制；它不会取代现有的课程准备、检索、评估或注册表所有者。

契约¶

• Mastery 循环在每次模型请求之前检查当前已授权的缓存数据包。缓存未命中和管理性反馈都不会自动启动准备/模型调用。现有的 mastery_prepare_lesson 工具负责付费工作。
• 过期/变更的数据包会针对当前已授权材料提供明确的聚焦准备；它不是永久性的辅导拒绝，也不是要求重新上传的理由。访问、来源身份和不可读性约束仍然强制执行。
• 就绪的部分证据支持其有用的教学片段。它并不确立完整的目标覆盖范围，也不独立授权任何任意的评估。
• 明确成功的准备会在当前回合绑定教学目标；推进策略目标会使该绑定失效。模型提供的私有回调不能取代运行时绑定器。
• 原生的请求前接缝也会在强制结束时运行。真实的来源故障会被传播，而不是被转换为空成功的回退。
• 已准备页面的像素是瞬态的，限于两次查看，并且从属于较新的工具检索图像。其他已准备页面仍作为来源锚点，而非当前像素检查的声明。工具对和原始学习者消息会被保留。
• 持久的数据包标记在归一化后仍然存在，因此后续回合可以替换历史数据包，同时保持正确的归档边界。不会引入全局历史截断或额外的上下文路由器。
• mastery_note_explained 在其现有事务内重新验证当前的来源证据，并记录 coverage: partial，不产生成绩/Mastery 学分。

1952 中的公开交付引用/回执执行机制仍然是一个独立、互补的贡献。本分支并不声称它证明了解释文本已被可见地送达。其通用的 explained 导航阶段得以保留；新的 coverage 字段明确防止完整目标覆盖的声明。没有更改中文提示词、个人资料/记忆投射功能或用户设置。¶

证据¶

• 缓存/按需测试最初失败：11 个失败，1 个现有工具用例通过。
• 真实的选定 PDF 教学记录测试最初失败两次：未准备的教学被接受，且部分覆盖缺失。
• 原生请求边界测试最初失败五次：钩子从未运行，故障可以被绕过，持久的数据包标记丢失。
• 第一个钩子实现暴露了强制结束捕获会吞掉真实来源故障的问题；现在普通轮次和强制结束路径都会保留这些故障。
• 最终定向测试套件：85 个通过，涵盖按需准备、原生请求边界以及物理来源页面/来源守卫测试。所有模型/检索响应均为确定性伪造；PDF 页面标识和渲染使用临时存储中的合成文件。
• 额外检查涵盖同回合显式恢复、焦点过期、学习者原文引用和归档边界、当前访问撤销、部分教学、付费调用次数不变、工具图像优先级以及无持久像素。

一次可选的更广泛运行有 268 个通过的测试和两个无关的失败。两者在未更改的语义父分支上也会失败：冷启动部分流超时/事件观察测试，以及一项需要在新贡献工作树中未初始化 agents.yaml 的摘要测试。没有为两者添加生产级变通方案。Ruff 和 git diff --check 对变更的 Python/源码/测试文件均通过。