Files
yun-xue-tang-assistant/src/meta.js
T
voidandClaude Sonnet 4.6 18c5e5a3be feat: 每日积分改以平台积分台账为准
- 新增 points-platform:读取 /ssp/#/my/point 背后的 rule/org 与 point/history/self
- 整门课完成不再直接 +3,等平台真的入账后按 nameType 归类计数
- 平台今日学习积分达到上限,或连续 3 门确有学习内容却未入账时收尾
- 接口不可用(未登录/跨域/网络)时退回本地计数,面板额外显示平台台账
- 新增离线回归测试与只读探测脚本

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-02 20:43:40 +08:00

67 lines
4.9 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// ==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 时判定整门课
* 完成,自动回列表并进入下一门。
* - 进入课程(列表刷课或自己点开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起
* 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。
* 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。
* - 不按门数设上限:每日积分模式下整门课完成计 1 次,积分目标完成或没有可学内容时收尾。
* - 脚本不跳过普通课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到
* 需要人工完成的滑块/拼图验证、答题/测验章节、长时间无计时进展)就退避重试:
* 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 秒内即可生效,无需手动刷新页面。
*/