前言¶
DeepSeek Harness（DSH）采用插件化架构，旨在通过扩展实现功能解耦。对于需要接入视频生成能力的场景，直接调用第三方 API 通常涉及异步轮询、文件上传与预览卡片展示等繁琐操作。dsh-video-gen 插件通过封装 MiniMax H3 模型（经由 easyframe 中转），为 DSH 的 Web Profile 提供了开箱即用的视频生成能力，涵盖文生视频、图生视频及可视化工作台。
这是什么¶
该插件由 oebeliever 维护，属于模型推理类插件。它通过注册 video-generate、video-image2video 等工具，将 MiniMax H3 的接口能力注入 DSH。Host 端处理核心逻辑与文件存储，Client 端提供设置卡片、对话内预览及可视化工作台。底层使用 Node.js ≥ 20 的原生 fetch，无第三方运行时依赖。
核心功能¶
- 多模式生成：支持文生视频、首帧图生、首尾帧过渡、尾帧续写、参考生成（最多9张图+3个音频）。
- 异步任务处理：自动轮询任务状态，支持通过
video-status续查、video-cancel取消、video-queue查看队列。 - 对话内预览：生成完成后，MP4 文件以预览卡片形式展示在对话中，支持播放与下载。
- 可视化工作台：位于输入框上方，提供类似即梦的四步界面，支持素材拖拽上传、历史视频库及实时额度显示。
- 参数控制：可配置模型档位（base/fast/mini）、清晰度（480p/720p）、画幅（9种）、时长（5-15秒）及提示词优化开关。
- 环境变量支持：支持通过环境变量或本地明文配置 API Key。
安装与启用¶
该插件面向 DSH 的 web profile。安装前需确保环境满足：Node.js ≥ 20，pnpm。
- 运行以下命令安装插件：
dsh plugin --profile web add github:oebeliever/dsh-video-gen
- 安装完成后，必须重启 DSH（重新运行
dsh web）。
配置¶
重启后，进入 设置 → 插件 → 插件配置 → MiniMax H3 视频生成。
- API Key：需要 easyframe 平台的 Key（格式
sk-...），明文保存在~/.dsh/settings.yaml，也可使用环境变量MINIMAX_API_KEY。 - 接口地址：默认为
https://minimax.api.easyframe.cn。 - 模型档位：仅支持
minimax-h3-base、minimax-h3-fast、minimax-h3-mini三个档位。 - 其他参数：包括清晰度、画幅、时长及轮询时长等。
对话工具¶
安装后，AI 会自动获得以下工具，可在对话中直接调用：
- video-generate：文生视频。传入描述即可自动创建任务并轮询下载。
- video-image2video：图生视频。传图片路径（1张为首帧，2张为首尾帧，≥3张为参考图）。
- video-status：查询任务状态，支持续等。
- video-cancel：取消排队或生成中的任务。
- video-queue：查看并发上限、排队数与当前 Key 的任务位置。
典型用法¶
- 生成 10 秒横版视频：
video-generate 10秒横版视频：黄昏城市天台，镜头缓缓推近... - 首尾帧过渡：
video-image2video 首帧 D:\shots\sky.png 尾帧 D:\shots\night.png 过渡 8秒... - 查询队列：
video-queue
视频生成工作台¶
在对话输入框上方，存在一个「视频生成工作台」。其操作流程为：
1. 设置画面参数（模型、清晰度、画幅、时长）。
2. 选择生成模式与上传素材（支持拖拽）。
3. 使用「✨ 自动生成提示词」组装提示词。
4. 点击生成，查看实时轮询结果。
输出与存储¶
生成的 MP4 默认保存至会话目录的 outputs/video/，重名自动编号。历史视频保存在 ~/.dsh/storages/video-gen/library（保留 7 天，最多 300 条）。
注意事项¶
- 插件默认不并发，避免资源耗尽。
- 需要有效且充值的 easyframe API Key。
- 仅支持 MiniMax H3 的三个指定档位。
- API Key 仅在本机明文保存。
总结¶
dsh-video-gen 将 MiniMax H3 的视频生成能力无缝集成到 DeepSeek Harness 的对话流中，通过 CLI 工具与可视化工作台，解决了异步任务管理与文件预览的痛点，适合需要快速构建视频生成能力的 DSH 用户。
