Skip to content

Repository files navigation

学习通自动刷课助手

一款用于超星学习通平台的浏览器自动刷课插件(Manifest V3)。

CI

功能特性

  • 自动播放视频:检测到视频后自动播放;被拦截时降级静音播放,并尝试点击播放按钮
  • 倍速调节:0.5x - 4x,播放器改回倍速时自动纠正
  • 静音播放:默认开启,提高自动播放成功率
  • 自动答题:视频弹窗题随机作答并提交(仅用于跳过弹窗)
  • 防挂机提示:自动点击“继续学习 / 我知道了”
  • 跳过章节测验:测验步骤可自动进入下一节
  • 测验页自动作答:章节测验勾选客观题(单选/多选/判断)并自动交卷;主观题跳过
  • 自动切换章节:优先从课程目录进入下一未完成小节
  • 步骤页签识别:停在“学习目标”时自动切到“视频”
  • 文档阅读:文档类任务点自动滚动
  • 卡顿恢复:进度长时间不动时尝试恢复
  • 状态浮层 / 弹窗:显示当前章节、进度条、最近活动;浮层可暂停/隐藏/收起
  • 浮层可拖拽:位置与收起状态会记住;支持快捷加减倍速
  • 会话统计:时长 / 切章数 / 答题数,可一键重置
  • 剩余进度:显示目录中未完成小节数量
  • 快捷键Alt+Shift+S 开关刷课,Alt+Shift+H 显示浮层
  • 设置导入导出:JSON 备份与恢复
  • 页面轻提示:开始/暂停、学完等关键节点轻量提示
  • 学完自动暂停:目录无未完成小节时自动停止
  • 会话限流:可限制本会话最多切章数 / 最大学习分钟数(按活跃时长)
  • 进度同步:iframe 播放进度实时同步到浮层与弹窗
  • 卡顿恢复:播放卡住时自动分级尝试恢复
  • 目录回绕:切章时会回绕查找更早的未完成小节
  • 人工验证检测:出现刷脸/安全验证时自动暂停并提示手动处理
  • 验证消失提示:验证弹窗关闭后提醒可继续,不自动绕过
  • 浮层快捷操作:下一节、重置会话统计
  • 恢复失败保护:多次卡顿恢复失败后自动暂停,避免空转
  • 相位 badge:暂停原因一眼可见(验/卡/满/完)
  • 弹窗实时同步:课程页自动暂停后弹窗立即更新
  • 切章确认:确认目录切换成功后才计数;失败会提示手动处理
  • 限流进度:设置页实时显示已用切章/活跃分钟
  • 后台提醒:页面进入后台或扩展更新时给出可读提示
  • 选项摘要:折叠区显示当前开启能力;倍速过高有风险提示
  • 恢复默认:一键还原设置;浮层双击标题可复位位置
  • 图标 badge:运行中 ON,停止
  • 设置即时生效:修改后立即同步,无需保存、无需刷新
  • 稳健运行:MutationObserver 防抖、状态上报节流、扩展重载后自动停表

安装步骤

Chrome / Edge

  1. 下载本项目到本地
  2. 打开 chrome://extensions/(Edge:edge://extensions/
  3. 开启“开发者模式”
  4. 点击“加载已解压的扩展程序”
  5. 选择本项目文件夹

Firefox(115+)

  1. 打开 about:debugging#/runtime/this-firefox
  2. 点击“临时加载附加组件”
  3. 选择 manifest.json

使用方法

  1. 安装后打开学习通课程播放页
  2. 插件自动工作;也可点图标调整设置
  3. 右下角浮层可查看章节/进度,并暂停或隐藏
  4. 设置修改后立即生效

配置选项

选项 说明 默认
开启自动刷课 总开关
自动答题 弹窗题随机作答
静音播放 提高自动播放成功率
跳过章节测验 测验页自动下一节
章节测验自动作答 勾选客观题并自动交卷;主观题跳过
自动下一节 视频/任务完成后继续
关闭防挂机提示 自动点继续学习
显示页面浮层 右下角状态面板
学完自动暂停 目录学完后自动停止
本会话最多切章 达到后自动暂停;0 不限制 0
本会话最多分钟 达到后自动暂停;0 不限制 0
播放倍速 0.5x - 4x 1.5x

