dsh-video-studio

安装与首次配置

1. 准备运行环境

需要准备	用途	什么时候需要
DSH Desktop，提供插件所需的服务接口	运行插件，提供会话、模型和任务服务	始终需要
本机 Chrome 或 Chromium	捕获实际画面帧并参与视频渲染	实际帧检查和导出时
FFmpeg	视频编码、音频处理与混音	导出或处理声音时
ffprobe	读取音频与成片信息	导入音频、检查媒体时
DSH 中已配置的模型	理解需求、生成分镜和画面、按要求改片	使用模型创作时
本机语音或自有语音服务	把旁白文字合成为音频	需要自动配音时，可选

手动编辑已有工程、预览和本地导出不需要调用聊天模型。聊天模型与配音服务分别配置。

尚未安装浏览器时，可以从 Chrome 官网下载。FFmpeg 可从其下载页面查找对应系统的构建；macOS 用户如果已安装 Homebrew，也可以按 FFmpeg 软件包说明运行 brew install ffmpeg。完成安装后，按下文检查 FFmpeg 和 ffprobe 的路径。

2. 安装并启用插件

1. 准备与当前版本对应的安装包，例如 dsh-video-studio-0.5.2.tgz。可使用维护者提供的包，或按开发与扩展中的步骤自行构建。
2. 打开 DSH 的 插件管理 → 添加插件，填写 .tgz 文件的绝对路径。
3. 安装完成后启用插件。安装与启用是两个步骤，请确认插件已处于运行状态。
4. 点击 DSH 侧栏的 映流 · 视频工作台，进入影片首页。

普通使用不需要克隆源码，也不需要执行后面的开发命令。

3. 检查本地渲染工具

在影片首页点击 环境设置；进入工作台后，也可以点击右上角的 环境。

三个工具分别显示「已就绪」或「待配置」。修改路径后，点击「保存并检查环境」。

插件会尝试自动查找工具。如果显示「待配置」，填写对应可执行文件的绝对路径，而不是安装目录。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 的用户可以在终端运行以下命令查找位置；没有输出通常表示工具未安装，或不在当前终端的搜索路径中。

command -v ffmpeg
command -v ffprobe

点击 保存并检查环境，确认三个工具均为「已就绪」。如果修改了本机工具的安装位置，再来这里更新路径即可。

使用已有音频

1. 在 资产库 → 导入素材 中选择音频文件。
2. 打开 声音与配音，选择「音频资产」和「用途」：配音、背景音乐或音效。
3. 选择「绑定范围」。旁白通常绑定具体镜头，背景音乐通常绑定整部影片。
4. 点击 添加声音片段，设置时间和音量。需要时勾选循环播放。
5. 确认 预览和导出包含声音 已勾选，切回 影片预览，点击 刷新预览 后播放试听。

参数	如何理解
片段起点（秒）	绑定镜头时，相对该镜头开头计算；绑定全片时，相对影片开头计算
裁入（秒）	从源音频的哪个位置开始使用
裁出（源文件秒）	使用到源音频的哪个位置；留空使用到文件结尾
音量	1 为原音量，0.25 为原音量的四分之一；可以先降低背景音乐，再试听旁白是否清楚
淡入、淡出（秒）	声音渐强、渐弱的持续时间

例如，把一段音频绑定第二个镜头，起点设为 1，裁入设为 2、裁出设为 6，就会在第二个镜头开始 1 秒后，播放源文件第 2～6 秒的内容。