前言¶
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，因此本文不额外给出目录页链接。
