米侠浏览器脚本未加载需依次检查：版本是否带“UM”或“UserScript”标识、miscript://能否访问、注入总开关是否开启、脚本路径格式是否正确、@match规则是否精确匹配URL、@run-at是否为document-end等合法值、阅读模式是否关闭。
米侠浏览器安装脚本后目标页面完全没反应，按钮不出现、DOM未修改、控制台也无报错，说明脚本压根没加载进页面——不是逻辑写错了，而是从浏览器底层开关到脚本元数据匹配，中间任一环节断裂都会导致静默失效。
确认浏览器是否具备脚本运行基础
在地址栏输入【about:version】→ 查看版本号末尾是否带有【UM】或“UserScript”字样。没有则说明当前安装包不支持脚本功能，【必须卸载后前往官网下载带‘脚本版’标识的安装包重装】。
重启浏览器后，在地址栏输入【miscript://】，能正常打开脚本管理页才算基础就位。旧版本即使开启所有开关也无法调用 DOM 接口，且不报错、不提示、不弹窗。
开启浏览器级脚本注入总开关
点击右上角三个点图标 → 进入【设置】→ 【高级设置】→ 向下滚动找到【脚本注入】选项 → 将“启用脚本注入”开关切换为开启状态。
若该选项缺失，请立即检查版本号：必须为 v5.5.4.2 及以上，旧版本不提供此开关，也无法通过设置补救。关闭浏览器再重新打开，确保设置生效——这一步不做，后面所有操作全部无效。
验证脚本存放路径与文件格式
方法一：本地 .js 脚本必须放对位置且无 BOM 头
将脚本文件保存为 UTF-8 无 BOM 编码的纯文本，扩展名严格为【.js】（小写，不能是 .JS 或 .user.js）；Android 用户存入【/sdcard/MiXiaBrowser/scripts/】，macOS 用户存入【~/Library/Application Support/MiXiaBrowser/scripts/】。
【注意：文件必须为 UTF-8 无 BOM 格式，否则解析失败；用记事本另存为“UTF-8(无签名)”最稳妥】。若路径中含中文、空格或大小写错误（如 MixiaBrowser 写成 mixiabrowser），浏览器会直接忽略该文件。
方法二：在线脚本需手动刷新扫描
开启注入开关后，返回【脚本注入】页，点击右上角【刷新脚本列表】，等待几秒——若脚本仍不出现，说明路径错误或文件被系统拦截（如 iOS/iPadOS 因沙盒限制无法访问该目录）。
检查脚本匹配规则与执行时机
第一步：确认 @match 规则精确覆盖目标网页 URL
例如目标页是 https://www.bilibili.com/video/BV1xx411c7mD，脚本中必须包含 @match *://*.bilibili.com/* 或更具体的 @match *://www.bilibili.com/video/*。若只写 @match https://bi，匹配将失败。
第二步：检查 @run-at 是否声明且值合法
打开脚本编辑界面，定位到元数据块（// ==UserScript== 和 ==/UserScript== 之间），查找是否存在 @run-at 行。若整段注释里完全没出现这个词，说明该参数根本未声明，脚本将回退到米侠默认时机——通常是 document-start，但实际行为不稳定。
米侠浏览器仅稳定识别以下三种 @run-at 值：document-end（推荐用于绝大多数 DOM 操作）、document-start（仅适用于劫持 fetch/XMLHttpRequest）、context-menu（v5.5.4+ 才稳定）。其他如 document-idle、document-ready 等均不生效。
第三步：验证是否被阅读模式或文本重排拦截
进入目标网页后，点击地址栏右侧“更多”按钮（三点竖排图标），确认【阅读模式】和【文本重排】两项均为关闭状态。这两项会剥离原始 HTML 结构，导致脚本找不到目标节点而静默跳过。
