新增无头运行能力,解决 Linux 无图形化服务器上无法常驻的问题;同时改掉 "遇到考试课/无进展课就跳过"的策略,改为在同门课上退避重试。 - runner/:自己起无头 Chromium,用 CDP 把构建产物注入页面主世界(等价 @grant none),不装插件、不需要桌面环境或 Xvfb;含浏览器探测与启动参数、 持久化 profile、陈旧 SingletonLock 清理、优雅退出、日志轮转、启动预检 - runner.config.mjs / start-headless.cmd:通用配置 + Windows 一键入口; 凭据只走 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD 环境变量 - src/exam.js:含考试章节的课程自动进考试 → 开始/继续 → 空卷提交 → 确定, 交卷后靠平台记账推进课程;maxExamTries 限制同门课交卷次数,防不记账时死循环 - 去掉跳过与黑名单:没学完就退避重试(30s 起翻倍,最长 5 分钟), 同门课超过 maxCourseRetries 次才停整轮并提示,替代原 maxConsecutiveFailures - 每完成一门都重新拉列表接口取平台实时状态再选下一门,避免用陈旧队列 - 学习进度改存 sessionStorage(yun-xue-tang-run-state-v3),整页跳转/刷新可续; 运行开关不跨会话,浏览器重启后必须显式开跑 - dev/:新增 real-cdp / real-run / real-test / real-e2e 实跑脚本与 check.mjs 统一静态检查(JS 22 + 批处理 2),替代逐文件 node --check - docs/evidence/headless-linux-evidence.txt + 实跑截图,README 补无头部署章节
107 lines
4.7 KiB
JavaScript
107 lines
4.7 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 崩溃重启循环与退出码
|
||
*
|
||
* 用法(详见 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 不无头(无图形环境里会被忽略;本机调试用)
|
||
* --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,强制认定「有没有图形显示会话」(自动判断不准时用)
|
||
*
|
||
* 退出码: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';
|
||
|
||
async function main() {
|
||
// --help:打印完整参数表(含配置文件字段、环境变量、当前生效值)后直接退出
|
||
if (cfg.HELP) {
|
||
console.log(cfg.helpText());
|
||
process.exit(0);
|
||
}
|
||
// 配置文件里有未知字段 / 废弃参数 / 被忽略的凭据:起来先提醒一句,不阻断
|
||
for (const w of cfg.WARNINGS || []) warn('配置:' + w);
|
||
|
||
const stop = createStopHandler({ log });
|
||
|
||
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) {
|
||
closeLog();
|
||
if (e instanceof PreflightError) {
|
||
for (const l of e.lines) error(l);
|
||
process.exit(e.exitCode);
|
||
}
|
||
throw e;
|
||
}
|
||
|
||
const { exitCode } = await runSupervisor({
|
||
cfg,
|
||
binary: pre.browser,
|
||
scriptSrc: pre.scriptSrc,
|
||
stop,
|
||
log,
|
||
warn,
|
||
error,
|
||
});
|
||
|
||
closeLog();
|
||
process.exit(exitCode);
|
||
}
|
||
|
||
main().catch((e) => {
|
||
error('致命错误:' + (e && e.stack ? e.stack : e));
|
||
closeLog();
|
||
process.exit(1);
|
||
});
|