米侠浏览器中第三方脚本失效需分步排查：先确认是否仅停用（开关灰色可点击启用），再检查匹配规则、@run-at时机和@version字段，最后修复编码格式、API调用及路径丢失问题。
米侠浏览器中已安装的第三方网页脚本在匹配规则失效、执行时机错位或元数据缺失时会停止响应，表现为脚本条目变灰、目标网页无任何增强效果、控制台报“@match not matched”或“document is not ready”，必须逐项校验并手动更新才能恢复运行。
确认脚本是否真正过期而非仅停用
进入暴力猴主界面 → 左上角菜单 → 「脚本列表」→ 找到目标脚本 → 查看右侧开关状态。若为灰色关闭态，先点击启用；若启用后仍无效，再继续排查。这一步操作起来很简单，直接点一下就行，但很多人误以为“变灰=损坏”，其实只是新版强制重置了启用状态。
右滑该脚本条目 → 点击「详情」→ 查看「最后修改时间」与「匹配网址」字段。若「匹配网址」为空或显示 *://*/*，说明 @match 规则未正确注入，脚本根本不会触发；若时间戳停留在2024年以前，大概率是作者已弃更，需寻找替代脚本或手动修复。
检查并更新核心元数据字段
点击脚本右侧「编辑」图标 → 滚动至顶部 // ==UserScript== 区域 → 逐行核对以下三项：
① 【@match 必须精确覆盖当前网页URL】：打开目标网页 → 地址栏复制完整URL（含 http:// 或 https://）→ 对比 @match 行。旧脚本常用 *://*.example.com/*，但v5.5+要求协议显式声明，应补全为两行：
https://*.example.com/*
http://*.example.com/*
否则HTTPS跳转后脚本彻底失活。
② 【@run-at 必须设为 document-end】：若脚本操作 DOM 元素（如自动点击、插入按钮），旧版默认 document-idle 在v5.5中已被移除，不加此行会导致代码执行时节点尚未生成，静默失败。
③ @version 字段必须存在且为有效语义化版本（如 2.1.0），不能留空或写“最新版”。该字段用于暴力猴判断是否需要更新提示，缺失则无法识别新版本推送。
修复脚本文件本身兼容性问题
方法一：验证并重存为 UTF-8 无 BOM 格式
用 Acode 或类似纯文本编辑器打开脚本文件 → 全选内容 → 复制粘贴至新文件 → 另存为时选择「UTF-8（无BOM）」→ 文件名保持小写 .user.js 结尾（如 adblock-plus.user.js）。
方法二：检查是否存在被移除的 API 调用
v5.5+ 移除了 unsafeWindow 和部分 GM_xmlhttpRequest 的简写形式。若脚本含 unsafeWindow.location 或 GM_getValue() 未带 namespace 参数，需替换为 window.location 和 GM_getValue('key', 'default', 'namespace')。
方法三：确认路径未被系统清理
用文件管理器打开 /sdcard/MiXiaBrowser/scripts/ → 查找对应 .user.js 文件。若不存在，说明安卓系统自动清理了长时间未访问的脚本目录，需重新下载最新版脚本文件并放入该路径，再重启浏览器 → 打开暴力猴 → 左上角菜单 → 「重新扫描脚本」。
