新增无头运行能力,解决 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 补无头部署章节
65 lines
2.5 KiB
JavaScript
65 lines
2.5 KiB
JavaScript
// 优雅退出:收到终止信号时按注册顺序并行执行收尾函数,然后退出。
|
||
//
|
||
// 用法:把「怎么把浏览器关干净」注册进来,主程序不用到处写信号处理。
|
||
// 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,
|
||
};
|
||
}
|