Skill 使用指南
SoulDub Video Translate Skill
使用 SoulDub 原声配音能力翻译本地 MP4 视频，然后下载翻译后的视频和 SRT 字幕。
该仓库发布 souldub-video-translate Agent Skill。
功能说明
该 Skill 可以帮助 Agent：
- 将本地 .mp4 视频上传到 SoulDub。
- 创建视频翻译任务。
- 跟踪长时间运行的翻译进度。
- 下载翻译后的视频和字幕。
成功运行后会保存：
result.mp4：翻译后的视频translated.srt：目标语言字幕bilingual.srt：双语字幕
安装
从公开 GitHub 仓库安装：
npx skills add jiabaogithub/souldub-skills --skill souldub-video-translate使用
安装后，让你的 Agent 使用本地 MP4 路径和目标语言调用该 Skill：
Use the souldub-video-translate skill to translate C:\path\to\video.mp4 into Japanese.该 Skill 也接受受支持的语言名称，例如 Japanese、Chinese、日语、中文 和 粤语。
Agent 会收集缺失信息、启动翻译、报告进度，并在任务完成后返回本地输出路径。
配置
该 Skill 需要 SoulDub API Key。
安装后，让 Agent 检查认证状态：
uv run scripts/video_translation.py auth status如果尚未配置 API Key，该 Skill 会创建这个用户级配置文件：
~/.souldub/souldub.config.yaml在该文件中设置 souldub_api_key，或设置 SOULDUB_API_KEY 环境变量。
运行要求
- Python 3.11+
uv- 可访问 SoulDub Agent API 的网络环境
- SoulDub API Key
- 源 MP4 文件的读取权限
- 输出目录的写入权限
运行数据与安全
已安装的 Skill 文件按只读处理。
运行状态存储在用户平台状态目录中。翻译结果默认输出到源视频旁边的 souldub_outputs/ 文件夹。
该 Skill 不持久化 API Key、预签名上传 URL、媒体网关 URL 或临时签名参数。
开发
仓库结构：
skills/
└── souldub-video-translate/在该仓库根目录验证本地发现：
npx skills add . --list安装本地工作副本：
npx skills add . --skill souldub-video-translate直接运行 helper 进行本地调试：
cd skills/souldub-video-translate
uv run scripts/video_translation.py auth status