前言¶

智能體處理文本翻譯比較常見，但“把這個視頻做成英文版”通常不是一條簡單工具調用能完成的：要麼人工上傳到網頁應用，要麼自己接 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