前言¶
在 DSH 里用模型写文案、整理素材并不稀奇，但若要把这些内容变成可检查、可逐帧修改、最终在本机落盘的短片，常见做法往往是另开一套视频工具或手工拼 HTML 再录屏。流程割裂后，分镜、源码和导出规格很难留在同一份工程里继续迭代。
映流（dsh-video-studio）是面向 DSH Desktop 的视频制作插件：你可以在会话里让模型编排分镜并生成镜头动画，也可以打开工作台手动改文案、调声音、编辑每个镜头的 HTML/CSS/JS，最后用本机 Chrome 与 FFmpeg 导出 MP4。分镜、素材、前端源码和修改历史保存在本地工程中。当前版本 0.5.1，适配 DSH 0.2.1-rc.2，维护者 lakeofsky347 主要在 macOS Desktop 上验证；分类为工作流。插件以 MIT 许可证发布，安装前建议自行查阅 GitHub 仓库 源码与许可证；插件在 DSH 进程权限下运行。
这是什么¶
一句话定位：在对话中构思影片，在工作台里调整镜头，最后导出本地 MP4。
画面由前端代码绘制，插件已包含节点编辑器与浏览器驱动（依赖 playwright-core），无需安装 ComfyUI。目前支持图片、文字和音频输入；资料中明确说明暂不支持导入视频剪辑、云端渲染、完整图层关键帧编辑器或多人实时协作。
核心功能¶
| 你想做的事 | 在映流中的做法 |
|---|---|
| 用图文做介绍片、知识讲解或展示视频 | 提供主题和素材，让模型生成分镜与前端动画 |
| 修改某个镜头的文案、色彩或节奏 | 编辑镜头属性，或用自然语言说明修改要求 |
| 精细调整动画和布局 | 编辑每个镜头的 HTML、CSS 和 JavaScript |
| 加入旁白、背景音乐和音效 | 导入音频并安排片段，或使用已配置的配音服务 |
| 检查某个瞬间的实际画面 | 播放预览、逐帧定位、查看关键帧，或导出当前帧 PNG |
| 继续制作已有影片 | 从影片首页打开工程，查看历史、恢复修改、再次导出 |
工作台主要区域包括：顶部工具栏（创作模型、输出规格、生成/预览/导出）、左侧资产库、中间分镜画布、右侧镜头属性、下方镜头顺序与影片预览等工作面板。会话制作与工作台编辑的是同一份影片工程，可随时切换。
安装与启用¶
运行环境¶
| 需要准备 | 用途 |
|---|---|
| DSH Desktop（版本与插件 peer 依赖一致，即 0.2.1-rc.2 系列） | 运行插件、会话、模型与任务 |
| 本机 Chrome 或 Chromium | 捕获实际画面帧并参与渲染 |
| FFmpeg | 视频编码、音频处理与混音 |
| ffprobe | 读取音频与成片信息 |
| DSH 中已配置的模型 | 生成分镜与画面（可选：手动编辑与本地导出可不调用聊天模型） |
| 本机语音或自有语音服务 | 自动配音（可选） |
资料未给出 dsh plugin add github:... 类命令。官方步骤是安装 .tgz 包：
- 准备与当前版本对应的安装包，例如
dsh-video-studio-0.5.1.tgz（可使用维护者提供的包，或按仓库「开发与扩展」章节自行构建）。 - 打开 DSH 的 插件管理 → 添加插件，填写
.tgz文件的绝对路径。 - 安装完成后启用插件（安装与启用是两步）。
- 点击侧栏 映流 · 视频工作台，进入影片首页。
普通使用不需要克隆源码。
检查本地渲染工具¶
在影片首页点击 环境设置；进入工作台后也可点右上角 环境。三个工具应显示「已就绪」；若为「待配置」，填写可执行文件的绝对路径（不是安装目录）。macOS 路径示例：
| 工具 | 路径示例 |
|---|---|
| Google Chrome | /Applications/Google Chrome.app/Contents/MacOS/Google Chrome |
| FFmpeg（Apple Silicon Homebrew） | /opt/homebrew/bin/ffmpeg |
| ffprobe（Apple Silicon Homebrew） | /opt/homebrew/bin/ffprobe |
在终端可先用下面命令确认 FFmpeg 是否在 PATH 中：
command -v ffmpeg
command -v ffprobe
修改路径后点击 保存并检查环境，确认三项均为「已就绪」。
典型用法¶
方式一：从 DSH 会话开始¶
适合已在对话中整理好主题、文案或素材的情况。
- 打开可使用视频工具的 DSH 会话，上传图片、文字或音频。
- 说明主题、目标片长、画幅与内容；人名、产品名与数据需写准确。
- 让模型先创建工程、整理分镜，再生成画面。示例提示（摘自 README）：
用我上传的三张街景照片，制作一部约 30 秒的中文城市漫步短片。横屏 16:9，1920 × 1080，30 FPS。分为开场、街巷细节和收尾三个部分，文字简洁，图片缓慢移动。先创建工程并整理分镜，再生成画面。保留可编辑的文字、颜色和图片参数，导出前检查实际帧。这次先做无声版。
- 从视频工具结果卡片打开工作台查看影片或指定帧。
- 局部修改时限定范围，例如只改第二个镜头并检查首帧、中间帧、末帧。
- 确认后在会话中让模型导出，或在工作台点击 导出视频。
耗时的渲染或配音由 DSH 后台任务处理。
方式二：从工作台开始¶
- 新建影片，填写名称、主题、初始目标片长（秒）和初始输出比例。
- 在 资产库 导入素材或添加文字；图片支持 PNG、JPEG、WebP；文字支持 TXT、Markdown 或粘贴；音频支持 WAV、MP3、M4A、AAC、FLAC、OGG。
- 在 创作模型 中选择已配置的提供方与模型，点击 生成分镜，再 生成画面。
- 预览 后继续调整；需要声音时配置 声音与配音；完成后设置 输出设定 并导出 MP4。
生成分镜 与 生成画面 是两步；再次点击「生成分镜」会重新编排整套镜头。已有影片只需局部改动时，应使用镜头属性或「修改这个镜头」，而不是整片重分镜。
风格库与源码¶
影片首页的 视频制作风格 可导入 Markdown、TXT、JSON 或 ZIP 风格包；JSON 可含 name、description、prompt 等字段。风格库保存在本机工程目录的 styles.json 中。
需要精细控制时，在 前端源码 中编辑 HTML、CSS、JS，保存后 刷新预览。源码草稿未提交时会阻止预览与导出；自定义源码若要与右侧属性联动，需读取 ctx.params（详见仓库 docs/API.md）。
配音（可选）¶
导入音频后在 声音与配音 中添加片段并绑定镜头或全片；勾选 预览和导出包含声音。
macOS 本机语音示例：语音端点填 local:say，启用后「声音」可填如 Tingting，保存后在镜头旁白处 生成镜头配音。远程服务需填写兼容接口地址及模型、声音 ID 等；Key 由 DSH 凭据服务保存，不写入影片工程。
适用场景与注意¶
适合谁： 需要在 DSH 工作流里把图文/音频做成可编辑短片、并坚持本地 MP4 导出的开发者或内容制作者；接受「镜头级前端动画 + 本机渲染」而非专业 NLE 或云端成片。
限制（以 README 为准）： 无视频剪辑导入、无云端渲染、无完整关键帧图层编辑器、无多人实时协作；子代理协作依赖 DSH 自身代理与任务能力。
安全与合规： 插件随 DSH 进程运行，安装 .tgz 前请阅读仓库源码与 MIT 许可证；使用远程配音时，旁白文本会提交到你配置的端点。
DeepSeek Harness 社区插件目录由独立站点维护（SkillHub 插件页），与 DeepSeek / 幻方无官方从属关系；「一切皆插件」是 DSH 生态的常见组织方式，映流是其中一条工作流向的视频制作路径。
结尾¶
映流把「模型生成分镜与前端动画」「工作台可视化与源码编辑」「Chrome + FFmpeg 本地导出」收进同一套本地工程。若你的目标是在 DSH 里完成从素材到 MP4 的闭环，可按 .tgz 安装、配好 Chrome 与 FFmpeg，再从会话或影片首页选一条路径试做第一部无声短片。
- 目录页：https://www.skillhub.cn/plugins/lakeofsky347/dsh-video-studio
- GitHub：https://github.com/lakeofsky347/dsh-video-studio
