必须先确认版本含“um”或“userscript”，否则需重装脚本版；再开启脚本注入开关、安装暴力猴并授予权限，将utf-8无bom的xxx.user.js存至指定路径，重启后重新扫描或手动导入，最后验证匹配网页是否生效。
你想在米侠浏览器里跑自己写好的或从 GitHub 下载的本地 .user.js 脚本，但点开暴力猴面板却找不到文件——这不是脚本丢了，而是米侠对脚本加载路径、编码格式和启用流程有硬性要求，漏掉任一环节都会导致脚本静默失效。
确认浏览器支持脚本功能
地址栏输入 【about:version】 回车，查看版本号末尾是否含“UM”或“UserScript”。不含则说明当前安装包不支持脚本，必须卸载后去官网下载带“脚本版”标识的安装包重装。这一步跳过，后续所有操作都无效且无提示。
重启后，在地址栏输入 【miscript://】，能打开空白脚本管理页即表示基础支持已就位。
开启全局脚本注入开关
点击右上角菜单 → 进入【设置】→ 【高级设置】→ 找到【脚本注入】→ 开启“启用脚本注入”。
若该选项根本不存在，请立即检查版本号：必须为 v5.5.4.2 及以上，旧版本无法补救。
安装并配置暴力猴管理器
米侠浏览器自身不执行脚本，暴力猴是唯一可行入口。没有它，.user.js 文件只是纯文本。
方法一：通过扩展面板授予权限
点击右上角扩展图标 → 找到“暴力猴” → 右键“管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】。
方法二：进入暴力猴内部确认总开关
点击暴力猴图标 → 左上角菜单 → 设置 → 通用 → 确保【启用脚本】为开启状态。这一步常被忽略，却是暴力猴是否响应的总闸。
部署本地 .user.js 脚本
第一步：将脚本文件重命名为 xxx.user.js（后缀必须是 .user.js，不能是 .js 或 .txt）
第二步：保存至对应系统路径：
Android 设备：/sdcard/MiXiaBrowser/scripts/
macOS 设备：~/Library/Application Support/MiXiaBrowser/scripts/
⚠️注意：文件必须为 UTF-8 无 BOM 格式，用记事本另存为“UTF-8（无签名）”最稳妥，否则暴力猴解析失败。
第三步：重启米侠浏览器 → 点击暴力猴图标 → 左上角菜单 → 选择“重新扫描脚本” → 等待列表刷新完成。
第四步：若仍未识别，可手动添加
点击暴力猴首页底部三个横杠图标 → 左右滑动 → 选择“导入脚本” → 从文件管理器中选取刚存好的 .user.js 文件。
验证脚本是否生效
打开暴力猴面板 → 找到刚导入的脚本 → 确认右侧开关为开启状态（绿色）。
访问脚本 @match 规则匹配的任意网页，观察页面变化：出现自定义按钮、元素消失、控制台输出日志，或弹出 alert 提示，即表示运行成功。
