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(假时钟口径)
This commit is contained in:
1 parent
c1e883d67f
commit
65bf63ea6a
17 files changed
+1608
-28
No files matched your search
+33
-1
@@ -37,6 +37,8 @@ const DEFAULTS = {
|
||||
profile: '', // 留空 = ./.run-profile
|
||||
logFile: '', // 留空 = ./run-logs/headless.log
|
||||
logMaxBytes: 5 * 1024 * 1024,
|
||||
tui: true, // true = 交互式终端里启用面板;非 TTY 自动退化为逐行日志
|
||||
color: true, // false = 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
|
||||
};
|
||||
|
||||
const argv = process.argv.slice(2);
|
||||
@@ -100,7 +102,7 @@ if (CONFIG_FILE) {
|
||||
// ---------------------------------------------------------------------------
|
||||
// 命令行解析:--key value / --key=value / --flag
|
||||
// ---------------------------------------------------------------------------
|
||||
const BOOL_KEYS = ['preferShort', 'headless', 'check'];
|
||||
const BOOL_KEYS = ['preferShort', 'headless', 'check', 'tui', 'color'];
|
||||
const NUM_KEYS = ['maxCourses', 'budgetMinutes', 'restartMinutes', 'idleRestartMinutes', 'port', 'logMaxBytes'];
|
||||
const STR_KEYS = ['origin', 'url', 'profile', 'logFile', 'chrome', 'extraArgs', 'config'];
|
||||
|
||||
@@ -140,6 +142,8 @@ for (let i = 0; i < argv.length; i++) {
|
||||
let key = toCamel(name);
|
||||
if (ALIASES[name]) key = ALIASES[name];
|
||||
if (name === '--visible') key = 'headless'; // --visible = headless false
|
||||
if (name === '--no-tui') key = 'tui'; // --no-tui = tui false
|
||||
if (name === '--no-color') key = 'color'; // --no-color = color false
|
||||
if (name === '--help' || name === '-h') key = 'help';
|
||||
if (name === '--check') key = 'check';
|
||||
const known = CONFIG_KNOWN.has(key) || key === 'help' || key === 'config';
|
||||
@@ -164,6 +168,7 @@ for (let i = 0; i < argv.length; i++) {
|
||||
continue;
|
||||
}
|
||||
if (name === '--visible') val = String(parseBool(val, name) ? 0 : 1); // --visible 0 → headless 1
|
||||
if (name === '--no-tui' || name === '--no-color') val = String(parseBool(val, name) ? 0 : 1);
|
||||
cliRaw[key] = val;
|
||||
}
|
||||
|
||||
@@ -209,6 +214,8 @@ merged.logFile = envStr('YUN_XUE_TANG_LOG_FILE', merged.logFile);
|
||||
merged.profile = envStr('YUN_XUE_TANG_PROFILE_DIR', merged.profile);
|
||||
merged.chrome = envStr('YUN_XUE_TANG_CHROME_BIN', merged.chrome);
|
||||
merged.extraArgs = envStr('YUN_XUE_TANG_EXTRA_ARGS', merged.extraArgs);
|
||||
merged.tui = envBool('YUN_XUE_TANG_TUI', merged.tui);
|
||||
merged.color = envBool('YUN_XUE_TANG_COLOR', merged.color);
|
||||
|
||||
// 命令行最后覆盖
|
||||
const numBad = [];
|
||||
@@ -291,6 +298,26 @@ export const EXTRA_ARGS = String(merged.extraArgs || '').split(/\s+/).filter(Boo
|
||||
export const CHROME_BIN = merged.chrome || '';
|
||||
export const WARNINGS = configWarnings;
|
||||
|
||||
/** 面板是否带颜色:配置 / 环境变量 / 行业惯例的 NO_COLOR 都生效 */
|
||||
export const COLOR = merged.color && !process.env.NO_COLOR;
|
||||
|
||||
/**
|
||||
* 是否启用终端面板(TUI)。
|
||||
* 三个条件都满足才开:配置没关 + stdout 是交互式终端 + 不是自检模式。
|
||||
* 自检要打印 PASS/FAIL 清单,塞进面板的日志区会看不到,所以强制逐行输出。
|
||||
* 重定向到文件、管道、CI、计划任务里 stdout 不是 TTY,会自然退化。
|
||||
*/
|
||||
export const TUI = !!merged.tui && !CHECK_ONLY && !!process.stdout.isTTY;
|
||||
|
||||
/** 面板没开时,给一句人能看懂的原因(日志里只打一次) */
|
||||
export function tuiDisabledReason() {
|
||||
if (TUI) return '';
|
||||
if (CHECK_ONLY) return '自检模式不启用面板(要逐行看 PASS/FAIL)';
|
||||
if (!merged.tui) return '已按配置 / --no-tui 关闭面板';
|
||||
if (!process.stdout.isTTY) return 'stdout 不是交互式终端(重定向 / 管道 / 服务),改用逐行日志';
|
||||
return '环境不支持终端面板,改用逐行日志';
|
||||
}
|
||||
|
||||
/** 一条便于粘贴到 issue / 日志的自述 */
|
||||
export function describeRun() {
|
||||
return {
|
||||
@@ -306,6 +333,8 @@ export function describeRun() {
|
||||
idleRestartMinutes: IDLE_RESTART_MINUTES,
|
||||
profileDir: PROFILE_DIR,
|
||||
logFile: LOG_FILE,
|
||||
tui: TUI,
|
||||
color: COLOR,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -325,6 +354,8 @@ export function helpText() {
|
||||
['chrome', '--chrome', 'YUN_XUE_TANG_CHROME_BIN', CHROME_BIN || '(自动探测)', '浏览器可执行文件'],
|
||||
['extraArgs', '--extra-args', 'YUN_XUE_TANG_EXTRA_ARGS', EXTRA_ARGS.join(' ') || '(无)', '追加给浏览器的参数'],
|
||||
['profile', '--profile', 'YUN_XUE_TANG_PROFILE_DIR', PROFILE_DIR, '持久化 profile 目录'],
|
||||
['tui', '--no-tui', 'YUN_XUE_TANG_TUI', TUI ? '开' : '关', '交互式终端里的进度面板;非 TTY 自动关闭'],
|
||||
['color', '--no-color', 'YUN_XUE_TANG_COLOR', COLOR ? '开' : '关', '面板是否用 ANSI 颜色(也认 NO_COLOR)'],
|
||||
['logFile', '--log-file', 'YUN_XUE_TANG_LOG_FILE', LOG_FILE, '日志文件'],
|
||||
['logMaxBytes', '--log-max-bytes', 'YUN_XUE_TANG_LOG_MAX_BYTES', LOG_MAX_BYTES, '单文件上限,超出轮转'],
|
||||
['(字段 check)', '--check', '', CHECK_ONLY, '只做环境自检,不动进度'],
|
||||
@@ -349,6 +380,7 @@ export function helpText() {
|
||||
lines.push(' node runner/headless.mjs --check # 只做环境自检');
|
||||
lines.push(' node runner/headless.mjs --max-courses 3 # 本次最多 3 门');
|
||||
lines.push(' node runner/headless.mjs --headless 0 # 开有界面浏览器调试');
|
||||
lines.push(' node runner/headless.mjs --no-tui # 不用面板,回到逐行日志');
|
||||
lines.push(' node runner/headless.mjs --config ./config/runner.config.mjs # 显式指定配置文件');
|
||||
lines.push('');
|
||||
lines.push('旧参数名(仍然兼容):--max / --budget / --restart / --idle / --log / --log-max / --visible');
|
||||
|
||||
+26
-3
@@ -18,6 +18,7 @@
|
||||
* session.mjs 单次会话:起浏览器 → 注入 → 自动登录 → 刷课 → 监控 → 收尾
|
||||
* selfcheck.mjs --check 的只读环境自检
|
||||
* supervisor.mjs 崩溃重启循环与退出码
|
||||
* tui.mjs 交互式终端面板(框线 + 进度条,q 退出;非 TTY 自动关闭)
|
||||
*
|
||||
* 用法(详见 README「无头运行」):
|
||||
* npm run build # 先出构建产物
|
||||
@@ -35,6 +36,8 @@
|
||||
* --profile DIR 持久化 profile 目录(默认 ./.run-profile)
|
||||
* --port N CDP 调试端口(默认 9336)
|
||||
* --visible 不无头(无图形环境里会被忽略;本机调试用)
|
||||
* --no-tui 不用终端面板,回到逐行日志(stdout 非 TTY 时自动如此)
|
||||
* --no-color 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
|
||||
* --url URL 起始页面(默认 https://kfmic.yunxuetang.cn/login.html)
|
||||
* YUN_XUE_TANG_CHROME_BIN Chrome/Chromium 可执行文件路径(默认自动探测)
|
||||
* YUN_XUE_TANG_EXTRA_ARGS 追加给浏览器的命令行参数(空格分隔)
|
||||
@@ -44,6 +47,8 @@
|
||||
* YUN_XUE_TANG_LOG_FILE 日志文件路径(默认 ./run-logs/headless.log)
|
||||
* YUN_XUE_TANG_LOG_MAX_BYTES 单个日志文件上限,超过就轮转成 .1(默认 5MB)
|
||||
* YUN_XUE_TANG_HAS_DISPLAY 0/1,强制认定「有没有图形显示会话」(自动判断不准时用)
|
||||
* YUN_XUE_TANG_TUI 0/1,是否启用终端面板(默认 1,非 TTY 时无效)
|
||||
* YUN_XUE_TANG_COLOR 0/1,面板是否带颜色(也认 NO_COLOR)
|
||||
*
|
||||
* 退出码:0 正常收尾 / 1 无进展卡死 / 2 环境或参数问题 / 3 连续登录失败
|
||||
*/
|
||||
@@ -52,6 +57,7 @@ import { log, warn, error, closeLog } from './log.mjs';
|
||||
import { createStopHandler } from './stop.mjs';
|
||||
import { runPreflight, PreflightError } from './preflight.mjs';
|
||||
import { runSupervisor } from './supervisor.mjs';
|
||||
import { createTui } from './tui.mjs';
|
||||
|
||||
async function main() {
|
||||
// --help:打印完整参数表(含配置文件字段、环境变量、当前生效值)后直接退出
|
||||
@@ -59,11 +65,22 @@ async function main() {
|
||||
console.log(cfg.helpText());
|
||||
process.exit(0);
|
||||
}
|
||||
// 配置文件里有未知字段 / 废弃参数 / 被忽略的凭据:起来先提醒一句,不阻断
|
||||
for (const w of cfg.WARNINGS || []) warn('配置:' + w);
|
||||
|
||||
const stop = createStopHandler({ log });
|
||||
|
||||
// 面板在预检之前就建好:预检的提示也进面板日志区,不会出现「先刷屏再盖住」
|
||||
const tui = createTui({
|
||||
enabled: cfg.TUI,
|
||||
title: '云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : ''),
|
||||
logFile: cfg.CHECK_ONLY ? '' : cfg.LOG_FILE,
|
||||
color: cfg.COLOR,
|
||||
onQuit: (reason) => stop.request(reason),
|
||||
});
|
||||
tui.set({ phase: '环境预检', tone: 'info' });
|
||||
|
||||
// 配置文件里有未知字段 / 废弃参数 / 被忽略的凭据:起来先提醒一句,不阻断
|
||||
for (const w of cfg.WARNINGS || []) warn('配置:' + w);
|
||||
|
||||
let pre;
|
||||
try {
|
||||
pre = await runPreflight({
|
||||
@@ -77,11 +94,16 @@ async function main() {
|
||||
log,
|
||||
});
|
||||
} catch (e) {
|
||||
closeLog();
|
||||
if (e instanceof PreflightError) {
|
||||
tui.set({ phase: '环境预检失败', tone: 'error' });
|
||||
tui.finish();
|
||||
for (const l of e.lines) error(l);
|
||||
warn('修好上面问题后重跑;参数用 --help 查看。');
|
||||
closeLog();
|
||||
process.exit(e.exitCode);
|
||||
}
|
||||
tui.finish();
|
||||
closeLog();
|
||||
throw e;
|
||||
}
|
||||
|
||||
@@ -90,6 +112,7 @@ async function main() {
|
||||
binary: pre.browser,
|
||||
scriptSrc: pre.scriptSrc,
|
||||
stop,
|
||||
tui,
|
||||
log,
|
||||
warn,
|
||||
error,
|
||||
|
||||
+19
-1
@@ -5,11 +5,25 @@
|
||||
// openLog(file, maxBytes); // 不调用就只打终端
|
||||
// log('信息A', { x: 1 }); // → [2026-01-01 00:00:00] [信息] 信息A {"x":1}
|
||||
//
|
||||
// 终端面板(tui.mjs)启用时会把「终端」这一路改道到面板的日志区(setConsoleSink),
|
||||
// 文件那一路始终是纯文本逐行 —— 面板不会污染日志文件,grep / 采集不受影响。
|
||||
//
|
||||
// 注意:openLog 必须在任何写文件之前调用;closeLog 在进程退出路径上兜底调用。
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
|
||||
let stream = null;
|
||||
/** 终端输出目标;null = 直接 console.log(未启用面板时的默认行为) */
|
||||
let consoleSink = null;
|
||||
|
||||
/**
|
||||
* 接管 / 归还终端输出。传 null 恢复逐行 console.log。
|
||||
* sink(level, text) 收到的是完整的一行(不含换行)。
|
||||
* @param {null | ((level: string, text: string) => void)} fn
|
||||
*/
|
||||
export function setConsoleSink(fn) {
|
||||
consoleSink = typeof fn === 'function' ? fn : null;
|
||||
}
|
||||
|
||||
/** 打开日志文件;maxBytes 为单文件上限,超出时把现有文件改名成 .1 */
|
||||
export function openLog(file, maxBytes) {
|
||||
@@ -42,7 +56,11 @@ function line(level, args) {
|
||||
if (typeof a === 'string') return a;
|
||||
try { return JSON.stringify(a); } catch (e) { return String(a); }
|
||||
}).join(' ');
|
||||
console.log(text);
|
||||
if (consoleSink) {
|
||||
try { consoleSink(level, text); } catch (e) { /* 面板异常不影响日志文件 */ }
|
||||
} else {
|
||||
console.log(text);
|
||||
}
|
||||
if (stream) { try { stream.write(text + '\n'); } catch (e) { /* ignore */ } }
|
||||
}
|
||||
|
||||
|
||||
@@ -93,6 +93,16 @@ export const EXPR_SNAPSHOT = `JSON.stringify((function () {
|
||||
lessons: items.length,
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
// 本课程可获得多少学分:平台只把它写在倒计时文案里
|
||||
// 「还需 2小时 7分钟 可完成本课程学习并获得6.52学分,加油!」
|
||||
// 学完后倒计时会消失,所以必须在播放期间就读出来(运行器靠它累计到手学分)
|
||||
credit: (function () {
|
||||
var el = document.querySelector('.yxtulcdsdk-course-player__countdown');
|
||||
if (!el) return null;
|
||||
var t = String(el.innerText || el.textContent || '').replace(/\\s+/g, '');
|
||||
var m = t.match(/获得([0-9]+(?:\\.[0-9]+)?)学分/);
|
||||
return m ? Number(m[1]) : null;
|
||||
})(),
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
doneCount: Object.keys(a.S.completedTitles || {}).length,
|
||||
retryCount: Object.keys(a.S.courseRetries || {}).length,
|
||||
|
||||
+29
-4
@@ -13,6 +13,8 @@ import { runSelfCheck } from './selfcheck.mjs';
|
||||
|
||||
/** 看护循环间隔:既不能太密(CDP 往返),也要能及时补注入 */
|
||||
export const WATCHDOG_MS = 1500;
|
||||
/** 主监控轮询间隔:与面板的 1 秒刷新对齐,画面才不会一帧新一帧旧 */
|
||||
export const MONITOR_MS = 1000;
|
||||
/** 状态读不到多久后判定浏览器不可用 */
|
||||
const STATE_TIMEOUT_MS = 90000;
|
||||
/** 连续多少次登录失败判定为凭据/验证码问题(退出码 3) */
|
||||
@@ -37,11 +39,14 @@ const LOGIN_COOLDOWN_MS = 20000;
|
||||
* @param {string} o.binary 浏览器可执行文件
|
||||
* @param {string} o.scriptSrc 构建产物源码(注入用)
|
||||
* @param {object} o.stop stop.mjs 的 stop 句柄
|
||||
* @param {object} [o.tui] tui.mjs 的面板(不传 / 未启用时所有调用都是空操作)
|
||||
* @param {Function} o.log / o.warn / o.error 日志函数
|
||||
*/
|
||||
export async function runSession(o) {
|
||||
const { cfg, binary, scriptSrc, stop } = o;
|
||||
const log = o.log, warn = o.warn, error = o.error;
|
||||
// 面板是可选件:未启用时 set/snap 都是空操作,这里不需要分支判断
|
||||
const tui = o.tui || { set: () => {}, snap: () => {}, finish: () => {}, enabled: false };
|
||||
|
||||
let browser = null;
|
||||
let cdp = null;
|
||||
@@ -79,6 +84,8 @@ export async function runSession(o) {
|
||||
activeCleanup = async () => { await disposeSession(); unregister(); };
|
||||
|
||||
// ---- 起浏览器 + 建标签页 + 连 CDP ----
|
||||
// 注意:attempt 由 supervisor 管,这里不要传(传 undefined 会把它抹掉)
|
||||
tui.set({ phase: '启动浏览器', tone: 'info' });
|
||||
browser = await launchBrowser({
|
||||
binary,
|
||||
profileDir: cfg.PROFILE_DIR,
|
||||
@@ -88,6 +95,7 @@ export async function runSession(o) {
|
||||
log,
|
||||
});
|
||||
log('浏览器就绪:' + browser.version.Browser + ' profile=' + cfg.PROFILE_DIR);
|
||||
tui.set({ phase: '打开页面', tone: 'info' });
|
||||
|
||||
const target = await httpJson('http://127.0.0.1:' + cfg.PORT + '/json/new?' + encodeURIComponent(cfg.START_URL), 'PUT');
|
||||
const wsUrl = target && target.webSocketDebuggerUrl;
|
||||
@@ -138,6 +146,7 @@ export async function runSession(o) {
|
||||
const t = await page.evalJS('typeof window.__yunXueTangAuto');
|
||||
if (t === 'object') {
|
||||
injected++;
|
||||
tui.set({ injected, phase: '已注入脚本' });
|
||||
log('已注入脚本(第 ' + injected + ' 次):' + String(s.href).slice(0, 90));
|
||||
} else {
|
||||
warn('注入后未生成 window.__yunXueTangAuto(typeof=' + t + ')');
|
||||
@@ -163,6 +172,7 @@ export async function runSession(o) {
|
||||
if (Date.now() - loginLastAt < LOGIN_COOLDOWN_MS) return;
|
||||
loginLastAt = Date.now();
|
||||
loginAttempts++;
|
||||
tui.set({ phase: '自动登录(第 ' + loginAttempts + ' 次)', tone: 'warn' });
|
||||
log('登录页:自动登录(第 ' + loginAttempts + ' 次尝试)');
|
||||
try {
|
||||
const r = await page.evalJS(exprAutoLogin(cfg.USR, cfg.PWD));
|
||||
@@ -175,6 +185,7 @@ export async function runSession(o) {
|
||||
|
||||
if (loginAttempts) {
|
||||
loginAttempts = 0;
|
||||
tui.set({ phase: '已登录,准备刷课', tone: 'ok' });
|
||||
log('已离开登录页,登录成功');
|
||||
}
|
||||
|
||||
@@ -202,12 +213,16 @@ export async function runSession(o) {
|
||||
}
|
||||
if (!st.batchRunning && st.route !== 'other') {
|
||||
const ok = await page.tryEval(exprStartBatch(cfg.PREFER_SHORT));
|
||||
if (ok) log('已启动列表刷课' + (cfg.PREFER_SHORT ? '(优先短课程)' : ''));
|
||||
if (ok) {
|
||||
tui.set({ phase: '刷课中', tone: 'ok' });
|
||||
log('已启动列表刷课' + (cfg.PREFER_SHORT ? '(优先短课程)' : ''));
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
// ---------------- 自检模式 ----------------
|
||||
if (cfg.CHECK_ONLY) {
|
||||
tui.set({ phase: '环境自检中', tone: 'info' });
|
||||
const result = await runSelfCheck({
|
||||
page,
|
||||
tickWatchdog,
|
||||
@@ -260,7 +275,7 @@ export async function runSession(o) {
|
||||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||||
}
|
||||
await sleep(2000);
|
||||
await sleep(MONITOR_MS);
|
||||
continue;
|
||||
}
|
||||
const snap = JSON.parse(raw);
|
||||
@@ -268,10 +283,19 @@ export async function runSession(o) {
|
||||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||||
}
|
||||
await sleep(2000);
|
||||
await sleep(MONITOR_MS);
|
||||
continue;
|
||||
}
|
||||
lastStateAt = Date.now();
|
||||
// 面板每一轮都刷(快照本身就是最新状态,不需要另算);未启用时是空操作
|
||||
tui.snap(snap);
|
||||
if (!finishReason) {
|
||||
if (snap.runFinished) tui.set({ phase: '脚本已停止', tone: 'ok' });
|
||||
else if (snap.retryWait > 0) tui.set({ phase: '等待重试', tone: 'warn' });
|
||||
else if (snap.video && !snap.video.paused) tui.set({ phase: '刷课中', tone: 'ok' });
|
||||
else if (snap.route === 'list') tui.set({ phase: '列表页排队中', tone: 'info' });
|
||||
else tui.set({ phase: '运行中', tone: 'info' });
|
||||
}
|
||||
|
||||
// 编解码器缺失:视频元素有源但解码错误(MEDIA_ERR_DECODE / SRC_NOT_SUPPORTED)
|
||||
if (!codecWarned && snap.video && snap.video.src && snap.video.err >= 3) {
|
||||
@@ -321,12 +345,13 @@ export async function runSession(o) {
|
||||
break;
|
||||
}
|
||||
|
||||
await sleep(2000);
|
||||
await sleep(MONITOR_MS);
|
||||
}
|
||||
|
||||
// ---------------- 收尾 ----------------
|
||||
const elapsed = Math.round((Date.now() - startedAt) / 1000);
|
||||
const final = await page.tryEval(EXPR_FINAL_STATS).then((v) => (v ? JSON.parse(v) : {})).catch(() => ({}));
|
||||
tui.set({ phase: '本次会话结束,收尾中', tone: 'ok', completed: final.completed || 0 });
|
||||
log('本次会话结束:' + (finishReason || '收到退出信号') +
|
||||
' 用时 ' + Math.floor(elapsed / 60) + ' 分 ' + (elapsed % 60) + ' 秒' +
|
||||
' 本次完成 ' + (final.completed || 0) + ' 门,累计 ' + (final.doneCount || 0) + ' 门');
|
||||
|
||||
@@ -4,6 +4,7 @@
|
||||
// const stop = createStopHandler({ log });
|
||||
// const unregister = stop.add(() => browser.kill());
|
||||
// if (stop.stopping) return; // 主循环里轮询这个开关
|
||||
// stop.request('q'); // 面板里按 q 也走同一条收尾路径
|
||||
//
|
||||
// 收尾完成后会 closeLog() 并以 0 退出,所以主循环不用自己处理信号。
|
||||
//
|
||||
@@ -56,6 +57,13 @@ export function createStopHandler(opts = {}) {
|
||||
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; },
|
||||
/** 本平台实际监听的信号列表(自检 / 日志里用) */
|
||||
|
||||
@@ -0,0 +1,111 @@
|
||||
// 学习统计:本次运行学了多久、拿到多少学分。
|
||||
//
|
||||
// 两个口径都是用户能直接验证的,所以规则要写死在这里、别散到面板里:
|
||||
// · 学习时长 = 视频真正在播的累计时间(暂停 / 排队 / 重试退避 / 页面加载都不算)
|
||||
// · 获得学分 = 本次运行里真正刷完的课程能拿到的学分之和(按课程去重)
|
||||
//
|
||||
// 数据都来自 page.mjs 的 EXPR_SNAPSHOT:视频状态来自 <video> 元素,
|
||||
// 学分来自倒计时文案「…可完成本课程学习并获得6.52学分,加油!」。
|
||||
// 学完之后那个倒计时元素就消失了,所以学分必须边播边记进 creditOf。
|
||||
//
|
||||
// 这里不读时钟以外的任何东西,也不太碰终端——所以能脱离浏览器和 TTY 直接测。
|
||||
/** 两次快照间隔超过这个秒数就认为中间断过(浏览器重启 / 进程被挂起),不补计 */
|
||||
const MAX_GAP_SECONDS = 60;
|
||||
|
||||
/**
|
||||
* @param {object} [opts]
|
||||
* @param {Function} [opts.now] 取当前时间(毫秒),测试里可换成假时钟
|
||||
*/
|
||||
export function createStudyTracker(opts = {}) {
|
||||
const now = opts.now || (() => Date.now());
|
||||
|
||||
let studySeconds = 0; // 本次运行累计播放时长(秒)
|
||||
let creditEarned = 0; // 本次运行累计获得学分
|
||||
let credit = null; // 当前这门课学完能拿多少学分(平台只在播放期间写出来)
|
||||
let lastAt = 0; // 上一条快照的时间,用来算两次之间播了多少秒
|
||||
let lastPlaying = false;
|
||||
let lastCompleted = 0;
|
||||
let lastCourse = '';
|
||||
|
||||
const creditOf = new Map(); // 课程名 → 可得学分(学完后元素消失,只能靠缓存)
|
||||
const credited = new Set(); // 已计入的课程,防止重试 / 刷新页面重复累加
|
||||
|
||||
/**
|
||||
* 吃一条主监控快照,返回最新的统计值。
|
||||
* 传进来的快照字段可能缺失(页面刚跳转时就是半空的),所以全部按可选处理。
|
||||
*/
|
||||
function update(snap) {
|
||||
if (!snap || snap.noApi) return get();
|
||||
const at = now();
|
||||
const course = snap.course || '';
|
||||
|
||||
// ---- 学习时长:只算视频真的在播的时间 ----
|
||||
// 用「两次快照的真实间隔」而不是写死的轮询周期:CDP 往返偶尔会慢,
|
||||
// 写死一个常数会让长跑下来明显偏少或偏多。间隔过大说明中间断过,直接丢弃不补计。
|
||||
// 只有「上一帧在播、这一帧也在播」才计:宁可少算一秒,不能把
|
||||
// 暂停后挂机的时间 算成学习时长(挂机好几分钟才是常态)。
|
||||
const playing = !!(snap.video && !snap.video.paused);
|
||||
if (lastPlaying && playing && lastAt > 0) {
|
||||
const gap = (at - lastAt) / 1000;
|
||||
if (gap > 0 && gap <= MAX_GAP_SECONDS) studySeconds += gap;
|
||||
}
|
||||
lastPlaying = playing;
|
||||
lastAt = at;
|
||||
|
||||
// ---- 学分:边播边记「这门课值多少分」----
|
||||
const read = typeof snap.credit === 'number' && snap.credit > 0 ? snap.credit : null;
|
||||
if (read != null) {
|
||||
credit = read;
|
||||
if (course) creditOf.set(course, read);
|
||||
} else if (course && creditOf.has(course)) {
|
||||
credit = creditOf.get(course); // 倒计时消失(学完了)后沿用缓存值
|
||||
} else if (course && course !== lastCourse) {
|
||||
credit = null; // 换课了,新课的学分还没读出来
|
||||
}
|
||||
|
||||
// ---- 学分:只给真正刷完的课发分 ----
|
||||
const completed = Number(snap.completed) || 0;
|
||||
if (completed > lastCompleted) {
|
||||
// 完成数涨了:刚刷完的那门课此刻可能已经从快照里切走,所以用上一次记的课程名
|
||||
const justDone = lastCourse || course;
|
||||
if (justDone && creditOf.has(justDone) && !credited.has(justDone)) {
|
||||
credited.add(justDone);
|
||||
creditEarned += creditOf.get(justDone);
|
||||
}
|
||||
lastCompleted = completed;
|
||||
}
|
||||
if (course) lastCourse = course;
|
||||
|
||||
return get();
|
||||
}
|
||||
|
||||
/** 当前统计值(不会被外部改到内部状态) */
|
||||
function get() {
|
||||
// 学分保留两位小数:平台给的本来就是 0.23 / 6.52 这种,浮点累加会出现 3.7499999
|
||||
return { studySeconds, credit, creditEarned };
|
||||
}
|
||||
|
||||
/** 日志 / 收尾用的一句话(没有数据时返回空串,调用方直接跳过) */
|
||||
function summary() {
|
||||
if (studySeconds <= 0 && creditEarned <= 0) return '';
|
||||
return '视频累计播放 ' + fmt(studySeconds) + ',获得 ' + creditText() + ' 学分';
|
||||
}
|
||||
|
||||
/** 学分文本:整数不带小数点,小数保留最多两位并去掉尾随 0 */
|
||||
function creditText(value) {
|
||||
const v = value === undefined ? creditEarned : value;
|
||||
return String(Number(v.toFixed(2)));
|
||||
}
|
||||
|
||||
return { update, get, summary, creditText, reset() { studySeconds = 0; creditEarned = 0; credit = null; lastAt = 0; lastPlaying = false; lastCompleted = 0; lastCourse = ''; creditOf.clear(); credited.clear(); } };
|
||||
}
|
||||
|
||||
/** 秒 → 1:23:45 / 23:45(与面板显示保持一致,面板自己那份在 tui.mjs) */
|
||||
function fmt(sec) {
|
||||
const s = Math.max(0, Math.round(Number(sec) || 0));
|
||||
const h = Math.floor(s / 3600);
|
||||
const two = (n) => String(n).padStart(2, '0');
|
||||
const m = Math.floor((s % 3600) / 60);
|
||||
const r = s % 60;
|
||||
return h > 0 ? h + ':' + two(m) + ':' + two(r) : two(m) + ':' + two(r);
|
||||
}
|
||||
+50
-10
@@ -1,4 +1,4 @@
|
||||
// 进程层:日志开关、启动横幅、崩溃重启循环、退出码。
|
||||
// 进程层:日志开关、终端面板、启动横幅、崩溃重启循环、退出码。
|
||||
//
|
||||
// 一次会话(session.mjs)只管一个浏览器进程;这里管「崩了就重来」以及「什么情况该放弃」。
|
||||
// 重试等待递增:15s → 30s → 45s …,上限 120s,避免持续失败时疯狂刷 CDP 端口。
|
||||
@@ -7,6 +7,7 @@ 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';
|
||||
|
||||
const RETRY_BASE_MS = 15000;
|
||||
const RETRY_MAX_MS = 120000;
|
||||
@@ -16,7 +17,9 @@ const RETRY_MAX_MS = 120000;
|
||||
* @param {object} o.cfg
|
||||
* @param {string} o.binary
|
||||
* @param {string} o.scriptSrc
|
||||
* @param {object} o.stop
|
||||
* @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) {
|
||||
@@ -26,6 +29,19 @@ export async function runSupervisor(o) {
|
||||
// 自检不写文件日志:避免每次 --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);
|
||||
},
|
||||
});
|
||||
tui.set({ maxCourses: cfg.MAX_COURSES });
|
||||
|
||||
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
|
||||
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
|
||||
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 config/runner.config.mjs,使用内置默认值)'));
|
||||
@@ -35,23 +51,33 @@ export async function runSupervisor(o) {
|
||||
warn(noDisplayReason() + ',配置里的 headless: false 被忽略,强制无头运行。');
|
||||
}
|
||||
if (!cfg.CHECK_ONLY) {
|
||||
log('日志 ' + cfg.LOG_FILE + '(' + (process.platform === 'win32' ? 'Ctrl+C 结束' : 'Ctrl+C 结束') + ')');
|
||||
log('日志 ' + cfg.LOG_FILE + '(Ctrl+C 或面板里按 q 结束)');
|
||||
}
|
||||
if (!cfg.TUI && cfg.tuiDisabledReason) log('面板:' + cfg.tuiDisabledReason());
|
||||
tui.set({ phase: '启动中' });
|
||||
|
||||
let attempt = 0;
|
||||
let last = null;
|
||||
|
||||
/** 收尾时先把面板收掉,退出日志和退出码提示才会逐行打印出来 */
|
||||
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 });
|
||||
last = await runSession({ ...o, cfg, tui });
|
||||
if (stop.stopping) break;
|
||||
if (cfg.CHECK_ONLY) break;
|
||||
// 正常结束:只有「脚本自己停了 / 无进展」且配了重启间隔才再来一轮
|
||||
const restartable = !last.limitReached && 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;
|
||||
@@ -61,20 +87,34 @@ export async function runSupervisor(o) {
|
||||
// 会话抛错时内部的收尾代码已被跳过,这里补上:否则浏览器进程会残留、端口被占
|
||||
await disposeActiveSession();
|
||||
error('会话异常:' + (e && e.message ? e.message : e));
|
||||
tui.set({ phase: '会话异常,准备重试', tone: 'error' });
|
||||
// 连登 5 次失败基本都是密码错 / 要验证码,重试没意义,直接用专门的退出码结束
|
||||
if (e && e.message && /连续 \d+ 次登录失败/.test(e.message)) {
|
||||
finishTui('登录失败,检查账号密码 / 验证码', 'error');
|
||||
return { exitCode: 3, last };
|
||||
}
|
||||
const waitMs = Math.min(RETRY_BASE_MS * attempt, RETRY_MAX_MS);
|
||||
warn('浏览器/连接异常,' + Math.round(waitMs / 1000) + ' 秒后重试(第 ' + attempt + ' 次)');
|
||||
const secs = Math.round(waitMs / 1000);
|
||||
warn('浏览器/连接异常,' + secs + ' 秒后重试(第 ' + attempt + ' 次)');
|
||||
tui.set({ phase: '会话异常,' + secs + ' 秒后重试', tone: 'warn' });
|
||||
await sleep(waitMs);
|
||||
}
|
||||
}
|
||||
|
||||
log('=== 运行器退出 ===');
|
||||
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 ? '退出:长时间无进展' : '正常收尾';
|
||||
finishTui(phase, exitCode === 0 ? 'ok' : (stalled ? 'warn' : 'error'));
|
||||
|
||||
if (cfg.CHECK_ONLY) return { exitCode: last && last.ok ? 0 : 1, last };
|
||||
// 0 = 正常收尾(达到上限 / 预算 / 无更多课程);1 = 无进展卡死
|
||||
if (last && /没有任何进展/.test(last.finishReason || '')) return { exitCode: 1, last };
|
||||
return { exitCode: 0, last };
|
||||
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 };
|
||||
}
|
||||
+558
@@ -0,0 +1,558 @@
|
||||
// 终端面板(TUI):把无头运行器的状态画成一个会自己刷新的框,代替刷屏的逐行日志。
|
||||
//
|
||||
// 设计约束(都很重要,改之前先看一遍):
|
||||
// 1. 只读:面板不提供暂停 / 改配置之类的操作,唯一按键是 q(或 Ctrl+C)优雅退出。
|
||||
// 「改行为」仍然走配置文件 / 环境变量 / 命令行,面板不制造第二套控制入口。
|
||||
// 2. 不碰日志文件:面板只接管「终端」输出(log.mjs 的控制台 sink),
|
||||
// run-logs/*.log 仍然是纯文本逐行,grep / 采集都不受影响。
|
||||
// 3. 自动降级:stdout 不是交互式终端(重定向到文件、CI、计划任务)时完全不启用,
|
||||
// 行为与旧版逐行日志一模一样(见 config.mjs 的 TUI 判断)。
|
||||
//
|
||||
// 重绘方式:不整屏清空,而是「回到本帧首行重画」——面板上方的启动横幅等历史输出
|
||||
// 仍留在回滚区里。技巧是最后一帧不留结尾换行,光标停在帧尾;下次从帧尾向上移动
|
||||
// (行数-1) 行即回到首行,因此永远不会触发终端滚动、也不会闪烁。
|
||||
import { setConsoleSink } from './log.mjs';
|
||||
import { createStudyTracker } from './study.mjs';
|
||||
|
||||
const ESC = '\x1b[';
|
||||
const RESET = ESC + '0m';
|
||||
/** 保留多少行历史日志(终端再高也只显示其中一部分) */
|
||||
const BUFFER_MAX = 200;
|
||||
/** 标签列宽(「倒计时」这类三字标签也放得下) */
|
||||
const LABEL_W = 7;
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 中文对齐:全角字符占 2 列,直接用 String.length 补空格会把边框顶歪
|
||||
// ---------------------------------------------------------------------------
|
||||
function charWidth(ch) {
|
||||
const cp = ch.codePointAt(0);
|
||||
if (cp === 0 || cp < 32 || (cp >= 0x7f && cp < 0xa0)) return 0;
|
||||
if (cp === 0x2329 || cp === 0x232a) return 2;
|
||||
if (cp >= 0x1100 && cp <= 0x115f) return 2;
|
||||
if (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) return 2;
|
||||
if (cp >= 0xac00 && cp <= 0xd7a3) return 2;
|
||||
if (cp >= 0xf900 && cp <= 0xfaff) return 2;
|
||||
if (cp >= 0xfe30 && cp <= 0xfe6f) return 2;
|
||||
if (cp >= 0xff00 && cp <= 0xff60) return 2;
|
||||
if (cp >= 0xffe0 && cp <= 0xffe6) return 2;
|
||||
if (cp >= 0x1f300 && cp <= 0x1f64f) return 2;
|
||||
if (cp >= 0x1f900 && cp <= 0x1f9ff) return 2;
|
||||
if (cp >= 0x20000 && cp <= 0x3fffd) return 2;
|
||||
return 1;
|
||||
}
|
||||
|
||||
/** 字符串在终端里占几列(ANSI 转义序列不计数) */
|
||||
export function textWidth(s) {
|
||||
let w = 0;
|
||||
for (const ch of stripAnsi(s)) w += charWidth(ch);
|
||||
return w;
|
||||
}
|
||||
|
||||
/** 去掉 ANSI 序列(算可见宽度用) */
|
||||
export function stripAnsi(s) {
|
||||
return String(s).replace(/\x1b\[[0-9;]*[A-Za-z]/g, '');
|
||||
}
|
||||
|
||||
const ANSI_RE = /\x1b\[[0-9;]*[A-Za-z]/g;
|
||||
|
||||
/**
|
||||
* 按可见列宽遍历:回调拿到 (token, width),ANSI 转义序列 width=0。
|
||||
* cut / padEnd 都靠它,否则带颜色的字符串会被当成超宽而错误截断。
|
||||
*/
|
||||
function walkWidth(s, fn) {
|
||||
s = String(s);
|
||||
let i = 0;
|
||||
ANSI_RE.lastIndex = 0;
|
||||
let m;
|
||||
while ((m = ANSI_RE.exec(s))) {
|
||||
for (const ch of s.slice(i, m.index)) fn(ch, charWidth(ch));
|
||||
fn(m[0], 0);
|
||||
i = m.index + m[0].length;
|
||||
}
|
||||
for (const ch of s.slice(i)) fn(ch, charWidth(ch));
|
||||
}
|
||||
|
||||
/** 右侧补空格到指定列宽(ANSI 序列不计数) */
|
||||
function padEnd(s, width) {
|
||||
const gap = width - textWidth(s);
|
||||
return gap > 0 ? String(s) + ' '.repeat(gap) : String(s);
|
||||
}
|
||||
|
||||
/** 截断到指定列宽,被截断时末尾用 … 占位(ANSI 序列不计数,截断后补 reset) */
|
||||
function cut(s, width) {
|
||||
s = String(s);
|
||||
if (width <= 0) return '';
|
||||
const plain = stripAnsi(s);
|
||||
if (textWidth(plain) <= width) return s;
|
||||
let out = '';
|
||||
let w = 0;
|
||||
let truncated = false;
|
||||
walkWidth(s, (tok, cw) => {
|
||||
if (truncated) return;
|
||||
if (cw === 0) { out += tok; return; } // ANSI 序列照常透传
|
||||
if (w + cw > width - 1) { truncated = true; return; }
|
||||
out += tok;
|
||||
w += cw;
|
||||
});
|
||||
return out + '…' + (s.includes('\x1b[') ? '\x1b[0m' : '');
|
||||
}
|
||||
|
||||
/** 秒数 → 01:12:45 / 12:45 */
|
||||
export function formatDuration(sec) {
|
||||
const s = Math.max(0, Math.round(Number(sec) || 0));
|
||||
const h = Math.floor(s / 3600);
|
||||
const two = (n) => String(n).padStart(2, '0');
|
||||
const m = Math.floor((s % 3600) / 60);
|
||||
const r = s % 60;
|
||||
return h > 0 ? h + ':' + two(m) + ':' + two(r) : two(m) + ':' + two(r);
|
||||
}
|
||||
|
||||
/** 进度条:█ / ░ 各占 1 列 */
|
||||
export function progressBar(ratio, width) {
|
||||
const r = Math.max(0, Math.min(1, Number(ratio) || 0));
|
||||
const filled = Math.round(r * width);
|
||||
return '█'.repeat(filled) + '░'.repeat(Math.max(0, width - filled));
|
||||
}
|
||||
|
||||
/**
|
||||
* 一组行在宽度 cols 下实际占的屏幕行数。
|
||||
* 终端在窗口变窄时会把超宽的行自己折成多行,所以「逻辑行数」≠「屏幕行数」;
|
||||
* 回退光标、决定清屏起点都得用这个函数,否则窗口一变就会留下半截面板。
|
||||
* 行宽为 0 时算一行(空白行不折)。
|
||||
*/
|
||||
export function visualRows(widths, cols) {
|
||||
const w = Math.max(1, Number(cols) || 80);
|
||||
let total = 0;
|
||||
for (const raw of widths || []) {
|
||||
const width = Number(raw) || 0;
|
||||
total += Math.max(1, Math.ceil(width / w));
|
||||
}
|
||||
return total;
|
||||
}
|
||||
|
||||
/** ANSI 颜色;关闭时全部退化为恒等函数(NO_COLOR / --no-color) */
|
||||
function makeColors(on) {
|
||||
const wrap = (code) => (s) => (on ? ESC + code + 'm' + s + RESET : String(s));
|
||||
return {
|
||||
bold: wrap('1'), dim: wrap('2'), gray: wrap('90'),
|
||||
red: wrap('31'), green: wrap('32'), yellow: wrap('33'),
|
||||
blue: wrap('34'), magenta: wrap('35'), cyan: wrap('36'),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建面板实例。enabled 为 false 时所有方法都是空操作,
|
||||
* 所以上层(supervisor / session)可以无条件调用 tui.set() / tui.snap()。
|
||||
*
|
||||
* @param {object} opts
|
||||
* @param {boolean} opts.enabled 是否启用(由 config.mjs 按 TTY 判断)
|
||||
* @param {Function} [opts.onQuit] 用户按 q / Ctrl+C 时的回调(接到 stop.mjs 上)
|
||||
* @param {string} [opts.title] 标题
|
||||
* @param {string} [opts.logFile] 日志文件路径(面板里显示)
|
||||
* @param {boolean} [opts.color] 是否用 ANSI 颜色(默认看 NO_COLOR)
|
||||
* @param {object} [opts.out] 输出流(测试用,默认 process.stdout)
|
||||
* @param {object} [opts.stdin] 输入流(测试用,默认 process.stdin)
|
||||
*/
|
||||
export function createTui(opts = {}) {
|
||||
const enabled = !!opts.enabled;
|
||||
const out = opts.out || process.stdout;
|
||||
const stdin = opts.stdin || process.stdin;
|
||||
const onQuit = opts.onQuit || (() => {});
|
||||
const colorOn = enabled && opts.color !== false && !process.env.NO_COLOR;
|
||||
const C = makeColors(colorOn);
|
||||
|
||||
const state = {
|
||||
title: opts.title || '云学堂助手 · 无头运行器',
|
||||
phase: '启动中',
|
||||
tone: 'info', // info / ok / warn / error
|
||||
attempt: 1,
|
||||
course: '',
|
||||
lesson: '',
|
||||
summary: '',
|
||||
countdown: null,
|
||||
completed: 0,
|
||||
maxCourses: 0,
|
||||
doneCount: 0,
|
||||
retryCount: 0,
|
||||
retryWait: 0,
|
||||
lessons: 0,
|
||||
video: null,
|
||||
// 学习统计(只在本次运行内累计,退出清零,不落盘)
|
||||
studySeconds: 0, // 学习时长:只累加视频真正在播的时间
|
||||
creditEarned: 0, // 获得学分:只算本次运行里完成(刷完)的课程
|
||||
credit: null, // 当前课程可得多少学分(平台只在播放期间写在倒计时文案里)
|
||||
injected: 0,
|
||||
logFile: opts.logFile || '',
|
||||
startedAt: Date.now(),
|
||||
};
|
||||
|
||||
const buffer = [];
|
||||
// 学时 / 学分累计逻辑在 study.mjs(纯数据,可脱离终端与浏览器单测)
|
||||
const study = createStudyTracker(opts.studyOpts);
|
||||
let timer = null;
|
||||
let resizeTimer = null;
|
||||
let lastLines = 0;
|
||||
// 上一帧每行的「可见列宽」。终端变窄时它会把自己重排(把宽行折成多行),
|
||||
// 所以回退光标时不能只数逻辑行数,得按新宽度算出旧帧实际占了几行。
|
||||
let lastWidths = [];
|
||||
let finished = false;
|
||||
let rawAttached = false;
|
||||
|
||||
// ---------------- 布局 ----------------
|
||||
// 窗口大小每画一帧都重新读:拖动终端、tmux 分屏、浏览器式面板都会改 out.columns / out.rows,
|
||||
// 不做缓存,resize 之后第一帧就是对的。宽度跟终端走(只保留最小 36 列防止破版)。
|
||||
const columns = () => Math.max(36, Number(out.columns) || 80);
|
||||
const rowsOf = () => Math.max(8, Number(out.rows) || 24);
|
||||
|
||||
// 记住上一次实际用过的尺寸。Windows 的 Node 不会在最大化 / 拉伸控制台时发 resize 事件
|
||||
// (libuv 拿不到那边的控制台尺寸变更通知),所以不能只靠事件,必须每次画之前自己比一次。
|
||||
let lastCols = columns();
|
||||
let lastRows = rowsOf();
|
||||
/** 终端尺寸真的变了就记录并报告;缩小需要先清整块(否则旧帧的尾巴会露在框外) */
|
||||
function syncSize() {
|
||||
const cols = columns();
|
||||
const rows = rowsOf();
|
||||
if (cols === lastCols && rows === lastRows) return false;
|
||||
const shrank = cols < lastCols || rows < lastRows;
|
||||
lastCols = cols;
|
||||
lastRows = rows;
|
||||
return shrank;
|
||||
}
|
||||
|
||||
/**
|
||||
* 当前窗口下的行分配。
|
||||
* 矮窗口(<15 行)进紧凑模式:省掉「课时」「日志」两行,先保住视频进度和学时;
|
||||
* 更矮时连日志区和底部 q 提示也省掉——绝不让面板超出窗口,超出会把回滚区里的历史顶掉。
|
||||
*/
|
||||
function layout() {
|
||||
const rows = rowsOf();
|
||||
const compact = rows < 15;
|
||||
const hint = rows >= 10 ? 1 : 0;
|
||||
const infoRows = compact ? 5 : 7; // 状态 / 课程 / 学时 / 视频 / 进度(+ 课时 / 日志)
|
||||
// 1 标题行 + infoRows + 1 分隔行 + room 日志行 + 1 底边框 + hint
|
||||
const slack = rows - (infoRows + 3 + hint);
|
||||
const showLogs = slack >= 1;
|
||||
const room = showLogs ? Math.min(10, slack) : 0;
|
||||
return { rows, compact, hint, showLogs, room };
|
||||
}
|
||||
|
||||
function toneWrap(text) {
|
||||
if (state.tone === 'ok') return C.green(text);
|
||||
if (state.tone === 'warn') return C.yellow(text);
|
||||
if (state.tone === 'error') return C.red(text);
|
||||
return C.cyan(text);
|
||||
}
|
||||
|
||||
function videoValue(width) {
|
||||
const v = state.video;
|
||||
if (!v || !v.d) {
|
||||
if (state.countdown != null) return C.gray('等待视频(倒计时 ' + state.countdown + 's)');
|
||||
return C.gray('—');
|
||||
}
|
||||
const ratio = v.d > 0 ? v.t / v.d : 0;
|
||||
// 窄终端里进度条先缩,仍有地方就按实宽决定加不加时光与状态(不硬截断)
|
||||
const times = formatDuration(v.t) + '/' + formatDuration(v.d);
|
||||
const barW = Math.max(10, Math.min(40, width - 30));
|
||||
const parts = [progressBar(ratio, barW), String(Math.round(ratio * 100)).padStart(3) + '%'];
|
||||
const used = () => textWidth(parts.join(' '));
|
||||
if (used() + 2 + textWidth(times) <= width) parts.push(times);
|
||||
const tail = v.err >= 3 ? C.red('解码失败 error.code=' + v.err) : (v.paused ? C.yellow('暂停') : '');
|
||||
if (tail && used() + 2 + textWidth(tail) <= width) parts.push(tail);
|
||||
return parts.join(' ');
|
||||
}
|
||||
|
||||
function countValue(width) {
|
||||
// 字段按重要性递降:本次/累计是骨架,其余在窄终端里从右往左丢,不硬截断
|
||||
const parts = ['本次 ' + state.completed + (state.maxCourses > 0 ? '/' + state.maxCourses : ''),
|
||||
'累计 ' + state.doneCount];
|
||||
const extra = [];
|
||||
if (state.lessons) extra.push('课时数 ' + state.lessons);
|
||||
if (state.retryWait > 0) extra.push(C.yellow('等待重试 ' + state.retryWait + 's'));
|
||||
else if (state.retryCount > 0) extra.push(C.yellow('待重试 ' + state.retryCount));
|
||||
if (state.countdown != null) extra.push('倒计时 ' + state.countdown + 's');
|
||||
const used = () => textWidth(parts.join(' · '));
|
||||
for (const item of extra) {
|
||||
if (used() + 3 + textWidth(item) > width) break; // +3 = ' · '
|
||||
parts.push(item);
|
||||
}
|
||||
return parts.join(' · ');
|
||||
}
|
||||
|
||||
function statusValue(valueW) {
|
||||
const plain = state.phase + (state.attempt > 1 ? ' · 第 ' + state.attempt + ' 次尝试' : '');
|
||||
const colored = toneWrap(plain);
|
||||
const elapsed = '已运行 ' + formatDuration((Date.now() - state.startedAt) / 1000);
|
||||
const gap = valueW - textWidth(plain) - textWidth(elapsed);
|
||||
if (gap < 2) return cut(colored + (gap > 0 ? ' '.repeat(gap) : '') + ' ' + elapsed, valueW);
|
||||
return colored + ' '.repeat(gap) + C.gray(elapsed);
|
||||
}
|
||||
|
||||
/**
|
||||
* 「学时」行:本次已学时长 + 本次获得学分。
|
||||
* 时长按视频实际播放累计(排队 / 重试 / 加载不算);
|
||||
* 学分只算真正刷完的课程,且按课程去重。窄终端先丢「本门」再截断。
|
||||
*/
|
||||
function studyValue(width) {
|
||||
const parts = [C.cyan('已学 ' + formatDuration(state.studySeconds))];
|
||||
parts.push(C.green('学分 ' + study.creditText(state.creditEarned)));
|
||||
const used = () => textWidth(parts.join(' · '));
|
||||
if (state.credit != null) {
|
||||
const now = '本门 ' + study.creditText(state.credit);
|
||||
if (used() + 3 + textWidth(now) <= width) parts.push(now);
|
||||
}
|
||||
const tail = state.video && state.video.paused ? C.gray('暂停中,不计时') : '';
|
||||
if (tail && used() + 3 + textWidth(tail) <= width) parts.push(tail);
|
||||
return parts.join(' · ');
|
||||
}
|
||||
|
||||
/** 组装一帧的所有行(含 ANSI 色,宽度已按列算好) */
|
||||
function buildFrame() {
|
||||
const cols = columns();
|
||||
const inner = cols - 4; // "│ " + 内容 + " │"
|
||||
const valueW = inner - LABEL_W;
|
||||
|
||||
const row = (label, value) => {
|
||||
const text = padEnd(cut(value, valueW), valueW);
|
||||
return '│ ' + C.dim(padEnd(label, LABEL_W)) + text + ' │';
|
||||
};
|
||||
|
||||
const { compact, hint, showLogs, room } = layout();
|
||||
|
||||
const lines = [];
|
||||
const title = ' ' + cut(state.title, cols - 8) + ' ';
|
||||
lines.push('╭' + title + '─'.repeat(Math.max(0, cols - 2 - textWidth(title))) + '╮');
|
||||
lines.push(row('状态', statusValue(valueW)));
|
||||
lines.push(row('课程', state.course || (state.phase === '启动中' ? '—' : '列表页 / 未识别')));
|
||||
// 学时紧跟在课程后面:挂机时最关心「学了多久、赚了多少」
|
||||
lines.push(row('学时', studyValue(valueW)));
|
||||
// 紧凑模式先丢「课时」「日志」:视频进度和学时才是挂机时真想看的
|
||||
if (!compact) lines.push(row('课时', [state.lesson || '—', state.summary].filter(Boolean).join(' ')));
|
||||
lines.push(row('视频', videoValue(valueW)));
|
||||
lines.push(row('进度', countValue(valueW)));
|
||||
if (!compact) {
|
||||
lines.push(row('日志', [state.logFile || '(未写日志文件)', '已注入 ' + state.injected + ' 次'].join(' · ')));
|
||||
}
|
||||
|
||||
if (showLogs) {
|
||||
const sec = ' 最近日志 ';
|
||||
lines.push('├' + C.dim(sec) + '─'.repeat(Math.max(0, cols - 2 - textWidth(sec))) + '┤');
|
||||
|
||||
const recent = buffer.slice(-room);
|
||||
const blank = '│' + ' '.repeat(cols - 2) + '│';
|
||||
for (let i = recent.length; i < room; i++) lines.push(blank);
|
||||
for (const line of recent) {
|
||||
lines.push('│ ' + C.dim(padEnd(cut(line, inner), inner)) + ' │');
|
||||
}
|
||||
}
|
||||
|
||||
lines.push('╰' + '─'.repeat(Math.max(0, cols - 2)) + '╯');
|
||||
if (hint) lines.push(C.gray(cut(' q 退出(等价 Ctrl+C:暂停视频、停批量、关浏览器)· 完整日志照常写入日志文件', cols)));
|
||||
return lines;
|
||||
}
|
||||
|
||||
/**
|
||||
* 画一帧。尺寸变了就改跑 redraw():终端变窄 / 变矮时,上一帧更宽或更高的字符
|
||||
* 会露在新框外面,必须先整块清掉;变大时旧帧完全被盖住,直接重画就行。
|
||||
*/
|
||||
function render() {
|
||||
if (!enabled || finished) return;
|
||||
// Windows 控制台最大化 / 拖动时不会发 resize 事件,只能在这里发现变化
|
||||
if (syncSize()) redraw();
|
||||
else paint();
|
||||
}
|
||||
|
||||
function paint() {
|
||||
if (!enabled || finished) return;
|
||||
let lines;
|
||||
try {
|
||||
lines = buildFrame();
|
||||
} catch (e) {
|
||||
return; // 面板自身出错绝不能影响刷课
|
||||
}
|
||||
const cols = columns();
|
||||
const maxRows = rowsOf();
|
||||
if (lines.length > maxRows) lines = lines.slice(0, maxRows);
|
||||
|
||||
// 上一帧在当前宽度下实际占的可视行数(窗口没变时它就等于上帧的逻辑行数)
|
||||
const prevRows = visualRows(lastWidths, cols);
|
||||
let buf = '';
|
||||
// 上一帧光标停在帧尾;向上移动 (可视行数-1) 行即回到本帧首行
|
||||
if (prevRows > 0) {
|
||||
const up = Math.max(0, Math.min(prevRows - 1, maxRows - 1));
|
||||
buf += ESC + up + 'A\r';
|
||||
}
|
||||
for (let i = 0; i < lines.length; i++) {
|
||||
// 行尾清到行末(\x1b[K):终端变窄或日志变短时,上一帧的尾巴不会残留
|
||||
buf += lines[i] + ESC + 'K';
|
||||
if (i < lines.length - 1) buf += '\r\n';
|
||||
}
|
||||
buf += ESC + '0J'; // 本帧下方的内容一并清掉(终端变矮时防残留)
|
||||
try { out.write(buf); } catch (e) { /* ignore */ }
|
||||
lastLines = lines.length;
|
||||
lastWidths = lines.map((l) => textWidth(stripAnsi(l)));
|
||||
}
|
||||
|
||||
/**
|
||||
* 硬重绘:终端尺寸变了之后,上次记的帧行数已经不可信(终端可能还自己重排过),
|
||||
* 所以先把光标拉回块首、清掉整块,再按新尺寸画一帧。
|
||||
* 向上移动的步数取 min(上帧行数-1, 当前行数-1):窗口缩到比上帧还矮时不会被顶出屏幕。
|
||||
*/
|
||||
function redraw() {
|
||||
if (!enabled || finished) return;
|
||||
if (lastWidths.length > 0 || lastLines > 0) {
|
||||
const cols = columns();
|
||||
const maxRows = rowsOf();
|
||||
// 关键:用「旧帧在新宽度下会被折成几行」来回退,而不是旧的逻辑行数。
|
||||
// 最大化后再还原(170 列 → 80 列)时,旧帧每行都被折成两行,
|
||||
// 按逻辑行数退会落在旧面板中间,上半截就永远留在屏幕上了。
|
||||
const folded = visualRows(lastWidths, cols);
|
||||
if (folded - 1 > maxRows - 1) {
|
||||
// 旧帧折行后比整个窗口还高:它的起点已经滚到屏幕上方去了,
|
||||
// 光标最多只能退到第一行,退不到块首。这种情况只能整屏重置——
|
||||
// 先把光标匀回左上角再清掉全屏,然后在顶部重画。
|
||||
// (屏幕上方的历史会没,但那些日志本来就在 run-logs/*.log 里)
|
||||
try { out.write(ESC + 'H' + ESC + '2J'); } catch (e) { /* ignore */ }
|
||||
} else {
|
||||
const up = Math.max(0, folded - 1);
|
||||
try { out.write('\r' + (up > 0 ? ESC + up + 'A' : '') + ESC + '0J'); } catch (e) { /* ignore */ }
|
||||
}
|
||||
lastLines = 0; // 光标已经回到块首,paint 不必再回退
|
||||
lastWidths = [];
|
||||
}
|
||||
paint();
|
||||
}
|
||||
|
||||
// ---------------- 键盘:只认 q / Q / Ctrl+C ----------------
|
||||
function onKey(chunk) {
|
||||
for (const ch of String(chunk)) {
|
||||
if (ch === 'q' || ch === 'Q' || ch === '\u0003') {
|
||||
// 先收面板再走退出流程,退出日志才能正常打在面板下面
|
||||
const reason = ch === '\u0003' ? 'Ctrl+C' : 'q';
|
||||
finish();
|
||||
onQuit(reason);
|
||||
return;
|
||||
}
|
||||
if (ch === '\u000c') redraw(); // Ctrl+L 强制重画(终端被外部输出打乱时用)
|
||||
}
|
||||
}
|
||||
|
||||
function attachInput() {
|
||||
if (!enabled || rawAttached) return;
|
||||
if (!stdin || !stdin.isTTY || typeof stdin.setRawMode !== 'function') return;
|
||||
try {
|
||||
stdin.setRawMode(true);
|
||||
stdin.setEncoding('utf8');
|
||||
stdin.on('data', onKey);
|
||||
stdin.resume();
|
||||
rawAttached = true;
|
||||
} catch (e) {
|
||||
rawAttached = false;
|
||||
}
|
||||
}
|
||||
|
||||
function restoreInput() {
|
||||
if (!rawAttached) return;
|
||||
rawAttached = false;
|
||||
try {
|
||||
stdin.off('data', onKey);
|
||||
stdin.setRawMode(false);
|
||||
stdin.pause();
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
// ---------------- 生命周期 ----------------
|
||||
function finish() {
|
||||
if (!enabled || finished) return;
|
||||
finished = true;
|
||||
if (timer) { clearInterval(timer); timer = null; }
|
||||
if (resizeTimer) { clearTimeout(resizeTimer); resizeTimer = null; }
|
||||
if (typeof out.removeListener === 'function') {
|
||||
out.removeListener('resize', onResize);
|
||||
}
|
||||
restoreInput();
|
||||
setConsoleSink(null); // 终端输出恢复逐行,收尾日志才看得见
|
||||
// 摘掉 exit 监听:supervisor 重试用例里同一进程会建多次面板,不摘会触发 MaxListeners 警告
|
||||
try { process.removeListener('exit', finish); } catch (e) { /* ignore */ }
|
||||
try { out.write('\n' + ESC + '?25h'); } catch (e) { /* ignore */ } // 换行 + 显示光标
|
||||
}
|
||||
|
||||
/**
|
||||
* 窗口尺寸变化:拖拽终端时 resize 事件会连发几十次,去抖后再硬重绘。
|
||||
* 注意这条路径只在支持该事件的平台生效(Linux / macOS / Windows Terminal);
|
||||
* Windows 传统控制台(conhost)拖窗口 / 最大化不会发事件,那种情况靠
|
||||
* render() 里的 syncSize() 在 1 秒内发现。两者取其一即可,都碰到也只是多一次重绘。
|
||||
*/
|
||||
function onResize() {
|
||||
if (resizeTimer) clearTimeout(resizeTimer);
|
||||
resizeTimer = setTimeout(() => {
|
||||
resizeTimer = null;
|
||||
lastCols = columns(); // 事件已经告诉我们尺寸变了,直接记录,避免 syncSize 再判一次
|
||||
lastRows = rowsOf();
|
||||
redraw();
|
||||
}, 60);
|
||||
if (typeof resizeTimer.unref === 'function') resizeTimer.unref();
|
||||
}
|
||||
|
||||
function install() {
|
||||
if (!enabled || finished) return;
|
||||
attachInput();
|
||||
try { out.write(ESC + '?25l'); } catch (e) { /* ignore */ } // 隐藏光标
|
||||
// 终端输出改道到面板日志区;文件日志不受影响(log.mjs 里两路分开写)
|
||||
setConsoleSink((level, text) => {
|
||||
buffer.push(text);
|
||||
if (buffer.length > BUFFER_MAX) buffer.splice(0, buffer.length - BUFFER_MAX);
|
||||
// 警告 / 错误立即重绘,普通信息等下一次定时刷新,避免频繁重绘
|
||||
if (level !== '信息') render();
|
||||
});
|
||||
if (typeof out.on === 'function') out.on('resize', onResize);
|
||||
render();
|
||||
timer = setInterval(render, 1000);
|
||||
if (typeof timer.unref === 'function') timer.unref();
|
||||
if (typeof process.on === 'function') process.on('exit', finish);
|
||||
}
|
||||
|
||||
if (enabled) install();
|
||||
|
||||
return {
|
||||
enabled,
|
||||
/** 合并更新面板状态(enabled=false 时是空操作) */
|
||||
set(patch) {
|
||||
if (enabled && patch) Object.assign(state, patch);
|
||||
},
|
||||
/**
|
||||
* 用 session 的主监控快照刷新面板,顺便累计学习时长与学分(详细规则见 study.mjs)。
|
||||
*/
|
||||
snap(s) {
|
||||
if (!enabled || !s || s.noApi) return;
|
||||
const pick = (v, d) => (v === undefined ? d : v);
|
||||
const st = study.update(s);
|
||||
state.studySeconds = st.studySeconds;
|
||||
state.creditEarned = st.creditEarned;
|
||||
state.credit = st.credit;
|
||||
|
||||
state.course = pick(s.course, '');
|
||||
state.lesson = pick(s.lesson, '');
|
||||
state.summary = (s.summary && s.summary.text) || '';
|
||||
state.countdown = s.countdown == null ? null : s.countdown;
|
||||
state.completed = Number(s.completed) || 0;
|
||||
state.doneCount = pick(s.doneCount, 0);
|
||||
state.retryCount = pick(s.retryCount, 0);
|
||||
state.retryWait = pick(s.retryWait, 0);
|
||||
state.lessons = pick(s.lessons, 0);
|
||||
state.video = s.video || null;
|
||||
},
|
||||
render,
|
||||
redraw,
|
||||
finish,
|
||||
/** 学习统计(收尾日志用,与面板显示同一份数据) */
|
||||
get study() { return study.get(); },
|
||||
/** 学习统计的一句话摘要(没有数据时是空串) */
|
||||
studySummary() { return study.summary(); },
|
||||
/** 当前布局分配(自测里断言矮终端降级用) */
|
||||
get layout() { return layout(); },
|
||||
/** 当前状态快照(自检 / 测试用) */
|
||||
get state() { return { ...state }; },
|
||||
/** 已缓存的终端日志行(测试用) */
|
||||
get logLines() { return buffer.slice(); },
|
||||
};
|
||||
}
|
||||
Reference in new issue
Block a user