Version Raptor v1.2.2 | 一键升版：认你自己的命名规范把最后那组数字 +1，该存盘时按钮会「生气」

先讲官方的开头两句，因为这是它全部的价值所在：“Ever forget to save or version up? Version Raptor is here to help.”（忘了存、忘了升版？它在。）

干这行的人都遇到过这两种翻车：做到第三个小时忘了存；或者存了但没升版，第二天打开发现自己在改昨天的文件。Version Raptor 就围着这两件小事做面板——升版、补版号、提醒存档，以及在你打开错的文件时拦住你。

它最被用户反复提到的优点是：不发明命名规范，认你自己的。官网用户 David Arbor 的原话是 “It works with your naming conventions and doesn’t require you to conform to someone else’s.”——看起来是小事，但这恰好是多数「工作流工具」失败的地方：用之前先要你改名。

先说三件要紧的事：① 它现在是 Name Your Own Price——页面建议价 $0.00，个人可以付任意金额，企业/团队必须按建议价购买才获得有效授权；② 本包 v1.2.2 与官网当前版本一致（Jul 29, 2026）；③ 这份重打包缺两个 HTML 入口文件，装上也打不开面板——原因、证据和 30 秒补法我写在文末，没有替你伪造作者的文件。

一、Smart Version Up：认最后一组数字，靠复制实现自增

官方给的描述：检测「最后一组数字」并安全自增，方式是以复制工程/合成/序列来实现，所以旧版本永远还在，随时能回去。

它认的格式很宽，官方给了三个例子：
project-v01 → project-v02
comp_0001 → comp_0002
sequence_v01_JT → sequence_v02_JT

第三个例子最说明问题：版本号在中间、后面还跟着后缀（_JT 可能是剪辑师缩写）。很多自制脚本只能处理「版本号在末尾」，一遇到这种就废。用复制而非原地改名也是关键设计——它天然满足「升版要留旧版」的行业惯例，而不依赖你的存档习惯。

二、Add Version：把历史遗留文件拉回正轨

如果工程/合成/序列还没有版本号，一键把版本号追加到名字上。

这条看着像补丁功能，实际解决的是很现实的一类文件：final_ok、final_ok_new、真的最终版。手工整理这类名字最费时间，而且容易改错。它把「先有规范再有工具」的顺序反过来了——先用工具把名字理出规范。

三、该存档了会提醒，阈值自己调

官方两条：超过设定的小时数就提醒你该保存了；提醒阈值可以按你的节奏调整。

这条有人会觉得鸡肋，但官网用户评价里它反而被提到最多。NFL 的 Mark Velasco 原话：“A great reminder when auto-save fails.”——自动保存失败时，它是唯一的提醒。这个场景很真实：AE 的自动保存会失败（磁盘满、工程过大、崩溃前），而失败是静默的。

四、Safe Versioning：这条才是真正值钱的功能

官方描述：如果检测到你的工程文件已经有更新的版本存在，升版按钮会被禁用，防止覆盖最新文件，同时提醒你「你可能打开的是一份旧工程」。

为什么说它最值钱：它防的不是手滑，而是「以为自己在新版上干活」。手滑丢的是一个操作，这种错误丢的是半天——你在 v02 上改了三小时，才发现 v03 早就存在，而你的改动全在旧分支上。

而且它的实现方式很克制：禁用按钮 + 提示，不去猜你想干什么、不自动合并、不弹一堆选项。把判断权交回给人，只负责让你无法无视这个事实——这是工作流工具该有的分寸。

五、它的视觉语言：一个会「生气」的按钮

官网用户评价里被反复提到的一点：该存档时是 mad（生气）图标，存完变 happy。Jacob Resch 的原话：“This has now become my favourite button to click on in After Effects :)!”

这点从包内文件能直接印证——script-icons/ 里有成套两组 SVG：
happy.svg / happy-comp.svg / happy-project.svg / happy-sequence.svg
mad.svg / mad-comp.svg / mad-project.svg / mad-sequence.svg

它按当前对象类型（工程 / 合成 / 序列）切换图标，而不是一个通用图标糊到底。旁边还有两个几十字节的入口 jsx（versionUpItem.jsx 51 B、versionUpProject.jsx 54 B），供脚本菜单直接调升版动作——意味着你可以给它绑快捷键。

六、v1.2.2 修的是什么（这条暴露了技术难点）

