fix: 移除课程门数上限,避免与每日积分目标冲突

maxCourses 按整门课计数,而积分按课时计;只剩考试的课会白占名额,
曾出现 5 门用光但今日视频积分只拿到 1/3 就停止的情况。现在只由
今日积分完成、没有可学内容或 budgetMinutes 决定收尾。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-02 19:36:57 +08:00
1 parent 0eb4c40629
commit f41fc72fe2
20 files changed
+45 -106

No files matched your search

+2 -2
View File
@@ -3,8 +3,8 @@
YUN_XUE_TANG_USR=
YUN_XUE_TANG_PWD=
# 本次最多完成几门课(docker compose 用;0 / 留空 = 不限)
YUN_XUE_TANG_MAX_COURSES=100
# 本次最多刷多少分钟(0 / 留空 = 不限;Docker 里常用)
YUN_XUE_TANG_BUDGET_MINUTES=0
# 任务结束时推送 Bark 手机通知(正常刷完 / 卡死 / 登录失败)。
# 填 Bark App 里的推送地址(含设备 key),留空 = 不推送。优先级高于 config/runner.config.mjs
+5 -8
View File
@@ -48,7 +48,6 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
| `startClickCooldownMs` | `3000` | 「开始学习」重复点击冷却:3 秒内没起播就补点 |
| `entryGraceMs` | `30000` | 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」 |
| `stuckMs` | `5 分钟` | 连续多久没有计时进展就放弃当前课程 |
| `maxCourses` | `10` | 本次最多完成多少门;`0` = 不限 |
| `maxCourseRetries` | `5` | 同一门课最多重试多少次;超过则停止整轮刷课并提示(不会跳过该课) |
| `courseRetryDelayMs` | `30000` | 首次重试前的等待;每次翻倍,最长 5 分钟 |
| `alignToFirstIncomplete` | `true` | 进入课程先从第一个未学完的课时学起;`false` = 沿用平台上次位置 |
@@ -94,8 +93,8 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
sudo apt install -y chromium # 或安装官方包:google-chrome-stable
# 2. 构建产物
npm install && npm run build
# 3. 调参:改 config/runner.config.mjs(maxCourses、budgetMinutes、preferShort…)
# 只想临时覆盖就用命令行,例如 npm run headless -- --max-courses 3
# 3. 调参:改 config/runner.config.mjs(budgetMinutes、preferShort…)
# 只想临时覆盖就用命令行,例如 npm run headless -- --budget-minutes 15
# 4. 凭据走环境变量(不要写进配置文件)
export YUN_XUE_TANG_USR='你的账号'
export YUN_XUE_TANG_PWD='你的密码'
@@ -238,7 +237,6 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
| 参数 | 环境变量 | 配置文件字段 | 默认 | 作用 |
| --- | --- | --- | --- | --- |
| `--check` | — | (不支持) | 关 | 只做环境自检:浏览器能启动、页面能打开、脚本能注入、视频编解码可用;不登录、不动进度,通过则退出码 0 |
| `--max-courses N`(旧名 `--max`) | `YUN_XUE_TANG_MAX_COURSES` | `maxCourses` | `10` | 本次最多完成 N 门课,`0` = 不限 |
| `--budget-minutes N`(旧名 `--budget`) | `YUN_XUE_TANG_BUDGET_MINUTES` | `budgetMinutes` | `0` | 运行 N 分钟后收尾退出(适合放进 cron 定长跑) |
| `--restart-minutes N`(旧名 `--restart`) | `YUN_XUE_TANG_RESTART_MINUTES` | `restartMinutes` | `0` | 脚本自己停下后等待多少分钟再开新一轮;`0` = 直接退出 |
| `--idle-restart-minutes N`(旧名 `--idle`) | `YUN_XUE_TANG_IDLE_RESTART_MINUTES` | `idleRestartMinutes` | `30` | 连续多少分钟无进展判定卡死 |
@@ -273,7 +271,6 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
```js
// config/runner.config.mjs
export default {
maxCourses: 0, // 0 = 不限,一直刷到没有未学完的课
budgetMinutes: 0, // 0 = 不限运行时长
preferShort: true, // 时长正序选课
restartMinutes: 0, // 0 = 停下就退出
@@ -326,7 +323,7 @@ YUN_XUE_TANG_BARK_URL=https://api.day.app/<key>
- 配了 `restartMinutes` 时,重复的同一结论(例如「今日积分已学完」)只推一次,不会每轮刷屏。
- `--help` 与启动日志里的 key 会打码成 `/***`,避免日志泄露推送权限。
退出码:`0` 正常收尾(达到 `maxCourses` / `budgetMinutes` / 无更多可学课程)、`1` 无进展卡死、
退出码:`0` 正常收尾(`budgetMinutes` 到点 / 今日积分完成 / 无更多可学课程)、`1` 无进展卡死、
`2` 环境或参数问题(缺构建产物、缺凭据、找不到浏览器、端口被占、参数写错)、`3` 连续 5 次登录失败(见 runner/)
(多半是密码错误或站点要求验证码)。
@@ -379,7 +376,7 @@ docker run --rm yun-xue-tang-assistant --check
docker run -d --name yun-xue-tang \
-e YUN_XUE_TANG_USR='你的账号' \
-e YUN_XUE_TANG_PWD='你的密码' \
-e YUN_XUE_TANG_MAX_COURSES=100 \
-e YUN_XUE_TANG_BUDGET_MINUTES=60 \
-v "$PWD/.run-profile:/app/.run-profile" \
-v "$PWD/run-logs:/app/run-logs" \
--shm-size=512m \
@@ -397,7 +394,7 @@ docker stop yun-xue-tang # SIGTERM → 暂停视频 → 停批量
cp .env.example .env # 填 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD
docker compose build
docker compose run --rm yun-xue-tang --check # 自检
docker compose run --rm yun-xue-tang --max-courses 3 # 只刷 3 门,跑完就退
docker compose run --rm yun-xue-tang --budget-minutes 15 # 最多跑 15 分钟
docker compose up -d # 常驻
docker compose logs -f
docker compose down
+1 -3
View File
@@ -14,15 +14,13 @@
*/
export default {
// ---------- 选课 / 刷课策略 ----------
/** 本次最多完成多少门课;0 = 不限(一直刷到没有未学完的课) */
maxCourses: 100,
/** 运行多少分钟后收尾退出;0 = 不限(适合 cron 定长跑时设成 60) */
budgetMinutes: 0,
/** 优先总时长最短的课程(正序);false = 按列表原顺序 */
preferShort: true,
/** 每日积分模式:按课时类型计分(文档1/视频3/音频2/微课2,每次3分),四类封顶即停;false = 普通刷课 */
pointsMode: true,
/** 脚本自己停下后等多少分钟再开新一轮;0 = 直接退出。配合 --max 可以实现分段刷完 */
/** 脚本自己停下后等多少分钟再开新一轮;0 = 直接退出。配合 restartMinutes 可以分段刷完 */
restartMinutes: 0,
/** 连续多少分钟没有任何进展就判定卡死并退出(0 = 用内置的 30 分钟) */
idleRestartMinutes: 30,
+2 -2
View File
@@ -53,7 +53,7 @@ console.log('收尾文案');
{
const done = buildFinishMessage({
kind: 'done',
finishReason: '已完成 10 门(达到上限 maxCourses=10)',
finishReason: '脚本已停止(本次完成 10 门;无更多可学课程)',
completed: 10,
elapsed: 125,
points: { enabled: true, text: '今日积分 15/24 · 文档1/1 视频3/3 音频1/2 微课0/2' },
@@ -61,7 +61,7 @@ console.log('收尾文案');
eq(done.title, '云学堂助手:任务完成', '正常完成标题');
ok(done.body.indexOf('今日积分 15/24') === 0, '正文以今日积分开头');
ok(done.body.indexOf('完成 10 门 · 用时 2 分 5 秒') > 0, '完成门数与用时');
ok(done.body.indexOf('达到上限') > 0, '带上结束原因');
ok(done.body.indexOf('无更多可学课程') > 0, '带上结束原因');
eq(buildFinishMessage({ kind: 'stalled' }).title, '云学堂助手:长时间无进展', '卡死标题');
eq(buildFinishMessage({ kind: 'login' }).title, '云学堂助手:登录失败', '登录失败标题');
+1 -2
View File
@@ -119,7 +119,7 @@ const colored = makeFrame({
lessons: 8,
video: { t: 812, d: 1320, paused: false, err: 0, src: 1 },
});
tui.set({ phase: '刷课中', tone: 'ok', injected: 4, maxCourses: 10 });
tui.set({ phase: '刷课中', tone: 'ok', injected: 4 });
},
});
ok(colored.frame.includes('\x1b['), '彩色帧里确实有 ANSI 序列');
@@ -332,7 +332,6 @@ console.log('可视行换算');
console.log('极端尺寸');
const narrow = makeFrame({ columns: 36, rows: 12, color: true, setup(tui) {
tui.snap({ course: '课程', completed: 3, doneCount: 17, lessons: 8, retryCount: 1, countdown: 812, video: { t: 812, d: 1320, paused: false, err: 0, src: 1 } });
tui.set({ maxCourses: 10 });
}});
for (const line of narrow.lines) {
ok(textWidth(stripAnsi(line)) <= 36, '36 列终端:行宽不超界', String(textWidth(stripAnsi(line))));
+3 -3
View File
@@ -2,7 +2,7 @@
# cp .env.example .env # 填账号密码(.env 已在 .gitignore 里,不会入库)
# docker compose build
# docker compose run --rm yun-xue-tang --check # 先自检(只读,不登录)
# docker compose run --rm yun-xue-tang --max-courses 3 # 只刷 3 门,跑完就退
# docker compose run --rm yun-xue-tang --budget-minutes 15 # 最多跑 15 分钟
# docker compose up -d # 正式后台刷课
# docker compose logs -f # 跟随日志(也可 tail -f ./run-logs/headless.log)
# docker compose down # 停(SIGTERM → 暂停视频 → 关浏览器)
@@ -36,8 +36,8 @@ services:
YUN_XUE_TANG_PWD: "${YUN_XUE_TANG_PWD:-}"
# 面板要求 stdout 是 TTY,后台跑必须关(默认就是关的,这里显式写出来防误改)
YUN_XUE_TANG_TUI: "0"
# 本次最多完成几门课;0 = 不限
YUN_XUE_TANG_MAX_COURSES: "${YUN_XUE_TANG_MAX_COURSES:-100}"
# 本次最多刷多少分钟;0 = 不限
YUN_XUE_TANG_BUDGET_MINUTES: "${YUN_XUE_TANG_BUDGET_MINUTES:-0}"
# 任务结束时推 Bark 手机通知;不填则沿用 config/runner.config.mjs 里的 barkUrl
YUN_XUE_TANG_BARK_URL: "${YUN_XUE_TANG_BARK_URL:-}"
YUN_XUE_TANG_BARK_GROUP: "${YUN_XUE_TANG_BARK_GROUP:-}"
+1 -1
View File
@@ -3,7 +3,7 @@
# 所有实际逻辑仍在 runner/headless.mjs 里,这里不复制任何业务判断,避免两处行为分叉。
#
# docker run 镜像 → 没凭据则 --check(只读自检),有凭据则正式刷课
# docker run 镜像 --max-courses 3 → 参数原样透传给运行器
# docker run 镜像 --budget-minutes 15 → 参数原样透传给运行器
# docker run -it 镜像 sh → 进容器排查
set -e
+4 -12
View File
@@ -23,7 +23,6 @@ export const SCRIPT_FILE = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
// 一层:内置默认值
// ---------------------------------------------------------------------------
const DEFAULTS = {
maxCourses: 0, // 0 = 不限(一直刷到没有未学完的课)
budgetMinutes: 0, // 0 = 不限
preferShort: true,
pointsMode: true, // 每日积分模式:按课时类型计分,四类封顶后停止(文档1/视频3/音频2/微课2)
@@ -56,7 +55,6 @@ const DEPRECATED = {
};
/** 旧参数名 -> 配置字段(保持向后兼容,dev/tests/ 下的脚本还在用) */
const ALIASES = {
'--max': 'maxCourses',
'--budget': 'budgetMinutes',
'--restart': 'restartMinutes',
'--idle': 'idleRestartMinutes',
@@ -110,10 +108,10 @@ if (CONFIG_FILE) {
// 命令行解析:--key value / --key=value / --flag
// ---------------------------------------------------------------------------
const BOOL_KEYS = ['preferShort', 'pointsMode', 'headless', 'check', 'tui', 'color'];
const NUM_KEYS = ['maxCourses', 'budgetMinutes', 'restartMinutes', 'idleRestartMinutes', 'port', 'logMaxBytes', 'barkTtl'];
const NUM_KEYS = ['budgetMinutes', 'restartMinutes', 'idleRestartMinutes', 'port', 'logMaxBytes', 'barkTtl'];
const STR_KEYS = ['origin', 'url', 'profile', 'logFile', 'chrome', 'extraArgs', 'config', 'barkUrl', 'barkGroup'];
/** kebab-case → camelCase:--max-courses → maxCourses */
/** kebab-case → camelCase:--budget-minutes → budgetMinutes */
function toCamel(flag) {
return flag.replace(/^--/, '').replace(/-([a-z])/g, (m, c) => c.toUpperCase());
}
@@ -207,7 +205,6 @@ const envStr = (name, cur) => {
// ---------------------------------------------------------------------------
const merged = { ...DEFAULTS, ...fileConfig };
merged.maxCourses = envNum('YUN_XUE_TANG_MAX_COURSES', merged.maxCourses);
merged.budgetMinutes = envNum('YUN_XUE_TANG_BUDGET_MINUTES', merged.budgetMinutes);
merged.restartMinutes = envNum('YUN_XUE_TANG_RESTART_MINUTES', merged.restartMinutes);
merged.idleRestartMinutes = envNum('YUN_XUE_TANG_IDLE_RESTART_MINUTES', merged.idleRestartMinutes);
@@ -249,7 +246,6 @@ for (const [key, raw] of Object.entries(cliRaw)) {
const problems = [...numBad];
if (numBad.length === 0) {
if (!(merged.port >= 1 && merged.port <= 65535)) problems.push('port 必须在 1-65535 之间,收到 ' + merged.port);
if (!(merged.maxCourses >= 0)) problems.push('maxCourses 不能为负,收到 ' + merged.maxCourses);
if (!(merged.budgetMinutes >= 0)) problems.push('budgetMinutes 不能为负,收到 ' + merged.budgetMinutes);
if (!(merged.restartMinutes >= 0)) problems.push('restartMinutes 不能为负,收到 ' + merged.restartMinutes);
if (!(merged.idleRestartMinutes >= 0)) problems.push('idleRestartMinutes 不能为负,收到 ' + merged.idleRestartMinutes);
@@ -282,8 +278,6 @@ export const START_URL = merged.url ? String(merged.url) : ORIGIN + '/login.html
export const USR = process.env.YUN_XUE_TANG_USR || '';
export const PWD = process.env.YUN_XUE_TANG_PWD || '';
export const PORT = merged.port;
/** 本次最多完成几门课(0 = 不限) */
export const MAX_COURSES = merged.maxCourses;
/** 运行多少分钟后收尾(0 = 不限) */
export const BUDGET_MINUTES = merged.budgetMinutes;
export const PROFILE_DIR = merged.profile
@@ -352,7 +346,6 @@ export function describeRun() {
checkOnly: CHECK_ONLY,
headless: !VISIBLE,
port: PORT,
maxCourses: MAX_COURSES > 0 ? MAX_COURSES : '不限',
budgetMinutes: BUDGET_MINUTES > 0 ? BUDGET_MINUTES : '不限',
preferShort: PREFER_SHORT,
pointsMode: POINTS_MODE,
@@ -370,7 +363,6 @@ export function describeRun() {
export function helpText() {
const rows = [
['配置字段', '命令行', '环境变量', '当前生效', '说明'],
['maxCourses', '--max-courses', 'YUN_XUE_TANG_MAX_COURSES', MAX_COURSES, '本次最多完成几门课;0 = 不限'],
['budgetMinutes', '--budget-minutes', 'YUN_XUE_TANG_BUDGET_MINUTES', BUDGET_MINUTES, '跑多少分钟后收尾;0 = 不限'],
['preferShort', '--prefer-short', 'YUN_XUE_TANG_PREFER_SHORT', PREFER_SHORT, '优先总时长最短的课程'],
['pointsMode', '--points-mode', 'YUN_XUE_TANG_POINTS_MODE', POINTS_MODE, '每日积分模式:文档1/视频3/音频2/微课2,封顶即停'],
@@ -410,11 +402,11 @@ export function helpText() {
lines.push('');
lines.push('示例:');
lines.push(' node runner/headless.mjs --check # 只做环境自检');
lines.push(' node runner/headless.mjs --max-courses 3 # 本次最多 3 门');
lines.push(' node runner/headless.mjs --budget-minutes 15 # 最多跑 15 分钟');
lines.push(' node runner/headless.mjs --headless 0 # 开有界面浏览器调试');
lines.push(' node runner/headless.mjs --no-tui # 不用面板,回到逐行日志');
lines.push(' node runner/headless.mjs --config ./config/runner.config.mjs # 显式指定配置文件');
lines.push('');
lines.push('旧参数名(仍然兼容):--max / --budget / --restart / --idle / --log / --log-max / --visible');
lines.push('旧参数名(仍然兼容):--budget / --restart / --idle / --log / --log-max / --visible');
return lines.join('\n');
}
+1 -2
View File
@@ -7,7 +7,7 @@
* 这个文件只做「组装」:解析参数 → 启动前预检 → 交给 supervisor 跑。
* 具体实现在同目录的模块里:
*
* config.mjs 参数与环境变量(--max / YUN_XUE_TANG_* 全部集中在这里)
* config.mjs 参数与环境变量(--budget / YUN_XUE_TANG_* 全部集中在这里)
* platform.mjs 平台差异(有无图形会话、沙箱参数、进程树收尾、端口排查命令)
* preflight.mjs 启动前检查(产物 / Node 版本 / 凭据 / 浏览器 / 端口)
* log.mjs 终端 + 文件日志(超上限轮转)
@@ -32,7 +32,6 @@
* 常用参数 / 环境变量:
* --check 只自检:浏览器可启动、页面可访问、脚本可注入、视频编解码可用,
* 不登录、不点课程、不动进度
* --max N 本次最多完成 N 门课(0 = 不限,默认读脚本自身配置)
* --budget N 运行 N 分钟后收尾(0 = 不限,默认 0)
* --profile DIR 持久化 profile 目录(默认 ./.run-profile)
* --port N CDP 调试端口(默认 9336)
+1 -6
View File
@@ -63,14 +63,13 @@ export const EXPR_SELF_CHECK = `JSON.stringify((function () {
};
})())`;
/** 看护循环:判断是否需要注入 / 是否在登录页 / 当前 --max 生效值 */
/** 看护循环:判断是否需要注入 / 是否在登录页 */
export const EXPR_WATCH = `JSON.stringify({
href: location.href,
ready: typeof window.__yunXueTangAuto === 'object',
onLogin: !!(window.__yunXueTangAuto && window.__yunXueTangAuto.isLoginPage()),
hasPwd: !!document.querySelector('input[type=password]'),
bodyLen: (document.body && document.body.innerText || '').length,
maxCourses: (window.__yunXueTangAuto && window.__yunXueTangAuto.CFG) ? window.__yunXueTangAuto.CFG.maxCourses : null,
})`;
/** 主监控快照:课程、课时、进度、倒计时、视频状态 */
@@ -137,10 +136,6 @@ export const EXPR_PAUSE_AND_SAVE = `(function () {
return true;
})()`;
/** 把 maxCourses 同步到页面(0 = 不限,必须一并推送) */
export const exprSetMaxCourses = (max) =>
`(function(){ var a = window.__yunXueTangAuto; if (a && a.CFG) a.CFG.maxCourses = ${Number(max)}; return true; })()`;
/** 启动 / 接续批量刷课,同时同步「优先短课程」「每日积分」偏好 */
export const exprStartBatch = (preferShort, pointsMode) => `(function () {
var a = window.__yunXueTangAuto;
+8 -26
View File
@@ -1,13 +1,13 @@
// 单次会话:一个浏览器进程的生命周期。
//
// 顺序:起浏览器 → 建标签页 → 连 CDP → 转发页面日志 → 每 1.5 秒看护
// (补注入 / 自动重登 / 启动批量 / 同步 --max)→ 主监控(进度、卡死、退出条件)→ 收尾。
// (补注入 / 自动重登 / 启动批量)→ 主监控(进度、卡死、退出条件)→ 收尾。
// 崩溃或断线时直接抛错,由 supervisor.mjs 负责重建浏览器。
import { connect, httpJson, sleep } from './cdp.mjs';
import { launchBrowser } from './browser.mjs';
import {
createPage, EXPR_WATCH, EXPR_SNAPSHOT, EXPR_FINAL_STATS, EXPR_PAUSE_AND_SAVE,
exprSetMaxCourses, exprStartBatch, exprAutoLogin,
exprStartBatch, exprAutoLogin,
} from './page.mjs';
import { runSelfCheck } from './selfcheck.mjs';
@@ -57,7 +57,6 @@ export async function runSession(o) {
let loginLastAt = 0;
let finished = false;
let finishReason = '';
let limitReached = false;
let lastSig = '';
let lastStateAt = Date.now();
let codecWarned = false;
@@ -65,8 +64,6 @@ export async function runSession(o) {
// 拿不到主循环的控制流,必须把错误寄存下来,由主循环抛出。
let fatalError = null;
const consoleErrors = [];
/** 是否达到配置的上限(maxCourses=0 表示不限) */
const limitReachedByConfig = (completed) => cfg.MAX_COURSES > 0 && completed >= cfg.MAX_COURSES;
const page = {
evalJS: null, json: null, tryEval: null,
@@ -131,7 +128,7 @@ export async function runSession(o) {
});
// ---------------- 看护循环 ----------------
// 每 WATCHDOG_MS 跑一次:新 document 补注入;掉登录自动重登;启动/接续批量;同步 --max。
// 每 WATCHDOG_MS 跑一次:新 document 补注入;掉登录自动重登;启动/接续批量。
const tickWatchdog = async () => {
if (disconnected || stop.stopping) return;
const s = await page.tryEval(EXPR_WATCH).then((v) => (v ? JSON.parse(v) : null));
@@ -157,12 +154,6 @@ export async function runSession(o) {
return;
}
// 运行策略同步到页面:maxCourses > 0 时覆盖脚本内置的 CFG.maxCourses;
// 配成 0 表示「不限」,也要推 0 过去,否则页面里仍是脚本自己的 10 门上限。
if (s.maxCourses !== null && s.maxCourses !== cfg.MAX_COURSES) {
await page.tryEval(exprSetMaxCourses(cfg.MAX_COURSES));
}
// 掉登录:用环境变量里的账号自动重登(限速 + 次数上限)
if (s.onLogin) {
if (loginAttempts >= MAX_LOGIN_ATTEMPTS) {
@@ -200,13 +191,10 @@ export async function runSession(o) {
const st = JSON.parse(raw);
if (st.batchFinished) {
if (limitReachedByConfig(st.completed)) {
limitReached = true;
finishReason = '已完成 ' + st.completed + ' 门(达到上限 maxCourses=' + cfg.MAX_COURSES + ')';
} else if (cfg.RESTART_MINUTES > 0) {
if (cfg.RESTART_MINUTES > 0) {
finishReason = '脚本已停止(本次完成 ' + st.completed + ' 门),按 YUN_XUE_TANG_RESTART_MINUTES 稍后重新开始';
} else {
finishReason = '脚本已停止(本次完成 ' + st.completed + ' 门;无更多可学课程或达到脚本内上限)';
finishReason = '脚本已停止(本次完成 ' + st.completed + ' 门;无更多可学课程)';
}
finished = true;
return;
@@ -237,7 +225,6 @@ export async function runSession(o) {
}
log('模式:无头 ' + (browser.headless ? 'headless' : '否') +
' 上限 ' + (cfg.MAX_COURSES > 0 ? cfg.MAX_COURSES + ' 门' : '不限') +
' 预算 ' + (cfg.BUDGET_MINUTES > 0 ? cfg.BUDGET_MINUTES + ' 分钟' : '不限') +
' 短课程优先 ' + (cfg.PREFER_SHORT ? '开' : '关') +
' 每日积分 ' + (cfg.POINTS_MODE ? '开' : '关') +
@@ -323,7 +310,7 @@ export async function runSession(o) {
if (snap.lesson) parts.push('课时 ' + String(snap.lesson).slice(0, 24));
if (snap.summary && snap.summary.text) parts.push(String(snap.summary.text).slice(0, 24));
if (snap.countdown != null) parts.push('倒计时 ' + snap.countdown + 's');
parts.push('本次完成 ' + snap.completed + (cfg.MAX_COURSES > 0 ? '/' + cfg.MAX_COURSES : ''));
parts.push('本次完成 ' + snap.completed);
if (snap.retryWait) parts.push('等待重试 ' + snap.retryWait + 's');
else if (snap.retryCount) parts.push('待重试 ' + snap.retryCount);
log(parts.join(' '));
@@ -334,12 +321,7 @@ export async function runSession(o) {
log('✔ 已完成 ' + snap.completed + ' 门(累计记录 ' + snap.doneCount + ' 门)');
}
// 到达上限 / 脚本停止 / 长时间无进展
if (limitReachedByConfig(snap.completed)) {
limitReached = true;
finishReason = '已完成 ' + snap.completed + ' 门(达到上限 maxCourses=' + cfg.MAX_COURSES + ')';
break;
}
// 脚本停止 / 长时间无进展
if (snap.runFinished) { finishReason = '脚本已停止:' + (snap.status || '未知原因'); break; }
if (Date.now() - lastProgressAt > stallLimit) {
finishReason = '超过 ' + Math.round(stallLimit / 60000) + ' 分钟没有任何进展(最后停在 ' +
@@ -366,7 +348,7 @@ export async function runSession(o) {
activeCleanup = null;
return {
finishReason, limitReached, completed: final.completed || 0, elapsed, injected, ok: true,
finishReason, completed: final.completed || 0, elapsed, injected, ok: true,
points: final.points || null,
};
}
+3 -4
View File
@@ -41,7 +41,6 @@ export async function runSupervisor(o) {
else if (typeof stop.request === 'function') stop.request(reason);
},
});
tui.set({ maxCourses: cfg.MAX_COURSES });
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
@@ -102,8 +101,8 @@ export async function runSupervisor(o) {
// 只在最终收尾推就等于永远不推。重复结论由 notify() 的识别键挡掉。
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
await notify(finishResult(last));
// 正常结束:只有「脚本自己停了 / 无进展」且配了重启间隔才再来一轮
const restartable = !last.limitReached && cfg.RESTART_MINUTES > 0;
// 正常结束:配了重启间隔就再来一轮
const restartable = cfg.RESTART_MINUTES > 0;
if (!restartable) break;
log('按 YUN_XUE_TANG_RESTART_MINUTES=' + cfg.RESTART_MINUTES + ' 等待后重新开始…');
tui.set({ phase: '等待 ' + cfg.RESTART_MINUTES + ' 分钟后重开', tone: 'ok' });
@@ -134,7 +133,7 @@ export async function runSupervisor(o) {
const stalled = !!(last && /没有任何进展/.test(last.finishReason || ''));
const exitCode = cfg.CHECK_ONLY ? (last && last.ok ? 0 : 1) : (stalled ? 1 : 0);
// 0 = 正常收尾(达到上限 / 预算 / 无更多课程);1 = 无进展卡死;3 = 连续登录失败
// 0 = 正常收尾(预算 / 积分完成 / 无更多课程);1 = 无进展卡死;3 = 连续登录失败
const phase = cfg.CHECK_ONLY
? (exitCode === 0 ? '自检通过' : '自检失败')
: stalled ? '退出:长时间无进展' : '正常收尾';
+1 -3
View File
@@ -171,7 +171,6 @@ export function createTui(opts = {}) {
summary: '',
countdown: null,
completed: 0,
maxCourses: 0,
doneCount: 0,
retryCount: 0,
retryWait: 0,
@@ -264,8 +263,7 @@ export function createTui(opts = {}) {
function countValue(width) {
// 字段按重要性递降:本次/累计是骨架,其余在窄终端里从右往左丢,不硬截断
const parts = ['本次 ' + state.completed + (state.maxCourses > 0 ? '/' + state.maxCourses : ''),
'累计 ' + state.doneCount];
const parts = ['本次 ' + state.completed, '累计 ' + state.doneCount];
const extra = [];
if (state.lessons) extra.push('课时数 ' + state.lessons);
if (state.retryWait > 0) extra.push(C.yellow('等待重试 ' + state.retryWait + 's'));
+1 -1
View File
@@ -9,7 +9,7 @@ rem
rem Usage:
rem scripts\start-headless.cmd use config\runner.config.mjs
rem scripts\start-headless.cmd --help print all options
rem scripts\start-headless.cmd --max 3 command line overrides config file
rem scripts\start-headless.cmd --budget-minutes 15 command line overrides config file
rem ---------------------------------------------------------------
setlocal
chcp 65001 >nul
+3 -10
View File
@@ -47,16 +47,9 @@ export function completeCurrent() {
pauseAllMedia();
console.log(TAG, '课程完成:', title, '第', S.completedThisRun, '门,返回列表选下一门');
const limit = CFG.maxCourses > 0 ? CFG.maxCourses : Infinity;
if (S.completedThisRun >= limit) {
S.batchRunning = false;
S.batchFinished = true;
saveRunState();
setStatus('本次已完成 ' + S.completedThisRun + ' 门,已停止。可重新勾选开始新一轮。');
} else {
setStatus('课程完成:' + truncate(title, 26) + '(本次 ' + S.completedThisRun + ')');
}
// 不按门数设上限:每日积分模式由 pointsDone() 决定何时收尾,
// 一门课只有考试、没产出积分时也要继续找下一门。
setStatus('课程完成:' + truncate(title, 26) + '(本次 ' + S.completedThisRun + ')');
// 完成后的返回列表不能被 5 秒节流吞掉
later(function () { goToList(true); }, 1200);
}
-1
View File
@@ -6,7 +6,6 @@ export const CFG = {
startClickCooldownMs: 3000, // 「开始学习」重复点击冷却(3 秒内没起播就补点)
entryGraceMs: 30000, // 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」
stuckMs: 5 * 60 * 1000, // 连续多久没有计时进展就放弃当前课程
maxCourses: 10, // 本次最多完成多少门;0 = 不限
maxCourseRetries: 5, // 同一门课最多重试多少次(不跳过课程,超次数就停下整轮刷课)
courseRetryDelayMs: 30000, // 首次重试前的等待;之后每次翻倍,最长 5 分钟
alignToFirstIncomplete: true, // 进入课程先从「第一个未学完的课时」学起;false = 沿用平台上次位置
+1 -1
View File
@@ -78,7 +78,7 @@ try {
Object.defineProperty(window, '__yunXueTangAuto', {
value: {
S, R, state, points, tick, save: saveRunState, flush: flushRunState, route,
// CFG 暴露给无头运行器:可用 --max / YUN_XUE_TANG_MAX_COURSES 覆盖本次运行的门数上限
// CFG 暴露给无头运行器:脚本内可调参数(重试次数、冷却等)
CFG,
mediaPage, courseIdFromUrl,
readCountdown, readSummary,
+1 -1
View File
@@ -29,7 +29,7 @@
* - 进入课程(列表刷课或自己点开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起
* 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。
* 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。
* - 试跑稳定后,把 config.js 里的 CFG.maxCourses 改成 0 即可不限门数(会持续很久)。
* - 不按门数设上限:每日积分模式下按课时类型累计,积分目标完成或没有可学内容时收尾。
* - 脚本不跳过普通课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到
* 需要人工完成的滑块/拼图验证、答题/测验章节、长时间无计时进展)就退避重试:
* 30 秒起每次翻倍、最长 5 分钟,同一门课最多重试 CFG.maxCourseRetries 次,
+2 -3
View File
@@ -1,5 +1,5 @@
// ======== 面板 ========
import { CFG, VERSION, LS_ENABLED, LS_PREFER_SHORT, SS_SHORT_CATALOG, PANEL_ID, TAG } from './config.js';
import { VERSION, LS_ENABLED, LS_PREFER_SHORT, SS_SHORT_CATALOG, PANEL_ID, TAG } from './config.js';
import { R, S, state, points, saveRunState } from './state.js';
import { LS_POINTS_MODE } from './points.js';
import { route } from './route.js';
@@ -47,8 +47,7 @@ export function setStatus(text) {
export function updatePanel() {
if (cbBatch) cbBatch.checked = S.batchRunning;
if (statsEl) {
const limit = CFG.maxCourses > 0 ? CFG.maxCourses : '∞';
let text = '本次 ' + S.completedThisRun + '/' + limit;
let text = '本次 ' + S.completedThisRun;
const retryTitles = Object.keys(S.courseRetries || {}).length;
if (retryTitles) text += ' · 待重试 ' + retryTitles;
if (R.retryWaitUntil && Date.now() < R.retryWaitUntil) {
+4 -15
View File
@@ -29,7 +29,7 @@
* - 进入课程(列表刷课或自己点开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起
* 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。
* 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。
* - 试跑稳定后,把 config.js 里的 CFG.maxCourses 改成 0 即可不限门数(会持续很久)。
* - 不按门数设上限:每日积分模式下按课时类型累计,积分目标完成或没有可学内容时收尾。
* - 脚本不跳过普通课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到
* 需要人工完成的滑块/拼图验证、答题/测验章节、长时间无计时进展)就退避重试:
* 30 秒起每次翻倍、最长 5 分钟,同一门课最多重试 CFG.maxCourseRetries 次,
@@ -81,8 +81,6 @@
// 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」
stuckMs: 5 * 60 * 1e3,
// 连续多久没有计时进展就放弃当前课程
maxCourses: 10,
// 本次最多完成多少门;0 = 不限
maxCourseRetries: 5,
// 同一门课最多重试多少次(不跳过课程,超次数就停下整轮刷课)
courseRetryDelayMs: 3e4,
@@ -1124,8 +1122,7 @@
function updatePanel() {
if (cbBatch) cbBatch.checked = S.batchRunning;
if (statsEl) {
const limit = CFG.maxCourses > 0 ? CFG.maxCourses : "∞";
let text = "本次 " + S.completedThisRun + "/" + limit;
let text = "本次 " + S.completedThisRun;
const retryTitles = Object.keys(S.courseRetries || {}).length;
if (retryTitles) text += " · 待重试 " + retryTitles;
if (R.retryWaitUntil && Date.now() < R.retryWaitUntil) {
@@ -1447,15 +1444,7 @@
invalidateShortCatalog();
pauseAllMedia();
console.log(TAG, "课程完成:", title, "第", S.completedThisRun, "门,返回列表选下一门");
const limit = CFG.maxCourses > 0 ? CFG.maxCourses : Infinity;
if (S.completedThisRun >= limit) {
S.batchRunning = false;
S.batchFinished = true;
saveRunState();
setStatus("本次已完成 " + S.completedThisRun + " 门,已停止。可重新勾选开始新一轮。");
} else {
setStatus("课程完成:" + truncate(title, 26) + "(本次 " + S.completedThisRun + ")");
}
setStatus("课程完成:" + truncate(title, 26) + "(本次 " + S.completedThisRun + ")");
later(function() {
goToList(true);
}, 1200);
@@ -3604,7 +3593,7 @@
save: saveRunState,
flush: flushRunState,
route,
// CFG 暴露给无头运行器:可用 --max / YUN_XUE_TANG_MAX_COURSES 覆盖本次运行的门数上限
// CFG 暴露给无头运行器:脚本内可调参数(重试次数、冷却等)
CFG,
mediaPage,
courseIdFromUrl,