Files
voidandClaude Sonnet 4.6 6b508a0b1a feat: Bark 增加开始运行与获得学分提醒
收尾通知去掉重复的积分台账与完成门数;学习统计在无 TTY 时照常累计,保证 Docker 里也能推送学分提醒。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-11-02 22:30:11 +08:00

134 lines
6.2 KiB
JavaScript
Raw Permalink 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 参数与环境变量(--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);
});