icampus-learning-assistant/2倍速脚本使用说明.md

学员中心 · 2倍速学习助手使用说明

适用版本：1.4.0。浏览器设置核对日期：2026-10-06。

仓库首页 · 脚本文件 · 更新记录

1. 安装篡改猴和配置Chrome

本项目用于桌面Chrome的 学员中心课程页，匹配 https://icampus.yunyinsh.com/course/*。其他学习平台、手机浏览器和其他脚本管理器未做兼容验证。

篡改猴（Tampermonkey／油猴）是运行脚本的浏览器扩展。先安装扩展，再导入本仓库脚本；普通用户无需Node.js或Git。

1. 用Chrome普通窗口访问 官方商店页面，点击“添加至Chrome”。也可通过 篡改猴官网 的正式版商店入口安装。
2. 点击工具栏拼图图标，找到Tampermonkey，可固定到工具栏方便使用。
3. 地址栏输入 chrome://extensions，进入Tampermonkey“详情”，按下表配置。
4. 已安装用户无需重装；检查开关后继续安装脚本。

项目	设置
扩展启用	Tampermonkey扩展开关保持开启
Chrome 138及以上	详情页开启“允许用户脚本 / Allow User Scripts”
Chrome 138以前的适用版本	扩展列表右上角开启“开发者模式”
网站访问权限	允许 https://icampus.yunyinsh.com 自动运行，可选择“在特定网站上”添加
在无痕模式下启用	需要无痕使用时开启“Allow in incognito”
篡改猴开关	篡改猴总开关、已安装的本脚本均启用
允许访问文件网址	本脚本的文件导入、复制安装和HTTPS页面运行不需要

Chrome版本可在 chrome://settings/help 查看。新版Chrome不要仅打开开发者模式便认为权限已经齐全，应检查“允许用户脚本”。版本对应规则见 Chrome用户脚本文档、篡改猴Q209。

Chrome不能在无痕窗口内安装扩展，应先普通窗口安装再允许无痕。网站权限应自动允许课程站点，而不是每次点击扩展才临时授权。相关设置见 Chrome扩展管理帮助。

修改权限后刷新课程页。本脚本需要在页面加载时观察课程数据；保持原始脚本匹配规则、运行时机及沙盒设置，不需要额外修改高级选项。浏览器内部地址需复制到地址栏，通常不能从仓库直接点击打开。

2. 下载文件导入

1. 在仓库打开 icampus-study-helper.user.js。
2. 点击文件页面的“下载”，或打开“原始文件 / Raw”后保存。文件应名为 icampus-study-helper.user.js，不能是仓库HTML网页或误存的 .txt。下载整个仓库压缩包的用户先解压。
3. 点击篡改猴图标 →“管理面板 / Dashboard”→“实用工具 / Utilities”。
4. 找到“从文件导入 / Import from file”文件选择按钮，选中该 .user.js。
5. 在安装／导入页面核对名称“学员中心 · 2倍速学习助手”和版本 1.4.0，按提示确认安装或更新。仅选择文件不等于安装完成。
6. 回到“已安装脚本”，确认开关开启。
7. 刷新课程页，确认左下角版本为 1.4.0。

篡改猴导入入口见 官方导入导出说明。界面文字可能因版本不同而变化；若该入口不接受 .user.js，直接用下一节复制方式，无需将脚本改成JSON。

点击仓库文件后只显示源码也是正常的，可继续下载或复制。不要将SSH仓库地址粘贴到“从URL安装”中。

3. 复制代码安装

1. 打开脚本的“原始文件 / Raw”，或用文本编辑器打开下载的 .user.js。
2. 全选复制全部代码，包括最前面的 // ==UserScript== 配置块和文件末尾。
3. 篡改猴图标 →“添加新脚本 / Create a new script”。
4. 点击脚本编辑区域，Ctrl+A全选并删除默认模板，再粘贴全部代码。
5. 按 Ctrl+S，或“文件 → 保存”。确认名称、版本和启用开关。
6. 刷新课程页，检查助手面板版本。

不要复制行号、网页其他内容或Markdown代码围栏；不要粘贴到地址栏、浏览器控制台或URL导入框。

更新旧版本： 在管理面板点击原脚本进入编辑器，替换全部代码并保存即可，不必新建。文件导入时选择更新原脚本，保留原始名称与namespace，避免两份同时运行。

4. 开始、继续和停止

1. 停用旧诊断脚本、倍速实验脚本和重复助手。
2. 登录网站，打开“我的课程”，展开要学习的分组，清除不需要的筛选，确认目标课程已显示。
3. 选择“按列表顺序继续课程”，或进入具体课程选择“仅当前课程”。
4. 默认保留自动测验、后台播放和受限时尝试静音三个勾选，点击“开始”。
5. 需要停止时点击“人工取消”，之后刷新不会自动开始。

