米侠浏览器中已安装的各个版本User Script如何管理

需通过文件名、@version字段和本地哈希三者匹配识别版本；编辑元数据查看@version，路径末尾文件名含版本号即手动命名；并行安装须改名+改@version+独立存放；卸载旧版需停用→导出备份→删除条目→手动清理文件。

你想在米侠浏览器中区分、启用/停用、更新或彻底替换不同版本的同一款User Script（比如“知乎免登录下载 v1.2”和“v1.3-beta”），但发现脚本管理器列表里只显示一个条目，无法识别版本差异，也无法并行调试——这不是界面显示问题，而是米侠对脚本版本的识别逻辑完全依赖文件名、元数据块中的@version字段及本地存储哈希值三者匹配，任意一项不一致就会被当作全新脚本处理。

识别当前已安装脚本的真实版本信息

进入暴力猴主界面 → 点击左上角菜单 → 选择“脚本列表” → 找到目标脚本 → 点击右侧「编辑」图标 → 滚动至脚本头部元数据区（// ==UserScript== 开始部分）→ 查看 @version 行内容。这行必须是纯数字或语义化版本号（如 1.3.0），若为空、含空格或写成“最新版”，暴力猴将默认视为 v0.0.0，导致后续版本比对失效。

右滑该脚本条目 → 点击「详情」→ 查看「最后修改时间」和「文件路径」。Android设备路径为 /sdcard/MiXiaBrowser/scripts/xxx.user.js，macOS为 ~/Library/Application Support/MiXiaBrowser/scripts/xxx.user.js。路径末尾的文件名若含版本号（如 zhihu-dl-v1.2.user.js），则说明你曾手动重命名存放；若为随机哈希（如 a3f9d2e8.user.js），则该脚本是通过导入或新建生成，原始版本信息已丢失。

并行安装多个版本脚本（用于对比测试）

方法一：改名+改@version+独立存放

将 v1.2 脚本文件复制一份 → 重命名为 zhihu-dl-v1.2.user.js → 用Acode打开 → 修改头部 @version 为 1.2.0 → 保存为UTF-8无BOM → 放入 /sdcard/MiXiaBrowser/scripts/ 目录；同理处理 v1.3 脚本，命名为 zhihu-dl-v1.3.user.js，@version 改为 1.3.0。

重启米侠浏览器 → 打开暴力猴 → 左上角菜单 → 「重新扫描脚本」→ 两个版本将分别出现在列表中，名称自动取自 @name 字段，但可通过右滑条目 → 「重命名」来添加版本后缀（如“知乎免登录下载 v1.2”）。

【注意：两个版本的 @match 规则必须完全一致，否则可能只触发其中一个；若需隔离测试，可临时将 v1.3 的 @match 改为 https://www.zhihu.com/test/*，避免干扰生产环境】

方法二：同一文件内用条件分支模拟多版本

在单个脚本代码末尾添加：
if (GM_info.script.version === '1.2.0') { /* v1.2 特有逻辑 */ } else if (GM_info.script.version === '1.3.0') { /* v1.3 特有逻辑 */ }

这样无需管理多个文件，但调试时无法单独启停某版本，且 @version 必须与元数据块严格一致，否则 GM_info.script.version 返回 undefined。

安全卸载旧版本并保留新版本配置

第一步：确认新版本已启用且运行正常 → 打开目标网页 → 检查功能是否生效 → 查看暴力猴控制台日志（右键页面 → 「检查」→ Console 标签页）是否有报错。

第二步：停用旧版本 → 在暴力猴脚本列表中，找到旧版本条目 → 关闭右侧开关 → 右滑 → 选择「导出脚本」→ 保存为 backup-v1.2.js（留作回滚备份）。

第三步：彻底移除旧版本 → 返回脚本列表 → 长按旧版本条目 → 选择「删除」→ 在弹窗中点击「确定」。

【删除操作不可逆，且不会自动清理 /sdcard/MiXiaBrowser/scripts/ 目录下的对应 .user.js 文件；若该文件仍存在，下次扫描会重新加载为新条目】

第四步：清理残留文件 → 用文件管理器进入 /sdcard/MiXiaBrowser/scripts/ → 找到旧版本对应文件（如 zhihu-dl-v1.2.user.js）→ 长按 → 「删除」。

批量更新多个脚本的版本号与匹配规则

① 进入 /sdcard/MiXiaBrowser/scripts/ 目录 → 长按空白处 → 选择「选择全部」→ 勾选所有 .user.js 文件 → 点击右下角「编辑」。

② 使用文本编辑器全局替换：将所有 // @version 后的旧版本号（如 1.1.0）替换为新版本号（如 1.3.0）；将 // @match https://old-site.com/* 替换为 // @match https://new-site.com/*。

③ 保存时务必选择「UTF-8无BOM」格式 → 返回米侠浏览器 → 暴力猴界面 → 左上角菜单 → 「重新扫描脚本」。

这一步完成后，所有脚本的 @version 和 @match 将同步更新，但启用状态、@run-at 设置等用户配置项不会被覆盖，仍保留原设置。