剪映：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，应在正式发布前冻结源码并重新打包。