前言¶

智能体处理文本翻译比较常见，但“把这个视频做成英文版”通常不是一条简单工具调用能完成的：要么人工上传到网页应用，要么自己接 ffmpeg、ASR、翻译、TTS 和时间轴对齐。

pinch-eng/dsh-audio-dub 是 DeepSeek Harness（DSH）的配音插件，把这条流程封装成服务端任务：传入本地路径或直连媒体 URL，返回一个保留原说话人声音的成品配音。

这是什么¶

它是由 pinch-eng 维护的 DSH 配音插件，MIT 许可，包版本 0.1.0。

核心定位是：把视频或音频翻译成另一种语言，同时保留原说话人的声音，也就是 AI voice cloning。转录、翻译、语音克隆和 timing 都在服务端完成，DSH 侧等待结果。

插件提供三个工具：

• dub_media
• dub_status
• dub_languages

支持的目标语言包括：

zh, en, es, fr, de, pt, ru, ja, ko, it

源语言可以是 auto。

核心工具¶

dub_media¶

用于提交一次配音任务。

本地文件会先以流式方式上传到 presigned upload target，再提交任务。

等待预算耗尽不等于任务失败。任务仍会在服务端继续，返回的 job_id 可以交给 dub_status 查询。

dub_status¶

用于查询任务状态。

dub_languages¶

无参数。

该工具是本地查询，不产生网络调用，也不产生费用。

安装与启用¶

先把插件安装到 DSH profile。以 headless profile 为例：

dsh plugin --profile headless add github:pinch-eng/dsh-audio-dub

安装时插件会自行注册，不需要手工编辑 cordis.yml。

然后设置 API key：

export PINCH_API_KEY=pk_xxx

可以尝试一次配音任务：

dsh --profile headless "dub ./demo.mp4 into English"

配置¶

下面是插件的配置项和默认值：

MCP 替代¶

如果不安装插件，也可以通过官方 bridge 使用 hosted MCP server：

- id: mcp-pinch
  name: '@deepseek-ai/dsh-mcp-client'
  config:
    serverName: pinch
    transport: streamable-http
    url: https://portal.startpinch.com/api/mcp
    headers:
      Authorization: !!js `Bearer ${process.env.PINCH_API_KEY}`

插件路径更适合把“配音一个本地文件或直链媒体”作为一个任务工具使用；MCP 路径则把同一服务以 MCP server 方式暴露。

价格与限制¶

已核实的服务限制如下：

• 价格：每 1 分钟媒体 $0.50
• 单个文件最大 60 分钟
• 单个文件最大 2 GB
• 下载链接有效期为 48 小时
• 下载链接过期后，可以再次调用 dub_status 获取新的链接

余额为空时，工具会返回 insufficient_balance，并附带 top-up URL。

安全与运行注意¶

使用这个插件时，需要注意它读取文件和访问网络的范围。

• source 是本地路径时，插件读取该文件；除此之外不读取其他本地文件。
• 网络访问限于 baseUrl 以及返回的 presigned storage target。
• API key 会作为 Authorization header 发送到 baseUrl，不会出现在工具结果中。
• 但工具参数会写入 session log，所以不要把 API key 粘贴到 prompt 里。
• key 只用于配音相关 endpoints，不能用来签发更多 key。
• source 只接受本地文件路径或直连媒体 URL；YouTube、Bilibili、社交帖子等页面 URL 不是媒体文件，会被拒绝。

插件以当前 dsh 进程权限运行。安装前建议检查源码、许可证和依赖。

运行依赖如下：

Node: ^22.19.0 || >=24.0.0

peerDependencies:
  @deepseek-ai/cordis ^4.0.1-rc.1
  @deepseek-ai/dsh-tools ^0.0.1-rc.1

适用场景¶

这个插件适合以下情况：

• 需要把本地视频或音频文件翻译成另一种语言
• 需要保留原说话人的声音
• 想在 DSH 工作流中用一次工具调用完成配音
• 源文件是本地路径或直连媒体 URL
• 可以接受按媒体时长计费，并且文件不超过 60 分钟、2 GB

如果来源是网页链接、社交平台链接或需要人工上传网页应用，这个插件不会抓取页面内容，也不会处理非媒体 URL。

链接¶

• GitHub 仓库：pinch-eng/dsh-audio-dub
• 目录页：具体 URL 未在已核实资料中给出，可在 DSH 社区目录中搜索 pinch-eng/dsh-audio-dub