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:
1 parent
8200bfa0c5
commit
8193326b70
19 files changed
+4884
-1671
No files matched your search
@@ -17,7 +17,7 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;一
|
||||
| 完成即跳课 | 平台汇总变成 `已完成学习`、进度 100% 或 `x/y` 满时判定整门课完成,自动回列表选下一门;不会停在已完成页,也不会把播完的视频从头重播 |
|
||||
| 多类型播放页 | 识别 `#/course/play`、`#/video/play`、`#/audio/play`、`#/ppt/play` 等播放页;单视频课程同样自动点「开始学习」 |
|
||||
| 防挂机验证 | 识别「已触发防挂机验证」弹窗并点「继续学习」;滑块/拼图类验证不绕过,提示人工处理 |
|
||||
| 批量刷课 | 在列表页逐门进入未学完的课程,默认本次最多 10 门,连续失败 5 门自动停止 |
|
||||
| 批量刷课 | 在列表页逐门进入未学完的课程,本次门数与连续失败上限见下方配置表 |
|
||||
| 短课程优先 | 批量模式默认按课程总时长**从短到长**选课(跨页),先完成 1 分钟的课再学 1 小时的课;面板可关闭 |
|
||||
| 失败隔离 | 答题/考试类课程、长时间无计时进展的课程会被跳过并记录原因,不影响后续课程 |
|
||||
| 进度可续 | 运行状态存在 `localStorage`,刷新、热更新后继续上次的队列和页码 |
|
||||
@@ -34,7 +34,7 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;一
|
||||
|
||||
## 配置
|
||||
|
||||
脚本顶部的 `CFG` 是唯一的配置入口:
|
||||
配置项集中在 `src/config.js` 的 `CFG`(改完 `npm run build` 重新打包):
|
||||
|
||||
| 配置项 | 默认 | 作用 |
|
||||
| --- | --- | --- |
|
||||
@@ -59,10 +59,13 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;一
|
||||
|
||||
## 开发热加载
|
||||
|
||||
改完脚本保存即生效,不用复制粘贴、不用刷新页面。详见 [dev/README.md](dev/README.md)。
|
||||
源码已拆分为 `src/` 下的多个模块,构建后合成单文件脚本。改完保存即生效,不用复制粘贴、不用刷新页面。详见 [dev/README.md](dev/README.md)。
|
||||
|
||||
```powershell
|
||||
npm run dev # 等价于 node dev/serve.mjs,默认 127.0.0.1:8899
|
||||
npm install # 首次需要(安装 esbuild)
|
||||
npm run build # 打包 src/ → yun-xue-tang-assistant.user.js
|
||||
npm run build:watch # 监听 src/,保存即自动重新打包
|
||||
npm run dev # 等价于 node dev/serve.mjs,默认 127.0.0.1:8899
|
||||
```
|
||||
|
||||
Windows 下也可以直接双击 [`dev/start-dev.cmd`](dev/start-dev.cmd)。脚本暴露 `window.__ytDispose()`,
|
||||
@@ -71,7 +74,24 @@ Windows 下也可以直接双击 [`dev/start-dev.cmd`](dev/start-dev.cmd)。脚
|
||||
## 目录结构
|
||||
|
||||
```text
|
||||
yun-xue-tang-assistant.user.js 业务脚本本体(唯一需要安装的文件)
|
||||
src/ 业务脚本源码(拆成多个模块,日常改这里)
|
||||
meta.js UserScript 头 + 用法注释
|
||||
config.js CFG / 常量 / VERSION
|
||||
lifecycle.js 定时器·监听器·dispose
|
||||
utils.js DOM 工具
|
||||
state.js S / R / 持久化
|
||||
panel.js 悬浮面板
|
||||
route.js 路由识别
|
||||
login.js 登录 / 一键刷课
|
||||
list.js 列表页 + 短课程优先
|
||||
player.js 播放器 / 防挂机 / 课时切换
|
||||
course.js 课程页主循环
|
||||
complete.js 完成 / 失败
|
||||
index.js 主循环 / 启动 / 调试入口
|
||||
build.mjs esbuild 打包脚本
|
||||
package-lock.json 依赖锁(esbuild)
|
||||
package.json npm scripts(build / build:watch / dev / check)
|
||||
yun-xue-tang-assistant.user.js 构建产物(唯一需要安装的文件,不要手改)
|
||||
dev/ 本地热加载开发工具(HTTP 服务 + 薄加载器)
|
||||
docs/screenshots/ 实跑截图
|
||||
docs/evidence/ 实跑日志与接口证据
|
||||
|
||||
Reference in new issue
Block a user