官网版本历史顶部：1.2.2 — Jul 29, 2026 — Fixed versioning issue with many leading zeros。修复「前导零很多」时的升版问题。

这条看似小，其实是这类工具的核心难点：comp_0001 必须升成 comp_0002，补零位数要保住。很多自制脚本一升版就把 0002 写成 2，命名规范当场散掉。位数越多（比如 shot_000001）越容易出问题——这正是本版在修的。

用法建议：拿到手先拿一个带前导零的名字试一次升版，看它把你的格式认成什么。这是最快摸清它边界的方式。

包内逐字节（20 个文件 617,462 字节）：assets/main-BlxqHUnF.cjs 516,690 B（React 面板主逻辑，包内最大）；jsx/index.jsxbin 21,006 B（ExtendScript 桥，已混淆）；assets/index-BTa_7FB0.cjs 23,839 B（共享 chunk）；META-INF/signatures.xml 15,024 B；assets/main-BEg7TwwU.css 2,949 B；8 个 happy/mad SVG 合计约 43 KB；CSXS/manifest.xml 2,974 B；Add Keys.reg 1,768 B；install-as-admin.zip 1,159 B。

价格与授权（这点要看清）：官网卖法是 Name Your Own Price，页面显示 $0.00，并注明「个人用户可以付任意金额，显示的价格只是建议；企业、团队等必须按建议价支付才能获得有效授权」。所以它名义上可付 $0，但商业使用要按建议价买——这不是一个「随便用」的授权。

兼容性：官网 COMPATIBILITY 列 AE 2026 / 2025 与 Premiere Pro 2026 / 2025；包内 manifest 实际写的宿主版本范围是 AEFT [17.7, 99.9]、PPRO [14.9, 99.9]（即 AE 17.7+ / PPR 14.9+ 理论上都能装，官方只对上面四版背书）。

双扩展结构：CSXS/manifest.xml 里注册了两个 Extension——…versionraptor.main（面板，AutoVisible=true）与 …versionraptor.invisible（后台常驻，AutoVisible=false，在应用激活/初始化时启动）。后台那个负责「该存档了」这类与面板无关的提醒，所以面板关掉提醒照样工作。

⚠ 本包缺陷（实测证据）：main/ 与 invisible/ 两个目录是空的，而 manifest 要求 ./main/index.html 与 ./invisible/invisible.html——两个 HTML 都不存在，面板打不开。我对原始 rar 逐条目核对（unrar l，33 个条目）：rar 里本身就没有任何 .html 文件，两个目录是空目录入档；node_modules/ 同样为空，manifest 引用的 src/assets/dark-icon.png、light-icon.png 也不在。结论是这份重打包在制作时丢了 .html / .png / node_modules 内容，不是解压失败。

30 秒补法（说明文件里有完整内容）：新建 main/index.html（引入 ../assets/main-BEg7TwwU.css 与 ../assets/main-BlxqHUnF.cjs，body 放 <div id="app"></div>）和 invisible/invisible.html（引入 ../assets/index-DAIJ9fu2.css 与 ../assets/invisible-uP-W7nsy.cjs）。依据是主 bundle 里的挂载点就是 getElementById("app")，共享 chunk 用 cep_node.require(__dirname + "/assets/index-BTa_7FB0.cjs") 引入，文件名取自包内实际存在的 hashed 资源。图标缺失不影响功能。

更省事的路径：这个产品在官网是 Name Your Own Price，个人可以直接付 $0 拿完整版——完整的包是作者原版，不缺文件。本站保留这份原始重打包并如实标注缺陷，是为了不替你伪造作者的文件。如果你只是想用它，去官网下完整版最快；如果你想研究它的实现，这包里的 JS 是完整的。

被谁推荐过（官方 FEATURED IN）：After Effects Community Recap（2022 年 9 月）、The Lester Banks Blog、ProVideo Coalition After Effects Roundup（2022 年 9 月）、Featured Adobe Creative Cloud Plugins、Premiere Gal「#10 Recommended Free Plugin for Premiere Pro」。用户评价来自 Austin Saylor、David Arbor、Jacob Resch、Patrick Butler、Mark Velasco（NFL）、Lori Schkufza 等。

原产品页：https://aescripts.com/version-raptor/

封面图片来自作者官方产品页。本文为中文整理，功能与兼容性信息以作者官方页面与包内说明为准。资源仅供学习交流，商业使用请购买正版授权。