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

+49
View File
@@ -0,0 +1,49 @@
/**
* 无头运行器配置文件(JS 模块,可以写注释、也可以写表达式)。
*
* 生效优先级(后者覆盖前者):
* 内置默认值 < 本文件 < 环境变量 YUN_XUE_TANG_* < 命令行参数 --x
*
* 账号密码不在这里:仍然只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,
* 这样本文件可以放心提交,也不会出现在 `ps` / 任务管理器 / 计划任务历史里。
*
* 改完直接重新运行 `node runner/headless.mjs` 即生效,不需要 npm run build
* (build 只打包注入浏览器的 src/ 脚本)。
*
* 每一项的覆盖方式见 README「无头运行 → 配置文件」;`--help` 会打印带默认值的完整清单。
*/
export default {
// ---------- 选课 / 刷课策略 ----------
/** 本次最多完成多少门课;0 = 不限(一直刷到没有未学完的课) */
maxCourses: 10,
/** 运行多少分钟后收尾退出;0 = 不限(适合 cron 定长跑时设成 60) */
budgetMinutes: 0,
/** 优先总时长最短的课程(正序);false = 按列表原顺序 */
preferShort: true,
/** 脚本自己停下后等多少分钟再开新一轮;0 = 直接退出。配合 --max 可以实现分段刷完 */
restartMinutes: 0,
/** 连续多少分钟没有任何进展就判定卡死并退出(0 = 用内置的 30 分钟) */
idleRestartMinutes: 30,
// ---------- 站点 / 浏览器 ----------
/** 站点根地址(换分公司环境只改这一行) */
origin: 'https://kfmic.yunxuetang.cn',
/** 起始页面;留空 = <origin>/login.html */
url: '',
/** CDP 调试端口;同机跑多个实例时分开 */
port: 9336,
/** true = 无头(默认);false = 开有界面浏览器,需要图形会话,没有时会被强制无头 */
headless: true,
/** Chrome/Chromium 可执行文件路径;留空 = 自动探测 */
chrome: '',
/** 追加给浏览器的命令行参数(空格分隔),例如 '--proxy-server=socks5://127.0.0.1:1080' */
extraArgs: '',
// ---------- 文件 / 日志 ----------
/** 持久化 profile 目录(cookie / localStorage);留空 = ./.run-profile,删掉即重置登录态 */
profile: './.run-profile',
/** 日志文件;留空 = ./run-logs/headless.log */
logFile: './run-logs/headless.log',
/** 单个日志文件上限(字节),超出后轮转成 .1 */
logMaxBytes: 5 * 1024 * 1024,
};