#!/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); });