前言¶
在 DSH 裏用模型寫文案、整理素材並不稀奇，但若要把這些內容變成可檢查、可逐幀修改、最終在本機落盤的短片，常見做法往往是另開一套視頻工具或手工拼 HTML 再錄屏。流程割裂後，分鏡、源碼和導出規格很難留在同一份工程裏繼續迭代。
映流（dsh-video-studio）是面向 DSH Desktop 的視頻製作插件：你可以在會話裏讓模型編排分鏡並生成鏡頭動畫，也可以打開工作臺手動改文案、調聲音、編輯每個鏡頭的 HTML/CSS/JS，最後用本機 Chrome 與 FFmpeg 導出 MP4。分鏡、素材、前端源碼和修改歷史保存在本地工程中。當前版本 0.5.1，適配 DSH 0.2.1-rc.2，維護者 lakeofsky347 主要在 macOS Desktop 上驗證；分類爲工作流。插件以 MIT 許可證發佈，安裝前建議自行查閱 GitHub 倉庫 源碼與許可證；插件在 DSH 進程權限下運行。
這是什麼¶
一句話定位：在對話中構思影片，在工作臺裏調整鏡頭，最後導出本地 MP4。
畫面由前端代碼繪製，插件已包含節點編輯器與瀏覽器驅動（依賴 playwright-core），無需安裝 ComfyUI。目前支持圖片、文字和音頻輸入；資料中明確說明暫不支持導入視頻剪輯、雲端渲染、完整圖層關鍵幀編輯器或多人實時協作。
核心功能¶
| 你想做的事 | 在映流中的做法 |
|---|---|
| 用圖文做介紹片、知識講解或展示視頻 | 提供主題和素材，讓模型生成分鏡與前端動畫 |
| 修改某個鏡頭的文案、色彩或節奏 | 編輯鏡頭屬性，或用自然語言說明修改要求 |
| 精細調整動畫和佈局 | 編輯每個鏡頭的 HTML、CSS 和 JavaScript |
| 加入旁白、背景音樂和音效 | 導入音頻並安排片段，或使用已配置的配音服務 |
| 檢查某個瞬間的實際畫面 | 播放預覽、逐幀定位、查看關鍵幀，或導出當前幀 PNG |
| 繼續製作已有影片 | 從影片首頁打開工程，查看歷史、恢復修改、再次導出 |
工作臺主要區域包括：頂部工具欄（創作模型、輸出規格、生成/預覽/導出）、左側資產庫、中間分鏡畫布、右側鏡頭屬性、下方鏡頭順序與影片預覽等工作面板。會話製作與工作臺編輯的是同一份影片工程，可隨時切換。
安裝與啓用¶
運行環境¶
| 需要準備 | 用途 |
|---|---|
| DSH Desktop（版本與插件 peer 依賴一致，即 0.2.1-rc.2 系列） | 運行插件、會話、模型與任務 |
| 本機 Chrome 或 Chromium | 捕獲實際畫面幀並參與渲染 |
| FFmpeg | 視頻編碼、音頻處理與混音 |
| ffprobe | 讀取音頻與成片信息 |
| DSH 中已配置的模型 | 生成分鏡與畫面（可選：手動編輯與本地導出可不調用聊天模型） |
| 本機語音或自有語音服務 | 自動配音（可選） |
資料未給出 dsh plugin add github:... 類命令。官方步驟是安裝 .tgz 包：
- 準備與當前版本對應的安裝包，例如
dsh-video-studio-0.5.1.tgz（可使用維護者提供的包，或按倉庫「開發與擴展」章節自行構建）。 - 打開 DSH 的 插件管理 → 添加插件，填寫
.tgz文件的絕對路徑。 - 安裝完成後啓用插件（安裝與啓用是兩步）。
- 點擊側欄 映流 · 視頻工作臺，進入影片首頁。
普通使用不需要克隆源碼。
檢查本地渲染工具¶
在影片首頁點擊 環境設置；進入工作臺後也可點右上角 環境。三個工具應顯示「已就緒」；若爲「待配置」，填寫可執行文件的絕對路徑（不是安裝目錄）。macOS 路徑示例：
| 工具 | 路徑示例 |
|---|---|
| Google Chrome | /Applications/Google Chrome.app/Contents/MacOS/Google Chrome |
| FFmpeg（Apple Silicon Homebrew） | /opt/homebrew/bin/ffmpeg |
| ffprobe（Apple Silicon Homebrew） | /opt/homebrew/bin/ffprobe |
在終端可先用下面命令確認 FFmpeg 是否在 PATH 中：
command -v ffmpeg
command -v ffprobe
修改路徑後點擊 保存並檢查環境，確認三項均爲「已就緒」。
典型用法¶
方式一：從 DSH 會話開始¶
適合已在對話中整理好主題、文案或素材的情況。
- 打開可使用視頻工具的 DSH 會話，上傳圖片、文字或音頻。
- 說明主題、目標片長、畫幅與內容；人名、產品名與數據需寫準確。
- 讓模型先創建工程、整理分鏡，再生成畫面。示例提示（摘自 README）：
用我上傳的三張街景照片，製作一部約 30 秒的中文城市漫步短片。橫屏 16:9，1920 × 1080，30 FPS。分爲開場、街巷細節和收尾三個部分，文字簡潔，圖片緩慢移動。先創建工程並整理分鏡，再生成畫面。保留可編輯的文字、顏色和圖片參數，導出前檢查實際幀。這次先做無聲版。
- 從視頻工具結果卡片打開工作臺查看影片或指定幀。
- 局部修改時限定範圍，例如只改第二個鏡頭並檢查首幀、中間幀、末幀。
- 確認後在會話中讓模型導出，或在工作臺點擊 導出視頻。
耗時的渲染或配音由 DSH 後臺任務處理。
方式二：從工作臺開始¶
- 新建影片，填寫名稱、主題、初始目標片長（秒）和初始輸出比例。
- 在 資產庫 導入素材或添加文字；圖片支持 PNG、JPEG、WebP；文字支持 TXT、Markdown 或粘貼；音頻支持 WAV、MP3、M4A、AAC、FLAC、OGG。
- 在 創作模型 中選擇已配置的提供方與模型，點擊 生成分鏡，再 生成畫面。
- 預覽 後繼續調整；需要聲音時配置 聲音與配音；完成後設置 輸出設定 並導出 MP4。
生成分鏡 與 生成畫面 是兩步；再次點擊「生成分鏡」會重新編排整套鏡頭。已有影片只需局部改動時，應使用鏡頭屬性或「修改這個鏡頭」，而不是整片重分鏡。
風格庫與源碼¶
影片首頁的 視頻製作風格 可導入 Markdown、TXT、JSON 或 ZIP 風格包；JSON 可含 name、description、prompt 等字段。風格庫保存在本機工程目錄的 styles.json 中。
需要精細控制時，在 前端源碼 中編輯 HTML、CSS、JS，保存後 刷新預覽。源碼草稿未提交時會阻止預覽與導出；自定義源碼若要與右側屬性聯動，需讀取 ctx.params（詳見倉庫 docs/API.md）。
配音（可選）¶
導入音頻後在 聲音與配音 中添加片段並綁定鏡頭或全片；勾選 預覽和導出包含聲音。
macOS 本機語音示例：語音端點填 local:say，啓用後「聲音」可填如 Tingting，保存後在鏡頭旁白處 生成鏡頭配音。遠程服務需填寫兼容接口地址及模型、聲音 ID 等；Key 由 DSH 憑據服務保存，不寫入影片工程。
適用場景與注意¶
適合誰： 需要在 DSH 工作流裏把圖文/音頻做成可編輯短片、並堅持本地 MP4 導出的開發者或內容製作者；接受「鏡頭級前端動畫 + 本機渲染」而非專業 NLE 或雲端成片。
限制（以 README 爲準）： 無視頻剪輯導入、無雲端渲染、無完整關鍵幀圖層編輯器、無多人實時協作；子代理協作依賴 DSH 自身代理與任務能力。
安全與合規： 插件隨 DSH 進程運行，安裝 .tgz 前請閱讀倉庫源碼與 MIT 許可證；使用遠程配音時，旁白文本會提交到你配置的端點。
DeepSeek Harness 社區插件目錄由獨立站點維護（SkillHub 插件頁），與 DeepSeek / 幻方無官方從屬關係；「一切皆插件」是 DSH 生態的常見組織方式，映流是其中一條工作流向的視頻製作路徑。
結尾¶
映流把「模型生成分鏡與前端動畫」「工作臺可視化與源碼編輯」「Chrome + FFmpeg 本地導出」收進同一套本地工程。若你的目標是在 DSH 裏完成從素材到 MP4 的閉環，可按 .tgz 安裝、配好 Chrome 與 FFmpeg，再從會話或影片首頁選一條路徑試做第一部無聲短片。
- 目錄頁：https://www.skillhub.cn/plugins/lakeofsky347/dsh-video-studio
- GitHub：https://github.com/lakeofsky347/dsh-video-studio
