剪映:npm STDIO 接入
本机运行剪映连接器,检索和打开草稿,执行剪辑、预览与导出。剪映账号登录、权益及系统授权沿用客户端实际流程。
配置
正式包发布后,在豆包选择 STDIO,启动命令为 npx,参数逐行填写:
--yes
--package=@capcut/jianying-mcp@<固定版本>
--registry=https://registry.npmjs.org/
jianying-mcp
版本来自该次正式发行记录;版本占位符和本地测试包名不能直接用于上架。显式使用官方 npm 源,避免宿主默认镜像尚未同步新版本而下载失败。连接器入口从自身安装目录定位运行文件,不依赖工作目录或用户填写机器路径。
npm 包使用宿主运行时;手动 ZIP 不携带运行时,由安装脚本检查并在必要时下载 Node 到用户私有目录。
运行环境
由宿主提供 Node.js 18.17+ 和 npm/npx。一个 npm 包支持 Mac Apple Silicon、Intel 和 Windows x64,包内不包含 Bun、Node.js 二进制或平台运行时子包。入口使用 npx 所用的 Node.js 绝对路径启动 STDIO 服务,共享后端和浏览器网关也复用该运行时。系统或 Node.js 版本不支持时返回明确错误。
无需 postinstall、可选运行时依赖,不修改系统 PATH,不注册开机服务。STDIO 原样继承,退出与停止信号转交 Node.js 服务;草稿、登录态和日志沿用现有本机目录,不写入 npm 包。
共享后端按实际运行时构建更新,不只比较 npm 版本号或传输协议。新版 STDIO 将自身运行时入口和 buildId 交给已认证的后端;后端核对清单及文件完整性后保存快照,等待已受理操作收尾并交接状态。支持本地 ZIP 与 npm 缓存等不同目录之间的更新。接管完成前不向旧构建派发新请求;拒绝更新或部署不完整时明确返回错误,不静默使用旧下载配置。已接管的快照与被替代构建记录在状态目录 shared-runtime-release.json,旧目录里的 STDIO 重连后跟随新构建,不反向降级。此能力需后端包含跨目录更新实现;更早版本拒绝时需先重启到新版,不强制终止其他宿主的进程。
打包与验证
python3 Tools/doubao-hub-pilot/package-npm.py --name <正式包名> --output <新输出目录>
脚本从当前源码构建单个 npm tgz,记录源码提交、工作区状态和逐文件哈希。运行代码和卡片依赖已内联,包含第三方许可记录,不包含剪映客户端、测试代码、内部审批材料、node_modules 或原生扩展。脚本仅打包,不执行发布。
验证换目录、中文及空格路径、最低 Node.js 版本、STDIO 握手、工具发现、卡片资源、WebSocket 转发及重连、stdin 关闭和停止信号。Windows 参数和路径模拟不能代替 Windows 实机验收。
发布
使用已经批准的 npm 组织和包名,按固定版本发布单个包。完成从公网 registry 安装和真实宿主回归后填写表单。公开发布须完成公司审批并得到用户明确授权;测试快照若含 dirty=true,应在正式发布前冻结源码并重新打包。