控件／状态	含义
按列表顺序继续课程	从当前显示列表首个未完成课程开始；已在课程内时先处理当前课程
仅当前课程	处理当前课程后等待，不继续其他课程
只做本门测验	先进入课程再点击，只处理该课程测验
自动测验，按平台合格线通过	自动答题、交卷和未合格重试；关闭后未合格测验需手动处理
切标签页继续播放	运行期间保留网站正常后台播放与保存流程
播放受限时尝试静音	有声自动播放被拒绝时尝试一次静音；成功后面板显示“静音”
已启动 · 等待恢复	仍启用，查看提示；普通等待会定期检查或随页面变化接续
人工取消	关闭自动运行并暂停助手控制的视频
运行记录 → 更新记录	显示当前页的近期运行记录

更换运行范围或“只做本门测验”前，先人工取消。启动状态保存在当前标签页会话中，同一页普通刷新和自动恢复刷新都可接续。新标签页、浏览器重启、结束无痕会话不保证保留。手动暂停视频时，助手等待手动播放，不抢占暂停操作。

5. 完成条件与检查范围

换课条件为 学习进度完成，且需要测验的课程已由平台判定合格。有明确学习进度时检查100%；没有该字段才参考平台课程完成标记。合格线由平台判断，脚本不根据分数猜测或写死阈值。

状态	行为
学习100%，测验75%，平台已合格	返回列表核对后下一课程
学习100%，测验75%，平台未合格	继续处理测验
学习75%，测验已合格	继续未完成视频
学习100%，不要求测验	返回列表核对后下一课程
页面显示完成但尚无平台确认	等待，不直接切换

视频自然播完且平台确认该资源完成才切换。课程完成后返回列表读取新状态，核对后继续；仅当前课程模式不换课。

自动队列基于当前列表已加载、已显示的课程卡片，按页面顺序处理。不会自动展开所有分组、翻页或扫描账号全部课程。显示范围完成后仍保持启用并等待；不能将提示理解为账号全部课程已检查。

6. 整体进度和预计完成时间

面板显示：

• 整体完成： 已完成课程数÷统计范围课程数。完成必须同时满足学习和测验要求。
• 平均学习进度： 各课程平台学习百分比的算术平均，按门数而非时长加权，与整体完成分开。
• 待合格测验： 需要测验但平台还未判定合格的课程数。
• 预计剩余： 尚需播放的时长按2倍速换算，再预留测验和切换时间。
• 预计完成： 当前时间加预计剩余，使用浏览器本地日期与时间；停止／等待时显示“等待开始或恢复后计算”。

统计范围

默认统计本页面已经收到的课程列表数据，显示“已读取课程列表”。仅当前课程模式只统计当前课；只做测验模式不预测结束时间。直接进入课程、尚未读取列表时显示“未读取列表，暂统计当前课程”，不要把这个百分比当成账号总体。

列表数据中有但页面未展开的课程可能计入统计，却不在自动队列可点击的范围。请展开目标分组以对应运行范围。刷新后需重新读取列表与时长样本；要看整体，先打开“我的课程”再继续运行。

估算方法和局限

已读到详情的课程使用各视频时长减去平台返回的已保存位置；完成资源记为零。未读取时长的课程按已知完整视频课程的平均时长，结合其学习百分比粗估，面板明确标记“粗估”和涉及门数。

时间预算另包含每门未合格测验 2分钟、每门未完成课程切换 15秒。这些是规划预留，不是平台保证。反复重考、网络加载、后台节流、等待人工或保存确认会延后；不同课程长短差异大时粗估误差也会变大。

没有可用时长样本时显示暂无法估算；已知存在未完成的非视频资源时提示需人工处理。暂停时不提供继续倒数的完成时刻。统计范围均完成时显示剩余0分钟。所有统计和估算仅用于展示，不参与平台完成判定或自动跳课。

7. 自动播放卡住，刷新是否有用

本次实际无痕页面提示“浏览器阻止自动播放，请手动点击网页‘点击播放’”。日志中反复出现播放拒绝；通过网页真实播放按钮恢复后，已观察到2倍速和平台保存确认。

刷新可以重新加载页面并接续已启动状态，但不能保证解除浏览器的自动播放限制。 页面加载异常、未捕获课程详情时可以刷新；明确提示自动播放受限时，优先点击网页“点击播放”。

1.4.0默认开启“播放受限时尝试静音”：有声播放被拒绝后尝试一次静音播放，使用Chrome正常允许的播放方式；不修改浏览器安全设置。成功后可在播放器恢复声音；不需要此行为时取消勾选。若静音也被拒绝，则保持启用、等待点击，不再仅靠定时器反复重试或自动刷新。浏览器机制见 Chrome自动播放说明。

不要在正在手动填写尚未保存答案时直接刷新。普通刷新不会清除本地答案记忆和启动意图，但页面尚未提交的输入可能丢失。

8. 自动测验与答案记忆

当前流程可能先处理本门未合格测验，再继续视频。支持每题最多8个不同文字选项的单选、判断、多选。

自动选择 → 点击当前可见“交卷” → 确认“确定交卷” → 等待评分。未合格时使用网页“重新测验”入口，根据逐题反馈保留正确答案、排除错误选项或组合，继续重试。没有脚本自设次数上限；已合格不再追求100分。

