refactor: 拆分 src/ 模块并接入 esbuild 构建

把单文件脚本拆成 src/ 下 13 个 ES 模块,用 esbuild 打回同名 .user.js,
产物文件名不变,dev/ 热加载链路无需改动。

- build.mjs:esbuild 打包(--watch / --minify),版本号只从 package.json
  读取,同时替换 meta.js 的 @version 与 config.js 的 VERSION
- 统一版本号来源,消除 package.json / meta.js / config.js 三处手写
- 补回 'use strict'(esbuild IIFE 默认不带,属真实行为回归)
- 清理重复实现:pauseAllMedia、listData、shortQuery、drain、clearPending、
  cbAuto 模块级引用、共用 cssText
- 去掉搬代码时残留的 IIFE 缩进、死字段、二次兜底默认值、过期注释
- README / dev/README 同步构建流程与目录结构

行为无变化,仅 src/config.js 的 CFG 改成构建期注入版本号。
This commit is contained in:
void committed 2026-10-24 22:45:27 +08:00
1 parent 8200bfa0c5
commit 8193326b70
19 files changed
+4884 -1671

No files matched your search

+48
View File
@@ -0,0 +1,48 @@
// ==UserScript==
// @name 云学堂助手
// @namespace yun-xue-tang-assistant.local
// @version __YT_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 时判定整门课
* 完成,自动回列表并进入下一门。
* - 进入课程(批量或手动打开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起
* 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。
* 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。
* - 试跑稳定后,把 config.js 里的 CFG.maxCourses 改成 0 即可不限门数(会持续很久)。
* - 平台若有防挂机检测/答题环节,脚本会跳过该课程并在面板提示。
* 防挂机验证(每 10 分钟一次、120 秒限时)会自动点「继续学习」;
* 答题/考试、滑块拼图类验证仍会跳过该课程。
* - 验证码/滑块需要手动完成,脚本不会绕过。
* - 课程/单位如有相关规定,请自行确认风险。
*
* 短课程优先:
* - 面板勾选「优先短课程(时长正序)」后,批量刷课会先读课程列表接口里的总时长,
* 按「未学完课程的总时长从短到长」选课,而不是按列表顺序。接口不可用时会自动
* 退回为「当前页按时长正序」,再不行就按原来的列表顺序,不会卡住批量任务。
*
* 开发热加载:
* - 本文件可直接被 dev/dev-loader.user.js 热注入:脚本暴露 window.__ytDispose(),
* 加载器在注入新版本前会先调用它清理定时器、监听器与面板,因此保存文件后
* 约 1 秒内即可生效,无需手动刷新页面。
*/