# 桥梁数字教员讲解修正验收

2026-09-15，开发、本机局域网及测试环境均通过。

- 四个任务默认视频讲解；场景加载完成且首帧显示后才播放。通过延迟真实模型/解码资源响应，确认 loading 可见时没有讲解播放调用。浏览器拒绝自动播放时保留视频模式，点击播放后正常继续。
- 右上角场景信息和整车工具使用纵向布局；1920、1600、1366 三种宽度无重叠。“三维实时交互”角标已移除。数字人框保持 3:4。
- 审核 39 段讲解及全部安全提示，重新生成 006 第 7 步、007 第 8/9/11 步、008 第 11/15 步。移除原稿、未展开、未给出参数等制作说明；008 保留记录依据并提交教员核对的要求。现用文件为 39 段 MP4、41 个 WAV，旧版本文件保留。
- 浮窗按钮与展开面板无阴影，头像绿点已移除。原因是公开接口优先用了旧上传视频，测试环境文件不存在返回 404；已统一使用随项目发布的内置头像。验收检查了实际教员 PNG 地址和图片加载完成，避免把临时品牌图标当作头像通过。
- 测试环境实际任务 86–89、固定内容版本 533–536 的全部 39 个步骤与新视频/讲解文字准确绑定；动作定义不变。

## 验证记录

- 前端两项目构建通过；桥梁脚本、媒体绑定及正式入口 14 项契约测试通过。
- Java 17 `mvn test` 通过，Surefire 汇总 562 项，失败/错误为 0。
- 公开头像接口回归 2 项通过，包含旧上传文件缺失的重现案例。
- 四任务前两步的视频播放、语音切换、视频失败备用、切步停止、刷新和关闭通过，见 `playback/live-result.json`。
- 本机、局域网、测试环境的 39 个 MP4 与 41 个 WAV HTTP SHA-256 均与发布文件一致；MP4 Range 返回 206。
- 三个数字人在测试环境 `/human/viewer/{id}` 完成真实语音驱动，收到开始/结束事件并有持续嘴部运动，无浏览器错误。见 `ai_person/ape2e/reports/instructors-v2-test-20260915/stable-viewer-validation.json`。

## 测试发布

- 数字车间：http://1.14.103.234:6180
- 数字人平台：http://1.14.103.234:7180
- 镜像：`digital-human-service:lecture-v2-20260915`，运行摘要 `6d66dd620303ea162047d7a9713b30f0f36575750f1a9a03c4f44aaf58f7659d`，容器 healthy。
- 五个源码仓库均已发布，提交及备份位置见 `deployment.json`。数据库无待执行的新变更；已有四任务及有效训练记录保留。
- 测试环境原有 v2 素材修改与新提交逐文件核对一致后，保存在名为 `lecture-v2-20260915-pre-deploy` 的 Git stash 中，再快进更新源码。
- 常规构建提示：前端部分包超过 500 kB；FastAPI 测试客户端有上游弃用提示。检查均成功。