如何在米侠浏览器中安装与使用.user.js格式的脚本

要在米侠浏览器中运行.user.js脚本，必须同时满足权限授予、路径存放、规则匹配、注入开关开启四个条件：启用暴力猴并授权“所有网站运行”和“访问文件网址”，脚本存于指定目录且为UTF-8无BOM格式的xxx.user.js，元数据块完整，且浏览器设置中开启“脚本注入”。

要在米侠浏览器中让.user.js脚本真正跑起来，必须同时满足权限授予、路径存放、规则匹配、注入开关开启四个硬性条件，缺一不可。

确认脚本管理器已启用并获得完整权限

米侠浏览器本身不内置脚本管理能力，必须依赖暴力猴等兼容油猴规范的管理器扩展。没有它，.user.js文件只是普通文本。

点击右上角扩展图标 → 找到“暴力猴”（或同类脚本管理器）→ 右键选择“管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】。

这一步漏掉任一权限，脚本连加载入口都没有，后续所有操作都无效。

返回暴力猴界面 → 左上角菜单 → 设置 → 通用 → 确保【启用脚本】开关为开启状态。

把.user.js文件放对位置并刷新识别

米侠浏览器只从指定目录扫描脚本，不会自动读取下载目录或任意路径下的.user.js文件。

将脚本文件重命名为xxx.user.js（确保后缀是.user.js而非.js），保存至：
Android设备：/sdcard/MiXiaBrowser/scripts/
macOS设备：~/Library/Application Support/MiXiaBrowser/scripts/

⚠️注意：文件不能带BOM头，否则暴力猴解析失败；用记事本另存为UTF-8无BOM格式最稳妥。

重启米侠浏览器 → 打开暴力猴面板 → 点击左上角菜单 → 选择“重新扫描脚本” → 等待列表更新完成。

手动添加脚本并配置关键元信息

如果脚本未出现在扫描列表中，或你想跳过文件系统直接部署，可用内置新建功能。

方法一：通过底部快捷入口
点击首页下方三个横杠图标 → 左右滑动找到并点击“脚本” → 点击“新增” → 选择“从代码添加” → 粘贴完整的.user.js源码 → 填写脚本名称 → 输入目标域名（如example.com）→ 提交。

方法二：通过设置路径进入
点击右上角三图标 → 设置 → 脚本扩展管理 → 点击+号 → 在新建界面中：
① 脚本名称：自定义，如“知乎免登录下载”
② 域名：填写@match规则对应的目标，例如https://www.zhihu.com/*
③ JS代码：必须粘贴包含完整元数据块（// ==UserScript== … // ==/UserScript==）的原始.user.js内容
④ 点击提交。

这一步若漏掉元数据块，暴力猴无法识别匹配规则和执行时机，脚本会静默失效。

开启浏览器级脚本注入开关

即使暴力猴一切正常，米侠浏览器自身仍有一道闸门——脚本注入总开关默认关闭。

点击右上角三个点 → 设置 → 高级设置 → 找到【脚本注入】选项 → 开启【启用脚本注入】。

该开关关闭时，暴力猴能显示脚本、能编辑、能保存，但完全不向网页DOM注入任何代码，页面行为毫无变化。

验证脚本是否生效

打开目标网页（URL必须严格匹配@match规则，比如@match https://github.com/* 就不匹配 http://github.com/）。

按F12打开开发者工具 → 切换到Console标签页 → 输入unsafeWindow 或者查看Sources面板下是否有该脚本文件加载记录。

若脚本含alert或console.log，此时应立即触发；若无反应，返回检查@match是否写错协议（漏了https?://）、是否多写了尾部斜杠、是否当前页面用了file://协议而未加@match file://*。