脚本未执行需逐层排查:先确认版本含【UM】或“UserScript”并能打开miscript://;再开启【设置→高级设置→脚本注入】开关并重启;接着为暴力猴授予“所有网站运行”权限并启用其自身脚本功能;然后确保脚本存于/sdcard/MiXiaBrowser/scripts/、小写.js、UTF-8无BOM、含匹配@match规则;最后添加@run-at document-end、关闭阅读模式并强制刷新。

米侠浏览器安装脚本后页面毫无变化、按钮不自动点击、样式没修改、控制台也无报错,说明脚本虽已导入但未真正进入执行环境——这通常不是代码问题,而是浏览器未给脚本“开门放行”,必须逐层检查权限通路是否被堵死。
确认浏览器是否具备脚本运行基础
打开地址栏,输入 about:version → 查看版本号末尾是否有【UM】或“UserScript”字样。没有则说明当前安装包不支持脚本功能,必须卸载后前往官网下载带“脚本版”标识的安装包重装。
安装完成后重启浏览器,在地址栏输入 miscript://,能正常打开脚本管理页才算基础就位。旧版即使开启所有开关也无法调用 DOM 接口,且不报错。
开启浏览器级脚本注入总开关
点击右上角三个点图标 → 进入【设置】→ 【高级设置】→ 向下滚动找到【脚本注入】选项 → 将“启用脚本注入”开关切换为开启状态。
【若该选项缺失,说明当前版本低于 v5.5.4.2,必须重装脚本版】。关闭浏览器再重新打开,确保设置生效。
授权脚本管理器扩展权限
米侠浏览器本身不内置脚本执行能力,必须依赖暴力猴等兼容油猴规范的扩展。没有它,.user.js 文件只是纯文本。
方法一:通过扩展面板授予权限
点击右上角扩展图标(拼图形状)→ 右键目标脚本管理器(如“暴力猴”)→ 选择“管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】两项开关。
方法二:进入暴力猴内部确认启用
点击暴力猴图标打开主界面 → 左上角菜单 → 设置 → 通用 → 确保【启用脚本】开关为开启状态。这一步常被忽略,但它是暴力猴自身是否响应的总闸。
验证脚本是否被正确加载与匹配
第一步:检查脚本文件路径与命名
安卓设备上,米侠浏览器仅扫描 /sdcard/MiXiaBrowser/scripts/ 目录下的 .js 文件。其他任何位置(如 Download、Documents)均不会被自动发现。文件名必须为纯小写 .js(不能是 .JS 或 .user.js),否则静默忽略。
第二步:确认脚本编码与元数据
用记事本类纯文本工具打开脚本文件,检查开头是否有 BOM 头(如 EF BB BF 字节);若有,另存为 UTF-8 无 BOM 格式。同时确认元数据块中包含 @match 行,且其值能匹配当前网页 URL,例如访问 https://bilibili.com/video/av123 时,@match 至少应为 https://bilibili.com/*。
第三步:强制刷新脚本列表并启用
进入【设置→高级设置→脚本注入】页 → 点击右上角【刷新脚本列表】→ 等待几秒 → 若脚本出现在列表中,逐个点击右侧开关启用。v5.5 起脚本启用状态不再继承旧版配置,必须手动点开每个开关。
修正脚本执行时机与内核适配
① 添加 @run-at 显式声明执行时机
很多旧脚本依赖默认 document-idle,但米侠 v5.5+ 默认改为 document-start。若脚本操作 DOM 元素,必须手动加上 @run-at document-end,否则执行时节点尚未生成。
② 切换内核组合测试
V6 系列默认关闭脚本注入,且内核行为更敏感:X5 内核屏蔽 AbortController、fetch streaming;系统内核 + iPhone UA 可能导致 PC 版选择器全部失效。必须尝试 X5+桌面UA 和 系统内核+iPhone UA 两种组合,并在每次切换后点击地址栏刷新按钮强制重载。
③ 关闭阅读模式与文本重排
点右下角三个点 → 【设置】→【网页浏览设置】→ 关闭【自动重排文本】和【阅读模式】。关闭后必须点击地址栏右侧刷新按钮强制重载——仅切换开关不刷新,DOM 仍被撕碎,脚本选择器全部失活。


















