宙斯浏览器PWA安装失败需先启用zeus://flags中“Enable add to home screen UI”并重启；再通过Application面板确认manifest和服务工作线程是否被识别；严格校验manifest必填字段、display值、图标格式与尺寸；确保Service Worker在load后注册且scope为'/'；最后清除Service Worker缓存重试。
宙斯浏览器网页PWA安装失败时，用户点击“添加到主屏幕”无响应、地址栏不出现安装图标、桌面快捷方式无法生成——这说明浏览器根本未将当前页面识别为合法PWA，问题出在基础运行条件未被满足，而非界面交互逻辑异常。
确认宙斯浏览器是否支持PWA安装
宙斯浏览器基于Chromium内核，但默认未开启PWA安装入口。需手动启用实验性功能：
1、在地址栏输入 zeus://flags 并回车；
2、搜索关键词 pwa 或 add to home screen；
3、找到 Enable add to home screen UI 选项，将其设为 Enabled；
4、点击页面底部 Relaunch 重启浏览器。【若该flag不存在，说明当前版本内核已移除PWA安装UI支持，需升级至v3.8.0+】
用Application面板诊断PWA健康状态
这是最权威的排查起点，能直接暴露宙斯浏览器内部判定结果：
① 打开目标网页 → 按 F12 打开开发者工具 → 切换到 Application 标签页；
② 左侧菜单依次点击 Manifest 和 Service Workers；
③ 查看顶部 Installability 区域的结构化报告——它会逐条列出宙斯是否认可该站点为PWA；
⚠️ 注意：若此处显示 “No manifest found” 或 “No service worker registered”，后续所有操作都无效，必须先解决这两项。
修复manifest.json关键字段缺失
宙斯浏览器对manifest校验比Chrome更严格，缺一不可：
方法一：检查必填字段是否存在
打开 https://yoursite.com/manifest.json（确保可直连访问），确认JSON中包含以下5项且值非空：【"name"、"short_name"、"start_url"、"display"、"icons"】；
方法二：修正display值
若 "display": "browser" 或 "display_override": ["browser"]，立即删除整行或改为 "standalone"——【"browser"是非法值，会导致整个manifest被宙斯静默忽略】；
方法三：验证icons尺寸与格式
icons数组中至少一项必须同时满足：type为 "image/png"、sizes为明确像素值（如 "192x192"）、src路径返回HTTP 200且Content-Type为 image/png；若仅写 "any" 或提供ICO/SVG格式，宙斯不会用于安装判定。
强制注册Service Worker并验证作用域
宙斯浏览器要求Service Worker不仅存在，还必须成功激活并控制当前页面：
第一步：确保注册时机正确
在HTML末尾或 window.addEventListener('load', ...) 中执行注册，禁止在DOM未就绪前调用 navigator.serviceWorker.register()；
第二步：显式声明scope参数
注册代码必须写成：navigator.serviceWorker.register('/sw.js', { scope: '/' })；若省略 scope，宙斯默认以sw.js所在目录为作用域，导致根路径页面不受控；
第三步：检查sw.js响应头
用DevTools Network面板确认请求 /sw.js 返回状态码200，且响应头含 Content-Type: application/javascript；若服务器返回 text/plain，宙斯拒绝注册。
清除宙斯浏览器PWA缓存重试
宙斯会缓存manifest解析结果和安装状态，旧错误配置可能长期残留：
1、完全关闭宙斯浏览器（任务管理器中确认无zeus.exe进程）；
2、打开文件管理器，进入：C:\Users\[用户名]\AppData\Local\ZeusBrowser\User Data\Default\Service Worker\CacheStorage；
3、删除该目录下所有子文件夹（保留CacheStorage空文件夹）；
4、重新启动浏览器，访问网页后再次打开Application面板查看Installability状态。
