必须逐层验证准入条件:启用脚本注入并重启确认已启用;脚本须为小写.js、utf-8无bom、独立存放于/sdcard/mixiabrowser/scripts/;暴力猴需开启权限与脚本功能,并手动重载;最后用console.log调试验证执行。

你想让米侠浏览器自动执行去广告、批量签到等操作,但脚本明明放进了目录、开关也开了,页面却毫无反应——这不是脚本逻辑错了,而是它根本没被加载或执行,必须逐层验证准入条件是否全部满足。
确认脚本注入总开关已真正启用
点击右上角三个点图标 → 进入【设置】→【高级设置】→【脚本注入】→将“启用脚本注入”切换为开启状态。【必须重启浏览器后,再返回该页面确认开关右侧显示“已启用”】。若仍显示“未启用”,说明开关状态未持久化,后续所有操作全部无效。
这一步跳过会导致脚本列表始终为空,控制台连加载日志都不会输出。
验证脚本文件是否通过米侠硬性校验
米侠浏览器对本地脚本执行三项不可绕过的静态检查:扩展名必须是纯小写 .js、编码必须是UTF-8无BOM、文件必须独立解压存放于指定路径——三者缺一不可。
第一步:用文件管理器长按该.js文件→「属性」或「详情」查看扩展名。若是 .JS、.Js 或带空格(如“my script.js”),浏览器会静默忽略,不报错也不显示。
第二步:用记事本类纯文本工具打开文件,全选→复制→粘贴到Notepad++或VS Code中,开启“显示所有字符”。若开头出现  或乱码,说明存在BOM头,必须另存为UTF-8无BOM格式;否则解析器在读取元数据块时直接中断。
第三步:确认脚本未被压缩包包裹——米侠不扫描.zip/.rar内嵌的.js,必须解压到目录层级中,且不能有 manifest.json 干扰识别。
检查脚本是否落入米侠可扫描的固定路径
安卓设备上,米侠浏览器仅扫描以下路径中的.js文件:【/sdcard/MiXiaBrowser/scripts/】。其他任何位置(如Download、Documents、根目录)均不会被自动发现。
操作很简单:用文件管理器新建文件夹,路径必须严格为 /sdcard/MiXiaBrowser/scripts/(注意大小写和斜杠方向),然后把你的.js文件复制进去。
若该路径已存在但脚本仍未出现在列表中,重启浏览器后进入「设置→高级设置→脚本注入」页,点击右上角「刷新脚本列表」按钮——这一步不能跳过,否则浏览器不会重新扫描磁盘。
定位脚本是否被暴力猴正确识别并启用
米侠本身不执行用户脚本,必须依赖暴力猴等兼容油猴规范的扩展。没有它,.js 文件只是纯文本。
方法一:确认暴力猴已授予权限
点击右上角扩展图标 → 找到“暴力猴” → 右键选择“管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】两项权限。
方法二:确认暴力猴自身脚本功能已打开
点击暴力猴图标打开主界面 → 左上角菜单 → 设置 → 通用 → 确保【启用脚本】开关为开启状态。这一步常被忽略,但它是暴力猴响应的总闸。
方法三:手动触发脚本重载
回到暴力猴面板 → 左上角菜单 → 选择“重新扫描脚本” → 等待列表更新完成。若脚本名称后仍显示“未启用”,需点击右侧开关手动启用。
快速验证脚本是否真正在执行
第一步:在脚本最开头插入调试语句
在元数据块下方、主逻辑之前加一行:console.log('Script loaded at:', Date.now());,保存后刷新目标网页。
第二步:打开开发者工具(地址栏输入 miaoxia://devtools)→ 切换到 Console 标签页。
若看到该日志输出,说明脚本已加载并执行;若无任何输出,问题仍在前四步中;若报红字错误,则进入语法调试流程。
第三步:强制切换内核验证执行环境
进入【设置】→【高级设置】→【内核与UA设置】→ 先切为【X5内核+桌面版UA】→重启测试;若失败,再切为【系统内核+iPhone UA】→重启重试。V6版本中,两种组合匹配失败即静默跳过,不提示、不报错。











