dsh-mv-cli：DeepSeek Harness 里的终端风格 MV 放映室

它是做什么的？

MV 放映室是 DeepSeek Harness（DSH）的娱乐类插件，在工作台里开出一块终端风格的放映区，播放与你自己音频或视频同步的音乐视频。它解决的是「想给一首歌配一段可视化画面却要另开一堆工具」的麻烦：脚本场景以你提供的音频作为时间轴，本地视频则用自身媒体时钟驱动。画面支持歌词、ASCII、Canvas2D 与 WebGL2 三维场景，由作者 Alice-Marx 以非官方同人作品形式维护，插件代码采用 MIT 协议。

核心功能

• 多渲染器场景：同一支 MV 可在 ASCII、像素 2D、WebGL2 3D 与本地视频渲染器之间切换，WebGL 不可用的客户端自动回退到通用渲染器。
• 音频驱动时间轴：脚本场景以用户自选音频为时钟，歌词与画面按音频进度推进，本地视频则保留自身媒体时钟并支持独立音频偏移。
• 本地视频导入：把已有的 MP4/M4V/MOV/WebM/MKV 帧直接搬进放映室，带声音或外挂音轨，支持拖动进度、暂停重播、音量静音、全屏与 PNG 截图。
• MV 包与创意工坊：每个 MV 包由 mv.json 描述，可在工坊里按类型、许可、标签、歌词、兼容性筛选浏览与安装。
• 歌词与 AI 创作：可选用 LRCLIB 按标题、艺人、专辑、时长查询歌词（不上传音频与文件名），也可开启 Harness Agent 会话辅助生成 MV 包。

怎么使用这个插件？

在 DSH 中启用后，侧边栏会出现 MV 放映室入口，先导入或选择一个 MV 包，再指定你自己的音频或本地视频作为时间基准即可开始放映。需要调整字号、ffmpeg 路径、歌词查询、代理与工坊镜像等行为时，在 DSH 插件配置页修改对应设置；本地偏好则保存在用户目录下的设置文件里。想放映 Manim 等外部动画，先用官方导入工具把渲染好的视频转成 MV 包文件夹再导入。

报错怎么排查？

插件因协议不匹配被禁用时，说明当前版本与 Harness 协议不一致，按官方说明升级插件并重启 Harness 即可恢复。WebGL 场景无法显示时，通常是客户端缺少 Chromium Worker OffscreenCanvas 或 WebGL2 支持，此时会回退到通用渲染器；本地视频无法解码则与 Chromium 编解码器支持有关。