# 学员中心 · 2倍速学习助手

适用于 `https://icampus.yunyinsh.com/course/` 的篡改猴脚本。当前版本 **1.3.0**。

## 安装

下载 `icampus-study-helper.user.js`，在篡改猴管理面板的“实用工具 → 从文件导入”中安装或更新原脚本。刷新课程页，确认面板版本为1.3.0，点击左下角“开始”。不要同时启用旧诊断脚本。

默认按课程列表顺序处理，支持仅当前课程，以及只做本门测验。首次安装等待点击开始；开始后保持启用，刷新同一标签页也会接续，只有“人工取消”才清除运行状态。

## 1.3.0 自动交卷与持续运行

电脑端的“交卷”在侧栏，手机端的底部交卷按钮在电脑上隐藏。旧版只查找底部按钮，导致已答完却无法提交。新版选择当前实际可见的交卷按钮，并自动确认交卷。

测验必须达到 **100%** 才允许继续本门视频或下一课程。低于100%时，根据逐题反馈保存正确答案、排除错误答案并重新测验；不设脚本自己的重考次数上限。当前现场试卷显示“答题次数：不限”。若入口暂不可用，保留已启动状态等待，不跳过该测验。

“运行中”和“等待恢复”都属于已启动。网络异常、等待评分、当前范围完成或需要人工处理时保持启用；自动定期检查或在页面变化后接续。需要停止时点“人工取消”。手动暂停视频后会等待用户恢复视频，不主动抢占暂停操作。

## 功能

- 2倍速正常播放，平台确认完成后切换视频。
- 单选、判断、多选自动作答、交卷，根据平台逐题反馈保存答案并重试。
- 保留正确答案，排除错误选项或组合；按题干和选项文字匹配，避免选项字母换序导致误答。
- 持续启用、等待恢复、异常提示、单标签页运行锁和本机答案记忆。
- 默认开启“切标签页继续播放”，助手运行时保留网站原有的后台进度保存定时器。

## 1.2.0 后台播放

安装后刷新课程页，点击“开始”，保持“切标签页继续播放”勾选，然后切换其他标签页或把浏览器放到后台。开关偏好会保存在本机。

已加载的课程组件在页面隐藏时主动停止心跳。后台模式在课程页的助手运行期间拦截这个隐藏事件，保留正常播放和网页原本的心跳；不会改写 `document.visibilityState`、播放位置或服务器请求。回到前台仍执行网站原来的恢复逻辑。暂停助手、关闭后台模式或离开页面时恢复正常处理。

考虑到 Chrome 可能降低后台定时器频率，后台等待窗口及标签页运行锁延长至至少180秒，返回前台后给保存请求20秒恢复时间。连续180秒没有保存确认仍会暂停，后台切换视频和答题可能比前台慢。

电脑休眠、浏览器关闭、标签页冻结/丢弃、断网或媒体自动播放被浏览器拒绝，无法靠网页脚本保证运行。若 Chrome 经常回收该页，可在性能设置中将该站点加入“始终保持活跃的网站”；脚本不会自动修改浏览器设置。

## 1.1.1 修复

修复视频切换后不继续播放的问题：为每段视频单独计时，等待新媒体数据就绪和网站恢复播放位置；播放器重建时重新绑定；临时 `AbortError` 最多重试三次。加载卡住时尝试网页播放按钮，90秒仍未就绪则最多刷新恢复一次。播放停滞或启动超时也共享这一次恢复额度。

自动恢复会临时保存当前课程与恢复额度，刷新后接续。1.3.0起，运行开关另外保存在标签页会话中，因此普通刷新也接续；人工取消后刷新不会启动。

浏览器明确拒绝自动播放时提示手动点击播放，不会无限刷新。正常播放后的手动暂停仍会停止助手。

## 验证

运行 `npm test`，无需安装依赖。当前61项本地行为测试覆盖播放、进度保存、测验循环、媒体加载恢复、后台模式、严格100%条件和刷新接续。测验模拟包含隐藏的手机端按钮与可见电脑端按钮，验证自动选择、交卷、确认、重试直至100%。

现场已确认原问题出现时第二段视频处于 `readyState=0` 且旧版已超时停止；修复通过模拟播放器与页面回归。尚未安装修复版验证真实课程完整连播。

后台模式测试模拟了网页真实的可见性处理和心跳响应，验证拦截、恢复、暂停、后台超时和延迟跳转等情况。尚未在用户浏览器中完成新版的长时间真实后台运行验证。

## 限制

计入进度、课程完成和重试能力均以平台返回结果为准。重考入口暂不可用时会等待；即使平台显示“合格”，不足100%仍不会放行。图片、材料、填空和问答题需要人工处理。请保持电脑唤醒。

更多说明见 [使用说明](2倍速脚本使用说明.md)。