前言¶
在 DeepSeek Harness (DSH) 的對話中編寫視頻腳本或劇本後，往往需要切換到外部工具進行預覽和導出。DSH Video Studio 將視頻編輯視圖整合進 DSH 工作區，允許你在保持對話、工作區和作曲器並排的情況下進行剪輯。
安裝與啓動¶
此插件依賴 Node.js 22.12+ 和 pnpm。安裝前請確保環境滿足要求。
npx @deepseek-ai/dsh plugin --profile web add -w github:lovstudio/dsh-video-studio
npx @deepseek-ai/dsh web
如果 DSH 已在運行，安裝後需重啓應用。啓動後，在現有對話中打開 Video 標籤頁，或在空白會話中點擊 Start editing。項目可指定版本標籤，例如鎖定到 v0.2.2：github:lovstudio/dsh-video-studio#v0.2.2。
核心功能¶
DSH Video Studio 提供以下核心能力：
* 媒體庫與時間軸：支持視頻、音頻、標題和字幕軌道，提供媒體庫瀏覽和幀級預覽。
* Remotion 集成：使用 Remotion 驅動預覽與 MP4 渲染，GSAP 動畫會自動同步到合成幀。
* ASR 語音識別：支持可插拔的語音識別服務，需配置服務器端點。
* 協作與保存：支持將當前項目狀態（ID、剪輯、播放頭）移交至 DSH Agent，實現雙向編輯。
工作區與項目管理¶
插件通過 DSH 會話元數據解析工作區路徑，允許你瀏覽並導入工作區內的媒體文件到項目媒體庫。源文件本身保持不變，項目 JSON 僅保留媒體引用，不嵌入源文件。
- 畫布模型：Portrait（豎屏）和 Square（方屏）畫布共享同一項目模型。
- 數據存儲：項目默認保存在
$DSH_HOME/video-studio（或~/.dsh/video-studio）。服務器保存操作具有原子性。 - 演示項目：新會話以空時間軸開始。演示項目（如標題）需手動打開。舊版本自動生成的演示項目不再自動替換當前會話，僅保留供手動打開。
API 與配置¶
插件提供 RESTful API 接口處理渲染、ASR 和文件管理。渲染任務使用不可變的項目快照，支持進度查詢、取消和 MP4 下載。
ASR 功能需要顯式配置服務器端點和模型。環境變量設置如下：
export DSH_VIDEO_ASR_ENDPOINT='https://your-provider.example/v1/audio/transcriptions'
export DSH_VIDEO_ASR_MODEL='your-timestamp-capable-model'
注意事項¶
- 需要安裝 Node.js 22.12+ 和 pnpm。
- DSH 已運行時安裝插件後需重啓。
- ASR 需要配置支持時間戳的服務器端點。
- 演示項目需手動打開。
- 項目 JSON 僅保留媒體引用，不包含源文件。
- 豎屏和方屏畫布共享項目模型。
生態鏈接¶
該插件爲社區貢獻項目，遵循 MIT 許可證。更多詳情及源碼請訪問：GitHub 倉庫。
