前言¶
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 用戶。
