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

+64
View File
@@ -0,0 +1,64 @@
// 优雅退出:收到终止信号时按注册顺序并行执行收尾函数,然后退出。
//
// 用法:把「怎么把浏览器关干净」注册进来,主程序不用到处写信号处理。
// const stop = createStopHandler({ log });
// const unregister = stop.add(() => browser.kill());
// if (stop.stopping) return; // 主循环里轮询这个开关
//
// 收尾完成后会 closeLog() 并以 0 退出,所以主循环不用自己处理信号。
//
// 各平台的信号差异(很重要,不然 Windows 上会「关不掉」):
// Linux/macOS Ctrl+C = SIGINT,kill = SIGTERM,两者都能收
// Windows Ctrl+C = SIGINT(可用),Ctrl+Break = SIGBREAK,关闭控制台窗口 = SIGHUP
// SIGTERM 根本收不到;用 taskkill /F 或任务管理器「结束任务」是 TerminateProcess,
// 任何处理函数都不会执行 —— 那种情况只能靠下次启动时清理残留进程+锁文件。
import { closeLog, log as defaultLog } from './log.mjs';
/** 各平台实际可能收到的终止信号 */
const SIGNALS = process.platform === 'win32'
? ['SIGINT', 'SIGBREAK', 'SIGHUP']
: ['SIGINT', 'SIGTERM', 'SIGHUP'];
/**
* @param {{ log?: Function, onExit?: (code:number)=>void }} [opts]
*/
export function createStopHandler(opts = {}) {
const say = opts.log || defaultLog;
const exit = opts.onExit || ((code) => process.exit(code));
const cleaners = [];
let stopping = false;
let triggered = null;
const run = async (signal) => {
if (stopping) return;
stopping = true;
triggered = signal;
say('收到 ' + signal + ',正在收尾…');
// 收尾函数并行跑,谁也挡不住谁(浏览器关不掉也要退)
await Promise.allSettled(cleaners.map((fn) => {
try { return Promise.resolve(fn()); } catch (e) { return Promise.reject(e); }
}));
closeLog();
exit(0);
};
process.on('SIGINT', () => run('SIGINT'));
process.on('SIGTERM', () => run('SIGTERM'));
process.on('SIGBREAK', () => run('SIGBREAK')); // Windows:Ctrl+Break
process.on('SIGHUP', () => run('SIGHUP')); // Windows:关闭控制台窗口
return {
/** 注册一个收尾函数,返回取消注册的函数 */
add(fn) {
cleaners.push(fn);
return () => {
const i = cleaners.indexOf(fn);
if (i >= 0) cleaners.splice(i, 1);
};
},
get stopping() { return stopping; },
get signal() { return triggered; },
/** 本平台实际监听的信号列表(自检 / 日志里用) */
signals: SIGNALS,
};
}