# 四套桥梁流程 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 环境：

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

在 `unreal_tran_web`：

```powershell
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`：

```powershell
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`：生成视频抽帧。