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');
|
||||
|
||||
Reference in new issue
Block a user