内容
<div align="center">
<img src="assets/orcadub.png" alt="OrcaDub" width="340">
### 翻译任何视频。保留原声。
**为您的代理提供 AI 视频配音服务 — `orcadub` 技能 + [`@orcadub/mcp`](https://www.npmjs.com/package/@orcadub/mcp) 服务器。**
[](LICENSE)
[官方网站](https://orcadub.orcarouter.ai) · [MCP 服务器](https://github.com/Continuum-AI-Corp/orcadub-mcp-server) · [获取 API 密钥](https://www.orcarouter.ai/console)
</div>
---
赋予任何代理将视频配音成另一种语言的能力：上传文件或传递 URL，将作业提交给 `orca/dub` 模型，通过 [OrcaRouter](https://www.orcarouter.ai) 网关，轮询进度，并下载完成的 MP4 文件。
两个独立的组件：
- **MCP 服务器** [`@orcadub/mcp`](https://www.npmjs.com/package/@orcadub/mcp) —
可在 **任何** MCP 客户端（Claude Code、Claude Desktop、Codex、Cursor、Windsurf、…）中使用。
- **技能 `dub-video`** — 一个适用于具备技能的代理（Claude Code/Desktop、Codex、…）的普通 `SKILL.md` 工作流程指南：何时配音，在计费前请求所需参数，轮询礼仪，在下载前确认。
## 安装
**Claude Code — 一键安装插件（MCP + 技能）：**
```
/plugin marketplace add Continuum-AI-Corp/orcadub-plugin
/plugin install orcadub@orcadub-skills
```
**Codex — 一键安装插件（MCP + 技能）：**
```bash
codex plugin marketplace add Continuum-AI-Corp/orcadub-plugin
codex plugin add orcadub@orcadub-skills
```
**其他 MCP 客户端 — 仅服务器，然后可选复制技能：**
```bash
# Cursor / Windsurf / Claude Desktop 等：添加一个 stdio 服务器，命令：npx 参数：-y @orcadub/mcp 环境变量：ORCADUB_API_KEY=sk-orca-...
# （每主机配置文件：参见下面的 MCP 服务器仓库链接）
# 可选，用于具备技能的代理（安装到 orcadub/ 文件夹中）：
cp -r skills/dub-video ~/.claude/skills/orcadub # Claude Code / Desktop
cp -r skills/dub-video ~/.codex/skills/orcadub # Codex
```
您需要一个 **OrcaRouter API 密钥**（`sk-orca-...`）— 在 [OrcaRouter 控制台](https://www.orcarouter.ai/console)（令牌管理页面）中创建一个。插件在安装时提示输入它，并将其作为 `ORCADUB_API_KEY` 传递给 MCP 服务器；配音作业按源视频的分钟数计费。
## 使用
直接询问：
> 将此视频配音成日语：https://www.youtube.com/watch?v=…
`dub-video` 技能驱动整个流程 — 它确认所需细节（源语言/目标语言，源文件或 URL，标题），提交作业，轮询直到完成，然后询问是否将 MP4 文件保存在本地。
## 配音选项
`dub_create` 需要 `source_lang`、`target_lang`、源（`file_id` 来自 `dub_upload` **或** 远程 `url`）和 `video_name`（带有 `file_id`）。可选开关映射到 [OrcaDub 网站](https://orcadub.orcarouter.ai)上的标签：
| 网站标签 | 参数 | 网站标签 | 参数 |
|---|---|---|---|
| 保留背景音频 | `preserve_bgm` | 音量匹配 | `loudness_enabled` |
| 叠加水印 | `watermark` | 翻译歌曲 | `song_translation` |
| 删除水印/字幕（付费） | `remove_watermark` | | |
详见 [`skills/dub-video/SKILL.md`](skills/dub-video/SKILL.md)。
## 内部组件
| 组件 | 功能 |
|---|---|
| MCP 服务器 `@orcadub/mcp` | 5 个工具：`dub_health`、`dub_upload`、`dub_create`、`dub_get`、`dub_download` |
| 技能 `dub-video` | 教导代理何时配音以及如何运行上传 → 创建 → 轮询 → 下载流程（在计费前询问，在下载前确认） |
## MCP 服务器详情
每主机配置示例（Cursor、Windsurf、Claude Desktop、Codex）、Docker 使用、预编译二进制文件和工具参考都存放在 [orcadub-mcp-server](https://github.com/Continuum-AI-Corp/orcadub-mcp-server) 仓库中。
## 许可证
[MIT](LICENSE)
