xiaoshu-app/docs/qa/reading-answer-distribution-release-2026-11-15.md

阅读理解打印答案分布与解析一致性发布 — 2026-11-15

用户已确认问题来自打印/PDF，并授权按方案修复、测试后发布。本次已发布至 https://h5.xiaoshu.pro/ 。

发布结果

• H5 版本：mobile-reading-answers-e02506e38cb6-20261115T102519376Z，源码提交 e02506e38cb67506653fa2e1dd4cf51f67bbcb1b。
• 同步更新唯一一条 english-reading-question-json-tpl 云端提示词；修改前核对完整旧文本及 updatedAt，保留条件回滚脚本。未更新后端网关、管理后台或原生安装包。
• 发布基线是正在运行的报告字体版本 mobile-report-fonts-b8fe8b13111f-20261115T100518307Z。使用其已验证源码快照，仅叠加阅读文件；保留既有字体等线上改动，未重新带入其他性能候选。
• 源站、公网版本清单一致，105 个资源逐文件 SHA-256 验证通过；5 条不带版本参数的深层路由回读通过。
• CDN 任务 8200599242：task_done，成功 1，失败 0。

修复行为

1. 一套五题通过稳定种子安排题序及选项，A/B/C/D 各至少一次，另一次随机分配。移动完整选项对象，正确内容及 check 保持关联。
2. 在线答题、打印题目和打印答案共用同一版顺序。首次打开、刷新、打印返回保持一致；“再做一次”建立新版本。
3. 解析中的明确选项字母同步映射，题目级和选项级解析一起处理；避免连续替换导致 A→B→C 串改。保留普通英文冠词、“Plan A”“维生素A”等内容。
4. 对不能可靠重排的位置依赖题或解析，明确提示核对而不输出错配试卷。本次全部 21 套真实样本可正常呈现。
5. 重做版本记录前一作答 ID，刷新/PDF 返回不复活旧成绩，新提交成功后仍能恢复新作答。
6. 生成示例不再每题固定首项为正确；新增校验和提示词要求，解析用内容与原文依据说明，避免引用字母或位置。

验证

• 初始阅读基线 38 项通过。新增测试先复现原问题：打印分布失败、映射/不变量失败、在线版本/生成偏置失败。
• 最终阅读专项 51 项通过；实际发布源码快照的移动端全量 417 项通过；生产构建通过。构建仍包含项目原有 CommonJS 警告，测试音频夹具仍有既有 404 提示，未伪称日志完全无告警。
• 一次独立审查发现四项问题，均建立失败回归后修复：旧解析的冒号/英文引用、普通字母误改、重做恢复旧答案、生成解析中的位置依赖。
• 只读取得今天 21 篇文章和 105 道题，数据级验证全部题组分布为 1/1/1/2，正确内容及四个选项集合完全保留，输入没有变更。
• 浏览器分别在本地发布候选和正式站资源上运行完整检查：逐套比较 21 套、105 道题的在线顺序、PDF 题目顺序、PDF 答案区顺序及正确内容，全部一致。
• 两次浏览器运行均用隔离接口接入上述真实题目样本，不把模拟提交写入生产。每次完成一套模拟 100 分提交，检查提交后的在线解析与打印解析一致；重做、刷新、PDF 返回保持新版本且不恢复旧选择；JavaScript 错误均为 0。
• 调用真实生成模型一次，以合成花园短文通过实际候选前端发出的提示词生成五题；无生产业务写入。生成与校验通过，显示答案 D/A/C/D/B，逐题核对解析与原文、正确内容一致。
• 本地及正式资源都通过应用实际导出按钮生成四页 PDF，并渲染逐页目视检查：题干、选项、正确标记及解析对应，无文字截断或错位。验收样本答案为 B/B/A/C/D。
• 390px 移动视口无横向溢出；微信 UA 下导出提示正常。没有实体手机或物理打印机验收，不能把浏览器模拟等同实机。
• 发布后再次只读回查原 105 道题的题干、选项、解析、题号、关联文章，全部与发布前一致；未改写学生历史题目和成绩。

证据与回滚

聚合结果：docs/qa/reading-answer-distribution-release-2026-11-15.json。

私有证据目录：/Users/mac/.local/state/xiaoshu/qa/2026-11-15-reading-answer-release/。包含源码范围核对、生产基线备份、构建/测试日志、题目映射审计、真实模型合成样本、浏览器检查、导出 PDF 与逐页 PNG、原站/公网文件校验、CDN 回执、生产数据回读。

• rollback-web.py 先核对当前线上仍属于本次入口/清单，再恢复之前入口并刷新 CDN；保留哈希资源。
• patch-prompt.mjs rollback 只在模板仍等于本次候选内容时还原旧文本，遇到其他修改立即停止。
• 不需要回滚学生业务数据。

已下载或已打印的旧 PDF 不会自动改变。用户需刷新阅读页面，重新导出/打印。此次验证的是选项、答案及解析在重新排列后的对应关系，不等于逐题完成所有历史 AI 内容的教学审校。