前言¶
在 DeepSeek Harness（DSH）裏做翻唱或變聲，常見做法是手動拼分離、推理、混音腳本，或依賴某個 WebUI 逐步點選。流程長、參數分散，agent 也很難按固定順序做體檢、試聽和失敗判斷。dsh-rvc-cover 是 SB-TDM 維護的 Windows 向 DSH 插件：不自帶 RVC 引擎和音色權重，只註冊 rvc-cover 技能，把 Applio 或 RVC 2.3 上的分離、試聽、換嗓、說話和混音步驟交給 agent 編排；真正出聲仍靠本機 Applio/RVC、ffmpeg 和你自己的 .pth。倉庫自述尚未在目標機器上跑通整首歌，安裝與聽感應自行驗證。
這是什麼¶
dsh-rvc-cover（GitHub：SB-TDM/dsh-rvc-cover）歸類爲模型推理。一句話：用本機已有 RVC 模型做翻唱換嗓，並讓 Edge TTS 合成的說話走同一份 .pth，便於聽感上像同一個人。它是 DSH bundle，通過 cordis.patch.yml 插入插件隊列，lib/index.js 僅在 ctx.skills 上註冊技能，不註冊 Host 工具；引擎未裝時不會多一層必失敗的按鈕。
核心功能¶
同一模型、先聽 10 秒¶
README 強調不要一上來轉整首歌。選定 Applio 目錄和推理用 .pth 後，建議順序爲：
- 體檢：確認是 Applio（根目錄有
core.py）還是 RVC 2.3（有webui.py），並檢查解釋器、ffmpeg、模型是否存在。 - 先聽 10 秒：第一次變調調用音高爲 0；基頻腳本只給出兩個片段的音高差，不直接當作最佳調。
- 再換嗓：Applio 走
core.py infer；RVC 2.3 無對應命令行，只能開 WebUI，插件裏的convert.ps1用不上。 - 同模型說話：Edge TTS 先合成，再經同一
.pth轉換；需聯網，不能代替試聽。 - 混音：伴奏隨移調；編碼後回讀響度。人聲軌 +2 dB 是軌增益，不是相對伴奏測出來的電平。
文件生成不等於完成；說話、低音和高音需一起聽，是否像同一人只能人耳判斷。
腳本與引擎識別¶
- 換嗓：
convert.ps1傳遞 Applio 的--volume-envelope；無.index時仍傳空--index-path，檢索強度降爲 0。 - 說話：
speak.ps1走官方 TTS 再 RVC；默認源語音zh-CN-XiaoxiaoNeural，目標音色來自你的模型。 - 混音：
mix.ps1優先 rubberband 移調伴奏，否則退回 ffmpeg；傳入-Source才與原曲比時長。 - 參數說明：
assets/references/parameters.md說明各起點值及哪些僅用於試聽。
只裝 Applio Desktop 安裝包過不了體檢；腳本認的是源碼或編譯包佈局。定調需在 Applio 的 Python 裏安裝 librosa、soundfile（見下文命令）。
安裝與啓用¶
在要使用的 profile 裏安裝，本地路徑或 GitHub 均可。裝完後重啓該 profile，插件列表中應顯示「RVC 翻唱」（README 註明這一步尚未在本機驗證）。
dsh plugin --profile web add C:\path\to\dsh-rvc-cover
dsh plugin --profile web add github:SB-TDM/dsh-rvc-cover
依賴需自行準備：DeepSeek Harness CLI（@deepseek-ai/dsh，需 Node.js ≥18）、PowerShell 7、Applio 或 RVC 2.3、推理 .pth（勿用 G_*.pth）、ffmpeg/ffprobe、NVIDIA 驅動。說話依賴 Edge TTS（在 Applio 內，需聯網）。
環境變量：
| 變量 | 含義 |
|---|---|
DSH_RVC_HOME |
Applio 或 RVC 根目錄 |
DSH_RVC_MODEL |
模型文件名，不含 .pth |
未設置 DSH_RVC_HOME 時應先確認路徑，不要猜測或自行 pip install 替代引擎。
定調腳本依賴（Applio 環境）：
& "$env:DSH_RVC_HOME\env\Scripts\python.exe" -m pip install librosa soundfile
典型用法¶
倉庫內體檢與三條主腳本示例（假設當前目錄能找到引擎、模型和音頻；可加 -DryRun 只打印命令）：
pwsh -File assets/scripts/preflight.ps1 -Root $env:DSH_RVC_HOME -ModelName $env:DSH_RVC_MODEL
pwsh -File assets/scripts/convert.ps1 -InputPath vocals.wav -Out vocals_conv.wav -Model models\target.pth -Pitch 0
pwsh -File assets/scripts/speak.ps1 -Text "今天晚上見。" -Out speech.wav -Model models\target.pth
pwsh -File assets/scripts/mix.ps1 -Vocal vocals_conv.wav -Instrumental instrumental.wav -Source source.mp3 -ShiftSemitones 0 -Out cover.mp3
convert.ps1 與 speak.ps1 也可用 -ApplioRoot 指定引擎根目錄。
適用場景與注意¶
適合：已在 Windows 10/11 x64 上部署 Applio（推薦完整目錄佈局）或 RVC 2.3，有合法來源的 .pth，希望在 DSH 裏用技能驅動「體檢 → 短試聽 → 換嗓 → 同模型說話 → 混音」而不是單次按鈕調用。
注意：
- 插件以當前 dsh 進程權限運行；安裝前請閱讀倉庫源碼與 MIT 許可證。公開分發翻唱需自行處理聲音權與詞曲授權。
- 本倉庫不含 RVC、Applio 或任何權重；RVC 2.3 無 CLI 推理，與 Applio 能力不對等。
- 社區目錄 skillhub.cn 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文僅介紹該插件本身。
結尾¶
dsh-rvc-cover 把本機 RVC 翻唱與同一模型說話收成一條 agent 可遵循的技能鏈，引擎和音色仍在你自己的機器與模型上。進一步說明與 issue 見 GitHub 倉庫，目錄入口見 SkillHub 插件頁。
