DeepSeek Harness 插件：music-code-mv 代碼驅動 MV 渲染

前言¶

DeepSeek Harness (DSH) 插件生態中，ayst-z/music-code-mv 提供了將代碼轉換爲音樂視頻的能力。與依賴視頻生成模型不同，該插件通過編寫 Canvas2D 或 Three.js 代碼來逐幀生成畫面，並利用本地無頭瀏覽器和 ffmpeg 進行合成。這種方式保證了結果的確定性和可控性。

核心功能¶

該插件主要解決從代碼生成高質量、可復現視頻的需求，具備以下特性：

確定性渲染：通過 renderAt(t) 函數實現虛擬時間渲染，保證相同的時間參數 t 始終對應相同的像素輸出。
Canvas2D 與 Three.js 支持：提供內置 Canvas2D 舞臺，包含掃描線、輝光、色差分離、切片故障、顆粒和暗角等效果。同時支持通過 import map 接入 Three.js 鏡頭。
場景特效覆蓋：允許對特定場景覆蓋後期特效，對於扁平 UI 鏡頭可跳過昂貴的後期處理鏈。
高性能並行渲染：支持跨 N 個 Chrome Worker 並行渲染幀，並具備自動空白幀探測以回退到軟件渲染（或硬件加速失敗時）。
硬件編碼：自動選擇 QSV、NVENC、AMF 或 x264 進行硬件編碼，支持 AV1/HEVC。
增量重渲染：基於渲染簽名（文件內容與 import 圖）判斷幀是否需要重繪，避免重複勞動。
HDR10 輸出：支持 10-bit HEVC 輸出，色彩空間爲 Rec.2020，傳輸特性爲 PQ，並包含真實的 SDR 到 PQ 轉換（非簡單標籤）。
中文圖形界面 (MV Studio)：提供基於瀏覽器的中文操作界面，包含時間線（支持場景重疊和本地/全局時間）、工程瀏覽、歌詞解析（LRC）和實時進度條。

安裝與啓用¶

安裝該插件需要先克隆倉庫，然後通過 DSH 命令添加。

    git clone https://github.com/ayst-z/music-code-mv
    cd music-code-mv

在 DSH 配置文件中添加該插件：

    dsh plugin add .

啓動 DSH 並使用對應的 profile：

    dsh --profile demo

其他安裝方式¶

若需要從 Git 倉庫的特定 commit 安裝，或通過 tarball 安裝，可以使用以下命令：

dsh plugin --profile demo add github:ayst-z/music-code-mv#<sha>
pnpm pack && dsh plugin --profile demo add ./dsh-music-code-mv-0.2.0.tgz

如需卸載，執行：

dsh plugin --profile demo remove dsh-music-code-mv

依賴與環境¶

運行該插件需要滿足以下環境要求：
* Node.js >= 18
* Google Chrome 或 Edge
* ffmpeg (用於視頻編碼)

注意事項：
* 該插件爲純 JavaScript，無需構建步驟。
* 在 file:// 環境下，界面會自動退化爲“在瀏覽器打開”的提示。
* 部分新版 npm 可能會靜默跳過 ffmpeg-static 的二進制下載，建議使用 @ffmpeg-installer/ffmpeg 替代。
* HDR Vivid（CUVA TU-068 動態元數據）暫不支持。

適用場景¶

適合需要通過代碼精確控制視頻畫面、追求高分辨率（最高 4K/120fps）、HDR10 輸出以及確定性行爲的開發者。它不依賴外部視頻生成模型，所有渲染邏輯由本地代碼完成。

插件目錄：skillhub.cn/plugins/ayst-z/music-code-mv
源碼地址：github.com/ayst-z/music-code-mv