准备能暴露问题的短片
选一段约 20 至 30 秒、声音清楚、说话人较少的片段，保留已知原文。这样能判断错误出在识别还是翻译。
准备目标语言和关键人名、产品术语。第一次测试尽量只改变一个参数，避免同时换声音、翻译设置与素材。
按照当前仓库版本安装
从下方官方仓库进入安装文档。云笔记本与本地安装的依赖、认证和算力限制可能不同，应跟随正在使用的代码版本。
本地运行前核查环境、FFmpeg、加速器和语音后端。部分说话人或语音组件需要另行接受模型条款与设置凭证，凭证应放到运行环境的秘密设置中。
git clone https://github.com/R3gm/SoniTranslate.git
cd SoniTranslate
# Follow the installation and launch instructions for this revision.逐阶段检查首次结果
按当前应用界面选择原语言、目标语言和说话人。保留原始音频与中间文本，方便定位每一步。
- 载入短片，确认原始音频正常。
- 选择原语言、目标语言和预计说话人。
- 检查识别后的人名、标点和片段边界。
- 流程允许时先修订译文，再生成语音。
- 边看视频边听配音，记录节奏和说话人错误。
按失败阶段排查问题
识别错的人名会被错误翻译，再被流畅地读出来。调音色不能修复上游文字，应先定位再重跑必要阶段。
| 现象 | 先检查 | 处理方式 |
|---|---|---|
| 人名读错 | 原始转写 | 改正文字，再运行后续阶段 |
| 音色分错人 | 说话人分配 | 复核分离结果与音色映射 |
| 旁白超出镜头 | 译文长度与时间轴 | 缩短表达或调整段落时间 |
| 模型或编码报错 | 环境与依赖 | 带准确错误搜索官方 Issues |
验收一个结果后再扩大规模
保存成功版本、环境和音色设置，再处理更长片段并安排人工语言复核。安装成功只证明流程能跑，不证明翻译准确。
云运行有配额，本地运行有硬件成本。逐一核查使用模型和语音的许可证，并确认声音形象的使用授权。
常见问题
配音和转写一样吗？
转写是把声音变成文字；配音还需要翻译、合成并让目标语言适配视频时间。
先跑完整视频可以吗？
建议先用包含关键术语和说话人的短片，降低排错时间和算力消耗。
开源项目里的语音都能免费商用吗？
需要核查具体模型、声音和服务的各自条款，不能只看主项目许可证。
官方资料
我们核对官方文档，说明使用限制，并提供资料来源。内容属于编辑指南，不是带评分的实测榜单。套餐和可用性可能变化，付费前请核查官方页面。
