#8493 打开文件的终端指令

必须选择视频文件 说明任务缺少输入文件参数。CLI 模式必须使用 --name 传入视频/音频的绝对路径，且 Windows 预打包版不支持命令行，必须源码部署后使用。

1. 基本命令格式

uv run cli.py --task vtv --name "/绝对路径/video.mp4" --source_language_code zh-cn --target_language_code en

• --task：任务类型，可选 stt（语音转录）、tts（文字配音）、sts（字幕翻译）、vtv（视频翻译）
• --name：必选，输入文件的绝对路径（注意加引号，路径含空格时必须加）
• 若报错提示缺少语言参数，vtv 任务的 --source_language_code 不可为 auto，必须明确中文/英文等代码

2. 示例

# 视频翻译：中文→英文，不配音只出字幕视频
uv run cli.py --task vtv --name "D:/videos/001.mp4" \
  --source_language_code zh-cn --target_language_code en --voice_role No

# 语音转录为字幕
uv run cli.py --task stt --name "D:/videos/001.mp4" --detect_language zh-cn

# 查看所有可用渠道/语言/模型
uv run cli.py --list languages

3. 常见原因排查

1. 未传 --name，或路径写成了相对路径。
2. 路径含中文/空格/特殊符号但未加英文双引号。
3. 使用的是 sp.exe 预打包版 —— 打包版无 CLI 功能。

请查阅相关文档：

• CLI命令行