# 需求分析

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

## 用户需求

新建一套适用于 Ubuntu 的配音工具与工作流文档：

- `Tools_scripts_XunFei-Ubuntu`
- `配音生成工作流-Ubuntu-Agent.md`

## 现状

- 现有 `待配音视频/Tools_scripts_XunFei` 目录中的脚本为 PowerShell 版本，主要适用于 Windows 或已安装 PowerShell 的环境。
- 现有工作流文档以 PowerShell 命令为主，不适合 Ubuntu 直接照抄执行。
- Ubuntu 环境更适合使用 Bash + Python + ffmpeg 的组合。

## 目标

- 提供 Ubuntu 可执行的讯飞普通 TTS 与超拟人 TTS 脚本。
- 保留原工作流中的配音稿格式、声音选择、语速控制、音频时长检查与视频合成步骤。
- 提供单视频换配音并自动按旁白调整画面速度的视频合成脚本。
- 新文档明确依赖安装、环境变量配置、常用命令、测试方式和常见问题。

## 约束

- 不在脚本中写入任何讯飞密钥。
- 通过 `XF_APPID`、`XF_APIKEY`、`XF_APISECRET` 环境变量读取凭证。
- 生成音频和视频的输出目录由用户指定，避免覆盖已有结果。