必须逐层验证：①版本含“um”且miscript://可访问；②开启【设置→高级设置→脚本注入】开关；③暴力猴获“所有网站运行”和“访问文件网址”权限并自身启用；④脚本存于/sdcard/mixiabrowser/scripts/且为utf-8无bom的.user.js；⑤@match精确匹配url、@run-at设为document-end。
米侠浏览器里明明把脚本文件放进scripts文件夹、暴力猴也装好了，可打开目标网页后脚本就是不执行——不是脚本写错了，而是脚本根本没被浏览器识别或注入，必须逐层验证从底层开关到匹配规则的每一环。
确认浏览器是否具备脚本运行基础
打开地址栏，输入【about:version】→ 查看版本号末尾是否有“UM”或“UserScript”字样。没有就说明当前安装包不支持脚本功能，【必须卸载后前往官网下载带‘脚本版’标识的安装包重装】。
重启浏览器后，在地址栏输入【miscript://】，能正常打开脚本管理页面才算基础支持已就位。
开启浏览器级脚本注入总开关
点击右上角三个点图标 → 进入【设置】→ 【高级设置】→ 找到【脚本注入】选项 → 将开关设为开启状态。
【若该选项缺失，说明当前版本低于 v5.5.4.2，必须升级】。关闭浏览器再重新打开，确保设置生效——这一步不做，后面所有操作全部无效。
检查暴力猴是否真正启用并授权
方法一：通过扩展面板授予权限
点击右上角扩展图标 → 找到“暴力猴” → 右键选择“管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】两项权限。
方法二：进入暴力猴内部确认启用
点击暴力猴图标打开主界面 → 左上角菜单 → 设置 → 通用 → 确保【启用脚本】开关为开启状态。这一步常被忽略，但它是暴力猴自身是否响应的总闸。
验证脚本文件是否被浏览器识别
第一步：确认路径是否严格为【/sdcard/MiXiaBrowser/scripts/】（安卓）或【~/Library/Application Support/MiXiaBrowser/scripts/】（macOS），注意大小写与斜杠方向。
第二步：检查文件扩展名是否为纯小写 .user.js —— 若是 .USER.JS、.js.txt 或带空格（如“签到脚本.user.js”），浏览器会静默忽略，不报错也不显示。
第三步：用记事本打开该文件 → 全选复制 → 粘贴到Notepad++或VS Code中 → 查看开头是否有乱码或隐藏BOM头（如 ）→ 【务必另存为UTF-8无BOM格式】。
修复脚本匹配与执行时机
第一步：关闭所有已打开的目标网站标签页
第二步：新建标签页 → 手动输入网址（如 https://bilibili.com）→ 等待页面完全加载完毕
第三步：点击地址栏左侧「脚本状态图标」→ 查看日志中是否出现「✅ 已激活|执行成功 x1」字样
第四步：若无日志或显示「❌ 匹配失败」，返回暴力猴编辑脚本 → 检查@match规则是否与当前URL完全一致。例如页面是 https://www.zhihu.com/question/123，而规则写的是 @match https://zhihu.com/*，就会因子域名不匹配而失效。
第五步：确认元数据块中包含 @run-at document-end —— 漏掉这一行，脚本大概率因元素未就绪而静默失败。
