宙斯浏览器脚本注入功能失效后应如何排查？

脚本注入失效需逐层验证：先确保Tampermonkey图标变蓝且可点击，再检查元数据块格式合法、@match匹配当前网址及JavaScript权限允许，最后清除缓存并重载脚本。

宙斯浏览器脚本注入功能失效时，页面无任何预期行为、控制台不报错但脚本完全静默，说明内容脚本未进入执行环境——此时不能依赖刷新或重装，必须按真实加载链路逐层验证注入是否真正发生。

确认脚本管理器是否已就绪并注入当前标签页

猴子图标未变蓝或点击无反应，代表Tampermonkey根本未激活，所有.user.js文件均被跳过解析。

在地址栏输入zeus://extensions回车→开启右上角“开发者模式”→点击“加载已解压的扩展程序”→选择Tampermonkey根目录（含manifest.json）→等待图标变为【蓝色且可点击】。

【必须重启当前标签页】：旧标签页仍运行在无脚本环境中，不关闭重开，注入永远不生效。

验证脚本元数据块格式合法性

元数据块（// ==UserScript== 开头部分）哪怕一个字符错误，整个脚本都会被引擎直接丢弃，且不提示具体位置。

右键猴子图标→“管理面板”→找到目标脚本→点击“编辑”→检查以下三项：

① 是否以// ==UserScript==开头、// ==/UserScript==结尾；

② 每行是否为// @key value格式，@后紧跟英文半角空格，value用英文引号包裹，如// @match "https://bilibili.com/*"；

③ 元数据块内是否混入中文标点、全角空格、多余空行或注释符号外的任意文本——这些都会导致解析中断。

删减法快速定位：删除// ==/UserScript==之后全部代码，只留alert("test");，保存后刷新目标页；若仍无弹窗，问题100%在元数据块。

检查匹配规则与站点JavaScript权限

脚本已启用但无反应，90%以上是@match未覆盖当前网址，或该域名被单独禁用JavaScript。

方法一：管理面板中点击脚本右侧“编辑”→确认@match包含当前页面完整协议+域名，例如访问https://www.zhihu.com/question/123，则需有@match https://www.zhihu.com/*或@match *://*.zhihu.com/*。

方法二：临时放宽测试→将原@match替换为@match *://*/* → Ctrl+S保存 → 刷新页面；若功能恢复，证明原规则过窄。

访问目标网页→点击地址栏左侧锁形图标→展开权限面板→确认“JavaScript”状态为“允许”，而非“阻止”或“自动”；【此设置仅对该域名及子域名生效】。

强制清除残留缓存并重载脚本

反复修改@match或grant后，旧版编译缓存可能卡住新逻辑，导致看似启用实则执行旧版本。

第一步：关闭所有目标域名的标签页。

第二步：在zeus://extensions页面→点击目标脚本右侧“详情”→向下滚动至“清除数据”按钮→点击执行。

第三步：返回管理面板→点击脚本右侧“重新加载”按钮→等待右下角出现小数字提示（表示缓存已刷新）→重新打开目标页面。