前言¶
DSH 的理念是「一切皆插件」。對智能體開發者來說，用 Remotion 做視頻不只是在終端裏跑命令，還需要在會話中完成項目診斷、composition 發現、still 渲染、video 渲染，以及輸出元數據校驗。
chenjie1129/remotion-video-plugin 是一個獨立社區插件，爲 DeepSeek Harness 提供結構化的 Remotion 工作流，並註冊五個限制在當前工作區內的工具。它由 chenjie1129 維護，MIT 許可。該插件不是 DeepSeek 或 Remotion 官方項目。
這是什麼¶
一句話定位：這是一個 Remotion video creation and verified rendering plugin for DeepSeek Harness。
它解決的問題是：讓 DSH 會話能夠以可檢查、可復現的方式調用 Remotion 項目，而不是隻依賴人工寫腳本或臨時命令。
它提供兩類能力：
- 一個用戶和模型都可調用的
remotion-videoskill。 - 五個工作區受限工具：
remotion_doctor、remotion_list_compositions、remotion_render_still、remotion_render_video、remotion_probe_output。
核心功能¶
規則模塊與模板¶
該插件提供 remotion-video skill，幷包含八個 focused rule modules。
它還包含三類藍圖：
product-launchvertical-captioneddata-story
此外，它包含十個 bilingual model-to-render evaluation cases，用於模型到渲染結果的檢查。
五個工具¶
下面是五個工具的職責：
| 工具 | 職責 |
|---|---|
remotion_doctor |
診斷 package、entry point、CLI、ffprobe 和 browser readiness |
remotion_list_compositions |
返回已註冊的 composition IDs |
remotion_render_still |
渲染一張 PNG 或 JPEG still |
remotion_render_video |
渲染視頻，並進行 metadata probe |
remotion_probe_output |
返回 normalized media metadata |
這些工具會配合輸出 artifact cards，包含 workspace-relative paths、byte sizes、SHA-256 digests 和 normalized media facts。
發佈證據¶
該插件區分了幾類證據：
- 單元與 contract checks。
- real Harness probe。
- browser-backed integration。
一個 release 在該 release commit 的 browser-backed integration workflow 通過前，不被聲明爲 fully proven。Probe-only success 也不會被當作 render-tool pass。
安裝與啓用¶
環境要求¶
使用前需要滿足以下條件：
- Node.js：
^22.19.0或>=24.0.0 - DeepSeek Harness host packages before
0.2.0：dsh-skill、dsh-tools、dsh-subprocess - 一個可信的 Remotion project，且該項目帶有自己的 project-local Remotion dependencies
- 由操作者配置 Chrome/Chromium，或使用 Remotion 支持的 browser acquisition
安裝¶
下面使用已覈實的 GitHub release tag 安裝命令，將插件添加到 web profile：
dsh plugin --profile web add github:chenjie1129/remotion-video-plugin#v0.4.0
配置與檢查¶
安裝後，可以先檢查合成後的 profile：
dsh --profile web --dump-config
如果需要爲工具行配置可信瀏覽器，可以使用類似下面的配置項：
- id: remotion-video-tools
name: '@chenjie1129/dsh-remotion-video-plugin/tools'
config:
browserExecutable: /absolute/path/to/chrome-or-chromium
browserMode: chrome-for-testing
移除¶
如果要移除插件，可以卸載對應的 bundle：
dsh plugin --profile web remove @chenjie1129/dsh-remotion-video-plugin
典型用法¶
標準智能體會話示例¶
可以開始一個 standard-agent session，並給出類似下面的請求：
Create a 15-second 16:9 product-launch video. Diagnose the project, use frame-driven animation, render a representative still, then render and verify the MP4.
工具調用順序¶
一個常見的流程是先做診斷，再發現 composition，然後渲染 still 和 video，最後檢查輸出：
remotion_doctor：確認項目、entry point、CLI、ffprobe 和 browser 是否可用。remotion_list_compositions：獲取可渲染的 composition IDs。remotion_render_still：渲染一張代表性 still。remotion_render_video：渲染視頻並做 metadata probe。remotion_probe_output：讀取 normalized media metadata。
開發檢查¶
在開發或驗證插件時，可以運行下面的檢查命令：
npm ci
npm run check
npm run release:verify
npm run test:e2e -- --probe-only
這些檢查覆蓋 Node 22/24、real Harness/Remotion integration CI，以及 npm trusted-publishing automation。
適用場景與注意¶
適合使用 DSH 做智能體工作流、並希望把 Remotion 渲染步驟納入會話工具鏈的開發者。
使用前需要注意：
- 該插件是獨立社區插件，不是 DeepSeek 或 Remotion 官方項目。
- 渲染會執行所選項目的 JavaScript 和已安裝依賴。
- 工具路徑被限制在當前會話工作區內。
- 命令使用固定參數數組。
- output replacement 是 opt-in。
- process output 和 props 有邊界限制。
- cancellation 會到達 managed process tree。
- 插件本身不收集 telemetry、不存儲 credentials、不上傳 media；但項目代碼、遠程資源或 Remotion browser acquisition 仍可能使用網絡。
- 插件爲 MIT 許可；Remotion 有獨立許可條款，使用者需要自行確認。
- 插件通常會在當前 DSH 進程權限下運行，安裝前應檢查源碼、依賴和許可證。
結尾¶
chenjie1129/remotion-video-plugin 的價值在於把 Remotion 的項目診斷、composition 發現、still/video 渲染和輸出校驗整理成 DSH 可調用的工作流，並提供可檢查的發佈證據。
GitHub 倉庫：
https://github.com/chenjie1129/remotion-video-plugin
已覈實資料未提供目錄頁 URL，因此本文不額外給出目錄頁鏈接。
