# VRC 解析助手：浏览器插件安装与更新

当前网站下载版：**v1.6.20**；本次核实的 Edge 商城公开版：**v1.6.12**。本站插件文件优先更新；Edge 商城需要审核，更新通常会慢几天。Edge 用户也可以直接安装下载版。

## 方式一：从 Edge 插件商城安装

1. 用 Edge 打开 [VRC 解析助手商城详情页](https://microsoftedge.microsoft.com/addons/detail/vrc-%E8%A7%A3%E6%9E%90%E5%8A%A9%E6%89%8B/ndojegkbnhflahiinhgejgdbgglgkifl)。
2. 点击“获取”，确认“添加扩展”。
3. 在地址栏旁的扩展菜单中固定“VRC 解析助手”。
4. 跳转按钮失效时，在网站安装说明中复制“商城备用链接”，粘贴到 Edge 地址栏打开。

商城版通过商城更新。商城页面显示的版本可能暂时低于本站下载版。

### 商城 v1.6.12 使用平台线路

1. 在网站“浏览器插件”面板点击“复制兼容节点”。地址为 `https://xingvrchat.com/edge-store/1.6.12`。
2. 打开插件设置页，展开“连接设置”，将“解析节点”替换为该地址并保存。
3. 节点改变后，使用本站账号在插件里重新登录。
4. 结果会显示“Edge 商城 1.6.12 兼容模式 · 平台线路”。免费档和满血档的限制照旧；这个入口不会提升权限。
5. 解析歌单时，网站需登录与插件相同的账户。旧插件只保存短期交接票据，私有曲目在网站校验账户后读取；票据过期请重新解析。

此兼容节点只针对商城当前公开版 1.6.12，不开放其他旧版专用入口。商城版不能执行本机 Cookie／本机网络解析，使用这些功能请安装下载版。新版插件使用普通节点 `https://dxxlot.top`，再选择本机线路或平台线路。

## 方式二：安装最新版 ZIP（Chrome、Edge 和其他 Chromium 浏览器）

1. 在网站点击“下载最新版插件 ZIP”，保存 `vrc-ext-haima-v1.6.20.zip`。
2. **先解压**到一个固定文件夹，安装后也要保留它。选择的文件夹内应直接包含 `manifest.json`，不能直接选择 ZIP。
3. 打开扩展管理页：Chrome 输入 `chrome://extensions`；Edge 输入 `edge://extensions`。这类地址请粘贴到地址栏，网页不能直接打开浏览器内部页面。
4. 开启“开发者模式”。
5. 点击“加载已解压的扩展程序”（部分浏览器称“加载解压缩的扩展”），选择第 2 步中包含 `manifest.json` 的文件夹。
6. 在扩展菜单中固定“VRC 解析助手”。需要登录功能时，打开插件设置页，使用本站账号登录。网页登录与插件登录各自独立。

其他支持 Chromium 扩展的桌面浏览器，可从浏览器菜单进入“扩展程序 / 管理扩展程序”，其余步骤相同。

## 网站与插件的平台账号分别管理

- 网站无需插件：网站“平台账号管理”中的 B站、网易云可扫码，QQ音乐、酷狗暂用高级导入，Cookie 保存在服务器。
- 插件本机线路：在插件设置的“插件本地账号”中登录或导入，Cookie 只留在本机，通过你的网络取链。
- 两边不会同步或互相借用 Cookie；一边解绑不会退出另一边。插件平台线路沿用已开放的站内能力，不读取网站个人账号。
- 本次服务器账号库增加生命周期隔离，原网站绑定需要重新扫码或导入一次；旧插件本地账号不自动迁入网站。

## 更新下载版

1. 关闭旧版正在打开的插件设置页。
2. 下载并解压新版，将新版文件替换到**原安装文件夹**中。
3. 返回扩展管理页，在“VRC 解析助手”卡片上点击“重新加载”。
4. 刷新需要使用插件的网页；如果提示登录失效，在插件设置页重新登录。

商城版和下载版的更新方式不同。切换到下载版后，如出现两个同名插件，先停用暂时不用的那个，避免重复弹出解析卡片。

## 常见情况

- **提示找不到清单文件**：请选中直接包含 `manifest.json` 的那一层文件夹。
- **插件加载后不出现**：到扩展菜单中固定插件图标，并刷新当前网页。
- **网站已登录，插件仍要求登录**：打开插件设置页，用本站账号单独登录。
- **移动、删除文件夹后插件失效**：下载版依赖原文件夹；恢复文件夹或重新加载。

官方操作说明：[Chrome 加载解压扩展](https://developer.chrome.com/docs/extensions/get-started/tutorial/hello-world#load-unpacked)、[Edge 本地安装扩展](https://learn.microsoft.com/en-us/microsoft-edge/extensions/getting-started/extension-sideloading)。