按题型、题干和选项文字匹配，选项字母换序不会直接照搬字母。仅平台明确反馈该题正确，或本次提交整卷确实100%正确时记为正确；75分合格的试卷不会整卷误记全对。内置第一门课程已验证的7道题答案，其余从反馈中逐步积累。

图片、材料、填空、问答、重复或不能识别的选项需人工处理。平台次数耗尽、入口不可用、缺少必要反馈或无新答案可试时等待，不反复提交相同答案，也不保证每种试卷自动通过。

9. 后台和无痕

先开始，再切其他标签页或将浏览器放后台，保持后台开关勾选。电脑保持唤醒、联网，浏览器和课程页保持打开。

Chrome经常回收课程页时，可在“设置 → 性能 → 始终保持活跃的网站”添加 icampus.yunyinsh.com。笔记本节能也可能减少后台活动，可根据电源情况调整。参考 Chrome性能帮助。

后台模式保留网站原有的正常播放和进度保存定时器，不改写真实页面可见状态、视频位置，不伪造或重放进度请求。关闭后台模式、停止助手或离开页面后恢复正常处理。后台等待和运行锁窗口至少180秒，回前台后给保存20秒恢复时间；仍无保存确认会等待处理。休眠、关闭浏览器、冻结／丢弃标签页、断网仍无法保证继续。

无痕使用需允许扩展无痕运行并刷新实际课程页。普通和无痕站点数据隔离，答案记忆、开关及状态不自动共用；所有无痕窗口关闭后站点数据通常清除。运行锁仅在同一站点存储环境内生效，不跨普通／无痕或不同浏览器，同账号请只运行一个页面。

10. 更新、停用和数据

仓库推送不会自动更新已安装代码，当前未配置仓库自动更新地址。重新导入最新脚本或在原编辑器替换并保存，然后刷新普通／无痕课程页检查面板版本。原本已启动的页刷新会接续，想先检查设置可提前人工取消。

停用／卸载前先人工取消，再在篡改猴关闭或删除脚本并刷新课程页，才能卸掉已加载代码。

保存位置	内容
网站本地存储	答案记忆、最近提交快照、后台和静音回退偏好、标签页运行锁
当前标签页会话存储	启用状态、运行范围和刷新恢复记录
当前页内存	运行记录、已读取课程列表和时长样本

本脚本不额外上传日志或账户信息，不保存登录凭据或视频链接；网站自身的请求照常运行。篡改猴导出脚本不包含本助手保存在课程网站中的答案记忆。更新脚本不会主动清空记忆；清理网站数据则可能清除答案和网站登录状态。

11. 常见问题

现象	处理
无助手面板	检查网址、扩展／脚本开关、用户脚本权限和网站权限；无痕另查无痕权限，最后刷新
无痕不生效	检查扩展无痕权限、实际使用的Chrome用户配置，再刷新无痕页
显示旧版本	确认保存／导入完成，停用重复脚本，刷新当前实际使用的课程页
已启动按钮不能再点	正常；查看下方运行／等待原因。换模式先人工取消
切换视频不播	等待新媒体就绪；自动播放拒绝按上一节处理；检查加载、网络和运行记录
答完不交卷	确认最新版本、是否有未答或不支持的题；1.3.0起已修正电脑侧栏交卷按钮识别
学习100%仍不换课	检查是否已合格、是否仅当前课程、列表是否返回新确认
75%已合格仍重考	确认当前页至少1.3.1，停用旧版并刷新
整体只显示1门	尚未读取课程列表或选择了仅当前课程；先打开“我的课程”
预计时间暂不可用	等待视频时长数据；暂停、仅测验或需人工处理时不会显示可靠完成时刻
估计时间不断变化	数据逐步补齐、测验重试、停顿或平台保存更新会改变估计
当前显示全完成但其他分组还有课	展开目标分组并加载列表，必要时刷新获取新状态
另一个学习页运行	在另一个页面人工取消或关闭，等待运行锁释放
课程重名	手动进入目标课程，选仅当前课程
登录、前置限制、无保存确认	按平台提示处理后刷新，同一标签页可接续
视频没有声音	查看是否标记静音，可在播放器恢复声音或关闭静音回退选项

反馈时展开“运行记录”并点“更新记录”，提供脚本版本、普通／无痕模式、运行范围、面板文字和必要记录，不要附凭据或完整敏感抓包。

12. 验证与恢复边界

81项本地行为测试：16播放／进度、13测验、13媒体恢复、12后台、10持续运行／完成条件、17统计／自动播放回退。覆盖低于100分但已合格换课、刷新接续、缺失时长、暂停预测、静音成功和仍被拒绝等情况。

现场已观察到网页原生2倍速、平台保存响应，以及本次点击播放后恢复。新版整体统计、估算和静音回退经过模拟测试，尚未完成所有真实课程和长时间后台端到端验证，不能保证最终学分或全部课程结构兼容。

前台视频加载90秒未就绪、启动20秒未推进或播放停滞60秒时，会尝试一次刷新恢复，每段视频在一次运行内共享该额度。临时播放中断有界重试；播放权限拒绝不进入刷新循环。前台视频结束25秒仍无平台完成确认会等待，后台窗口更长。这些恢复不会伪造完成状态。