feat: v2.8.0 无头运行器、考试自动交卷、改为退避重试不跳课

新增无头运行能力,解决 Linux 无图形化服务器上无法常驻的问题;同时改掉
"遇到考试课/无进展课就跳过"的策略,改为在同门课上退避重试。

- runner/:自己起无头 Chromium,用 CDP 把构建产物注入页面主世界(等价
  @grant none),不装插件、不需要桌面环境或 Xvfb;含浏览器探测与启动参数、
  持久化 profile、陈旧 SingletonLock 清理、优雅退出、日志轮转、启动预检
- runner.config.mjs / start-headless.cmd:通用配置 + Windows 一键入口;
  凭据只走 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD 环境变量
- src/exam.js:含考试章节的课程自动进考试 → 开始/继续 → 空卷提交 → 确定,
  交卷后靠平台记账推进课程;maxExamTries 限制同门课交卷次数,防不记账时死循环
- 去掉跳过与黑名单:没学完就退避重试(30s 起翻倍,最长 5 分钟),
  同门课超过 maxCourseRetries 次才停整轮并提示,替代原 maxConsecutiveFailures
- 每完成一门都重新拉列表接口取平台实时状态再选下一门,避免用陈旧队列
- 学习进度改存 sessionStorage(yun-xue-tang-run-state-v3),整页跳转/刷新可续;
  运行开关不跨会话,浏览器重启后必须显式开跑
- dev/:新增 real-cdp / real-run / real-test / real-e2e 实跑脚本与 check.mjs
  统一静态检查(JS 22 + 批处理 2),替代逐文件 node --check
- docs/evidence/headless-linux-evidence.txt + 实跑截图,README 补无头部署章节
This commit is contained in:
void committed 2026-10-25 23:04:40 +08:00
1 parent 8193326b70
commit ae117222df
47 files changed
+6198 -837

No files matched your search

+80
View File
@@ -0,0 +1,80 @@
// 进程层:日志开关、启动横幅、崩溃重启循环、退出码。
//
// 一次会话(session.mjs)只管一个浏览器进程;这里管「崩了就重来」以及「什么情况该放弃」。
// 重试等待递增:15s → 30s → 45s …,上限 120s,避免持续失败时疯狂刷 CDP 端口。
import { sleep } from './cdp.mjs';
import { cleanStaleSingleton } from './browser.mjs';
import { runSession, disposeActiveSession } from './session.mjs';
import { openLog } from './log.mjs';
import { noDisplayReason, platformName } from './platform.mjs';
const RETRY_BASE_MS = 15000;
const RETRY_MAX_MS = 120000;
/**
* @param {object} o
* @param {object} o.cfg
* @param {string} o.binary
* @param {string} o.scriptSrc
* @param {object} o.stop
* @param {Function} o.log / o.warn / o.error
*/
export async function runSupervisor(o) {
const { cfg, stop } = o;
const log = o.log, warn = o.warn, error = o.error;
// 自检不写文件日志:避免每次 --check 都改仓库内容
if (!cfg.CHECK_ONLY) openLog(cfg.LOG_FILE, cfg.LOG_MAX_BYTES);
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 runner.config.mjs,使用内置默认值)'));
log('浏览器 ' + o.binary);
log('profile ' + cfg.PROFILE_DIR + '(cookie / localStorage 持久化,删掉即重置登录态与进度缓存)');
if (cfg.WANT_VISIBLE && !cfg.VISIBLE) {
warn(noDisplayReason() + ',配置里的 headless: false 被忽略,强制无头运行。');
}
if (!cfg.CHECK_ONLY) {
log('日志 ' + cfg.LOG_FILE + '(' + (process.platform === 'win32' ? 'Ctrl+C 结束' : 'Ctrl+C 结束') + ')');
}
let attempt = 0;
let last = null;
while (!stop.stopping) {
attempt++;
if (attempt > 1) log('--- 第 ' + attempt + ' 次尝试 ---');
try {
last = await runSession({ ...o, cfg });
if (stop.stopping) break;
if (cfg.CHECK_ONLY) break;
// 正常结束:只有「脚本自己停了 / 无进展」且配了重启间隔才再来一轮
const restartable = !last.limitReached && cfg.RESTART_MINUTES > 0;
if (!restartable) break;
log('按 YUN_XUE_TANG_RESTART_MINUTES=' + cfg.RESTART_MINUTES + ' 等待后重新开始…');
const until = Date.now() + cfg.RESTART_MINUTES * 60000;
while (!stop.stopping && Date.now() < until) await sleep(2000);
if (stop.stopping) break;
cleanStaleSingleton(cfg.PROFILE_DIR);
} catch (e) {
if (stop.stopping) break;
// 会话抛错时内部的收尾代码已被跳过,这里补上:否则浏览器进程会残留、端口被占
await disposeActiveSession();
error('会话异常:' + (e && e.message ? e.message : e));
// 连登 5 次失败基本都是密码错 / 要验证码,重试没意义,直接用专门的退出码结束
if (e && e.message && /连续 \d+ 次登录失败/.test(e.message)) {
return { exitCode: 3, last };
}
const waitMs = Math.min(RETRY_BASE_MS * attempt, RETRY_MAX_MS);
warn('浏览器/连接异常,' + Math.round(waitMs / 1000) + ' 秒后重试(第 ' + attempt + ' 次)');
await sleep(waitMs);
}
}
log('=== 运行器退出 ===');
if (cfg.CHECK_ONLY) return { exitCode: last && last.ok ? 0 : 1, last };
// 0 = 正常收尾(达到上限 / 预算 / 无更多课程);1 = 无进展卡死
if (last && /没有任何进展/.test(last.finishReason || '')) return { exitCode: 1, last };
return { exitCode: 0, last };
}