3.1 KiB

Brut Annotations Historique

四套桥梁流程 v2 数字人讲解验收

2026-09-15；本机 Windows，教员1 v2；使用负责人已确认的 005 第一步样片参数。

交付

TASK-VIRTUAL-005：5 段；006：7 段；007：11 段；008：16 段，共 39 段。
MP4 位于 unreal_tran_web/public/legacy/virtual-training/videos/narration/，已进入前端 dist，采用静态地址播放。
总时长 264.24 秒，总大小 17,727,827 字节；480×640、25 FPS、H.264/AAC。
005 第一步与已确认样片逐字节相同。其余步骤复用各自原讲解音轨，以同一教员1 v2 和捕获方法生成。
任务 86–89 的发布版本 533–536 保留；39 个服务端步骤与讲解清单匹配。本次未创建或改写任务、版本、运行或成绩。
原 39 个视频与 42 个 WAV 的 SHA-256 均保持一致。讲解可切回语音，视频失败自动使用保留的语音。

验证结果

所有 39 段完整解码通过，编码、尺寸、帧率和时长检查通过。
39 段均存在有效声音，见 delivery-validation.json 中音量记录。
public、dist、本机 HTTP 下载、局域网 HTTP 下载的全部文件摘要一致；视频 Range 请求返回 206。
逐段预览页包含 39 个有效视频链接；每套流程抽帧检查，画面正常。
本机 http://127.0.0.1:6180 与局域网 http://192.168.31.168:6180 各测试四个真实任务的教员预览。页面用现有登录及教学 API，经同源 /api 访问配置的 Gateway 6100。
每套检查第一、第二步实际静态视频播放，切换语音/视频，三维操作后切步停止旧视频，损坏视频时回退 WAV，刷新后播放和关闭教员停止。两个环境均通过，页面脚本错误为 0，旧讲解资产下载为 0。
预览验证使用内部维护账号；未生成测试任务、学员运行或测试成绩。

已执行命令

在数字人 API 目录，使用既有 Python 环境：

python ../../unreal_tran/ute2e/tools/bridge-digital-video-static-generate.py

在 unreal_tran_web：

pnpm run build
node --test scripts/bridge-digital-video.contract.test.mjs scripts/bridge-script-narration.test.mjs
node --test scripts/bridge-scripts-3d-only.test.mjs
node scripts/virtual-training-formal-route.contract.test.mjs

构建成功，11 项视频/语音测试及 2 项三维脚本测试通过，正式入口契约通过。Vite 仍提示部分既有包超过 500 kB，不影响构建。

在 ute2e：

node tools/bridge-digital-video-static-live.mjs
$env:BASE_URL = 'http://192.168.31.168:6180'
node tools/bridge-digital-video-static-live.mjs
node tools/bridge-digital-video-static-delivery.mjs

证据

index.html：39 段视频集中预览。
generation.json、manifest.json：素材来源、逐步对应及文件摘要。
delivery-validation.json：全部视频、保留文件、构建输出和两处 HTTP 地址的验证。
live-result.json、lan-result.json：实际页面交互结果。
TASK-VIRTUAL-005-video.png 至 TASK-VIRTUAL-008-video.png：项目内播放截图。
各任务 *-frame.jpg：生成视频抽帧。