新增 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(假时钟口径)
130 lines
5.8 KiB
JavaScript
130 lines
5.8 KiB
JavaScript
#!/usr/bin/env node
|
||
/**
|
||
* 无头运行器入口:在**无图形化环境**里跑云学堂助手。
|
||
* 支持 Linux 服务器(机房机器 / 云主机 / 容器)与 Windows(桌面后台、服务器核心版、
|
||
* 计划任务、Session 0 服务),也能在 macOS 上无头跑。
|
||
*
|
||
* 这个文件只做「组装」:解析参数 → 启动前预检 → 交给 supervisor 跑。
|
||
* 具体实现在同目录的模块里:
|
||
*
|
||
* config.mjs 参数与环境变量(--max / YUN_XUE_TANG_* 全部集中在这里)
|
||
* platform.mjs 平台差异(有无图形会话、沙箱参数、进程树收尾、端口排查命令)
|
||
* preflight.mjs 启动前检查(产物 / Node 版本 / 凭据 / 浏览器 / 端口)
|
||
* log.mjs 终端 + 文件日志(超上限轮转)
|
||
* stop.mjs 终止信号优雅退出(Windows 上按 SIGINT/SIGBREAK/SIGHUP)
|
||
* browser.mjs 浏览器探测、启动参数(root / 容器 / Windows 无人值守适配)、残局清理
|
||
* cdp.mjs 极简 CDP 客户端
|
||
* page.mjs 注入后要调用的页面 JS 表达式 + page 求值封装
|
||
* session.mjs 单次会话:起浏览器 → 注入 → 自动登录 → 刷课 → 监控 → 收尾
|
||
* selfcheck.mjs --check 的只读环境自检
|
||
* supervisor.mjs 崩溃重启循环与退出码
|
||
* tui.mjs 交互式终端面板(框线 + 进度条,q 退出;非 TTY 自动关闭)
|
||
*
|
||
* 用法(详见 README「无头运行」):
|
||
* npm run build # 先出构建产物
|
||
* Linux/macOS: export YUN_XUE_TANG_USR=... export YUN_XUE_TANG_PWD=...
|
||
* Windows CMD: set YUN_XUE_TANG_USR=... set YUN_XUE_TANG_PWD=...
|
||
* Windows PS: $env:YUN_XUE_TANG_USR='...'
|
||
* npm run headless # 前台常驻,Ctrl+C 结束
|
||
* npm run headless:check # 只做环境自检(只读,不登录、不刷课)
|
||
*
|
||
* 常用参数 / 环境变量:
|
||
* --check 只自检:浏览器可启动、页面可访问、脚本可注入、视频编解码可用,
|
||
* 不登录、不点课程、不动进度
|
||
* --max N 本次最多完成 N 门课(0 = 不限,默认读脚本自身配置)
|
||
* --budget N 运行 N 分钟后收尾(0 = 不限,默认 0)
|
||
* --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 追加给浏览器的命令行参数(空格分隔)
|
||
* YUN_XUE_TANG_PREFER_SHORT 1/0,是否优先短课程(默认 1)
|
||
* YUN_XUE_TANG_RESTART_MINUTES 脚本停止/无进展后等待多久重新开始(0 = 直接退出,默认 0)
|
||
* YUN_XUE_TANG_IDLE_RESTART_MINUTES 连续无进展多少分钟后判定卡死(默认 30)
|
||
* 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 连续登录失败
|
||
*/
|
||
import * as cfg from './config.mjs';
|
||
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:打印完整参数表(含配置文件字段、环境变量、当前生效值)后直接退出
|
||
if (cfg.HELP) {
|
||
console.log(cfg.helpText());
|
||
process.exit(0);
|
||
}
|
||
|
||
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({
|
||
checkOnly: cfg.CHECK_ONLY,
|
||
scriptFile: cfg.SCRIPT_FILE,
|
||
usr: cfg.USR,
|
||
pwd: cfg.PWD,
|
||
port: cfg.PORT,
|
||
profileDir: cfg.PROFILE_DIR,
|
||
chromeBin: cfg.CHROME_BIN,
|
||
log,
|
||
});
|
||
} catch (e) {
|
||
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;
|
||
}
|
||
|
||
const { exitCode } = await runSupervisor({
|
||
cfg,
|
||
binary: pre.browser,
|
||
scriptSrc: pre.scriptSrc,
|
||
stop,
|
||
tui,
|
||
log,
|
||
warn,
|
||
error,
|
||
});
|
||
|
||
closeLog();
|
||
process.exit(exitCode);
|
||
}
|
||
|
||
main().catch((e) => {
|
||
error('致命错误:' + (e && e.stack ? e.stack : e));
|
||
closeLog();
|
||
process.exit(1);
|
||
});
|