米侠浏览器v5.5+油猴脚本失效需校准：确认安装“脚本版”包、开启注入总开关、扩展名必须为小写.user.js、UTF-8无BOM编码、脚本置于/sdcard/MiXiaBrowser/scripts/目录并重扫，元数据须含@run-at和@match及必要@grant声明，关闭阅读模式并尝试桌面UA+X5内核组合。
米侠浏览器v5.5+版本中油猴脚本加载后无反应、按钮不出现、控制台却无报错，不是脚本写错了，而是注入机制已彻底重构，旧配置全部失效，必须按新规则逐项校准才能恢复运行。
确认浏览器基础支持与注入总开关
打开米侠浏览器 → 地址栏输入 about:version → 查看版本号末尾是否含 UM 或 UserScript 字样。不含则说明当前安装包不支持脚本功能，必须卸载后前往官网下载带“脚本版”标识的安装包重新安装。
点击右上角三个点 → 【设置】→ 【高级设置】→ 【脚本注入】→ 将“启用脚本注入”切换为开启状态。【必须先做这一步】
关闭并重启浏览器后，再次进入该页面，确认开关右侧显示“已启用”，否则后续所有操作全部无效。
部署脚本前的三项硬性校验
米侠浏览器对本地脚本有三项不可绕过的准入条件：扩展名必须是纯小写 .user.js（不是 .js）、编码必须是UTF-8无BOM、文件必须独立解压存放于指定目录——三者缺一不可。
第一步：检查文件扩展名是否为 .user.js —— 若是 .JS、.js、.user.JS 或带空格（如“my script.user.js”），浏览器会静默忽略，不报错也不显示。
第二步：用记事本类纯文本工具打开该文件 → 全选 → 复制粘贴到在线BOM检测网站（如 bomcheck.net）；若检测出BOM头，需用Notepad++或VS Code另存为“UTF-8 无BOM”格式。Windows自带记事本默认保存为UTF-8带BOM，务必避开。
第三步：确认脚本未被压缩包包裹——米侠不支持直接读取.zip/.rar内嵌的.user.js，必须解压到目录层级中，且不能与 manifest.json 等其他文件混放于子文件夹内。
将脚本放入唯一可识别路径并强制重扫
安卓设备上，米侠浏览器仅扫描以下路径中的.user.js文件：【/sdcard/MiXiaBrowser/scripts/】。其他任何位置（如Download、Documents、根目录）均不会被自动发现。
用文件管理器新建文件夹，路径必须严格为 /sdcard/MiXiaBrowser/scripts/（注意大小写和斜杠方向），然后把你的 xxx.user.js 文件复制进去。
重启浏览器后，点击暴力猴图标 → 左上角菜单 → 选择“重新扫描脚本” → 等待右下角提示“扫描完成，共发现 X 个脚本”。【这一步不能跳过，否则浏览器不会重新扫描磁盘】
修正元数据块关键字段
方法一：手动补全执行时机与匹配协议
点击暴力猴图标 → 找到目标脚本 → 点击「编辑」→ 在 // ==UserScript== 和 // ==/UserScript== 之间添加或修正以下两行：
@run-at document-end
@match https://example.com/*
漏掉 @run-at document-end，脚本大概率因DOM元素尚未就绪而静默失败；旧脚本常用 *://*.example.com/*，但v5.5+对协议前缀更敏感，建议补全为 https://*.example.com/* 或按需添加 http:// 行。
方法二：确保基础权限声明存在
若脚本使用了 GM_* 函数（如 GM_setValue），必须在元数据块中显式声明：@grant GM_setValue。缺失 @grant 声明会导致脚本灰显不可点，暴力猴拒绝加载。
关闭干扰模式并切换UA与内核
第一步：关闭阅读模式与文本重排
进入任意网页 → 点击地址栏左侧「AA」图标 → 关闭【阅读模式】和【文本重排】两项。这两项会剥离原始DOM结构，导致脚本找不到目标元素。
第二步：尝试不同UA+内核组合
点击右上角三个点 → 【设置】→ 【高级设置】→ 【用户代理】→ 切换为【桌面版UA】；再返回同一级菜单 → 【内核设置】→ 尝试切换【X5内核】或【系统内核】。部分脚本在X5+桌面UA下才能正确触发 @match 规则。
切换后，务必长按刷新按钮（或清空缓存后刷新），强制页面重建DOM。
