Files
yun-xue-tang-assistant/runner/supervisor.mjs
T
voidandClaude Sonnet 4.6 6b508a0b1a feat: Bark 增加开始运行与获得学分提醒
收尾通知去掉重复的积分台账与完成门数;学习统计在无 TTY 时照常累计,保证 Docker 里也能推送学分提醒。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-02 22:30:11 +08:00

160 lines
7.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.
// 进程层:日志开关、终端面板、启动横幅、崩溃重启循环、退出码。
//
// 一次会话(session.mjs)只管一个浏览器进程;这里管「崩了就重来」以及「什么情况该放弃」。
// 重试等待递增:15s → 30s → 45s …,上限 120s,避免持续失败时疯狂刷 CDP 端口。
import { sleep } from './cdp.mjs';
import { cleanStaleSingleton } from './browser.mjs';
import { runSession, disposeActiveSession } from './session.mjs';
import { openLog } from './log.mjs';
import { noDisplayReason, platformName } from './platform.mjs';
import { createTui } from './tui.mjs';
import { notifyRunStarted, notifyRunFinished } from './notify.mjs';
const RETRY_BASE_MS = 15000;
const RETRY_MAX_MS = 120000;
/**
* @param {object} o
* @param {object} o.cfg
* @param {string} o.binary
* @param {string} o.scriptSrc
* @param {object} o.stop stop.mjs 的句柄
* @param {object} [o.tui] 已创建的面板(不传就按 cfg.TUI 自己建)
* @param {Function} [o.onQuitRequest] 面板按 q 时的回调(默认接到 stop 上)
* @param {Function} o.log / o.warn / o.error
*/
export async function runSupervisor(o) {
const { cfg, stop } = o;
const log = o.log, warn = o.warn, error = o.error;
// 自检不写文件日志:避免每次 --check 都改仓库内容
if (!cfg.CHECK_ONLY) openLog(cfg.LOG_FILE, cfg.LOG_MAX_BYTES);
// 面板要先于启动横幅建好:横幅和后续日志都会进面板的日志区
const tui = o.tui || createTui({
enabled: cfg.TUI,
title: '云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : ''),
logFile: cfg.CHECK_ONLY ? '' : cfg.LOG_FILE,
color: cfg.COLOR,
onQuit: (reason) => {
if (o.onQuitRequest) o.onQuitRequest(reason);
else if (typeof stop.request === 'function') stop.request(reason);
},
});
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 config/runner.config.mjs,使用内置默认值)'));
log('浏览器 ' + o.binary);
log('profile ' + cfg.PROFILE_DIR + '(cookie / localStorage 持久化,删掉即重置登录态与进度缓存)');
if (cfg.WANT_VISIBLE && !cfg.VISIBLE) {
warn(noDisplayReason() + ',配置里的 headless: false 被忽略,强制无头运行。');
}
if (!cfg.CHECK_ONLY) {
log('日志 ' + cfg.LOG_FILE + '(Ctrl+C 或面板里按 q 结束)');
}
if (!cfg.TUI && cfg.tuiDisabledReason) log('面板:' + cfg.tuiDisabledReason());
tui.set({ phase: '启动中' });
if (!cfg.CHECK_ONLY) {
// 整个进程只发一次「开始运行」;配了 restartMinutes 时每轮会话重开不再推
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
await notifyRunStarted(cfg, { log, warn });
}
let attempt = 0;
let last = null;
let lastNotified = '';
/**
* 收尾 Bark 通知。通知识别键相同的只发一次:配了 restartMinutes 时,
* 「今日积分已学完」这类结论会在每一轮重启后原样重复,没必要每小时推一次。
* 用户按 Ctrl+C 主动停的不发;自检模式不发。
*/
const notify = async (result) => {
if (stop.stopping || cfg.CHECK_ONLY) return;
const key = [result.kind, result.finishReason, result.completed,
result.points && result.points.text].join('|');
if (key === lastNotified) return;
lastNotified = key;
await notifyRunFinished(cfg, result, { log, warn });
};
/** 一次会话的结果 → 通知入参:卡死和无进展在退出码里是两种结论,标题也不同 */
const finishResult = (s) => ({
kind: /没有任何进展/.test((s && s.finishReason) || '') ? 'stalled' : 'done',
finishReason: (s && s.finishReason) || '',
completed: (s && s.completed) || 0,
elapsed: (s && s.elapsed) || 0,
points: s && s.points,
});
/** 收尾时先把面板收掉,退出日志和退出码提示才会逐行打印出来 */
const finishTui = (phase, tone) => {
tui.set({ phase, tone });
tui.finish();
};
while (!stop.stopping) {
attempt++;
if (attempt > 1) log('--- 第 ' + attempt + ' 次尝试 ---');
tui.set({ attempt, phase: attempt > 1 ? '重启浏览器' : '启动浏览器', tone: 'info' });
try {
last = await runSession({ ...o, cfg, tui });
if (stop.stopping) break;
if (cfg.CHECK_ONLY) break;
// 每轮会话自己结束就先推一次:配了 restartMinutes 时进程不会退出,
// 只在最终收尾推就等于永远不推。重复结论由 notify() 的识别键挡掉。
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
await notify(finishResult(last));
// 正常结束:配了重启间隔就再来一轮
const restartable = cfg.RESTART_MINUTES > 0;
if (!restartable) break;
log('按 YUN_XUE_TANG_RESTART_MINUTES=' + cfg.RESTART_MINUTES + ' 等待后重新开始…');
tui.set({ phase: '等待 ' + cfg.RESTART_MINUTES + ' 分钟后重开', tone: 'ok' });
const until = Date.now() + cfg.RESTART_MINUTES * 60000;
while (!stop.stopping && Date.now() < until) await sleep(2000);
if (stop.stopping) break;
cleanStaleSingleton(cfg.PROFILE_DIR);
} catch (e) {
if (stop.stopping) break;
// 会话抛错时内部的收尾代码已被跳过,这里补上:否则浏览器进程会残留、端口被占
await disposeActiveSession();
error('会话异常:' + (e && e.message ? e.message : e));
tui.set({ phase: '会话异常,准备重试', tone: 'error' });
// 连登 5 次失败基本都是密码错 / 要验证码,重试没意义,直接用专门的退出码结束
if (e && e.message && /连续 \d+ 次登录失败/.test(e.message)) {
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
await notify({ kind: 'login', finishReason: e.message, completed: 0, elapsed: 0 });
finishTui('登录失败,检查账号密码 / 验证码', 'error');
return { exitCode: 3, last };
}
const waitMs = Math.min(RETRY_BASE_MS * attempt, RETRY_MAX_MS);
const secs = Math.round(waitMs / 1000);
warn('浏览器/连接异常,' + secs + ' 秒后重试(第 ' + attempt + ' 次)');
tui.set({ phase: '会话异常,' + secs + ' 秒后重试', tone: 'warn' });
await sleep(waitMs);
}
}
const stalled = !!(last && /没有任何进展/.test(last.finishReason || ''));
const exitCode = cfg.CHECK_ONLY ? (last && last.ok ? 0 : 1) : (stalled ? 1 : 0);
// 0 = 正常收尾(预算 / 积分完成 / 无更多课程);1 = 无进展卡死;3 = 连续登录失败
const phase = cfg.CHECK_ONLY
? (exitCode === 0 ? '自检通过' : '自检失败')
: stalled ? '退出:长时间无进展' : '正常收尾';
if (last) {
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
await notify(finishResult(last));
}
finishTui(phase, exitCode === 0 ? 'ok' : (stalled ? 'warn' : 'error'));
log('=== 运行器退出 ===');
if (last && last.finishReason) log('结束原因:' + last.finishReason);
if (cfg.CHECK_ONLY && last) log('自检结果:' + (last.ok ? '通过' : '失败 —— ' + last.reason));
// 学习统计只在本次运行内有效(不落盘),退出时在日志里留一行,方便事后回看
const studyLine = typeof tui.studySummary === 'function' ? tui.studySummary() : '';
if (!cfg.CHECK_ONLY && studyLine) log('本次学习:' + studyLine);
return { exitCode, last, tui };
}