2026-05-19-00-11-40 新增Ubuntu配音工作流

工程分析/测试方案-2026-05-19-00-11-40.md

@@ -0,0 +1,42 @@
+# 测试方案
+
+开始时间：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` 并检查健康接口。