前言¶

在 DeepSeek Harness（DSH）裏做 Agent 協同動畫，常見做法是單獨 clone 工程、手動 npm install、再開終端跑 Vite 構建和服務，最後還要自己拼 MCP 連接器 JSON。步驟多、端口和目錄容易丟，換瀏覽器或重啓 DSH 後狀態也不好對齊。

下面介紹社區插件 dsh-remotion-launcher（維護者 laojingwei，分類：工作流）。它只做「啓動器」：在 DSH 頁面裏用懸浮面板完成 Remotion Studio 工程的安裝指向、前端構建、服務啓停，並生成可直接粘貼的 MCP 配置。動畫工程本身是另一個包 remotion-studio-mcp，需要單獨安裝；插件不含工程源碼。

這是什麼¶

dsh-remotion-launcher 是面向 DSH Web 側的工作流插件。Host 半部跑在 DSH 的 Node 進程裏，負責 spawn 構建與服務進程；Client 半部在瀏覽器裏提供可拖動的懸浮按鈕與操作面板。配置（工程目錄、端口、下載源等）落在本機 ~/.dsh/remotion-launcher.json，換瀏覽器不會丟。

Remotion Studio 工程以 MCP 模式對外提供工具；服務跑起來後，你仍需在 DSH 連接器裏掛上 MCP，Agent 才能調用工程生成網頁動畫視頻。面板裏的「MCP 配置」會按當前路徑和端口生成 JSON，無需手拼路徑。

核心功能¶

裝完並重啓 DSH 後，右下角會出現可拖動的懸浮按鈕，點開面板包含這些區域：

接上 MCP 時，兩種接法可在面板切換（選擇記在本機）：

• stdio：command: node 加工程內 tsx 與 server/mcp-proxy.ts，SERVER_URL 指向本機端口；服務未開時首次調用可自動拉起。
• HTTP：{ "type": "http", "url": "http://127.0.0.1:<端口>/mcp" }；依賴已在跑的服務，服務停則斷連。

卡片左側圓點表示就緒：綠色可用，黃色表示缺工程、依賴或服務未就緒；下方一行會說明缺什麼。

DSH 退出時，插件會結束自己拉起的子進程，避免端口被孤兒進程佔用。若啓動前探活發現端口上已有 /api/health 可達的服務，會標記爲「已在運行（非本插件啓動）」，不會重複拉起，也無法從面板停止該實例。

安裝與啓用¶

DSH 版本要求：>=0.2.1-rc.2（插件 package.json 中 engines.dsh 爲 >=0.2.1-rc.2 <0.3.0）。Node 要求：^22.19.0 || >=24.0.0。

第一步：安裝插件（三選一）¶

npm（國內可走 npmmirror 鏡像源）：

dsh plugin --profile web add dsh-remotion-launcher

GitHub：

dsh plugin --profile web add github:laojingwei/dsh-remotion-launcher

本地開發：

dsh plugin --profile web add "link:<插件目錄>"

也可在 DSH 設置 → 插件 → 添加插件 中填寫包名或地址。裝完後重啓 DSH（客戶端清單在啓動時構建）。

第二步：安裝工程¶

插件不含工程。重啓後面板第一行會顯示「工程 · 未安裝」，點「安裝」：

• 使用此目錄：本機已有 clone 或解壓的工程，直接指向該目錄。
• 下載並安裝：從 npm 拉取 remotion-studio-mcp 到所選目錄（可選 npmmirror / npm 官方 / 自定義 registry）。

自行 clone 工程示例：

git clone https://github.com/laojingwei/remotion-studio-mcp.git <工程目錄>
cd <工程目錄>
npm install

然後在面板 更換 → 選擇該目錄 → 使用此目錄。

工程包也可從 GitHub 或 npm 獲取；默認下載包名由環境變量 REMOTION_PROJECT_PACKAGE 控制，默認值爲 remotion-studio-mcp。

典型用法¶

1. 安裝插件並重啓 DSH，在面板裏安裝或指向 remotion-studio-mcp 工程根（需含 package.json 與 server/）。
2. 點「構建前端」，等待 dist/web 生成；構建進行中不會疊加第二次構建，且構建期間不能啓動服務。
3. 確認端口（默認 4380，可在面板修改），點「啓動」；日誌區查看輸出。服務運行中不能構建、換工程或改端口。
4. 在 MCP 配置 中選 stdio 或 HTTP，點「複製 JSON」，粘貼到 DSH 連接器管理頁的自定義連接器，再點「信任」。
5. 在 DSH 右側欄「瀏覽器」標籤可打開與服務相同的界面，與 Agent 共用；之後通過 Agent 調用 MCP 工具生成動畫。

可選環境變量（工程目錄優先級：面板設置 → 自動探測 → 環境變量）：

適用場景與注意¶

適合已經在用或打算用 Remotion Studio MCP 工程、希望在 DSH 內集中完成構建、啓停和 MCP 接線的工作流場景。插件與工程是兩個獨立包；只裝啓動器無法生成視頻，必須再裝工程並配置 MCP。

插件以當前 DSH 進程的權限在本機 spawn 子進程（含 npm pack、npm install、vite build、tsx 服務）。安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認路徑、registry 與端口策略符合你的環境。

已知約束包括：構建與服務互斥；停止超過約 6 秒可「強制重置」（僅清插件狀態）；非 npm 安裝的啓動器更新需按面板提示卸載後重裝，npm 安裝方式支持一鍵更新（能否熱換取決於 DSH HMR 與新實例握手）。

DeepSeek Harness 社區插件目錄託管在獨立站點 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係；生態理念是「一切皆插件」，本插件是工作流類社區貢獻之一。

結尾¶

dsh-remotion-launcher 把 Remotion Studio 工程的構建、服務生命週期和 MCP JSON 準備收進 DSH 面板，減少重複開終端和手配連接器。工程仍用 remotion-studio-mcp，Agent 側能力取決於 MCP 配置是否就緒。

• 目錄頁：https://www.skillhub.cn/plugins/laojingwei/dsh-remotion-launcher
• GitHub：https://github.com/laojingwei/dsh-remotion-launcher