feat: 考试结果页去重与跳课,构建镜像脚本支持国内换源

考试:
- 新增 src/exam-plan.js(纯函数)判定结果页处置:只有本页确实点过
  「提交考试/确定交卷」才算一次空卷交卷,平台恢复的旧结果页先回
  「考试说明页」重进,不再在结果页和课程页之间空转
- 重试也不会好的确定性失败(交卷次数到上限、说明页无「开始考试」、
  答卷页无「提交考试」、结果页反复回退)改为本轮跳过该课继续下一门,
  记录在 S.skippedCourses(sessionStorage),不会停下整轮刷课
- 新一轮开跑时清空 skippedCourses / examEmptySubmits,人工处理后可重试
- 补 dev/tests/exam-test.mjs(npm run test:exam,5 条用例)

构建:
- 新增 scripts/build-docker.mjs/.cmd/.sh(npm run docker:build):
  国内换源、按包版本打标签、构建后自检、--dry-run
- Dockerfile 增加 APT_MIRROR / NPM_REGISTRY 构建参数,
  docker-compose.yml 透传三个 build args,.env.example 补说明
This commit is contained in:
void committed 2026-10-29 21:31:45 +08:00
1 parent b588b1042f
commit 17217dbeb1
18 files changed
+763 -53

No files matched your search

