Test Log 测试日志
历次测试报告与处理状态。Each test round is logged here with its resolution status.
📬 报告新问题 How to report
请把测试报告电邮到 simonwanghkteacher+test@gmail.com，
抄送 simonwang@hkbu.edu.hk；处理结果一般在 24 小时内回复。
每个问题请提供：会话参考号（右上角 #ABC123）、操作步骤、预期 vs 实际结果、截图（如有）、浏览器与系统。
Round 4 · 胡文雯 Wilma Hu · 2026-08-23 · 上传卡住复测（仍未通过）
| # | 问题 | 状态 | 说明 |
|---|---|---|---|
| 1 | 上传 2.4 MB .pptx 后停在「正在读取幻灯片 Reading slides…」不再前进（20 日修复后复测仍复现） | ✅ 已解决（v0.1.8 / v0.1.9，2026-08-27 已部署） | 20 日 v0.1.1 修复的是浏览器端 base64 编码卡顿，请求已能发出；但重文件在服务端解析阶段仍会卡住（python-pptx 对复杂/大型幻灯片可能挂起数分钟），界面停在「正在读取幻灯片」。8 月 27 日修复：#267E2B23 同类问题，服务端改为有界解析（60 秒子进程超时 + 陈旧任务回收），前端增加 240 秒轮询截止与 60 秒后的进度明细（v0.1.8）；并把幻灯片文本提取改为直接读取 pptx 内部 XML（不再构建 python-pptx 对象模型），大型文件毫秒级完成（v0.1.9）。已部署（healthz version 0.1.9）。 |
详细分析见代码库 docs/testLog/resolution_20260823.md。与 2026-08-27 #267E2B23 同源。
Round 3 · Louisa · 2026-08-19 · 回归测试
| # | 问题 | 状态 | 说明 |
|---|---|---|---|
| 1 | 反馈中「全部微课」链接跳转到“我的任务”而非微课列表 | ✅ 已解决 | 哈希路由对 learn 等数据屏仅调用 J.show()，未触发数据加载；改为调用对应 show*() 函数（v0.1.4）。 |
| 2 | 实时转写反复失败（麦克风正常），但音频已保存 | ✅ 已解决 | 与第 10 条同源：Q&A/录音路径缺少浏览器实时转写兜底，已修复（v0.1.1）。 |
| 3 | 标点守卫只拦截单独的「～/?」，与字母组合（如 ~h）漏拦 | ✅ 已解决 | 剥离标点后要求至少 2 个真实字符（v0.1.4）。 |
| 4 | 任务小结排版凌乱，建议进度条 + 表格 | ✅ 已解决 | 小结改为完成度进度条 + 表格（v0.1.4）。 |
| 5 | 真实/虚假邮箱均可注册——是否需要真实邮箱校验？ | 💬 待讨论 | 产品设计决策，待与胡老师确认。 |
| 6 | 会话参考号偶尔需刷新后才显示 | ✅ 已解决 | 登录时立即渲染已保存的会话编号（v0.1.4）。 |
| 7 | 上一个任务阻挡下一任务界面——是否有意为之？ | 💬 待讨论 | 单一活动任务为当前设计，待确认是否调整。 |
| 8 | 示例材料载入了讲稿但未显示幻灯片 | ✅ 已解决 | 新增文件名显示，示例载入与手动选择都会更新（v0.1.4）。 |
| 9 | 学习页似乎缺失/列表未显示 | ✅ 已解决 | 同第 1 条（哈希路由），已修复（v0.1.4）。 |
| 10 | 实时转写不工作（第二轮前可用） | ✅ 已解决 | 同第 2 条，已修复（v0.1.1）。 |
| 11 | Q&A 问题千篇一律，未根据幻灯片个性化 | ✅ 已解决 | 前端在 Q&A 开始时若未持有讲稿，会先拉取当前版本讲稿再生成问题（v0.1.6）。 |
| 12 | 找不到行为日志条目 | ✅ 已解决 | logger.js 已加载但未注入会话号，导致前端事件不落库；现已在建立会话时注入（v0.1.6）。 |
| 13 | 错误信息中功能含义不清晰 | ✅ 已解决 | 将笼统的「出错了」改为明确的「评价未能完成」并保留进度明细（v0.1.6）。 |
详细分析见代码库 docs/testLog/resolution_20260820.md。其中第 2/10 条已修复上线，其余正在逐项处理。
上传 413 / 大文件被拒 · 2026-08-27
| # | 问题 | 状态 | 修复内容 |
|---|---|---|---|
| 1 | 较大的 .pptx（2.35 MB）上传失败，小文件（35 KB）正常 | ✅ 已解决（已部署） | 根因:nginx prefeedback.conf 未设 client_max_body_size，默认 1 MB，大文件在到达应用前就被拒（HTTP 413）。已设为 60m 并重载。实测该文件现可上传并完成（14 页，约 19 秒）。 |
详细分析见 preFeedbackRehearse/docs/debug27Aug-report.md。
Q&A 录音转写失败 · 2026-08-20
| # | 问题 | 状态 | 修复内容 |
|---|---|---|---|
| 1 | Q&A「录音回答」停止后显示「Transcription failed — please type. 转写失败」 | ✅ 已解决（已部署） | 双重根因:① Railway 生产环境未配置任何服务器端 STT 密钥（/api/stt 返回 503）;② Q&A 录音路径原本只走服务器转写，没有浏览器实时转写兜底。现修复 Q&A 路径：录音时同时启用浏览器 Web Speech 实时转写（与表达练习一致），停止后优先采用实时文本；仅当实时转写为空时才回退 /api/stt。这样即使服务器 STT 密钥缺失，语音回答也能正常工作。已于 2026-08-20 部署到 Railway 与阿里云（v0.1.1）。部署侧仍可在 Railway 设置 GROQ_API_KEY 以恢复高质量服务器转写（阿里云已配置 ElevenLabs，不受影响）。 |
相关报告:docs/testLog/qq_report_20260820.png。Louisa 2026-08-19 报告第 2/10 条（转写失败）与此同源。
Upload stalls · 上传卡住 · 2026-08-20
| # | 问题 | 状态 | 修复内容 |
|---|---|---|---|
| 1 | 上传 .pptx + 讲稿后停在「Uploading materials 上传材料…」,不再前进 | ✅ 已解决（已部署） | 根因在浏览器:旧流程先把整个 .pptx 在网页里 base64 编码再发送,大文件会卡住主线程,请求根本未发出。改为直接上传原始文件(服务器早已支持),不再在浏览器编码;若遇防火墙拦截原始 .pptx 则自动退回 base64 重试。服务器两条路径(仅讲稿≈15s、PPT+讲稿≈16s)实测均正常。E2E 9 项全通过。已于 2026-08-20 部署到 Railway 与阿里云（v0.1.1）。 ⚠️ 2026-08-23 复测复现:Wilma 上传 2.4 MB .pptx 仍卡在「正在读取幻灯片」— 根因移到服务端解析（见上方 Round 4，v0.1.8/v0.1.9 已修复）。 |
详细分析见 videolessonGen/docs/feedbackUser/upload-stuck-investigation-20260820.md。
Round 2 · Louisa · 2026-08-14 · 场景A
| # | 问题 | 状态 | 修复内容 |
|---|---|---|---|
| 1 | 反馈中点击视频链接（如 Review V05）显示"视频尚未接入" | ✅ 已解决 | 反馈问题按关键词自动链接到对应微课 V01–V08（/lesson/v0X），无匹配时回退"全部微课"。 |
| 2 | 新录音使前一次录音及转写内容丢失，无法保存 | ✅ 已解决 | 录音尝试原本已入库；现历史列表增加"查看转写"按钮，可查看并"载入转写框"恢复任意一次转写。 |
| 3 | Q&A 标点符号（「？」「～」）被误判为答案 | ✅ 已解决 | 前端与后端同时拦截纯标点/占位回答（？？？、～、n/a 等），提示重新输入真实回答。 |
| 4 | 任务小结仅有完成进度，没有质量评价 | ✅ 已解决 | 小结新增四维质量评价：完成度 / 内容质量 / 表达质量 / 问答表现（基于已存数据即时生成）。 |
详细分析见代码库 docs/testLog/resolution_20260818.md（
ChineseMedPresentationHu/docs/testLog/）。
Round 1 · 2026-08-11 前（初版联调）
| 改进项 | 状态 |
|---|---|
| 上传卡住 → 30 秒超时 + 网络超时提示 | ✅ 已解决 |
| 实时转写浏览器支持 → Chrome/Edge 提示与错误信息细化 | ✅ 已解决 |
| 中国大陆访问 → Vercel 前端 + Cloudflare 代理 | ✅ 已解决 |
| 会话参考号 #ABC123 与错误信息上下文 | ✅ 已解决 |
已知限制（无需报告）
- 上传大文件幻灯片：如长时间停留在上传/读取阶段，请检查文件大小并参照
videolessonGen/docs/feedbackUser/upload-stuck-investigation-20260820.md—— 2026-08-27 起服务端改为直接读取 pptx 内部 XML + 有界解析，正常大文件应在数秒内进入读取/评价阶段（v0.1.8/v0.1.9）。 - 实时转写仅支持 Chrome/Edge（Web Speech API 限制）
- 讲稿上传不支持 Word
.doc/.docx（请粘贴文本） - 教师评论为占位区域（尚未实现）
- 测试账号
test2026为共享账号，正式测试请用自己的账号