Chrome升级小助手——快速检查你的浏览器扩展是否已支持新版Chrome

为了解决快速查看浏览器扩展兼容情况，我开发了《Chrome升级小助手》帮你快速检测你的浏览器扩展是否都已兼容 Chrome 的 Manifest V3 标准。下载Python脚本或EXE版，即可一键生成详细兼容性报告，避免升级后扩展失效的窘境。

引子

总所周知，最近Chrome浏览器又双叒叕升级了，目前正式版已经更新到 142 版。说实话，每次看到Chrome更新我都又爱又恨：爱的是新功能确实香，恨的是 Manifest V2 扩展的日子也基本到头了。

随着Google对Manifest V2扩展的限制越来越严格，大部分主流扩展也都陆续发布了基于Manifest V3的版本。于是我决定把我的Chrome升级到最新的142版本。但是呢，我遇到了一个“小问题”：我装了几十个扩展（PS：当然我不会全启用，那要卡死个人了），怎么快速知道哪些扩展还没升级到Manifest V3呢？

最初的尝试：问AI，结果翻车了

最开始我偷了个懒，直接去问AI：“怎么批量检查 Chrome 扩展的 Manifest 版本？”
AI很热情地告诉我：“亲，可以在Chrome的扩展管理页面（chrome://extensions/）打开开发者模式，然后在控制台运行这段JS脚本就好了哦！”

我试了试，结果……根本检测不到。我和 AI 拉锯讨论了半天后，我意识到这方法不行——扩展管理页面的权限限制让脚本无法获取准确数据。

还是要自己动手：为什么不直接读文件呢？

正好最近我自己也在写 Chrome 扩展，突然想到：每个扩展的安装目录里不都有个 manifest.json 文件嘛！这里面记录了扩展的所有元数据，包括扩展使用的 Manifest 版本，这数据肯定是最准确的。
于是，我决定写一个Python脚本来解决这个问题。思路很简单：

• 找到Chrome扩展的安装目录（默认在AppData\Local\Google\Chrome\User Data\Default\Extensions）。
• 遍历所有扩展文件夹，读取每个扩展最新版本的manifest.json。（理论上同一个扩展存在多个版本是可能的）
• 解析出Manifest版本、扩展名称、描述等信息。
• 生成一个详细的报告，显示那些是V2、V3扩展。

Chrome 升级小助手 V1：石器时代

最开始的脚本非常简陋，就是遍历检查，然后把还在用 Manifest V2 的扩展名字写到一个 txt 文件里。
很快我发现，这样不行，因为有些上古扩展的 manifest.json 写的不是很规范，导致获取不到扩展的名字，如果脚本想适配他们的一些奇怪写法，又需要增加很多额外的代码量。而且我发现有我有十几个扩展是MV2的，需要手动去扩展页面根据名字慢慢找到底是哪个扩展，太费劲了。

Chrome 升级小助手 V2版：青铜时代

于是我决定改为生成一个 html 文件，反正扩展 ID 都有了，可以写一个超链接方便点击里面的链接跳转到扩展详情页不好吗。
然后发现，点击 html 文件中的「打开扩展详情页」连接，点击并不会打开扩展详情页（虽然链接是正确的）。
经过一番查找，原来是因为Chrome的安全限制，本地HTML文件中的chrome://链接无法直接点击打开（浏览器会阻止）。好吧，继续改。

Chrome 升级小助手 V3版：铁器时代

既然不让我直接点，那我就改为点击按钮，复制这个扩展详情页链接呗。这种本地JS还是让我用的嘛
同时我还发现之前脚本的一个小瑕疵：没有区分是扩展还是主题。Chrome 对主题的 Manifest 版本要求和扩展不同，主题停留在 Manifest V2 一般都没事，所以脚本需要将主题单列出来。

Chrome 升级小助手 V4版：蒸汽时代

V3版脚本写好，我自己测试没问题，发到群里小范围试用了一下，大家纷纷表示挺好用的，不过很快有群友提出来一个问题：“我现在知道了我的扩展如果升级到 Chrome 142 会不能用，但我怎么知道替代扩展在哪里呢”，很快就有人回道：“扩展的详情页会显示一个本扩展将停用的「相关扩展推荐」按钮，点那个就行了”。本来这事就结束了，但我试了一下我自己的141版的浏览器：扩展详情页居然没这个按钮，然后我反应过来了，没按钮就对了。教程里教大家怎么用 MV2 扩展的步骤里，不是把这个警告关了嘛，自己写的文章怎么快就差点忘了。

于是乎，Chrome升级小助手再次进化，增加「相关扩展推荐」按钮，利用Google应用商店自有的功能（https://chromewebstore.google.com/detail/{扩展ID}/related-recommendations）帮助大家找到可替代的扩展。（不一定都能找到，但总比一个一个手动找强一点）

