Files
yun-xue-tang-assistant/runner.config.mjs
T
void ae117222df 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 补无头部署章节
2026-10-25 23:04:40 +08:00

50 lines
2.4 KiB
JavaScript
Raw 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.
/**
* 无头运行器配置文件(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,
};