+24 -5
View File
@@ -20,8 +20,8 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
| 防挂机验证 | 识别「已触发防挂机验证」弹窗并点「继续学习」;滑块/拼图类验证不绕过,提示人工处理 |
| 课程列表自动刷课 | 在列表页逐门进入未学完的课程;每完成一门都重新调列表接口拿平台实时状态再选下一门,本次门数上限见下方配置表 |
| 短课程优先 | 列表刷课默认按课程总时长**从短到长**选课(跨页),先完成 1 分钟的课再学 1 小时的课;面板可关闭 |
| 考试自动空卷 | 含考试章节的课程不再跳过:自动点进考试节 → 开始/继续考试 → 一题不做直接「提交考试」→ 点「确定」交卷,交卷后课程进度被平台记账,课程即可完成;同一门课最多交卷 `maxExamTries` 次,防平台不记账时死循环 |
| 不跳过课程 | 没有任何「跳过本课」入口,也不会把某门课加入黑名单;没学完就退避重试(30 秒起翻倍,最长 5 分钟),同一门课最多重试 `maxCourseRetries` 次,超过才停下整轮刷课并提示原因,等人工处理 |
| 考试自动空卷 | 含考试章节的课程不再跳过:自动点进考试节 → 开始/继续考试 → 一题不做直接「提交考试」→ 点「确定」交卷,交卷后课程进度被平台记账,课程即可完成。只有本页真的点过「提交考试/确定交卷」,看到的结果页才算一次交卷;平台恢复的旧结果页会先回「考试说明页」重新进入,不会在结果页和课程页之间空转。同一门课最多交卷 `maxExamTries` 次,超过仍不记账就跳过该课继续下一门(写明原因) |
| 不跳过普通课程 | 没有任何「跳过本课」入口,也不会把普通课程加入黑名单;没学完就退避重试(30 秒起翻倍,最长 5 分钟),同一门课最多重试 `maxCourseRetries` 次,超过才停下整轮刷课并提示原因,等人工处理。**唯一例外**:考试空卷交卷达到 `maxExamTries` 仍未计入进度,或考试页始终没有可点的「开始考试/提交考试」——继续重试只会反复进同一门课,因此本轮跳过它、继续刷其它课 |
| 进度可续 | 学习进度存在 `sessionStorage`(`yun-xue-tang-run-state-v3`),整页跳转/刷新后继续上次的队列和页码;**运行开关不跨会话** —— 浏览器重启、运行器新建标签页后一律回到待机,必须显式开跑(避免未登录就报「运行中」) |
| 无头运行 | 在有/无图形界面的机器上都能跑;`runner/` 可自己起无头 Chromium 并注入脚本,适合 Linux 服务器 / Windows 无人值守常驻(见下方「无头运行」) |
@@ -52,7 +52,7 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
| `courseRetryDelayMs` | `30000` | 首次重试前的等待;每次翻倍,最长 5 分钟 |
| `alignToFirstIncomplete` | `true` | 进入课程先从第一个未学完的课时学起;`false` = 沿用平台上次位置 |
| `preferShortCourses` | `true` | 列表刷课时优先总时长更短的课程(正序);面板勾选框「优先短课程(时长正序)」可随时切换 |
| `maxExamTries` | `2` | 同一门课「空卷交卷」的最大次数;超过仍没计入进度就按普通未完成重试(防死循环) |
| `maxExamTries` | `2` | 同一门课「空卷交卷」的最大次数;超过仍没计入进度就本轮跳过该课、继续下一门(记录在会话里,重启后会重新尝试) |
| `examClickCooldownMs` | `1500` | 考试页内两次点击的间隔(毫秒) |
对齐起点对「一键刷课」和自己点开的课程(需勾选「当前课程自动连播」)都生效,
@@ -307,6 +307,21 @@ export default {
Node 22 与 **官方 google-chrome-stable**(不是发行版 chromium —— 后者不带 H.264/AAC,
课程视频会一直停在 0 秒),并在构建阶段跑完 `npm run build`,所以镜像开箱即用。
构建镜像推荐用仓库自带的脚本,它会把国内换源、按 `package.json` 版本打标签、构建后自检
这几件容易漏的事一趟做完(纯 `docker build` 当然也能用,下面第 1 步就是它展开后的样子):
```bash
npm run docker:build # 默认标签 <包名>:<版本号> + <包名>:latest
npm run docker:build -- --mirror # 国内网络:apt 换清华源、npm 换 npmmirror
npm run docker:build -- --check # 构建完顺手跑一次 --check 自检
npm run docker:build -- --dry-run # 只打印将要执行的 docker 命令,不构建
npm run docker:build -- --help # 全部选项(--tag / --platform / --no-cache / --pull / --chrome-url …)
Windows 下也可以直接双击 scripts\build-docker.cmd;Linux/macOS 用 ./scripts/build-docker.sh
```
`APT_MIRROR` / `NPM_REGISTRY` / `CHROME_DEB_URL` 三个构建参数按 **命令行 > 环境变量 > 仓库根 `.env`**
的优先级取值,所以也可以把它们写进 `.env` 一次配好,之后直接 `npm run docker:build`。
```bash
# 1. 构建(首次约 3-5 分钟,主要是下 Chrome 的 deb)
docker build -t yun-xue-tang-assistant .
@@ -399,12 +414,16 @@ src/ 业务脚本源码(拆成多个模块,日
list.js 列表页 + 短课程优先
player.js 播放器 / 防挂机 / 课时切换
exam.js 考试自动空卷交卷
exam-plan.js 考试结果页处置决策(纯函数,可单测)
course.js 课程页主循环
complete.js 完成 / 未完成重试
complete.js 完成 / 未完成重试 / 跳课
index.js 主循环 / 启动 / 调试入口
scripts/ 开发与运维脚本(不在构建产物里)
build.mjs esbuild 打包脚本(产物写回仓库根)
check.mjs 静态检查:node --check + 批处理纯 ASCII/CRLF 校验
build-docker.mjs 构建镜像(换源 / 打标签 / 构建后自检,参数见 --help)
build-docker.cmd Windows 一键构建镜像(双击即可)
build-docker.sh Linux / macOS 构建镜像(转交 build-docker.mjs)
start-dev.cmd Windows 一键启动本地热加载服务(双击即可)
start-headless.cmd Windows 一键启动无头运行器(双击即可)
runner/ 无头运行器(Linux / Windows,无图形化环境)
@@ -457,7 +476,7 @@ docs/
| `sessionStorage` 键(本次运行,关掉标签页即清空) | 内容 |
| --- | --- |
| `yun-xue-tang-run-state-v3` | 本轮是否在跑、页码、当前课程、本轮已完成与待重试记录 |
| `yun-xue-tang-run-state-v3` | 本轮是否在跑、页码、当前课程、本轮已完成 / 待重试 / 已跳过(考试交不了)记录 |
| `yun-xue-tang-short-catalog-v1` | 短课程时长队列缓存(TTL 5 分钟) |
旧版本(v2.8.0 之前)把所有状态整块存在 `localStorage` 的 `yun-xue-tang-batch-v2` 里,