Continuum-AI-Corp/orcadub-plugin

翻译任何视频。保留原声。

为您智能体准备的 AI 视频配音功能——dub-video 技能，驱动 @orcadub/cli 命令行工具。

网站 · CLI / 服务器仓库 · 获取 API 密钥 · OrcaDub 在 X 上

---

让任何智能体都能以对话方式将视频配音成另一种语言：上传文件或提供 URL，通过 OrcaRouter 网关向 orca/dub 模型提交任务，轮询进度，并下载完成的 MP4。

一个工具，一项技能：

• CLI @orcadub/cli — 一次性命令行工具（npx -y @orcadub/cli <子命令> 或预构建的 orcadub 二进制文件），无需常驻服务器。
• 技能 dub-video — 一份适用于支持技能的智能体（Claude Code/Desktop、Codex 等）的纯 SKILL.md 工作流指南，它调用 CLI：何时配音，在产生费用前询问必要参数，轮询规范，下载前确认。

安装

Claude Code — 一键安装插件（调用 OrcaDub CLI 的技能）：

/plugin marketplace add Continuum-AI-Corp/orcadub-plugin
/plugin install orcadub@orcadub-skills

Codex — 一键安装插件（调用 OrcaDub CLI 的技能）：

codex plugin marketplace add Continuum-AI-Corp/orcadub-plugin
codex plugin add orcadub@orcadub-skills

任何支持的智能体 — 引导式 CLI 安装：

npx -y @orcadub/cli skill install

# 非交互式示例：
npx -y @orcadub/cli skill install --platform codex --scope global --yes
npx -y @orcadub/cli skill install \
  --platform claude --platform cursor --scope project --yes

安装程序会自动检测已存在的智能体平台，并支持在 36 多个平台上进行项目/全局安装，包括 Hermes、OpenClaw 和 Command Code。它会下载本仓库的官方 dub-video 技能，除非提供 --force 参数，否则会保留现有差异内容，并支持结构化的 --json 输出。

手动安装备用方案：

# 复制技能（安装到 orcadub/ 文件夹中）：
cp -r skills/dub-video ~/.claude/skills/orcadub   # Claude Code / Desktop
cp -r skills/dub-video ~/.agents/skills/orcadub   # Codex

# 确保 Node 可用，以便技能可以运行 `npx -y @orcadub/cli`
#（或将预构建的 `orcadub` 二进制文件放在 PATH 中），并导出您的 API 密钥：
export ORCADUB_API_KEY=sk-orca-...

您需要一个 OrcaRouter API 密钥（sk-orca-...）——在 OrcaRouter 控制台（令牌管理页面）创建一个。将其导出为 ORCADUB_API_KEY，以便 CLI 进行身份验证；配音任务按源视频分钟数计费。

使用

直接提出请求：

把这个配音成日语：https://www.youtube.com/watch?v=…

dub-video 技能驱动整个流程——它确认必要细节（源/目标语言、源文件或 URL、标题），提交任务，轮询直到完成，然后询问是否将 MP4 保存到本地。

配音选项

create 需要 --source-lang、--target-lang、一个源（upload 的 --file-id 或远程 --url），以及 --video-name（与 --file-id 一起使用）。可选开关映射到 OrcaDub 网站 上的标签，并通过可重复的 --opt <参数>=true 标志传递：

网站标签	参数	网站标签	参数
保留背景音频	--opt preserve_bgm=true	音量匹配	--opt loudness_enabled=true
覆盖水印	--opt watermark=true	翻译歌曲	--opt song_translation=true
移除水印/字幕（付费）	--opt remove_watermark=true

详情请参阅 skills/dub-video/SKILL.md。

内部组件

组件	功能
CLI @orcadub/cli	5 个子命令：health、upload、create、get、download
技能 dub-video	教会智能体何时配音以及如何执行 upload → create → poll → download 流程（计费前询问，下载前确认）

CLI / 二进制文件详情

预构建的二进制文件、Docker 用法以及完整的子命令参考请在 orcadub-mcp-server 仓库中查找。同一个二进制文件在未指定子命令时也可以作为 MCP 服务器运行，适用于更喜欢常驻 MCP 连接而非一次性 CLI 的主机。

许可证

MIT