必须同时满足版本支持、注入开关开启、管理器授权、脚本规范四个条件:需安装“脚本版”(版本号含um/userscript)、开启【设置→高级设置→脚本注入】、为暴力猴授予权限并启用其自身脚本功能、脚本须为utf-8无bom格式且含完整元数据块。

你想让米侠浏览器自动执行网页增强功能,比如去广告、批量下载或自动签到,但脚本放进去却没反应——这不是脚本写错了,而是米侠的脚本运行机制和普通浏览器完全不同,必须同时满足四个硬性条件才能真正跑起来。
确认浏览器版本与脚本支持状态
打开米侠浏览器 → 地址栏输入 【about:version】 → 查看版本号末尾是否含“UM”或“UserScript”字样。不含则说明当前安装包不支持脚本功能,必须卸载后前往官网下载带“脚本版”标识的安装包重新安装。这一步跳过会导致后续所有操作白费,且无任何错误提示。
重启浏览器后,在地址栏输入 【miscript://】,能正常打开脚本管理页面才算基础支持已就位。
开启浏览器级脚本注入总开关
点击右上角三个点图标 → 进入【设置】→ 【高级设置】→ 向下滚动找到【脚本注入】选项 → 将“启用脚本注入”开关切换为开启状态。
若该选项缺失,请立即检查版本号:必须为 v5.5.4.2 及以上,旧版本不提供此开关,也无法通过设置补救。
安装并授权暴力猴脚本管理器
米侠浏览器本身不内置脚本执行能力,必须依赖暴力猴等兼容油猴规范的扩展。没有它,.user.js 文件只是纯文本。
方法一:通过扩展面板授予权限
点击右上角扩展图标 → 找到“暴力猴” → 右键选择“管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】两项权限。
方法二:进入暴力猴内部确认启用
点击暴力猴图标打开主界面 → 左上角菜单 → 设置 → 通用 → 确保【启用脚本】开关为开启状态。这一步常被忽略,但它是暴力猴自身是否响应的总闸。
部署.user.js脚本的三种方式
第一步:把脚本文件存放到指定目录
将脚本重命名为 xxx.user.js(后缀必须是 .user.js,不是 .js),保存至:
Android 设备:【/sdcard/MiXiaBrowser/scripts/】
macOS 设备:【~/Library/Application Support/MiXiaBrowser/scripts/】
⚠️注意:文件必须为 UTF-8 无 BOM 格式,否则暴力猴解析失败;用记事本另存为“UTF-8(无签名)”最稳妥。
第二步:重启浏览器 → 打开暴力猴面板 → 左上角菜单 → 选择“重新扫描脚本” → 等待列表更新完成。
第三步:若扫描未识别,可手动添加
点击首页底部三个横杠图标 → 左右滑动找到并点击“脚本” → 点击“新增” → 选择“从代码添加” → 粘贴完整 .user.js 源码(含 // ==UserScript== 元数据块)→ 填写脚本名称 → 输入目标域名(如 https://www.zhihu.com/*)→ 提交。
这一步若漏掉元数据块,暴力猴无法识别匹配规则和执行时机,脚本会静默失效,页面上完全看不到任何痕迹。











