Explorar el Código

docs: record three-tap reading release and online entry checks

彭峰 hace 17 horas
padre
commit
99494a708c

+ 2 - 0
docs/qa/three-tap-reading-2026-11-14.md

@@ -1,5 +1,7 @@
 # 三遍点读显示与手势修正 — 2026-11-14
 
+后续已获用户授权发布,线上状态与三入口验证见 [发布验收记录](three-tap-reading-release-2026-11-14.md)。下文保留发布前验证记录。
+
 ## 交付范围
 
 - 英文轮次第 1 次显示音标、第 2 次立即显示中文、第 3 次隐藏中文并保留音标;中文轮次第 1 次仅读音、第 2 次显示英文、第 3 次隐藏英文。

+ 35 - 0
docs/qa/three-tap-reading-release-2026-11-14.md

@@ -0,0 +1,35 @@
+# 三遍点读线上发布与三入口验收 — 2026-11-14
+
+## 发布结果
+
+用户本地验收后明确授权发布。本次仅发布学生/老师 H5 静态资源,版本为 `mobile-three-tap-fd93e27c629f-20261114T145550775Z`,正式站为 https://h5.xiaoshu.pro/ 。
+
+当前线上基线为 `0b7d9d5f89c7f877859fcebdbcda914027185e38`(11 月 14 日性能优化发布回退后保留的版本)。发布源码采用该提交的独立快照,仅应用本次已确认提交 `fd93e27c629f9dd0e0b07145cc99254d1ef979df` 的移动端差异;没有重新发布已回退的首页/恢复刷新优化。运行时代码范围核对为 4 个现有文件修改及 1 个新增手势指令,其他基线运行时文件逐字一致。
+
+没有更新后端网关、数据库、管理后台或原生安装包。原有每组最多6词、每组三轮、每词每轮三次,以及后续配对/听音/拼写等流程保持不变。
+
+## 发布与资源核验
+
+- 保存并校验原线上 105 个资源、入口及版本清单,保留全部原哈希资源。
+- 上传新资源,逐文件校验源站后再更新清单与入口;切换前再次核对线上入口未被其他发布更改。
+- CDN 刷新任务 `8194103890` 完成,成功 1、失败 0。
+- 源站与公网版本清单一致;公网 105 个静态文件 SHA-256 全部匹配。
+- 5 条不带版本参数的深层路由回读正确:老师/学生主页、生词本、陪练入口、课程选词、点读。
+
+## 验证
+
+- 本次实际发布源码快照的移动端全部 393 项回归通过,生产构建通过。此前主分支396项包含未发布性能候选的另外3项测试;本次采用线上基线测试,未删除或跳过发布快照中的测试。
+- 线上静态资源配隔离接口的三个入口完整验收全部通过:老师课程带学、老师生词本、学生生词本自学。每个入口选10词,仍拆为6+4两组,合计90次正常点读;完成各组三轮和配对、听音、拼写。
+- 320/375/768px 的英中同字号、右侧提示、长词长释义、无横向溢出均通过;真实鼠标拖动、CDP水平触摸、纵向原生滚动通过。此项使用隔离学习数据和音频夹具,不替代真实账号验收。
+- 真实账号及真实词汇三个入口均通过:老师课程带学、老师生词本、学生生词本自学各选择2词,按原规则完成三轮共18次点读,正常进入配对页。逐轮核对第1/2/3次提示、跨轮重置、长按左滑不计次、英中字号一致。
+- 真实浏览器观察到的课程/生词本读取请求全部成功;三入口音频资源响应分别5/5、6/6、6/6成功,JavaScript错误均为0。此项证明资源可用,不替代人工听音质量验收。
+- 真实抽查不带真实预约编号、不提交学习完成或成绩,客户端拦截写入保护未被触发,正式学习记录写入请求为0。
+- 首次真实断言将数据库释义中的多个空格与浏览器折叠空白后的文本直接比较,产生夹具误报;统一空白后再次完整运行三入口通过,产品代码未因此修改。
+
+## 回滚与证据
+
+私有发布目录:`/Users/mac/.local/state/xiaoshu/qa/2026-11-14-three-tap-release/`。包含源码快照、基线备份、源代码范围核对、构建/测试日志、源站与公网校验、CDN回执、隔离及真实浏览器证据。会话与真实个人数据不进入 Git。
+
+目录中的 `rollback-web.py` 会先确认当前入口和清单仍属于本次发布,再恢复原入口及清单并刷新 CDN;保留旧新哈希资源。出现后续发布时必须先核对,不能覆盖更新版本。无需回滚业务数据。
+
+浏览器验收不等于实体手机或微信 WebView 实机验收。

+ 3 - 1
docs/superpowers/plans/2026-11-14-three-tap-reading.md

@@ -32,4 +32,6 @@
 **Interfaces:** 使用生产构建与本地隔离 API,三个入口完整三轮、配对/听音/拼写流程。
 - [x] 检查三个入口及320/375/768px布局、鼠标和触摸手势,保存本地证据。
 - [x] 独立复查差异,完成相应回归,记录明确验证边界。
-- [ ] 仅提交本次修改并推送当前跟踪分支。
+- [x] 仅提交本次修改并推送当前跟踪分支。
+
+后续用户完成本地验收并授权上线,发布结果见 `docs/qa/three-tap-reading-release-2026-11-14.md`。