测试与调试
测试脚本（test/ 目录）
| 脚本 | 用途 |
|---|---|
run_full_pipeline.py | 全管线端到端测试（主题 → 完整视频） |
test_all.py | 集成测试（t2i / i2v / pipeline） |
test_i2v_direct.py | 图生视频直测 |
test_script_writer.py | 剧本 Agent 测试 |
debug_llm.py / debug_llm2.py | LLM 输出调试 |
comfyui_i2v_workflow.py / comfyui_test_workflow.py | ComfyUI 工作流测试 |
# 全管线端到端测试
python test/run_full_pipeline.py
# 集成测试
python test/test_all.py后端调试
- 后端启动后命令行输出所有请求与 Agent 执行日志（INFO 级）；
- LLM 调试：
python test/debug_llm.py； - 可通过
GET /api/system/status检查 ComfyUI 服务与 GPU 状态。
前端调试
cd video-frontend
npm run dev # 支持 HMR 热更新- 浏览器 DevTools Network 面板查看 API 请求；
- Console 面板查看前端日志。
常见问题排查
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
后端报 ModuleNotFoundError | 缺少依赖包 | pip install -r requirements.txt（或激活 .venv） |
| 前端启动报错 | node_modules 未安装 | cd video-frontend && npm install |
| ComfyUI 连接失败 | URL / Token 错误 | 检查配置页文生图 / 图生视频分组 |
| 视频合成失败 | FFmpeg 缺失 | 确认 video-platform/bin/ffmpeg.exe 存在 |
| 语音时长读取为 0 | ffprobe 缺失 | 确认 video-platform/bin/ffprobe.exe 存在 |
| CORS 错误 | 前端跨域被拦截 | 确认后端 CORS 中间件配置正确 |
验收基线（ACC 摘要）
- 全流程成功率 ≥ 85%；30 秒短片全流程 ≤ 15 分钟；
- 用户操作 ≤ 3 步（输入主题 → 配置 → 等待生成）；
- 参数覆盖：6 档分辨率 × 8 种风格 × 5 种音色正确生效；
- FFmpeg 自包含：无系统安装 FFmpeg 时合成流程正常；
- 安全基线：
/api/files越权路径返回 403。