digital-human-lipsync-service/docs/testing-and-acceptance.md

测试与验收清单

1. 本地语法检查

uv run python -m compileall src

1.1 单元测试

uv run python -m unittest discover -s tests

2. 服务启动检查

.\scripts\start.ps1

浏览器打开：http://127.0.0.1:7860/

验收：页面能打开，上传音频和视频后能产出视频。

3. Gradio Client 检查

.\scripts\test-client.ps1 -Audio C:\test\audio.wav -Video C:\test\avatar.mp4

验收：输出包含 video 字段，并且路径对应文件存在。

4. 主项目兼容检查

cd D:\WYF-project\aIzhinengti
python .\scripts\digital_human_process.py http://127.0.0.1:7860/ C:\test\audio.wav C:\test\avatar.mp4

验收：返回 success: true。

5. 真实模型效果验收

真实模型接入后，至少用三组样例：

• 正脸短视频 + 10 秒音频。
• 半身人物视频 + 30 秒音频。
• 有轻微转头的视频 + 15 秒音频。

检查项：

• 口型与音频基本同步。
• 输出视频时长接近音频时长或按预期截断。
• 输出画面无明显崩脸、黑屏、花屏。
• 失败时错误能定位到模型、依赖、显存或输入素材问题。

6. 性能记录

每次更换模型或参数，记录：

• GPU 型号和显存。
• 输入视频分辨率和时长。
• 音频时长。
• 推理耗时。
• 峰值显存。
• 输出文件大小。

7. 发布前检查

• README 已更新。
• .env.example 已更新。
• 没有提交模型权重。
• 没有提交大测试视频。
• 新增环境变量有说明。
• 主项目脚本验证通过。