Files
yun-xue-tang-assistant/runner/headless.mjs
T
void ae117222df feat: v2.8.0 无头运行器、考试自动交卷、改为退避重试不跳课
新增无头运行能力,解决 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 补无头部署章节
2026-10-25 23:04:40 +08:00

107 lines
4.7 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/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);
});