安装指南
本页面将引导您完成 XMOJ-Script 的完整安装流程。
快速安装（3 步）
- 安装 Tampermonkey 浏览器扩展
- 在浏览器扩展管理页面开启开发者模式（Chrome / Edge 必须）
- 点击 安装 XMOJ-Script → 在弹出框中点击「安装」
第一步：安装 Tampermonkey
XMOJ-Script 是一个 用户脚本（Userscript），需要借助 Tampermonkey 等用户脚本管理器来运行。
请根据您使用的浏览器，点击对应链接安装 Tampermonkey：
| 浏览器 | 安装链接 | 备注 |
|---|---|---|
| Google Chrome | Chrome 应用商店 | 推荐 |
| Microsoft Edge | Edge 加载项商店 | 推荐 |
| Mozilla Firefox | Firefox 附加组件 | 无需开发者模式 |
| Safari | App Store | 需额外配置 |
| Opera | Opera 插件商店 | — |
第二步：开启浏览器开发者模式
重要：Chrome / Edge 必须完成此步骤
由于 Google Chrome Manifest V3 政策，Tampermonkey 必须在开发者模式下才能完整运行用户脚本。跳过此步骤会导致脚本无法工作。
Google Chrome
地址栏输入
chrome://extensions并按 Enter找到页面右上角的「开发者模式」（Developer mode）开关
将其打开（开关变蓝色）
刷新页面后生效
Microsoft Edge
地址栏输入
edge://extensions并按 Enter找到页面左下角的「开发人员模式」开关
将其打开
Mozilla Firefox
Firefox 无需开启开发者模式，安装 Tampermonkey 后即可直接跳到第三步。
Safari（macOS）
- 打开 Safari →「偏好设置」→「高级」选项卡
- 勾选「在菜单栏中显示"开发"菜单」
- 菜单栏出现「开发」菜单后，点击「允许未签名的扩展」
- 在 Safari 扩展列表中启用 Tampermonkey
如何确认开发者模式已生效？
点击浏览器右上角 Tampermonkey 图标 → 控制面板。若页面正常打开且不显示「扩展无法完整运行」等警告横幅，说明开发者模式已正确配置。
第三步：安装 XMOJ-Script
点击上方按钮后，Tampermonkey 将弹出安装确认页面，确认信息无误后点击「安装」即可。
备用安装渠道
- ScriptCat 镜像站：国内访问更快
- GitHub Releases：手动下载
XMOJ.user.js后拖入 Tampermonkey 控制面板
第四步：验证安装
- 打开 www.xmoj.tech
- 若页面样式明显变化（导航栏更新、Bootstrap 风格按钮），说明脚本已运行
- 登录后点击右上角用户名，若菜单中出现「插件设置」，则安装完成 ✅
更新脚本
XMOJ-Script 支持自动更新。Tampermonkey 会定期检查最新版并静默更新。
手动更新步骤：
- 点击 Tampermonkey 图标 →「控制面板」
- 找到 XMOJ-Script 条目，点击右侧「更新」按钮（或「检查更新」）
常见问题
安装后访问 xmoj.tech 没有变化？
按以下顺序逐项排查：
| 检查项 | 说明 |
|---|---|
| Tampermonkey 是否已启用 | 扩展图标不应显示灰色或带叉 |
| XMOJ-Script 脚本是否已启用 | 控制面板中脚本开关应为打开状态 |
| 开发者模式是否已开启 | Chrome / Edge 必须，见第二步 |
| 是否访问了正确的域名 | 确认是 xmoj.tech 而非其他域名 |
| 尝试硬刷新 | Ctrl+Shift+R（macOS：⌘+Shift+R） |
提示「此扩展程序未经 Chrome 网上应用店验证」？
这是 Chrome 在启用开发者模式后对所有通过非商店途径安装的扩展显示的标准安全提示，属于正常现象。Tampermonkey 本身已通过 Chrome 商店审核，.user.js 是用户脚本的标准格式，不影响安全性。
安装页面显示乱码或加载失败？
可能是网络问题导致 GitHub 资源访问缓慢。请：
- 尝试通过 ScriptCat 镜像 安装
- 或稍后重试主安装链接
如何完全卸载脚本？
- 打开 Tampermonkey 控制面板
- 找到 XMOJ-Script 条目
- 点击右侧删除（垃圾桶）图标
- 确认删除即可，不影响浏览器本身