前言¶
在 DeepSeek Harness (DSH) 的对话中编写视频脚本或剧本后，往往需要切换到外部工具进行预览和导出。DSH Video Studio 将视频编辑视图整合进 DSH 工作区，允许你在保持对话、工作区和作曲器并排的情况下进行剪辑。
安装与启动¶
此插件依赖 Node.js 22.12+ 和 pnpm。安装前请确保环境满足要求。
npx @deepseek-ai/dsh plugin --profile web add -w github:lovstudio/dsh-video-studio
npx @deepseek-ai/dsh web
如果 DSH 已在运行，安装后需重启应用。启动后，在现有对话中打开 Video 标签页，或在空白会话中点击 Start editing。项目可指定版本标签，例如锁定到 v0.2.2：github:lovstudio/dsh-video-studio#v0.2.2。
核心功能¶
DSH Video Studio 提供以下核心能力：
* 媒体库与时间轴：支持视频、音频、标题和字幕轨道，提供媒体库浏览和帧级预览。
* Remotion 集成：使用 Remotion 驱动预览与 MP4 渲染，GSAP 动画会自动同步到合成帧。
* ASR 语音识别：支持可插拔的语音识别服务，需配置服务器端点。
* 协作与保存：支持将当前项目状态（ID、剪辑、播放头）移交至 DSH Agent，实现双向编辑。
工作区与项目管理¶
插件通过 DSH 会话元数据解析工作区路径，允许你浏览并导入工作区内的媒体文件到项目媒体库。源文件本身保持不变，项目 JSON 仅保留媒体引用，不嵌入源文件。
- 画布模型：Portrait（竖屏）和 Square（方屏）画布共享同一项目模型。
- 数据存储：项目默认保存在
$DSH_HOME/video-studio（或~/.dsh/video-studio）。服务器保存操作具有原子性。 - 演示项目：新会话以空时间轴开始。演示项目（如标题）需手动打开。旧版本自动生成的演示项目不再自动替换当前会话，仅保留供手动打开。
API 与配置¶
插件提供 RESTful API 接口处理渲染、ASR 和文件管理。渲染任务使用不可变的项目快照，支持进度查询、取消和 MP4 下载。
ASR 功能需要显式配置服务器端点和模型。环境变量设置如下：
export DSH_VIDEO_ASR_ENDPOINT='https://your-provider.example/v1/audio/transcriptions'
export DSH_VIDEO_ASR_MODEL='your-timestamp-capable-model'
注意事项¶
- 需要安装 Node.js 22.12+ 和 pnpm。
- DSH 已运行时安装插件后需重启。
- ASR 需要配置支持时间戳的服务器端点。
- 演示项目需手动打开。
- 项目 JSON 仅保留媒体引用，不包含源文件。
- 竖屏和方屏画布共享项目模型。
生态链接¶
该插件为社区贡献项目，遵循 MIT 许可证。更多详情及源码请访问：GitHub 仓库。
