用途:remotion-upgrade 用于升级 Remotion 及其相关包,让项目内所有 Remotion 依赖保持在同一个稳定版本,并使辅助依赖与官方推荐版本对齐。
主要能力:
- 检查项目清单和锁文件,识别所用的包管理器与工作区结构,并在升级过程中保留无关改动。
- 判断 @remotion/cli 是否在本地可用。可用时运行 npx remotion upgrade,同时更新项目本地的 Remotion skills,并跳过手动升级流程。
- CLI 不可用时执行手动升级:用 npm view remotion version 获取最新稳定版本;在项目中查找所有已安装的 remotion 和 @remotion/* 依赖,统一升级到该精确版本,并保持原有的依赖分区以及工作区或 catalog 约定。
- 通过 npm view @remotion/studio@<version> dependencies --json 读取目标版本 @remotion/studio 的依赖,据此对齐 zod、mediabunny、@huggingface/transformers 等辅助包;已安装的 @mediabunny/* 包使用 mediabunny 对应版本。
- 运行项目的包管理器以更新锁文件。
- CLI 不可用时,更新已安装的 Remotion skills,覆盖 remotion-best-practices、remotion-captions、remotion-create、remotion-docs、remotion-interactivity、remotion-license、remotion-maps、remotion-markup、remotion-multimedia、remotion-render、remotion-saas、remotion-studio、remotion-upgrade。
- 复核清单与锁文件差异,确保所有 Remotion 包版本一致、辅助包使用推荐版本;CLI 可用时还可运行 npx remotion versions 做额外检查。
使用方式:在 Remotion 项目环境中调用该技能即可,无需手动逐条执行上述命令。技能会根据 @remotion/cli 是否可用选择自动或手动升级路径。Remotion 的发布说明包含变更日志,可在升级后用于总结相关变化。
适用场景:需要将 Remotion 视频项目升级到最新稳定版本、统一多包版本、同步本地 Remotion skills,或在多工作区项目中维护依赖一致性的开发者。
限制:资料未说明支持的具体 Remotion 版本范围、对非 npm 生态包管理器的完整兼容性、失败回滚机制,以及技能本身的安装方式、收费与平台信息,这些暂未提供。