maxCourses 按整门课计数,而积分按课时计;只剩考试的课会白占名额, 曾出现 5 门用光但今日视频积分只拿到 1/3 就停止的情况。现在只由 今日积分完成、没有可学内容或 budgetMinutes 决定收尾。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
134 lines
6.2 KiB
JavaScript
134 lines
6.2 KiB
JavaScript
#!/usr/bin/env node
|
||
/**
|
||
* 无头运行器入口:在**无图形化环境**里跑云学堂助手。
|
||
* 支持 Linux 服务器(机房机器 / 云主机 / 容器)与 Windows(桌面后台、服务器核心版、
|
||
* 计划任务、Session 0 服务),也能在 macOS 上无头跑。
|
||
*
|
||
* 这个文件只做「组装」:解析参数 → 启动前预检 → 交给 supervisor 跑。
|
||
* 具体实现在同目录的模块里:
|
||
*
|
||
* config.mjs 参数与环境变量(--budget / 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 只自检:浏览器可启动、页面可访问、脚本可注入、视频编解码可用,
|
||
* 不登录、不点课程、不动进度
|
||
* --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);
|
||
});
|