Chrome 升级小助手 V5版：电气时代

V5版 脚本写好后，我在 TG 大群里分享了一下，群友们纷纷表示“好用！”“终于不用一个个手动检查了”。但也有群友吐槽：“我没 Python 啊，怎么装？”，“Python这么大的？”
也是，又不是每个人都是技术宅。于是我又把Python脚本打包成了《Chrome升级小助手.exe》，这样即使没有Python环境的用户也能直接使用啦！
按说这脚本没外部依赖，都是基本库，直接pyinstaller --onefile --clean --console --noconfirm Chrome升级小助手_V5.py一把梭哈就行。
结果这么个只有25K的小脚本，居然打包出来的exe体积有20多MB，这能忍？继续改进吧

Chrome升级小助手 V6版：信息时代

那就没办法了，虽然也不指望把exe压缩到只有2、3M的体积，但起码要是个位数吧，这么个小东西整20多M就有点恶心了。
那怎么快速减少打包体积呢？
1. 使用虚拟环境打包 ，以免引入不必要的东西进来
2. 使用UPX压缩可执行文件
3. 删除一切不需要的库，比如PIL（我又不处理图像）、tkinter（我又没GUI界面）、matplotlib（我又不画图）等等吧，诸如scipy、numpy、pandas全都干掉。
最终成果：5.7MB，还行吧，算不上极致压缩，如果再精细一点调整或者重新编译，我估计到3~4MB也是可以的，但这个精力就需要很多了，没必要。PyInstaller + UPX + 新虚拟环境 + 删除肯定没用到的库，算是一个比较平衡的打包方案。

Chrome 升级小助手 发布 & 教程

方式一：Python脚本版（适合有Python环境的用户）

如果你电脑有 Python 环境（建议3.10+，不过我估计3.6+应该就能用），可以直接下载 Python脚本版，这样体积更小。

1. 下载脚本文件（下载地址见文章末尾）
2. 保存到任意目录
3. 打开命令提示符（CMD）或PowerShell，导航到脚本所在目录
4. 运行：python Chrome升级小助手.py
5. 程序会自动查找Chrome扩展目录，如果找不到会提示你手动输入路径
6. 扫描完成后，会自动在目录下生成一个详细的HTML报告，并询问是否立即在浏览器中打开

报告会按Manifest版本分类显示所有扩展：
1. 红色标注的V2扩展：这些在Chrome升级后将无法使用，需要尽快寻找替代或更新。
2. 绿色标注的V3扩展：这些兼容新版本，可以放心使用
3. 主题扩展：即使是V2版也通常不受影响，但列出来，以防万一有问题。
报告中还提供了每个扩展的详情页链接和Chrome应用商店的推荐链接，方便你快速操作。

方式二：EXE版（适合所有Windows用户）

如果你没有Python环境，或者就想“开箱即用”，可以直接下载《Chrome升级小助手.exe》

1. 下载exe文件
2. 双击运行即可，无需安装任何依赖
3. 程序界面与Python版完全一样，按照提示操作即可

小贴士

• 运行前最好关闭Chrome浏览器，否则可能无法访问某些扩展的目录。
• 如果程序找不到扩展目录，会给出详细的手动查找指南，请按照提示操作。
• 报告中的“复制详情页链接”按钮可以方便地在Chrome中直接打开扩展管理页。

Chrome升级小助手 下载地址

• Python脚本：Chrome升级小助手.py
• EXE版本：Chrome升级小助手.exe

写在最后

• 在我自己的测试中，发现我有12个扩展还在用Manifest V2
  • 8个属于本来我就不用的，已经长期属于禁用状态，或者只是为了解决一些很细微的问题，用不用都可以，删了就好
  • uBlock Origin 我有三个，Lite版，MV2版 MV3满血移植版。除了最后的满血版，其他都是之前测试用的，Lite和MV2版删了就好
  • Proxy SwitchyOmega：这个作者已经停更了，不过有大佬接手继续搞了 MV 3版的，叫《Proxy SwitchyOmega 3 (ZeroOmega)》（注意此扩展李鬼极多，别下到李鬼加料版了）
  • Header Editor：这个没啥办法，虽然已经有基于MV3的Lite版，但无法使用自定义脚本，没招。
  • SingleFileZ：这个倒是没什么影响，毕竟可以用 SingleFile 嘛。

• 如果有任何问题或建议，欢迎在评论区留言，希望这个工具能帮到你！

• 如果遇到杀毒软件误报，请放心，这是打包 Python 程序的常见现象，代码完全开源可查。你可以自己审查前边的py脚本文件，并打包为exe使用。