### 米侠浏览器5.5+：脚本管理全面转向手动时代，这些坑一个都不能踩 先划重点：从5.5版本开始，米侠浏览器对用户脚本的管理逻辑发生了根本性变化——不再是“放进去就能用”，而是变成了一套必须逐项手动确认的流程。如果你升级后发现脚本全部失效，别急着怀疑代码，大概率是这些隐藏开关没开对。

旧版本里，把.js文件扔进目录，浏览器会自动识别并默认启用。新版则彻底碘伏了这一模式：脚本注入默认关闭、路径格式必须精确、编码要求严格、匹配规则需要显式声明、执行时机必须指定、甚至内核和UA的组合也会影响脚本能否正常运行。下面逐条拆解，缺一不可。 ## 脚本注入不再默认开启 第一步，也是最容易被忽略的一步：进入浏览器设置。点击右上角三个点→【设置】→【高级设置】→【脚本注入】，把“启用脚本注入”开关拨到开启状态。 注意：拨动开关后最好重启浏览器，然后回到这个页面确认开关右侧显示“已启用”。否则即便脚本文件存在，列表也会是空的，控制台没有任何日志，页面毫无注入痕迹——**这是所有后续操作的前提，未完成则后面全部无效**。 ## 脚本路径与格式要求升级 路径方面，安卓设备只认 `/sdcard/MiXiaBrowser/scripts/` 目录下的.js文件。其他任何路径——Download、Documents、甚至根目录——统统不识别。所以请确保脚本文件老老实实放在这个专用目录里。 接着是编码问题。长按脚本文件选择「编辑」，全选粘贴到纯文本工具中查看。如果开头出现乱码或隐藏的BOM头（典型的如EF BB BF字节），必须另存为UTF-8无BOM格式，否则浏览器会静默跳过，不报错也不显示。 扩展名必须是纯小写的 `.js`。如果你不小心写成了 `.JS`、`.Js`，或者文件名里带了空格（比如“my script.js”），米侠会直接忽略，连个警告都没有。 ## 匹配规则与执行时机需显式声明 很多旧脚本的 `@match` 规则写的是 `*://*.example.com/*`，但v5.5对协议变得敏感。建议拆成两行分别匹配： ```ja vascript @match https://*.example.com/* @match http://*.example.com/* ``` 执行时机也要手动指定。v5.5的默认时机是 `document-start`，但多数旧脚本依赖DOM加载完成。如果你的脚本需要操作按钮、表单等元素，必须添加 `@run-at document-end`；如果是要劫持原生fetch，则用 `@run-at document-start`。 还有一个容易踩的坑：阅读模式和文本重排。在任意网页点击右下角三个点→【设置】→【网页浏览设置】，关闭【自动重排文本】和【阅读模式】。关闭之后一定要点击地址栏右侧的刷新按钮强制重载，光切换开关不刷新等于没关——这两项功能会撕碎原始DOM，导致所有选择器失效。 ## 内核与UA组合影响脚本可执行性 进入【设置】→【高级设置】→【内核与UA设置】，这里有两个组合需要亲自测试。 先尝试 **X5内核 + 桌面UA** 组合，重启后测试脚本。如果失败，再切换为 **系统内核 + iPhone UA** 组合，重启重试。 X5内核适配国内多数视频站的HTML结构，但会屏蔽AbortController、fetch streaming等现代API；系统内核更接近Chrome原生行为，但部分网站会因UA识别返回移动端精简HTML——**两种组合必须都试，不能只试一种**。 ## 脚本启用状态不再继承旧配置 即便脚本文件没动、路径正确、编码合规，v5.5也会把所有旧脚本的初始状态设为“灰色禁用”。你必须手动进入【脚本注入】页面，逐个点击每个脚本右侧的开关，等待状态变为蓝色才表示启用成功。 这是强制安全策略，无法跳过，也没有批量启用功能。所以升级后会发现脚本列表都在，但都是关闭状态——别慌，一个一个点开就行。 总结一下：新版米侠的脚本管理从“隐式自动”变成了“显式手动”，每个环节都需要你亲自确认。不过一旦配置到位，稳定性反而比旧版更高。如果你正在遇到脚本不生效的问题，不妨按上面的步骤逐一排查，大概率能解决问题。