dsh-remotion-launcher
方便一键启动mcp工程Remotion Studio用； 在 DeepSeek Harness（DSH）里一键构建 / 启动 / 停止 Remotion Studio 动画工程，该工程是mcp模式，启动后需要你自己去配置mcp，配置好后你就可以让dsh去使用生成各种自己想要的网页动画视频。
插件和工程是两个独立包：本仓库只是启动器，工程是另一个包
remotion-studio。 工程包安装可选择github或npm官网下载。
它做什么
装上后在 DSH 右下角出现一个可拖动的悬浮按钮（🎬），点开是一个面板：
| 区域 | 说明 |
|---|---|
| 工程 | 显示当前工程目录，可安装 / 更换（详见下一节） |
| 构建前端 | 在工程根跑npx vite build，输出 dist/web |
| 启动 / 停止 | npx tsx server/index.ts（PORT=4380），自动探活 /api/health |
| 端口 | 可改，避免和别的软件抢 4380；写进本机配置，重启不丢 |
| 日志 | 构建 / 服务 / 安装的实时输出，环形缓冲 600 行 |
位置、端口、工程目录都存 Host 侧（~/.dsh/remotion-launcher.json），换浏览器、换端口不会丢。
安装
DSH 版本要求：>=0.2.1-rc.2。
第一步：装插件（三选一）
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 拉一份 |
「下载并安装」的流程：选目录（弹系统文件夹对话框）→ 选下载源 → 由 host 依次跑
npm pack remotion-studio-mcp@latest --registry=<下载源> --pack-destination <临时目录>
tar -xzf <tgz> -C <目标目录> --strip-components=1
npm install --registry=<下载源> # 在目标目录里，最慢的一步
也可以自己 clone：
git clone https://github.com/laojingwei/remotion-studio-mcp.git <工程目录>
cd <工程目录>
npm install
然后在面板里 更换 → 选择该目录 → 使用此目录。
工作方式
DSH 浏览器页面
└─ client.js（shell.overlay 悬浮按钮 + 面板）
│ fetch 同源 /remotion-plugin/*
▼
index.js（host 半部，跑在 DSH 的 Node 进程里）
├─ spawn: npx vite build → <工程>/dist/web
├─ spawn: npx tsx server/index.ts → http://localhost:4380
└─ spawn: npm pack / tar / npm install（只在下载工程时）
- host 半部只做进程管理和状态
- 服务地址可以在右侧栏「浏览器」标签里打开，和 agent 共用同一个界面
- DSH 退出时插件会杀掉自己拉起的子进程，避免端口被孤儿进程占用
工程目录（安装 / 更换）
面板第一行永远是「工程」，点右边按钮展开卡片：
| 字段 | 说明 |
|---|---|
| 目录 | 点「选择」弹系统文件夹对话框，也可以直接粘路径 |
| 使用此目录 | 指向本机已有的工程，不下载任何东西 |
| 下载并安装 | 从 npm 下载一份新工程到这个目录 |
| 下载源 | 国内镜像 npmmirror / npm 官方 / 自定义…（只影响下载） |
配置
工程目录的优先级：面板里选的（存 settings）→ 自动探测 → 环境变量。
自动探测顺序：插件目录的上一级 → 上一级里的 remotion-studio/、app/ → 再上一层。
| 变量 | 默认 | 说明 |
|---|---|---|
REMOTION_STUDIO_ROOT |
自动探测 | 工程根；面板里选过之后以面板为准 |
REMOTION_PROJECT_PACKAGE |
remotion-studio-mcp |
从 npm 下载的工程包名 |
REMOTION_PORT |
4380 |
服务端口（面板里也能改） |
启动时会检查工程根下有没有 package.json 和 server/；缺了就在日志里说明，并把面板切成「安装工程」形态，而不是让你点一个必然失败的启动按钮。
已知行为
- 端口已被占用：启动前先探
/api/health，通就标记「已在运行（非本插件启动）」，不会重复拉起，也无法从这里停止 - 构建串行：构建进行中再点不会叠加进程
- 构建期间不能启动：dist 正在重写，这时起服务会读到半份前端
- 服务运行中不能构建 / 换工程 / 改端口
- 停止卡住：「停止中」超过 6 秒会把按钮变成「强制重置」，只清插件状态不动进程
发布（给维护者）
npm version patch # 或 minor / major
npm publish # 包名 dsh-remotion-launcher（若已占用请改 name 或加 scope）
git push --follow-tags
发布前建议在 package.json 里补上 repository / homepage / bugs 字段，npm 页面会据此显示源码入口。
开发自检
npm run smoke # 两个半区的导出契约 + __ModuleLoader__ 格式 + 白名单 require
npm run host-sim # 用假 Context 跑 apply()，验证路由、状态、落盘
npm run check:encoding # Windows：确认 PowerShell 能原样传回中文路径
都不需要启动 DSH。host-sim 会把位置/端口写进系统临时目录，不碰真实配置。
No comments yet. Be the first to write one.