米侠浏览器怎样配置外部JS库的本地路径

米侠浏览器加载本地JS库需满足四条件：启用暴力猴并开启“在所有网站上运行”和“允许访问文件网址”权限；将库文件放入/sdcard/MiXiaBrowser/scripts/路径；在脚本中用@require ./xxx.js声明；重启浏览器后刷新脚本列表。

米侠浏览器加载外部JS库时，若依赖本地文件（如 jQuery、Lodash 或自定义工具库），必须将文件放在浏览器可识别的固定路径下，否则

确认脚本管理器是否已启用并授予权限

外部JS库需通过脚本管理器（如暴力猴）注入，而非直接由网页 script 标签加载。先确保暴力猴扩展已开启且拥有完整权限：点击右上角扩展图标 → 右键“暴力猴” → “管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】两项开关。

返回暴力猴界面 → 左上角菜单 → “设置” → “通用” → 确认【启用脚本】已打开。这一步不完成，后续所有@require声明均无效。

将JS库文件放入米侠浏览器指定扫描路径

安卓设备上，米侠浏览器仅自动扫描以下路径中的 .js 文件：【/sdcard/MiXiaBrowser/scripts/】。其他位置（如 /sdcard/Download/、/sdcard/lib/、根目录）不会被发现，即使路径正确写进 @require 也加载失败。

用手机文件管理器新建该路径：/sdcard/MiXiaBrowser/scripts/（注意大小写、斜杠方向，不能拼错为 Mixia 或 mixiabrowser）；把 jquery.min.js、lodash.4.17.21.js 等库文件复制进去。

若该文件夹已存在但库未生效，重启浏览器后进入【设置→高级设置→脚本注入】页，点击右上角【刷新脚本列表】按钮——此操作不可跳过，否则浏览器不会重新读取磁盘文件。

在用户脚本中正确声明本地库路径

方法一：使用 @require 指向 scripts 目录内相对路径
在脚本头部注释区添加：
@require ./jquery.min.js
@require ./lodash.4.17.21.js
注意：路径必须以 ./ 开头，不能写 file:///sdcard/... 或 /sdcard/...；也不能省略扩展名 .js。

方法二：在脚本正文内动态加载（适用于需条件加载或调试）
执行以下代码前，确保已通过方法一或手动确认库文件已在 scripts 目录中：
const script = document.createElement('script');
script.src = 'file:///sdcard/MiXiaBrowser/scripts/jquery.min.js';
document.head.appendChild(script);
【此方式绕过脚本管理器校验，但受 file:// 协议限制，部分 API（如 fetch、localStorage）可能仍不可用】

方法三：改用 CDN（推荐用于开发调试）
若本地路径反复失败，临时替换为：
@require https://cdn.jsdelivr.net/npm/[email protected]/dist/jquery.min.js
验证逻辑无误后再切回本地路径，避免误判为代码问题。

验证库是否成功加载

第一步：在目标网页打开控制台（菜单→检查元素→Console）；
第二步：输入 $ 或 jQuery（若引入 jQuery），回车；若返回函数定义而非 undefined，则加载成功；
第三步：若报错 ReferenceError: $ is not defined，检查 scripts 目录文件是否存在、扩展权限是否开启、脚本是否启用、@require 行是否拼写错误。

注意：若脚本匹配的是 file:// 协议页面（如本地 HTML 文件），需额外在 @match 中声明 @match file://*，否则脚本根本不会运行，自然也无法加载任何 @require。