# 测试方案

开始时间：2026-05-19-00-11-40

## 静态检查

- `python3 -m py_compile Tools_scripts_XunFei-Ubuntu/xfyun_tts_ubuntu.py Tools_scripts_XunFei-Ubuntu/build_final_video_ubuntu.py`
- `bash -n Tools_scripts_XunFei-Ubuntu/synthesize_xfyun_tts.sh`
- `bash -n Tools_scripts_XunFei-Ubuntu/synthesize_xfyun_super_tts.sh`
- `bash -n Tools_scripts_XunFei-Ubuntu/check_audio_duration.sh`

执行结果：全部通过。

## 功能检查

- 使用临时 Markdown 配音稿运行 `xfyun_tts_ubuntu.py --dry-run`，确认能解析 4 段。
- 使用 ffmpeg 生成临时测试视频与音频，运行 `build_final_video_ubuntu.py`，确认能输出 H.264/AAC 成片。
- 用 `ffprobe` 检查测试成片时长、编码和音频流。

执行结果：

- `xfyun_tts_ubuntu.py --dry-run` 可解析 4 段配音稿。
- 已安装并验证 `websocket-client=1.9.0`。
- 无讯飞凭证时脚本会在解析配音稿后明确提示 `Please set XF_APPID, XF_APIKEY and XF_APISECRET first.` 并退出。
- `build_final_video_ubuntu.py` 使用临时测试视频和两段测试音频生成成片成功。
- 测试成片信息：H.264 视频、AAC 音频，320x180，约 2.55 秒。
- `check_audio_duration.sh` 可列出测试音频时长。

## 仓库检查

- `git diff --check`
- `git status --short`

执行结果：

- `git diff --check` 通过。
- 待提交内容仅包含 Ubuntu 工具目录、Ubuntu 工作流文档和工程分析文档。

## 部署检查

- 本次主要新增文档和脚本，不改变 Web 服务逻辑。
- 按既有流程重新执行 `docker compose -f docker_compose_huijutec.yaml up -d --build` 并检查健康接口。