视频制作工作台 xuanyuanzhifeng/dsh-plugin-video

DeepSeek Harness 视频制作智能体

为你的 DeepSeek Harness 装上视频制作能力。

dsh-plugin-video 是一组面向 DeepSeek Harness 的视频制作扩展。接入已有的 Harness 后，你就能用自然语言驱动一个视频制作智能体：从编写脚本、规划分镜，到生成配音与图片、制作 HTML 动画，再到检查画面和渲染 MP4。

扩展同时为 Harness 增加了视频工作台。你可以在这里确认脚本、预览画面、查看时间轴，并通过对话持续修改视频，让创作过程从需求到成片都在同一个界面中完成。

HTML 视频工作台：项目列表、视频预览、时间轴和智能体对话

主要功能

- 先确认脚本，再开始制作：查看完整文案、分镜和视觉方案，确认后再生成画面与旁白。
- 边看边改：在同一个项目中持续对话，调整内容、画面和动画。
- 配音与生图：接入 DashScope Qwen TTS，以及支持所需异步接口的图片生成服务。
- 预览与时间轴：查看画面、字幕和音频轨道，播放或拖动定位。
- 检查与导出：智能体检查 HTML 和九宫格截图；需要成片时，手动渲染 MP4。

视频项目保存在本地目录，包含 HTML、脚本、时间轴和媒体素材，方便继续编辑与管理。

安装要求

本项目是 DeepSeek Harness 的源码扩展。安装时会把视频功能接入本地 Harness 源码，再由 Harness 完成构建和启动。通过 GitHub 下载即可，无需发布或安装本项目的 npm 包。

准备以下环境：

| 项目 | 要求 |
| Node.js | ^22.19 或 >=24 |
| pnpm | 11.7.0 |
| DeepSeek Harness | 可构建的 0.1.5-alpha.1 源码目录，建议单独准备一份用于视频工作台 |
| 模型服务 | 已配置可用的模型 API Key |
| 媒体服务 | 配音需要 DashScope Qwen TTS 凭据；使用 AI 生图时另需图片服务配置 |

当前版本仍处于早期阶段：同版本号的不同 Harness 源码可能存在接口差异，尚未完成全新公开上游版本的完整安装与视频生成验证。安装脚本会先检查环境；详细范围见验证记录。

快速安装

下载或克隆本仓库，进入仓库目录后，运行一条命令：

pnpm run setup:video --harness "/path/to/deepseek-harness" --start

把路径替换为你的 DeepSeek Harness 源码目录。脚本会自动检查环境、备份并安装扩展、安装依赖、完成构建、检查产物，最后启动视频工作台。macOS、Linux 和 Windows 使用同一条命令，无需先在本仓库执行 pnpm install。

首次安装需要下载依赖并构建，请等待终端输出。任何一步失败都会停止并显示失败阶段；处理错误后可重新执行同一条命令。只安装不启动时，去掉 --start；只预览安装变化时，将它换成 --dry-run。

默认配置与会话保存在本仓库的 .local/runtime，与已有 Harness 用户目录分开。需要指定其他位置时，添加 --home "/path/to/video-home"，后续启动也使用相同参数。分步安装和单独启动方式见安装说明。

配置 API Key

模型 API Key 通过 Harness 的模型与凭据配置提供。由于默认使用独立用户目录，已有 Harness 环境中的凭据不一定会自动带入。

配音和生图在视频工作台右上角的齿轮按钮中配置：

1. 音频生成：填写 DashScope API Key，确认 Base URL，并选择默认音色。
2. AI 图片生成：需要生成图片时，填写图片服务的 Base URL 和 API Key。
3. 点击“保存”，返回项目继续创作。

媒体生成设置：配置配音与图片服务的 API Key 和默认音色

图中的图片服务地址仅用于展示配置位置。请选择支持本项目异步图片生成协议的服务，不能直接替换成任意 OpenAI 兼容接口。配音默认使用 qwen3-tts-flash；具体环境变量和接口要求见配置说明。

也可以通过启动环境或 Harness 支持的凭据配置方式提供 Key，变量名见 .env.example。该示例文件中的 Key 均为空，扩展脚本不会自动加载它。请勿将真实密钥提交到 Git 仓库。

制作第一条视频

1. 描述需求

点击“新建项目”，输入主题、受众、时长和希望采用的风格。例如：

做一段面向编程初学者的中文横屏视频，用三个分镜讲清楚“把复杂任务拆成小步骤”。画面简洁，搭配中文旁白。先给我脚本确认。

2. 确认脚本与分镜

智能体会先整理完整文案和分镜方案。打开“脚本”页签审阅；需要调整时直接在右侧对话中说明，确认后再开始制作。

脚本页展示视频简介、受众与目标、完整文案及分镜列表

图中展示的是已完成项目的脚本页。新项目会先等待脚本确认，再进入制作阶段。

3. 预览并继续修改

制作完成后，进入“预览”页签播放视频，使用时间轴定位画面。需要修改时继续向智能体描述，例如“第二个分镜的文字太多，改成三个图标逐个出现”。

智能体会检查 HTML，并生成九宫格截图检查画面。修改脚本、分镜顺序或时长时，会重新进入脚本确认流程。

4. 导出 MP4

确认预览效果后，进入“MP4”页签点击渲染。默认制作流程会先交付可预览的 HTML，不会自动渲染成片；也可以在对话中明确要求智能体导出 MP4。

预览播放器中的字幕来自时间轴数据，不能据此认定导出的 MP4 已包含字幕。需要带字幕的成片时，请检查实际渲染结果。

项目默认保存在 ~/deepseek-harness-html-video。设置 DSH_VIDEO_PROJECTS_ROOT 可以更改保存位置。

更新与恢复

更新仓库后，重新执行安装与构建命令。安装器会跳过内容相同的文件，并在替换文件前保存备份；请保留安装完成时输出的备份路径。

需要恢复时执行：

node scripts/restore.mjs --backup "/path/to/printed-backup.json"
如果文件在安装后又被修改，恢复会停止，避免覆盖你的编辑。多次安装请按逆序恢复。恢复不处理依赖锁文件、构建输出、会话或视频项目；恢复后需重新安装依赖并构建。涉及旧文件删除的升级，请同时查看对应版本的迁移说明。

开发与帮助

| 目录 | 内容 |
| packages/video/video-studio | 视频服务与智能体工具 |
| packages/client/ui-video-studio | 浏览器工作台 |
| packages/bundle/video-app | 插件组合配置 |
| presets/html-video | 视频智能体提示词与工具配置 |
| skills/hyperframes | 随附的精简制作指导 |
| scripts | 安装、构建、启动、检查与恢复脚本 |

- 安装机制
- 模型与媒体配置
- 故障排查
- 开发与测试
- 验证范围

许可

本项目采用 MIT License，保留 DeepSeek 原始版权声明。第三方依赖使用各自许可证，来源说明见 NOTICE.md。