脚本不生效须按顺序排查：先开启注入总开关并确认“已启用”，再检查.js文件utf-8无bom编码及正确路径，接着刷新脚本列表，然后尝试x5内核+桌面ua、系统内核+iphone ua两种组合，关闭阅读模式与文本重排并强制刷新，最后重置注入配置重新导入。
米侠浏览器导入的脚本不生效或出现功能冲突，常见于注入开关未开、脚本路径放错、匹配规则失效、内核与UA组合不兼容、阅读模式撕毁DOM结构等环节，必须按实际现象分路径验证，不能只改一个地方就认为问题已解。
确认脚本注入总开关已开启
点击右上角三个点→【设置】→【高级设置】→【脚本注入】→将“启用脚本注入”切换为开启状态。
重启浏览器后，再进入该页面确认开关右侧显示“已启用”，【必须先做这一步】，否则后续所有操作全部无效。
检查脚本存放路径与文件格式
方法一：本地.js脚本必须放对位置且无BOM头
将脚本文件保存为UTF-8无BOM编码的纯文本，扩展名严格为.js；Android用户存入/sdcard/MiXiaBrowser/scripts/，macOS用户存入~/Library/Application Support/MiXiaBrowser/scripts/。
方法二：在线脚本需手动刷新扫描
开启注入开关后，返回【脚本注入】页，点击右上角【刷新脚本列表】，等待几秒——若脚本仍不出现，说明路径错误或文件被系统拦截（如iOS/iPadOS因沙盒限制根本无法访问该目录）。
强制切换内核+UA组合绕过兼容性陷阱
第一步：进入【设置】→【高级设置】→【内核与UA设置】
第二步：先将内核切换为【X5内核】，UA同步设为【桌面版】→重启浏览器→测试脚本
在 Linux 上通过 Chrome 挂载/VNC 自动发布小红书长笔记。Agent 撰写标题和正文后执行 xhs_publish.sh --publish --submit，触发小红书发布。
第三步：若失败，再切回【系统内核】+【iPhone UA】→重启→重试
X5内核对国内网站适配好但会屏蔽部分现代API，系统内核更接近Chrome行为但默认UA可能被识别为低端安卓设备导致服务器返回阉割版HTML——两种组合必须都试，不能只试一种。某些金融类或视频平台网页在X5内核下会彻底禁用脚本注入，此时必须用系统内核+iPhone UA才能触发完整DOM加载，脚本才有执行基础。
关闭阅读模式与文本重排
在任意网页点右下角三个点→【设置】→【网页浏览设置】→关闭【自动重排文本】和【阅读模式】
关闭后必须点击地址栏右侧刷新按钮强制重载，仅切换开关不刷新等于没关。这两项功能会主动重构页面DOM结构，把原始HTML撕碎重排，油猴脚本依赖的元素选择器全部失效。
重置注入配置并重新导入脚本
① 进入【脚本注入】设置页→点击右上角【更多】→【导出配置】（可选，用于备份）
② 点击【重置脚本注入设置】，确认清除全部注入规则与启用状态
③ 重启浏览器，重新将.js文件放入/sdcard/MiXiaBrowser/scripts/目录
④ 返回【脚本注入】页，点击【刷新脚本列表】→勾选目标脚本→点击右上角【启用】
