xiaoshu-app/docs/qa/pending-updates-release-2026-10-30.md

2026-10-30 未发布更新上线记录

发布范围

按用户授权，提交并推送今天的代码，将尚未发布的相关更新部署至正式环境：

• 11627fe：学习记录词表默认隐藏中文，发音结束后显示该词释义；中断、翻页、离开页面不误显示。
• 89ef58e：Excel 词库批量预检、增量保存、逐行结果、失败重试和刷新恢复进度。
• 1eee92a：老师学习记录仅列出账号正常、且在该老师名下今天或以后仍有未完成、未取消排课的学员；处理失效的历史选择及分页。
• 08619f7：上线验收发现历史学员查询的数字转文本关联绕过现有索引，改用数字编号及模型字段关联。相关查询复用现有索引，无需迁移。

缺失读音合成服务、结课后课表缓存刷新此前已经发布，本次保留这些线上行为。既有未跟踪迁移资料未提交。

正式版本

发布源代码：08619f72519a857c836f4bd472653879f92b36ae。

应用	发布编号	公网文件校验	无版本参数页面入口
管理端 https://admin.xiaoshu.pro	08619f72519a-20261030T031235709Z	96 个 SHA-256 一致	4 条通过
移动端 https://h5.xiaoshu.pro	mobile-08619f72519a-20261030T031236277Z	105 个 SHA-256 一致	8 条通过

按后端、管理端、移动端顺序发布，源站文件回读通过后更新入口并刷新 CDN。未清空静态桶，旧版本资源保留。

后端选择性更新 xiaoshu.app.gateway 的 coachStudentPage，以及 xiaoshu.ops.gateway / xiaoshu.ops.gateway.v3 的词库校验、预检、提交及状态函数；补充字段校验和结果汇总函数。与本次无关的线上函数逐项保持不变，发布后代码哈希回读一致。未整份覆盖线上网关，无新增表或字段迁移。

验证

• 全量前端测试：移动端 316 项、管理端 348 项通过。
• 相关后端测试 41 项通过，覆盖词库导入、学员筛选、管理端读取和单词音频；数字关联调整后再次通过 5 项学员筛选测试。
• 两端生产构建及 11 个云函数定义校验通过。原有样式体积和 CommonJS 警告仍存在，构建无错误。
• 使用正式部署函数及真实数据库验证在排课老师的筛选：样本返回 4 位学员，服务端函数耗时约 222 毫秒。两位无当前排课的老师返回空列表。首次历史全量对比发生超时，修正索引关联后才继续发布前端；不将该次失败计为验收通过。
• 正式运营接口创建专用目录和 8 条测试词，分 4 次增量提交完成；状态接口正确恢复进度，重放提交没有重复建词。预检样本约 1.56 秒，仅为本次测量。8 条词条及附表、1 个目录、1 个导入批次均已清理，审计记录保留。
• 浏览器读取正式静态资源，以隔离接口和音频样本验证：中文在发音结束后显示、中断旧词不显示、刷新后恢复隐藏、不写学习结果、375px 无横向溢出；老师请求筛选范围且替换失效选择；管理端恢复上次导入并使用增量协议继续完成。

浏览器交互检查使用隔离数据，后端业务检查使用专用测试数据及只读真实数据；上述结果不代表手机微信实机验收。

回退及证据

本机受限目录：~/.local/state/xiaoshu/cloud-releases/2026-10-30-pending-updates/。

• 首次发布前后端基线及计划：initial-backend-release/。
• 数字关联修正前后端基线、最终计划及回读：各网关 baseline、gateway-plan.json、cloud-published.json。
• 两端入口、版本及被覆盖的同名资源备份：admin/baseline/、mobile/baseline/。
• 后端业务、清理、静态文件及浏览器验证：backend-verification.json、current-teachers-verification.json、test-batch-cleanup.json、两端 verification.json、browser-verification.json。

回退时恢复所需后端基线和两端旧入口、版本清单及同名资源，刷新对应 CDN；不删除现有词库、学习记录、TTS 缓存或已生成音频。