// ==UserScript== // @name 云学堂助手 // @namespace yun-xue-tang-assistant.local // @version __YUN_XUE_TANG_VERSION__ // @description 云学堂助手:自动登录、从第一节顺序听课、自动切节、处理防挂机验证,并在课程列表页逐门自动刷课(单视频/音频课程也支持,含考试章节的课自动空卷交卷,学完自动进入下一门,可优先短课程) // @match *://kfmic.yunxuetang.cn/* // @match *://*.yunxuetang.cn/* // @grant none // @run-at document-idle // ==/UserScript== /* * 用法: * 1. 浏览器安装 Tampermonkey,新建脚本,粘贴本文件全部内容并保存。 * 2. 打开 https://kfmic.yunxuetang.cn/login.html,在右下角面板填账号/密码, * 点「一键登录并刷课」;登录成功后会自动进入课程列表并开始逐门学习。 * 3. 也可以手动登录后,在列表页点「一键刷课」。 * * 密码保存: * - 只有勾选「记住密码」才会写入本机 localStorage,使用 base64 混淆(不是加密, * 本机其他脚本仍可读取)。公用电脑请不要勾选。 * - 不勾选时密码只用于本次登录,不会落盘。 * * 重要说明: * - 平台按“真实播放时长”计时,快进、倍速都不省时间,脚本只做自动播放和自动切节。 * - 同时支持多课时课程(#/course/play)和单视频/音频/课件播放页(#/video/play 等): * 单视频课程会自动点「开始学习」;平台汇总变成「已完成学习」/100%/x=y 时判定整门课 * 完成,自动回列表并进入下一门。 * - 进入课程(列表刷课或自己点开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起 * 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。 * 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。 * - 不按门数设上限:每日积分模式下按课时类型累计,积分目标完成或没有可学内容时收尾。 * - 脚本不跳过普通课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到 * 需要人工完成的滑块/拼图验证、答题/测验章节、长时间无计时进展)就退避重试: * 30 秒起每次翻倍、最长 5 分钟,同一门课最多重试 CFG.maxCourseRetries 次, * 超过才停下整轮刷课并在面板写明原因,等人工处理后点「一键刷课」接着跑。 * - 选课每次都动态查询:每完成一门课都重新调列表接口,拿平台实时的已完成/未完成状态, * 再按总时长从短到长挑下一门,不使用本地缓存的旧快照。 * - 防挂机验证(每 10 分钟一次、120 秒限时)会自动点「继续学习」。 * - 考试章节支持:自动进入考试、不答题直接交卷(空白交卷)。交卷后平台会把考试节点 * 计入课程进度,含考试章节的课程也能学完。 * 只有本页真的点过「提交考试/确定交卷」,看到的结果页才算一次交卷;平台恢复的旧 * 结果页会先回考试说明页重新进入,避免在结果页和课程页之间空转。 * 同一门课最多交卷 CFG.maxExamTries 次,超过仍没计入进度、或考试页没有可点的 * 「开始考试/提交考试」时,本轮跳过这门课继续下一门(会写明原因),不再反复重进。 * - 验证码/滑块需要手动完成,脚本不会绕过。 * - 课程/单位如有相关规定,请自行确认风险。 * * 短课程优先: * - 面板勾选「优先短课程(时长正序)」后,列表刷课会先读课程列表接口里的总时长, * 按「未学完课程的总时长从短到长」选课,而不是按列表顺序。接口不可用时会自动 * 退回为「当前页按时长正序」,再不行就按原来的列表顺序,不会卡住刷课任务。 * * 无头运行(Linux 服务器 / Windows 无人值守): * - 不装 Tampermonkey 也能跑:仓库里的 runner/headless.mjs 会自己起一个无头 Chromium, * 用 CDP 把本文件注入页面主世界(等价 @grant none),并用固定 profile 持久化登录。 * npm run build && npm run headless:check && npm run headless(凭据读环境变量)。 * Windows 上也可以直接双击 start-headless.cmd。 * - 需要在无头环境里调试本文件时,可以把 window.__yunXueTangAuto 当成调试入口, * 用 runtime.evaluate 直接调 tick()/startBatch()/readSummary() 等,不必开界面。 * * 开发热加载: * - 本文件可直接被 dev/dev-loader.user.js 热注入:脚本暴露 window.__yunXueTangDispose(), * 加载器在注入新版本前会先调用它清理定时器、监听器与面板,因此保存文件后 * 约 1 秒内即可生效,无需手动刷新页面。 */