米侠浏览器v4.0与v5.0脚本兼容性对比

先说说米侠浏览器在脚本支持上的一个关键分水岭：v4.0 和 v5.0 完全是两套逻辑。v4.0 默认自动注入脚本，而且没有开关、没有内核切换选项；到了 v5.0，不仅加了一个手动总控开关，还新增了 X5/系统双内核选项，脚本必须匹配对应内核的 DOM 与 API 才能跑起来。另外，v5.0 还多出几条硬性要求——关闭阅读模式、使用 UTF-8 无 BOM 编码、脚本路径必须放对。下面拆开细讲。

v4.0 版本默认启用脚本注入，且没有内核切换开关——所有油猴脚本在页面加载完成后自动执行，用户什么都不用管。v5.0 则把脚本注入改成了手动总控开关，默认关闭，同时新增 X5/系统双内核选项，脚本必须匹配对应内核的 DOM 结构与 API 支持范围才能生效。

v4.0脚本运行机制

启动浏览器后，只要脚本文件存放在默认路径（Android 为 /sdcard/MiXiaBrowser/scripts/），无需任何设置就能自动识别并注入到匹配网页中。这一步操作很简单，直接把 .js 文件放进去，刷新页面就能看到效果。

脚本执行时机固定在 DOMContentLoaded 之后、window.load 之前，不依赖 UA 或内核类型判断——v4.0 不存在“启用脚本注入”开关，也无内核切换项，所有配置均为硬编码写死。

v5.0脚本注入必须开启总开关

第一步：点击右上角三个点 → 【设置】 → 【高级设置】 → 【脚本注入】 → 将“启用脚本注入”切换为开启状态。

第二步：重启浏览器后，返回该设置页确认开关右侧显示“已启用”，否则后续所有脚本均静默失效。

这一步是 v5.0 相比 v4.0 最根本的差异。没执行的话，脚本列表为空、页面中完全无注入痕迹，连控制台都看不到任何脚本执行日志。

内核与UA组合影响脚本可执行性

方法一：X5内核 + 桌面UA
适配国内多数视频站 HTML 结构，但会屏蔽部分现代 API（如 AbortController、fetch streaming），导致依赖这些 API 的脚本报错退出。

方法二：系统内核 + iPhone UA
保留完整 Chrome 行为，但部分网站会返回移动端精简 HTML，原 v4.0 中基于 PC 版 DOM 写的 querySelector 选择器全部失效。

两种组合必须都试，不能只试一种——因为 v5.0 不再像 v4.0 那样统一用单一内核兜底。

阅读模式与文本重排会破坏脚本基础

在任意网页点右下角三个点 → 【设置】 → 【网页浏览设置】 → 关闭【自动重排文本】和【阅读模式】。

关闭后必须点击地址栏右侧刷新按钮强制重载，仅切换开关不刷新等于没关。

v4.0 版本无此功能，因此不存在因 DOM 被撕碎导致脚本失效的问题。

脚本路径与编码要求升级

① 脚本文件必须保存为 UTF-8 无 BOM 编码，扩展名严格为 .js；
② Android 用户必须存入 /sdcard/MiXiaBrowser/scripts/，macOS 用户存入 ~/Library/Application Support/MiXiaBrowser/scripts/；
③ iOS/iPadOS 因沙盒限制无法访问该目录，v5.0 在此平台实际不支持本地脚本注入。