浏览器扩展安装与版本管理

MaskPilot 将扩展按浏览器账号分配。每个账号只加载已经选择的扩展，便于让不同工作流使用不同工具，同时减少无关扩展对环境的影响。

使用经过匹配的版本

扩展商店会记录扩展版本与支持的浏览器版本范围。绑定或升级前先确认兼容性；当组合未通过验证时，优先选择兼容的扩展版本或浏览器版本，并在测试账号中验证。下载、校验或解压错误属于安装问题，应按扩展安装失败或文件损坏的修复步骤清除旧安装文件后再重试，不要和版本不兼容混为一谈。

控制每个账号的扩展集合

安装扩展不等于让所有账号自动加载。检查具体账号的扩展选择，修改后完全关闭账号再重新启动。即使选择同一个扩展，不同账号的运行数据仍然独立；具体边界见不同账号中的扩展设置为什么不一样。遇到下架或更新提示时，先确认当前工作流是否依赖该版本。

谨慎使用本地扩展

本地 Manifest V3 扩展可从文件夹或 ZIP 包导入，但只保存在当前设备，不会随账号同步到其他设备。导入前确认来源与内容，并按本地扩展权限检查方法分别核对网站访问、浏览器能力和适用账号，再在测试账号验证页面行为。MaskPilot 无法找到或验证 Manifest 时，按本地扩展导入失败排查步骤检查所选根目录、ZIP 层级、必填信息和兼容性，不要通过降低扩展包要求来绕过错误。