宙斯浏览器扩展无法启用是因manifest.json不符合manifest v3规范：需将manifest_version改为3，补全key、scripting权限及host_permissions字段，确保zip根目录含manifest.json且无密码/非标准格式，最后清空extensions缓存重启。
宙斯浏览器扩展安装后无法启用、图标不显示或静默失败，通常不是插件本身损坏，而是manifest.json文件不符合其强制执行的Manifest V3规范——跳过校验步骤会导致加载链路在第一步就中断。
检查并修正manifest_version字段
宙斯浏览器基于Chromium 128内核，完全拒绝加载manifest_version为2的扩展，哪怕其他字段全部正确，也会直接跳过解析。
用记事本或VS Code打开插件ZIP包内的manifest.json → 按Ctrl+F搜索"manifest_version" → 若值为2，必须手动改为【"manifest_version": 3】→ 保存文件。
改完后重新打包ZIP：选中manifest.json及所有资源文件 → 右键“发送到→压缩文件夹” → 确保新ZIP根目录下直接就是manifest.json，不能有额外文件夹包裹。
补全V3必需字段
Manifest V3在宙斯浏览器中不是可选项，而是硬性准入门槛。缺任一关键字段，扩展会静默禁用，界面不报错也不提示。
方法一：插入key字段
若manifest.json顶部没有"key"字段，需在{开头后第一行插入合法公钥字符串（可从Tampermonkey官方CRX解压包中复制base64格式key），否则宙斯拒绝注入任何content script。
方法二：确认permissions与host_permissions共存
检查"permissions"数组是否包含"scripting"；再确认同级是否存在"host_permissions": ["
【注意】host_permissions不能留空字符串[""]，必须明确声明权限范围，否则宙斯解析器判定为非法配置。
验证ZIP包结构合法性
第一步：右键该ZIP文件 → 属性 → 查看“大小”是否大于50KB；若小于，大概率是GitHub页面自动生成的空包或损坏包，需回到原始仓库下载带源码的完整ZIP。
第二步：双击打开ZIP → 确认manifest.json是否直接位于根目录；若路径为extension-master/manifest.json，则必须重打包，把manifest.json拖到ZIP顶层再压缩。
第三步：确认该ZIP未设密码、未用7z/RAR格式另存——宙斯解析器遇到非标准ZIP头会直接终止读取，不弹窗不报错。
清除Extensions缓存强制重载
① 完全关闭宙斯浏览器（任务管理器中结束所有zeus.exe进程）；
② 打开文件管理器，进入C:\Users\[用户名]\AppData\Local\ZeusBrowser\User Data\Default\Extensions；
③ 删除Extensions文件夹下所有子文件夹（保留Extensions空文件夹本身）；
④ 重启浏览器，再次尝试静默安装修正后的ZIP包。
