米侠浏览器脚本未生效需四层排查：先确认【启用脚本注入】开关已开启并重启浏览器；再检查脚本为小写.js、UTF-8无BOM、独立存放于/sdcard/MiXiaBrowser/scripts/；接着修正@match协议匹配和@run-at document-end；最后关闭阅读模式、切换内核或UA适配。
米侠浏览器安装脚本后在网页上无法生效，常见表现为页面无新增按钮、自定义UI不出现、右键菜单无扩展项、控制台也无报错日志，这说明脚本虽已安装，但根本未被注入执行，必须从注入通路、匹配规则、执行时机、路径合规性四层逐级排查。
确认脚本注入总开关是否开启
脚本注入是整个机制的底层通道，未开启则所有后续步骤全部失效。该开关独立于脚本管理器本身，且状态变更需重启才生效。
1、点击米侠浏览器右上角三个点图标 → 进入【设置】→【高级设置】。
2、向下滚动找到【脚本注入】或【用户脚本管理】选项，点击进入。
3、确认【启用脚本注入】开关为蓝色开启状态；若为灰色，点击切换并等待页面刷新。
【此步骤不可跳过：关闭后再重开浏览器，否则新状态不生效】
验证脚本文件是否符合准入条件
米侠浏览器对本地脚本有三项硬性校验：扩展名必须是纯小写 .js、编码必须是UTF-8无BOM、文件必须独立解压存放于指定目录——三者缺一不可。
第一步：检查文件扩展名是否为纯小写 .js —— 若是 .JS、.Js 或带空格（如“my script.js”），米侠浏览器会静默忽略，不报错也不显示。
第二步：用文件管理器长按该.js文件 → 「编辑」→ 全选内容粘贴到记事本类纯文本工具中查看：若开头出现乱码或隐藏BOM头（如 EF BB BF 字节），必须另存为UTF-8无BOM格式，否则解析失败。
第三步：确认脚本文件未被压缩包包裹——米侠浏览器不支持直接读取.zip/.rar内嵌的.js，必须解压到目录层级中，且manifest.json（如有）需与.js同级。
将脚本放入浏览器可识别的固定路径
安卓设备上，米侠浏览器仅扫描以下路径中的.js文件：【/sdcard/MiXiaBrowser/scripts/】。其他任何位置（如Download、Documents、根目录）均不会被自动发现。
操作很简单：用文件管理器新建文件夹，路径必须严格为 /sdcard/MiXiaBrowser/scripts/（注意大小写和斜杠方向），然后把你的.js文件复制进去。
若该路径已存在但脚本仍未出现，重启浏览器后进入「设置→高级设置→脚本注入」页，点击右上角「刷新脚本列表」按钮——这一步不能跳过，否则浏览器不会重新扫描磁盘。
修复匹配规则与执行时机
旧版油猴脚本常使用 *://*.example.com/* 这类宽泛匹配，但米侠v5.5+对 @match 协议前缀敏感，file:// 协议需显式声明，且 @run-at 必须限定为 document-end 才能稳定操作DOM。
方法一：编辑脚本 → 检查头部 @match 行
确保包含当前网页协议，例如访问本地HTML文件时，必须添加 @match file:///*；访问 https://site.com 时，避免只写 @match *://site.com/*，应补全为 @match https://site.com/* 和 @match http://site.com/*。
方法二：强制指定执行时机
在元数据块中加入 @run-at document-end。米侠不支持 document-idle 或 document-ready，误用会导致脚本在 DOM 尚未挂载时就退出，返回 null 且无提示。
方法三：禁用阅读模式干扰
某些网站启用米侠「阅读模式」后，原始DOM被替换为净化后的精简结构，脚本匹配的目标节点全部消失。进入目标网页 → 点击地址栏右侧「Aa」图标 → 关闭「阅读模式」再测试。
排除内核与UA导致的匹配失效
部分脚本通过 navigator.userAgent 或 window.webkitURL 判断运行环境，若米侠当前内核与UA组合不满足判断条件，脚本会主动 return 退出。
第一步：长按地址栏左侧锁形图标 → 弹出菜单中选择「切换内核」→ 尝试在 X5 内核与系统 WebView 之间切换一次。
第二步：在「设置」→「高级设置」→「内核与UA设置」中，将 User-Agent 改为「桌面版」或「iPhone」，保存后刷新网页。
第三步：若仍无效，在地址栏输入 miaoxia://devtools 打开开发者工具 → Console 标签页中输入 navigator.userAgent 回车，确认输出值是否与脚本中预设的 UA 判断逻辑一致。
