Releases: vark-debug/RocX
Releases · vark-debug/RocX
Release list
v0.3.0 — 飞书多维表格联动 + 团队统计
多维表格联动 + 团队统计
生成成功后自动把估价、剪辑师、工程、用途推送到多维表格,结算与统计可在表格里直接完成。
新增
- 多维表格联动:记录首次变为
generated时 fire-and-forget 上报,失败仅 toast 不影响生成 - 多用途分类(
purpose字段):视频生成/分辨率升级/提示词优化 - 估价三档(统一三位小数)
- 视频生成 / 分辨率升级:
(参考视频时长 + 输出视频时长) × 档位单价 - 提示词优化:
prompt_tokens × 5.80 + completion_tokens × 23.00元 / 百万 tokens
- 视频生成 / 分辨率升级:
- 飞书限流自动重试:错误码
800005652或 HTTP 429 时按 400 / 800 / 1600ms 退避重试,最多 3 次 - 设置页「测试上报」按钮:固定样例打一次验证链路
uxp.config.ts网络白名单:https://*.feishu.cn+https://connector.dingtalk.com
修复
storage.readSettings()在secureStorage命中时不再丢弃兜底文件里的非密钥字段
设置面板新增三项:飞书 Webhook 地址 / Token / 剪辑师
兼容性
向下兼容 Premiere Pro 25.6.4(UXP 8.1),25.6 / 26.x 全系可运行。
RocX v0.2.0 — Win/Mac 双平台全量验证,兼容 Premiere Pro 25.6.4
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
安装
- 下载下方附件
com.rocx.uxp_premierepro.ccx - 双击安装,按提示完成
- 重启 Premiere Pro
- 菜单栏 窗口 > 扩展 > 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/ 目录结构未变,历史记录可继续正常使用。
RocX v0.1.0 — 首个公开版本
RocX v0.1.0 — 首个公开版本
Adobe Premiere Pro 26.5+ 的 UXP 插件,在剪辑面板内直接调用 MiniMax(海螺 AI)视频生成模型。
下载
下方附件 com.rocx.uxp_premierepro.ccx 为已签名/打包好的插件,直接双击即可在 Premiere 中安装。
快速上手
- 在 Premiere Pro 中打开 窗口 → 扩展 → RocX
- 打开 设置,粘贴 MiniMax 官方开放平台签发的 API Key 并保存
- 抓帧 / 抓视频作为参考(可选),填写提示词,点击 生成
- 生成完成后在记录列表里 预览 / 导入到工程 / 升级到 2K
功能一览
- MiniMax-H3 / MiniMax-H3-Max 视频生成,多档时长 / 分辨率 / 画面比例
- 抓帧 / 抓视频参考素材,自动上传到 MiniMax
- 异步轮询 + 自动下载结果到 PR 项目旁
AI_Generated_Media/Imports/ - 提示词优化(
h3_context_ir,仅 H3) - 像素提升:H3 768P → 2K(
video_regeneration) - 拖拽视频到时间线 / 按钮导入到工程(含事务化
lockedAccess+executeTransaction) - 生成历史持久化到
<项目名>.ai-gen.json,跨会话恢复
系统要求
| 项目 | 要求 |
|---|---|
| Premiere Pro | 26.5.0 或更高 |
| 操作系统 | macOS(Windows 理论上可用,未验证) |
| API Key | MiniMax 官方开放平台签发(第三方中转 Key 不可用) |
| 网络 | 可访问 api.minimax.cn / cdn.hailuoai.com / algeng-video-infer.oss-cn-shanghai.aliyuncs.com |
本版本架构改进
- 跨端类型收口到
shared/messages.ts,UXP / WebView 端共享同一份事实源 - Premiere DOM API 调用规范化(
lockedAccess/executeTransaction改await,回调 async) - 文件移动语义统一为
copyTo + 校验 + delete,删除反复兜底 - 项目切换监听可清理(移除 IIFE 自启动 + 不可清理的
setInterval) - API Key 切换到 UXP
secureStorage,明文不再写入app-settings.json RecordsPanel.vue从 ~1250 行精简到 217 行,canvas 抽帧与缓存下沉到useRecordPreview/useRecordActions- DEV 模式调试工具按构建时常量隐藏,发布 ccx 包不含调试入口
已知限制
- 不支持并发生成(原型阶段),请逐条生成
- 仅在 macOS + Premiere Pro 26.5.0+ 验证通过
- 模型仅支持 MiniMax H3 / H3-Max(接 Kling / Runway 等需要额外适配)
反馈
Bug 与功能建议请到 Issues。