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
+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,
|
||||
|
||||
Reference in new issue
Block a user