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

+29
View File
@@ -61,6 +61,35 @@ export function completeCurrent() {
later(function () { goToList(true); }, 1200);
}
// 这门课在本轮是否已被判为「无法自动完成」而跳过(目前只有考试交不了的情况)
export function courseSkipped(title) {
const t = norm(title);
return !!(t && (S.skippedCourses || {})[t]);
}
// 跳过这门课,继续下一门。
// 只用于「重试也不会好」的确定性失败:考试空卷交卷后平台始终不记账、
// 结果页又回不到考试说明页。继续按 failCurrent 退避重试只会反复进同一门课,
// 最后停下整轮刷课,其它 5000 多门课也跟着停——所以这里记下原因、本轮不再选它,
// 由人工事后处理这门考试。记录只活在本次会话(sessionStorage),重启会重新尝试。
export function skipCurrent(reason) {
const title = recordTitle();
const key = norm(title);
if (key) S.skippedCourses[key] = { reason: reason, at: Date.now() };
S.activeCourse = null;
S.coursePhase = PHASE_IDLE;
S.awaitingListReturn = true;
R.retryWaitUntil = 0;
R.retryTitle = '';
// 下一门课重新拉平台实时状态;被跳过的课仍在平台未学完列表里,靠 skippedCourses 排除
invalidateShortCatalog();
saveRunState();
setStatus('已跳过「' + truncate(title || '当前课程', 20) + '」:' + reason + '(继续下一门)');
console.warn(TAG, '跳过课程:', title, reason);
updatePanel();
later(function () { goToList(true); }, 1200);
}
// 课程没学完(不是「跳过」,是「重试」):
// 同一门课最多重试 CFG.maxCourseRetries 次,退避等待后重新进这门课;
// 超过次数才停止整轮刷课并明确提示——不会把这门课悄悄拉黑、换下一门。
+19
View File
@@ -0,0 +1,19 @@
// ======== 考试结果页的处置决策(纯函数,便于单测) ========
//
// 交卷后平台会把课程恢复到「考试结果页」。重进课程时也会看到这一页,
// 但那次并不是本页刚交的卷 —— 以前把它当成一次空卷交卷,导致:
// · examEmptySubmits 虚增,maxExamTries 形同虚设(上限在结果分支之后才检查);
// · 结果页 → 回课程页 → 又被恢复到结果页,同一页反复「交卷」,进度永远不动。
//
// 只有本页确实点过「提交考试 / 确定交卷」,结果页才算一次真实交卷。
// 否则先回到考试说明页重新进入考试;回不去才跳过这门课,等人工处理。
export function planExamResult(ctx) {
const submitted = !!(ctx && ctx.submitted);
const complete = !!(ctx && ctx.complete);
if (submitted) return complete ? 'complete' : 'count';
// 没交卷但平台已算完成:不重进考试,直接收课
if (complete) return 'complete';
if ((Number(ctx && ctx.staleTries) || 0) >= 2) return 'skip';
return 'reback';
}
+79 -17
View File
@@ -8,11 +8,12 @@ import { R, S, saveRunState } from './state.js';
import { textOf, isVisible, courseIdFromUrl } from './utils.js';
import { later } from './lifecycle.js';
import { setStatus } from './panel.js';
import { failCurrent, completeCurrent } from './complete.js';
import { failCurrent, completeCurrent, skipCurrent } from './complete.js';
import { readSummary } from './player.js';
import { planExamResult } from './exam-plan.js';
// 只认「考试」相关文案:答题/测验/问卷仍按「需要人工处理」跳过
const START_RE = /^(开始考试|继续考试|进入考试)$/;
const START_RE = /^(开始考试|继续考试|重新考试|进入考试)$/;
const SUBMIT_RE = /^(提交考试|提交试卷|交卷|交卷并退出)$/;
// 「交卷」类文案里只有考试独有的几个能用来判定「当前是考试答卷页」;
// 「提交试卷」同样会出现在答题/测验页上,不能拿来当考试标志(否则会误抢答题页)。
@@ -122,12 +123,13 @@ function confirmState() {
// 手动刷课(自己点开的课)里出错不应该动队列,只停下并提示;
// 批量刷课走 failCurrent(重试退避,超过次数才停止整轮)。
function examAbort(reason, manual) {
// skip=true:重试也不会好的确定性失败(考试交不了),本轮跳过这门课继续下一门。
function examAbort(reason, manual, skip) {
if (manual) {
setStatus('考试:' + reason);
return true;
}
failCurrent(reason);
if (skip) skipCurrent(reason); else failCurrent(reason);
return true;
}
@@ -159,6 +161,9 @@ export function backToCourse() {
R.lastCountdown = null;
R.lastSummary = null;
R.examLeaving = false;
// 离开考试页后,再看到的结果页(平台恢复的)就不能再算一次交卷
R.examSubmitted = false;
R.examPreviewAt = 0;
try {
const cur = location.href;
if (!target || cur === target) {
@@ -175,8 +180,53 @@ export function backToCourse() {
} catch (e) { /* ignore */ }
}
function finishExam() {
// 结果页其实是平台恢复的旧结果(本页没交过卷):回考试说明页重新进入考试。
// 交卷后课程页会被恢复到考试结果页,若直接回课程页只会再次看到同一页,
// 于是「交卷 → 回课程 → 又是结果页」无限循环,课程进度却不动。
function backToPreview() {
R.examLeaving = false;
const btn = findClickableByText(/^返回考试说明页$/);
if (btn) {
setStatus('考试:返回考试说明页,重新进入考试…');
examClick(btn);
return;
}
// 说明页按钮也找不到:只能退回课程页重进考试节;
// 平台若又把我们恢复到结果页,examStaleResults 会累加,最终跳过这门课。
backToCourse();
}
function finishExam(manual) {
if (R.examLeaving) return;
const s = readSummary();
const plan = planExamResult({
submitted: R.examSubmitted,
complete: !!(s && s.complete),
staleTries: R.examStaleResults,
});
if (plan === 'complete') {
R.examLeaving = true;
setStatus('考试已交卷(未答题),课程已完成');
later(completeCurrent, 1500);
return;
}
if (plan === 'reback') {
R.examLeaving = true;
R.examStaleResults++;
console.log(TAG, '考试结果页不是本页交的卷(平台恢复的旧结果),返回说明页重新进入考试');
setStatus('考试结果为上次残留,返回考试说明页重新进入…');
later(backToPreview, 1500);
return;
}
if (plan === 'skip') {
return examAbort('考试结果页反复出现,无法重新进入考试,需手动处理', manual, true);
}
// plan === 'count':本页确实点了「提交考试/确定交卷」
R.examLeaving = true;
const key = examCourseKey();
if (!S.examEmptySubmits) S.examEmptySubmits = {};
@@ -185,16 +235,8 @@ function finishExam() {
const times = S.examEmptySubmits[key];
console.log(TAG, '考试已空卷交卷(第', times, '次),返回课程页继续学习');
// 交卷后平台会立刻更新课程汇总;已经「已完成学习」就直接判这门课完成,不必再跳一轮
const s = readSummary();
if (s && s.complete) {
setStatus('考试已交卷(未答题),课程已完成');
later(completeCurrent, 1500);
return;
}
if (times >= Math.max(1, CFG.maxExamTries)) {
examAbort('已空卷交卷 ' + times + ' 次,仍未计入课程进度,请手动处理', false);
examAbort('已空卷交卷 ' + times + ' 次,仍未计入课程进度,需手动处理', manual, true);
return;
}
@@ -216,6 +258,7 @@ export function examTick(manual) {
R.examConfirms = 0;
R.examStarts = 0;
R.examActionAt = 0;
R.examPreviewAt = 0;
}
return false;
}
@@ -228,6 +271,10 @@ export function examTick(manual) {
R.examConfirms = 0;
R.examStarts = 0;
R.examPaperAt = 0;
// 新一次考试从说明页/答卷页开始时,之前的「已交卷」标记作废;
// 进入结果页时必须保留——那是本页刚交卷产生的
if (phase === 'preview' || phase === 'paper') R.examSubmitted = false;
R.examPreviewAt = phase === 'preview' ? now : 0;
if (phase === 'preview') {
console.log(TAG, '检测到考试章节:进入考试后不答题,直接交卷');
setStatus('检测到考试:进入考试后直接交卷…');
@@ -235,14 +282,15 @@ export function examTick(manual) {
}
if (phase === 'result') {
finishExam();
finishExam(manual);
return true;
}
// 同一门课空卷交卷次数上限:平台没记账时避免「进考试→交卷→再进考试」死循环
// 同一门课空卷交卷次数上限:平台没记账时避免「进考试→交卷→再进考试」死循环。
// 到上限就跳过这门课,继续下一门——再退避重试也只会重复同一份考卷。
const key = examCourseKey();
if (examTriedTimes(key) >= Math.max(1, CFG.maxExamTries)) {
return examAbort('已空卷交卷 ' + examTriedTimes(key) + ' 次,仍未计入课程进度,请手动处理', manual);
return examAbort('已空卷交卷 ' + examTriedTimes(key) + ' 次,仍未计入课程进度,需手动处理', manual, true);
}
if (now - R.examActionAt < CFG.examClickCooldownMs) return true;
@@ -251,9 +299,14 @@ export function examTick(manual) {
const root = examPreviewRoot();
const btn = findClickableByText(START_RE, root) || findClickableByText(START_RE);
if (!btn) {
// 说明页可能永远不给「开始考试」(考试已用完次数/需人工),不能无限等
if (now - R.examPreviewAt > 30000) {
return examAbort('考试说明页没有「开始考试」按钮,需手动处理', manual, true);
}
setStatus('考试:未找到「开始考试」按钮,等待页面渲染…');
return true;
}
R.examPreviewAt = 0;
R.examActionAt = now;
R.examStarts++;
if (R.examStarts > Math.max(3, CFG.maxExamTries + 3)) {
@@ -273,6 +326,9 @@ export function examTick(manual) {
const cs = confirmState();
if (cs.shown) {
if (!cs.btn) {
if (now - R.examPaperAt > 30000) {
return examAbort('交卷确认框里没有「确定」按钮', manual);
}
setStatus('考试:交卷确认框里没找到「确定」按钮');
return true;
}
@@ -281,6 +337,8 @@ export function examTick(manual) {
if (R.examConfirms > 6) {
return examAbort('交卷确认框点了多次仍未交卷', manual);
}
// 只有真的点了交卷,之后看到的结果页才算一次空卷交卷
R.examSubmitted = true;
setStatus('考试:不答题,确认交卷…');
examClick(cs.btn);
return true;
@@ -288,6 +346,9 @@ export function examTick(manual) {
const sub = findClickableByText(SUBMIT_RE);
if (!sub) {
if (now - R.examPaperAt > 30000) {
return examAbort('答卷页没有「提交考试」按钮', manual);
}
setStatus('考试:等待「提交考试」按钮…');
return true;
}
@@ -296,6 +357,7 @@ export function examTick(manual) {
}
R.examActionAt = now;
R.examSubmits++;
R.examSubmitted = true;
setStatus('考试:不答题,直接交卷…');
examClick(sub);
return true;
+2 -2
View File
@@ -16,7 +16,7 @@ import {
import { courseTick, manualCourseTick } from './course.js';
import {
stopBatch, retryCount, retryWaiting, retryWaitSeconds,
completeCurrent, failCurrent,
completeCurrent, failCurrent, skipCurrent, courseSkipped,
} from './complete.js';
import { examTick, examPhase } from './exam.js';
import {
@@ -95,7 +95,7 @@ try {
sortCardsByDuration, formatDuration,
pendingShortItems, invalidateShortCatalog,
retryCount, retryWaiting, retryWaitSeconds,
completeCurrent, failCurrent,
completeCurrent, failCurrent, skipCurrent, courseSkipped,
// 以下供开发/真机测试驱动内部路径使用:
scanCards, currentPage, maxPageNumber, startCourse, jumpToPage, nextPage,
listTick, courseTick, manualCourseTick,
+6 -5
View File
@@ -7,7 +7,7 @@ import {
import { norm, textOf, truncate } from './utils.js';
import { clickNode } from './player.js';
import { setStatus, updatePanel } from './panel.js';
import { failCurrent, stopBatch } from './complete.js';
import { failCurrent, stopBatch, courseSkipped } from './complete.js';
import { retryWaiting, retryWaitSeconds } from './complete.js';
export function scanCards() {
@@ -357,8 +357,8 @@ export function pendingShortItems() {
if (!cat) return [];
return cat.items.filter(function (item) {
if (!item || !item.title) return false;
// 只排除「本轮已完成」;不再排除任何「失败/跳过」——没过就是重试,不是拉黑
if (S.completedTitles[item.title]) return false;
// 只排除「本轮已完成」与「本轮已跳过(考试交不了)」;其它失败一律重试,不拉黑
if (S.completedTitles[item.title] || courseSkipped(item.title)) return false;
return true;
});
}
@@ -450,7 +450,8 @@ export function chooseShortCourse(cards, pending) {
} else {
const card = cardForShortItem(cards, target);
if (card) {
if (card.status === '已学完' || S.completedTitles[card.title]) {
if (card.status === '已学完' || S.completedTitles[card.title] ||
courseSkipped(card.title)) {
// 缓存与实际状态不一致:剔除这一门,下一 tick 继续挑下一门
forgetShortCourse(card.title);
return { wait: true };
@@ -607,7 +608,7 @@ export function listTick() {
const pending = cards.filter((c) => {
if (!c.title) return false;
if (/已学完|已完成|已学习/.test(c.status)) return false;
if (S.completedTitles[c.title]) return false;
if (S.completedTitles[c.title] || courseSkipped(c.title)) return false;
return true;
});
+8
View File
@@ -139,6 +139,7 @@ export function clearSavedCreds() {
}
export function startBatch() {
const freshStart = !S.batchRunning;
if (S.batchFinished) {
S.completedThisRun = 0;
S.batchFinished = false;
@@ -147,6 +148,13 @@ export function startBatch() {
R.retryWaitUntil = 0;
R.retryTitle = '';
}
if (freshStart) {
// 新一轮(含重启后重新开跑):考试相关的本轮记录也清零。
// 否则上次会话里的「已跳过 / 已交卷 N 次」会让这门课开跑就被跳过,
// 人工处理过考试也得不到重新尝试的机会。
S.skippedCourses = {};
S.examEmptySubmits = {};
}
S.batchRunning = true;
// 开跑时丢掉旧的时长队列:第一门课也要按平台实时状态挑
invalidateShortCatalog();
+6 -3
View File
@@ -2,7 +2,7 @@
// @name 云学堂助手
// @namespace yun-xue-tang-assistant.local
// @version __YUN_XUE_TANG_VERSION__
// @description 云学堂助手:自动登录、从第一节顺序听课、自动切节、处理防挂机验证,并在课程列表页逐门自动刷课(单视频/音频课程也支持,含考试章节的课自动空卷交卷,学完自动进入下一门,可优先短课程;不跳过任何课程)
// @description 云学堂助手:自动登录、从第一节顺序听课、自动切节、处理防挂机验证,并在课程列表页逐门自动刷课(单视频/音频课程也支持,含考试章节的课自动空卷交卷,学完自动进入下一门,可优先短课程)
// @match *://kfmic.yunxuetang.cn/*
// @match *://*.yunxuetang.cn/*
// @grant none
@@ -30,7 +30,7 @@
* 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。
* 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。
* - 试跑稳定后,把 config.js 里的 CFG.maxCourses 改成 0 即可不限门数(会持续很久)。
* - 脚本不跳过任何课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到
* - 脚本不跳过普通课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到
* 需要人工完成的滑块/拼图验证、答题/测验章节、长时间无计时进展)就退避重试:
* 30 秒起每次翻倍、最长 5 分钟,同一门课最多重试 CFG.maxCourseRetries 次,
* 超过才停下整轮刷课并在面板写明原因,等人工处理后点「一键刷课」接着跑。
@@ -39,7 +39,10 @@
* - 防挂机验证(每 10 分钟一次、120 秒限时)会自动点「继续学习」。
* - 考试章节支持:自动进入考试、不答题直接交卷(空白交卷)。交卷后平台会把考试节点
* 计入课程进度,含考试章节的课程也能学完。
* 同一门课最多交卷 CFG.maxExamTries 次,超过仍没计入进度就按普通未完成退避重试。
* 只有本页真的点过「提交考试/确定交卷」,看到的结果页才算一次交卷;平台恢复的旧
* 结果页会先回考试说明页重新进入,避免在结果页和课程页之间空转。
* 同一门课最多交卷 CFG.maxExamTries 次,超过仍没计入进度、或考试页没有可点的
* 「开始考试/提交考试」时,本轮跳过这门课继续下一门(会写明原因),不再反复重进。
* - 验证码/滑块需要手动完成,脚本不会绕过。
* - 课程/单位如有相关规定,请自行确认风险。
*
+8
View File
@@ -54,6 +54,7 @@ export function defaultRunState() {
// ---- 本轮记录 ----
completedTitles: {}, // 课程名 -> 完成时间戳(防平台记账延迟时重进同一门)
courseRetries: {}, // 课程名 -> { n, reason, at }(未完成重试次数)
skippedCourses: {}, // 课程名 -> { reason, at }(考试无法自动完成,本轮跳过)
examEmptySubmits: {}, // 课程 id -> 空卷交卷次数(防死循环)
};
}
@@ -106,6 +107,7 @@ function restoreFrom(obj) {
// ---- 本轮记录 ----
out.completedTitles = asMap(obj.completedTitles);
out.courseRetries = asMap(obj.courseRetries);
out.skippedCourses = asMap(obj.skippedCourses);
out.examEmptySubmits = asMap(obj.examEmptySubmits);
return out;
}
@@ -207,6 +209,9 @@ export const R = {
// 考试(空卷交卷)自动处理状态
examPhase: '', // '' | preview | paper | result
examActionAt: 0, // 上次考试页内点击时间
examSubmitted: false, // 本页是否真的点过「提交考试/确定交卷」(区分残留结果页)
examPreviewAt: 0, // 进入考试说明页的时间(找不到「开始考试」时的超时)
examStaleResults: 0, // 本课遇到残留结果页并尝试重进的次数
examStarts: 0, // 本形态点了多少次「开始考试」
examSubmits: 0, // 本形态点了多少次「提交考试」
examConfirms: 0, // 本形态点了多少次交卷确认「确定」
@@ -268,6 +273,9 @@ export function resetCourseRuntime() {
R.quizChecked = false;
R.examPhase = '';
R.examActionAt = 0;
R.examSubmitted = false;
R.examPreviewAt = 0;
R.examStaleResults = 0;
R.examStarts = 0;
R.examSubmits = 0;
R.examConfirms = 0;