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 补无头部署章节
This commit is contained in:
void committed 2026-10-25 23:04:40 +08:00
1 parent 8193326b70
commit ae117222df
47 files changed
+6198 -837

No files matched your search

+51
View File
@@ -0,0 +1,51 @@
// 日志:同时写终端和日志文件(文件超上限就轮转成 .1)。
//
// 用法:
// import { openLog, closeLog, log, warn, error } from './log.mjs';
// openLog(file, maxBytes); // 不调用就只打终端
// log('信息A', { x: 1 }); // → [2026-01-01 00:00:00] [信息] 信息A {"x":1}
//
// 注意:openLog 必须在任何写文件之前调用;closeLog 在进程退出路径上兜底调用。
import fs from 'node:fs';
import path from 'node:path';
let stream = null;
/** 打开日志文件;maxBytes 为单文件上限,超出时把现有文件改名成 .1 */
export function openLog(file, maxBytes) {
try {
fs.mkdirSync(path.dirname(file), { recursive: true });
try {
const st = fs.statSync(file);
if (st.size > maxBytes) fs.renameSync(file, file + '.1');
} catch (e) { /* 文件还不存在 */ }
stream = fs.createWriteStream(file, { flags: 'a' });
} catch (e) {
console.error('[日志] 无法写入 ' + file + ':' + e.message);
}
}
/** 关闭日志文件(可重复调用) */
export function closeLog() {
if (!stream) return;
try { stream.end(); } catch (e) { /* ignore */ } finally { stream = null; }
}
export function isLogOpen() {
return stream !== null;
}
const clock = () => new Date().toISOString().replace('T', ' ').slice(0, 19);
function line(level, args) {
const text = '[' + clock() + '] [' + level + '] ' + args.map(function (a) {
if (typeof a === 'string') return a;
try { return JSON.stringify(a); } catch (e) { return String(a); }
}).join(' ');
console.log(text);
if (stream) { try { stream.write(text + '\n'); } catch (e) { /* ignore */ } }
}
export const log = (...a) => line('信息', a);
export const warn = (...a) => line('警告', a);
export const error = (...a) => line('错误', a);