Files
yun-xue-tang-assistant/runner/stop.mjs
T
void 65bf63ea6a feat: v2.9.0 终端实时面板,学习时长与学分统计
新增 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(假时钟口径)
2026-10-26 21:49:13 +08:00

73 lines
2.9 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; // 主循环里轮询这个开关
// 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,
};
}