Files
yun-xue-tang-assistant/runner/stop.mjs
T
void ae117222df 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 补无头部署章节
2026-10-25 23:04:40 +08:00

65 lines
2.5 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 优雅退出:收到终止信号时按注册顺序并行执行收尾函数,然后退出。
//
// 用法:把「怎么把浏览器关干净」注册进来,主程序不用到处写信号处理。
// 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,
};
}