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:
void committed 2026-10-26 21:49:13 +08:00
1 parent c1e883d67f
commit 65bf63ea6a
17 files changed
+1608 -28

No files matched your search

+26 -3
View File
@@ -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,