新增 runner/tui.mjs(~470 行):前台运行时自动开一块实时面板, 框线布局显示状态 / 课程 / 学时 / 课时 / 视频进度条 / 进度 / 最近日志。 - 学习统计 runner/study.mjs:只累计视频真在播的时长(暂停、重试退避、 页面加载都不计),学分按课程去重(重试 / 刷新不重复计) - 页面侧新增 credit 快照:平台只把本门学分写在倒计时文案里, 学完文案就消失,所以边播边记 - log.mjs 增加 setConsoleSink:面板接管终端那一路,日志文件仍是纯文本 - 面板里按 q 等价 Ctrl+C,走 stop.request 同一条优雅收尾路径 - 尺寸自适应:宽度跟随终端(不封顶 120 列),无 resize 事件的平台 靠定时刷新发现尺寸变化;变窄时按旧帧在新宽度下的折行数回退光标, 折完超过窗口高就整屏重置;宽度 / 高度不足按重要性丢字段 - 非 TTY(重定向 / 管道 / 计划任务 / --check)自动降级为逐行日志, 不写 ANSI 控制字符;--no-tui / YUN_XUE_TANG_TUI=0 可手动关闭, --no-color / NO_COLOR 关颜色 - 监控轮询从 2000ms 调到 1000ms,与面板刷新对齐 - supervisor 收尾时先收面板再逐行打退出日志,并汇总本次学习时长 / 学分 - check.mjs 增加裸 CR 检查:脚本里的 config\runner 曾被写成裸 CR, 变成 config<CR>unner 导致找不到配置文件 自测:npm run test:tui(渲染 / 列宽 / 极端尺寸)、npm run test:study(假时钟口径)
73 lines
2.9 KiB
JavaScript
73 lines
2.9 KiB
JavaScript
// 优雅退出:收到终止信号时按注册顺序并行执行收尾函数,然后退出。
|
||
//
|
||
// 用法:把「怎么把浏览器关干净」注册进来,主程序不用到处写信号处理。
|
||
// const stop = createStopHandler({ log });
|
||
// const unregister = stop.add(() => browser.kill());
|
||
// if (stop.stopping) return; // 主循环里轮询这个开关
|
||
// stop.request('q'); // 面板里按 q 也走同一条收尾路径
|
||
//
|
||
// 收尾完成后会 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);
|
||
};
|
||
},
|
||
/**
|
||
* 主动请求收尾(终端面板里按 q / Ctrl+C 走这里),
|
||
* 与收到信号完全同一条路径:并行收尾 → closeLog → exit(0)。
|
||
*/
|
||
request(reason) {
|
||
run(reason || '面板退出');
|
||
},
|
||
get stopping() { return stopping; },
|
||
get signal() { return triggered; },
|
||
/** 本平台实际监听的信号列表(自检 / 日志里用) */
|
||
signals: SIGNALS,
|
||
};
|
||
}
|