#!/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 的只读环境自检 * notify.mjs 任务结束时的 Bark 手机通知 * 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_POINTS_MODE 1/0,每日积分模式(默认 1;文档1/视频3/音频2/微课2,封顶即停) * 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) * YUN_XUE_TANG_BARK_URL Bark 推送地址(含设备 key);留空 = 不推送 * YUN_XUE_TANG_BARK_GROUP Bark 通知分组(默认 Bark 自己的分组) * YUN_XUE_TANG_BARK_TTL Bark 通知在服务端保留多少秒(0 = 默认) * * 退出码: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); });