快捷键

快捷键 作用
Alt+Shift+S 切换自动刷课开关
Alt+Shift+H 显示并展开页面浮层

可在浏览器扩展管理页中自定义快捷键。

注意事项

  1. 倍速过高可能被判定学时无效,建议 1.5x - 2x
  2. 自动答题为随机选择;重要题请手动作答
  3. 若浏览器禁止自动播放,可先手动点一次播放
  4. 跳过测验不会替你完成得分;“章节测验自动作答”为随机勾选,答对率无保证,重要测试请手动作答
  5. 不处理人脸识别;遇到刷脸请手动完成
  6. 仅供学习交流,请遵守学校与平台规定

权限说明

权限 用途
storage 在本地浏览器中保存设置、运行状态、会话统计与活动日志
*://*.chaoxing.com/* 学习通主站:在课程播放页注入内容脚本,执行自动学习逻辑
*://*.fx361.com/* 学习通部分课程任务点所在的超星系资源域名,需注入内容脚本
*://*.edu.cn/* 部分学校经教育网域名入口打开学习通,需在这些页面注入脚本并接受 iframe 进度消息

插件不申请其他权限,不依赖任何服务器:所有数据仅保存在本地 chrome.storage 中,不上传。

常见问题(FAQ)

Q:安装后视频不自动播放? 浏览器自动播放策略可能拦截自动播放。插件会自动降级为静音播放并尝试点击播放按钮;若仍不生效,先手动点一次播放。

Q:倍速设置多少合适? 建议 1.5x - 2x。倍速过高可能被平台判定学时无效,插件在倍速大于 2x 时也会给出风险提示。

Q:遇到人脸识别 / 安全验证怎么办? 插件检测到刷脸或安全验证弹窗时会自动暂停并提示手动处理,验证弹窗关闭后会提醒可继续;插件不会绕过任何安全验证。

Q:自动答题能答对吗? 弹窗题与“章节测验自动作答”均为随机选择,答对率无保证;跳过测验也不会替你完成得分。重要题目请手动作答。

Q:切章 / 统计突然不动了? 页面进入后台可能被浏览器限速,建议保持课程页在前台。可查看浮层或图标 badge 的暂停原因(验 / 卡 / 满 / 完 / 停)。

Q:导入设置时提示“不是本插件配置”? 设置导入仅接受本插件导出的 JSON(会校验来源字段);旧版本导出的无来源字段备份仍可兼容导入。

Q:快捷键能改吗? 可以,在浏览器扩展管理页的快捷键设置中自定义。

免责声明

  • 本项目仅供学习与技术交流,请遵守所在学校的规定与超星学习通平台的用户协议。
  • 使用本插件产生的任何直接或间接后果(包括但不限于账号异常、学习记录无效、成绩风险等)由使用者自行承担。
  • 插件所有数据仅保存在本地浏览器中,不收集、不上传任何个人信息,不依赖任何服务器。
  • 插件不绕过人脸识别等平台安全机制,遇到安全验证会暂停并要求手动完成。
  • 若您是平台或学校代表且认为本项目不合适,请提交 Issue,我们将配合处理。

开发与测试

npm install
npm test          # 语法检查 + 单元测试 + Chromium e2e
npm run test:unit # 仅单元测试
npm run check     # 仅语法检查
npm run pack      # 打包为 dist/xxt-auto-<version>.zip
├── manifest.json
├── content.js
├── background.js
├── popup.html / popup.css / popup.js
├── shared/defaults.js
├── shared/dom.js
├── icons/
├── scripts/generate_icons.py
├── scripts/pack.sh
├── CHANGELOG.md
├── tests/
└── README.md

重新生成图标:

pip install pillow && python3 scripts/generate_icons.py

版本

  • 版本:1.15.0
  • 兼容:Chrome、Edge、Firefox 115+

About

学习通自动刷课助手(超星学习通浏览器插件)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages