Skip to content

RocX v0.2.0 — Win/Mac 双平台全量验证，兼容 Premiere Pro 25.6.4

Choose a tag to compare

View all tags
@vark-debug vark-debug released this 27 Sep 15:47
· 58 commits to main since this release
v0.2.0
6cb6033

RocX v0.2.0 — Win / Mac 双平台全量验证

首个完成 Windows + macOS 双平台全流程验证的版本。向下兼容到 Premiere Pro 25.6.4（UXP 8.1），25.6 / 26.x 全系可运行。

跨平台兼容

  • Windows 兼容修复
    • file:// 三斜杠路径统一处理
    • 剥离 \\?\ 长路径前缀，避免 UXP 文件 API 在 Windows 下拒绝访问
    • 抓帧写盘改为轮询确认，规避 Windows 下写入延迟导致的「文件未就绪」误报
    • Adobe Media Encoder（AME）缺失 / 启动失败时给出明确错误提示（Windows 下仅装 Premiere 不一定带 AME）
  • 兼容性下限确认到 Premiere Pro 25.6.4，25.6 / 26.0 / 26.2 / 26.3 / 26.5 全系 UXP 8.x 可运行

功能

  • 提交生成后自动清空参考素材：一次提交 = 一次完整输入清空，避免上一轮的参考图 / 参考视频被误带入下一轮生成（磁盘上的原始文件保留不动）
  • 抓视频比例自动匹配：按素材实际宽高比自动匹配并填写画面比例，provider 中性，按当前模型的合法 ratio 列表取最接近值

架构改进

  • provider 模块化抽象层：抽出 VideoGenProvider / ModelDescriptor / registry，UI 改为按 capabilities 能力位驱动（videoGeneration / promptOptimization / resolutionUpscale 等），不再硬编码具体模型名
  • webview-ui composable 拆分：main-webview.vue 拆出 useGenerationState / useReferences / useGenerationTasks，参考素材、轮询、记录等关注点分离
  • 移除大视频预览首帧遮罩，预览逻辑简化
  • 跨端类型收口 shared/messages.ts

安装

  1. 下载下方附件 com.rocx.uxp_premierepro.ccx
  2. 双击安装，按提示完成
  3. 重启 Premiere Pro
  4. 菜单栏 窗口 > 扩展 > RocX 打开面板

若双击安装无效，可在 UXP Developer Tool 中 Import 并 Load 本 CCX 包。

环境要求

项目 要求
软件 Adobe Premiere Pro 25.6.4 或更高版本
操作系统 Windows 与 macOS（双平台全量验证）
网络 可访问 api.minimax.cn、cdn.hailuoai.com 及阿里云 OSS 产物下载域名
账号 MiniMax 官方开放平台签发的 API Key（第三方中转 Key 不支持素材上传接口）
抓视频依赖 Adobe Media Encoder (AME) 必须已安装并能正常启动（抓帧不受影响）

已知限制

  • 不支持并发生成，建议逐条生成、完成后再发起下一条

升级说明

从 v0.1.0 升级可直接覆盖安装，无需卸载。生成记录（<项目名>.ai-gen.json）与已生成的 AI_Generated_Media/ 目录结构未变，历史记录可继续正常使用。

Assets 3
Loading