前言¶

在 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