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