宙斯浏览器扩展安装失败主因是加载链路校验被内核拦截：zip须为无密码标准格式且manifest.json直处于根目录；manifest.json必须为v3版、含key字段、“scripting”权限及“host_permissions”声明；插件需手动启用开关并清除extensions缓存重试。
宙斯浏览器扩展安装失败时，界面可能卡在“正在安装”、弹出“解析包错误”或直接跳回扩展管理页，根本原因不是插件本身损坏，而是加载链路中某一层校验被浏览器内核主动拦截。
检查ZIP包结构是否合法
静默安装要求压缩包是标准无密码ZIP格式，且根目录下必须直接包含manifest.json——若解压后看到的是“extension-main/manifest.json”这类嵌套结构，宙斯会直接跳过解析。
右键ZIP文件→属性→确认大小大于50KB；若小于该值，大概率是GitHub自动打包的空归档，需改用源码仓库的“Download ZIP”按钮重新下载。
【ZIP不能含密码、不能用7z/RAR伪装、不能有BOM头】，否则解析器在第一步就拒绝读取。
验证manifest.json是否满足V3强制字段
方法一：用记事本打开manifest.json→搜索"manifest_version"→若值为2，必须改为【"manifest_version": 3】并保存。
方法二：检查是否存在"key"字段→若缺失，需在文件最顶部插入合法公钥字符串（可从Tampermonkey官方CRX解压包中复制），否则宙斯静默禁用且不报错。
方法三：确认"permissions"数组中至少含"scripting"，且同级必须声明"host_permissions": [""]，缺任一字段，安装必然失败。
确认插件是否已手动启用
新安装的插件默认处于禁用状态，开关呈灰色且标有“已停用”，此时插件完全不运行。
点击右上角三点菜单 → 选择“扩展”或直接在地址栏输入zeus://extensions回车 → 在插件列表中找到目标名称 → 点击其右侧灰色开关，直至变为蓝色并显示“已启用”。
这一步操作起来很简单，但跳过会导致后续所有调试无效——【开关未变蓝=插件零执行】。
清除Extensions缓存并重试
① 关闭宙斯浏览器所有窗口及后台进程（任务管理器中确认zeus.exe无残留）；
② 打开文件管理器，进入：C:\Users\[用户名]\AppData\Local\ZeusBrowser\User Data\Default\Extensions；
③ 删除该目录下所有子文件夹（保留Extensions空文件夹）；
④ 重启浏览器，再次尝试静默安装同一ZIP包。
