个人试卷导出助手
安装指南 · 当前版本 1.7.1

安装：两条路径，同一个脚本文件

iPad 和安卓装法不一样，但用的是同一份 个人试卷导出助手.user.js。按你手上的设备选一条，照着顺序做，最后一步都是「打开一份试卷页，看右下角有没有出现浮球」。

我是 iPad 我是安卓

01iPad：Safari + Userscripts

iPad 上 Safari 不能直接跑用户脚本，需要一个负责加载脚本的扩展。这里用 Userscripts（App Store 免费）。

  1. 装扩展在 App Store 里搜索并安装 Userscripts。装好后先别急着打开网页，下一步才是关键。
  2. 打开扩展权限进入「设置 → Safari → 扩展」，找到 Userscripts，把开关打开，并允许它访问网站。这一步没做，脚本装了也不会执行——这是最常见的一处卡点。
  3. 在 Safari 里启用打开 Safari，点地址栏左侧的扩展图标，选中 Userscripts，进入它的界面。
  4. 给它读写的脚本目录Userscripts 会在「文件」App 里有一个自己的脚本目录。第一次使用时按它的引导设置一次即可，之后所有脚本都放在那里。
  5. 新增脚本在 Userscripts 里点「＋」新建一个脚本。
  6. 粘贴或导入 .user.js把 个人试卷导出助手.user.js 的内容整个粘进去保存；或者先把这个文件存进「文件」App，再从 Userscripts 里导入它。
  7. 确认运行范围脚本头部已经写好了匹配站点（组卷网、菁优网），不需要你改；只要确认脚本是启用状态即可。
  8. 验证在 Safari 里打开一份组卷网或菁优网的试卷页，页面右下角应该出现一个圆形浮球。出现了就算装好了。
下载时如果 Safari 直接把代码当文本打开：用分享菜单里的「存储到文件」，把它存进「文件」App，得到的是一个真实的 .user.js 文件，再从 Userscripts 里导入这个文件，比手工复制粘贴更不容易出错。
以后升级：拿新版本的 .user.js，用同样的方式导入覆盖旧脚本即可，不需要卸载扩展，也不用改动其它脚本。

02安卓：支持用户脚本的浏览器

安卓上没有统一的「用户脚本扩展」体系，所以要选一个能跑脚本的浏览器，再配一个脚本管理器。

  1. 选一个支持用户脚本的浏览器用主流里带扩展能力的浏览器（例如 Firefox 安卓版可以直接装扩展；也有支持 Chrome 扩展的第三方浏览器可选）。
  2. 装脚本管理器在浏览器里安装一个脚本管理器扩展（例如 Tampermonkey、Violentmonkey 这类），并确认它是启用状态。
  3. 安装脚本打开 个人试卷导出助手.user.js 的链接（本站「下载」区的按钮就指向它）。因为脚本管理器已经装好，它会接管这个文件并弹出安装页，确认安装即可。
  4. 检查启用状态回到脚本管理器的列表，确认「个人试卷导出助手」在里面，并且没有被停用。
  5. 验证打开一份组卷网或菁优网的试卷页，页面右下角出现圆形浮球即安装成功。
如果打开脚本链接只看到一堆代码：说明脚本管理器没有接管这个链接。要么先装好脚本管理器再重开链接，要么在管理器里新建脚本，把 .user.js 的内容整个粘贴进去保存。
提醒一句：安卓上的脚本管理器需要能访问站点，才会在试卷页注入面板。若浏览器开了「无痕模式」或对站点做了限制，脚本可能不会运行。

03常见卡点与排查

装完没反应，绝大多数是下面这几类。按顺序对号入座。

Userscripts 装了，但页面没反应

逐条确认：

  1. 「设置 → Safari → 扩展」里 Userscripts 的开关是否打开、是否允许访问网站。
  2. 打开试卷页时，地址栏左侧的扩展菜单里是否允许 Userscripts 在当前站点运行（iOS 可以按站点单独设置权限）。
  3. 脚本是否处于启用状态，内容是否完整保存（粘贴时被截断会导致整个脚本不执行）。
  4. 把页面彻底关闭再重新打开一次，扩展通常需要重新加载页面才会注入。
之前在别的站长什么样，现在又不行了

常见于系统更新、Safari 重启或扩展被系统回收之后——扩展的开关会被重置。回到「设置 → Safari → 扩展」重新打开 Userscripts，再刷新页面即可。这属于系统行为，不是脚本的问题。

脚本装了，页面却不显示浮球

先确认三件事：

  1. 当前页面是不是组卷网或菁优网。脚本只在匹配的站点上运行，其它网站不会出现浮球。
  2. 脚本在该站点是否被允许运行（扩展权限可能是按站点授予的）。
  3. 脚本管理器里这一条是不是启用状态，有没有被别的同名脚本挡住。

三条都对但仍旧没有浮球，那就是脚本在这个页面上没跑起来，属于需要反馈的问题：把页面地址和浏览器的版本一起记下来。

浮球在，但点导出没反应

先看面板上的状态行，它会写明当前站点（组卷网 / 菁优网 / 未知站点）和风控提示：

  1. 显示「需要验证码」或「登录已失效」：这是站点在拦。手动过验证码或重新登录后再点一次。
  2. 显示「未知站点」：当前页面不是受支持的站点，脚本不会尝试导出。
  3. 一直停在处理中：通常是网络或云端通道不通，稍等或换一份卷子再试；状态栏会写明这一次实际走的是哪条通道。
浮球挡住了页面上的按钮

它是设计成可拖动的：按住浮球拖到不碍事的位置，面板会跟着走，并按浮球所在的位置自动选择向左或向上展开。把设备从竖屏转成横屏后，位置会自动重算，不会跑到屏幕外。

浮球被 Safari 底部工具栏遮住

拖动浮球离开底部工具栏区域即可。滚动页面时工具栏可能收合或展开，浮球是固定在视口里的元素，所以最稳妥的做法是把它拖到屏幕中间偏右的位置。

想把脚本换到另一台设备

不用重新找别的版本：同一个 .user.js 文件在 iPad 和安卓上都能用，按上面两条路径各自装一次即可。

怎么升级到新版本

只要替换脚本内容：iPad 上在 Userscripts 里把新版本的 .user.js 重新导入覆盖，安卓上在脚本管理器里重新安装一次。文件名一直不变，所以覆盖安装不会影响其它脚本，也没有需要迁移的配置。

浮球与面板的位置关系 竖屏 面板向左展开 （浮球在右半边） 浮 浮球拖到底部时 面板改向上展开，不出屏 浮 面板始终贴着浮球，边距收在视口内。

位置是自动算的：你只管拖到一个顺手的地方。

04装完自检三条

1打开一份组卷网或菁优网的试卷页，右下角出现圆形浮球。
2点开浮球，面板上标出「当前：组卷网」或「当前：菁优网」，而不是「未知站点」。
3点一次「导出」，状态栏写出这一次走的是哪条通道，并最终拿到文件。

第三条没通过的话，回到上面的「浮球在，但点导出没反应」对照状态行提示。