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

+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