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

测试方案

开始时间：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 并检查健康接口。

执行结果：

• Docker 镜像重新构建成功，Web 服务容器重新创建。
• isiseg_app 状态为 healthy，端口映射为 0.0.0.0:10004->8001/tcp。
• 本机 http://127.0.0.1:10004/api/health 返回 {"status":"ok","service":"ISISeg","version":"0.1.0"}。
• 公网 https://isiseg.huijutec.cn/api/health 返回同样健康状态。