前言¶

在 DSH 里做演示、说明或工作流回顾时，常见做法是贴文字、截图或外站视频。前者信息密度低，后者又往往要单独剪辑，还要考虑显存和专用视频模型。若希望画面风格可控、又不依赖 GPU 视频生成，需要在 Harness 会话里把「写脚本 → 出画面 → 配音配乐」串成一条可复现的流水线。

下面介绍维护者 rightnowrose 发布的工作流插件 dsh-ai-fastvideo（社区目录：rightnowrose/dsh-ai-fastvideo，源码：GitHub）。它在会话视图增加「AI 速成视频」页签：用大模型按风格提示词现写单页 Canvas，再用无头浏览器逐帧渲染，经 ffmpeg 编码并叠加 TTS、BGM、音效，得到几秒到数分钟的 MP4。画面是网页而非视频模型输出，因此不占显存。

这是什么¶

dsh-ai-fastvideo 是 DeepSeek Harness 的 Web 客户端插件（package.json 版本 0.3.1，许可证 MIT）。宿主侧由 index.js 提供 HTTP 路由与任务队列，client.js 注入会话 UI；Python 与 Node 分工处理分镜、配音、混音与 CDP 逐帧渲染。

核心价值可以概括为两点：

1. 短视频（片段）：从内置 341 条风格提示词中多选，模型按所选风格为每个场景写一个单文件 Canvas 页面，再逐帧导出、编码并配音配乐，单条大约 3–60 秒。
2. AI 自拟（长片）：只给一句要求（例如总结工作区流程），模型自行拆分镜并逐屏出画面，时长约 15–360 秒；可选风格作视觉参考，并可选用工作区、当前对话或自选文件作为材料。

核心功能¶

风格库（341 条）¶

风格资源在 assets/styles/ 下按 10 类分目录，每条对应一个 .md 提示词，并配有同名 .jpg 缩略图（可选自增：往分类目录放 .md，约 60 秒内或点「刷新」生效；批量导入见 scripts/import_styles.py）。默认 styleDir 留空即使用包内库；也可在配置里指向自定义目录。

整理与来源在 README 中写明：部分由哔哩哔哩「俯仰观照」整理/改写，另有条目来自 lemomo-ai/lemo-opuscar、mg-styles-15、code-video 等开源项目，细则见 assets/styles/SOURCES.md 与 assets/licenses/。

渲染与成片流程¶

画面不调用视频大模型：无头 Edge 或 Chrome 通过 CDP 逐帧截图，默认 Node 渲染器（engine/node/render.mjs，README 称约 70ms/帧@1080p）；无 Node 时可退 PowerShell 版，config.renderer 可取 auto、node、powershell。

成片路径对比如下（摘自 README）：

面板与健康检查¶

安装并刷新后，会话视图顶部会出现「AI 速成视频」页签。面板右上角「环境」角标对应 /ai-video/health 中的 pythonOk、ffmpegOk、browserOk、renderer、llmReady 等探测结果。

安装与启用¶

环境要求（README）：DSH 桌面版、Python 3.10+、ffmpeg 7+、Edge 或 Chrome；Node 使用 DSH 自带即可。package.json 声明 node >= 20，DSH 兼容 >=0.2.0-rc.2 或 >=0.2.1-rc.2。

正式发布后的 npm 安装方式如下：

dsh plugin --profile web add dsh-ai-fastvideo

内网或本地开发包可使用：

# plugin_manager install_bundle target=<本包目录>

装完后刷新网页，确认页签出现。插件在当前 DSH 进程权限下拉起 Python、浏览器与 ffmpeg 子进程；安装前宜浏览仓库源码与 LICENSE、NOTICE.md，确认风格库第三方许可是否满足你的使用场景。

配置¶

配置文件路径：

• Windows：%USERPROFILE%\.dsh\data\dsh-ai-fastvideo\config.json
• macOS / Linux：~/.dsh/data/dsh-ai-fastvideo/config.json

首次打开面板会自动建目录。必填项仅为大模型 apiKey（及常用的 baseUrl、model）：

{
  "llm": { "baseUrl": "https://api.deepseek.com/v1", "model": "deepseek-chat", "apiKey": "sk-..." }
}

python、ffmpeg、ffprobe、browser 等可留空，插件按「配置文件 → 环境变量 → 自动探测」解析。可选字段示例：

{
  "python": "C:\\Python311\\python.exe",
  "ffmpeg": "C:\\ffmpeg\\bin\\ffmpeg.exe",
  "ffprobe": "C:\\ffmpeg\\bin\\ffprobe.exe",
  "browser": "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
  "renderer": "auto",
  "styleDir": "",
  "bgm": { "file": "", "volume": 0.13 },
  "stickersDir": "",
  "workspaceDir": ""
}

典型用法¶

会话面板¶

1. 打开「AI 速成视频」页签，在环境角标确认 llmReady 与 ffmpeg、浏览器状态正常。
2. 片段模式：勾选一种或多种风格，填写主题或台词，提交后等待写页、渲帧与混音完成。
3. 长片模式：输入一句 brief，按需选风格与材料来源（工作区 / 对话 / 文件），指定目标时长区间内的成片。

命令行（不经过面板）¶

README 提供在 engine\python 下的示例：

cd engine\python
python -m videogen.cli quick --words "你|懂什么|听话" --out out.mp4
python -m videogen.cli build spec.json --out out.mp4
python -m videogen.auto_film --brief "讲讲这个项目" --duration 30 --out out.mp4
python -m videogen.cli doctor

doctor 与开发自测脚本 node scripts/selftest.mjs 可在无浏览器场景下粗验 health、catalog、jobs 等路径。

适用场景与注意¶

适合：需要在 DSH 会话里快速产出讲解短片、风格化台词卡、工作区或对话材料的结构化回顾；团队已有 DeepSeek API（或其它 OpenAI 兼容端点），并愿意在本机安装 ffmpeg 与 Chromium 系浏览器。

注意：

• 长片为逐屏串行写页与渲帧，1080p 下 6 分钟量级成片 README 估计约 12–15 分钟；可先降到 720p 试跑。
• 无声时常见处理：安装 edge-tts；若使用自训练音色需 GPT-SoVITS 等服务就绪。
• 渲染卡在「渲染」：0.2 起有多层超时，超时自动放弃该屏并退回模板；成片发灰时检查 health.renderer 是否为 node。
• 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态以「一切皆插件」为方向，安装与运行责任在本地环境与插件作者声明的许可范围内。

结尾¶

dsh-ai-fastvideo 把 341 条可扩展风格、Canvas 逐帧渲染与 TTS/BGM/SFX 混音收进 DSH 会话页签，用「选风格出片段」或「一句话自拟长片」两条路径覆盖常见说明类视频需求，且无需视频生成模型与显存。进一步了解实现可看仓库 docs/design.md，分发说明见 docs/publishing.md。

• 社区目录：https://www.skillhub.cn/plugins/rightnowrose/dsh-ai-fastvideo
• GitHub：https://github.com/rightnowrose/dsh-ai-fastvideo