feat: 每日积分模式与 Bark 完成提醒

- 按课时类型计分:文档 1 / 视频 3 / 音频 2 / 微课 2,每次 3 分,单日封顶 24 分;满额换类,无内容即停
- 积分计数落 localStorage,跨刷新/重启保留、跨天清零;面板与无头 TUI 都显示今日积分
- 运行器自己收尾时通过 Bark 推送今日积分、完成门数、用时和结束原因;手动停止与 --check 不推送
- 新增 --points-mode / --bark-* 参数及对应 YUN_XUE_TANG_* 环境变量
- 补充 points / notify 离线回归测试与 OpenSpec 配置

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-01 22:19:52 +08:00
1 parent 17217dbeb1
commit 0eb4c40629
31 files changed
+2954 -21

No files matched your search

+55
View File
@@ -20,6 +20,7 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
| 防挂机验证 | 识别「已触发防挂机验证」弹窗并点「继续学习」;滑块/拼图类验证不绕过,提示人工处理 |
| 课程列表自动刷课 | 在列表页逐门进入未学完的课程;每完成一门都重新调列表接口拿平台实时状态再选下一门,本次门数上限见下方配置表 |
| 短课程优先 | 列表刷课默认按课程总时长**从短到长**选课(跨页),先完成 1 分钟的课再学 1 小时的课;面板可关闭 |
| 每日积分模式 | 按**课时类型**计分:文档 1 次、视频 3 次、音频 2 次、微课 2 次,每次 3 分,单日封顶 24 分。先补文档/音频/微课单条内容,视频额度靠课程里的视频课时;某类满额自动切下一类,四类都满(或剩余类型没内容)就停止刷课。计数存 localStorage、跨刷新/重启不丢、跨天清零;面板可随时关闭 |
| 考试自动空卷 | 含考试章节的课程不再跳过:自动点进考试节 → 开始/继续考试 → 一题不做直接「提交考试」→ 点「确定」交卷,交卷后课程进度被平台记账,课程即可完成。只有本页真的点过「提交考试/确定交卷」,看到的结果页才算一次交卷;平台恢复的旧结果页会先回「考试说明页」重新进入,不会在结果页和课程页之间空转。同一门课最多交卷 `maxExamTries` 次,超过仍不记账就跳过该课继续下一门(写明原因) |
| 不跳过普通课程 | 没有任何「跳过本课」入口,也不会把普通课程加入黑名单;没学完就退避重试(30 秒起翻倍,最长 5 分钟),同一门课最多重试 `maxCourseRetries` 次,超过才停下整轮刷课并提示原因,等人工处理。**唯一例外**:考试空卷交卷达到 `maxExamTries` 仍未计入进度,或考试页始终没有可点的「开始考试/提交考试」——继续重试只会反复进同一门课,因此本轮跳过它、继续刷其它课 |
| 进度可续 | 学习进度存在 `sessionStorage`(`yun-xue-tang-run-state-v3`),整页跳转/刷新后继续上次的队列和页码;**运行开关不跨会话** —— 浏览器重启、运行器新建标签页后一律回到待机,必须显式开跑(避免未登录就报「运行中」) |
@@ -52,6 +53,7 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
| `courseRetryDelayMs` | `30000` | 首次重试前的等待;每次翻倍,最长 5 分钟 |
| `alignToFirstIncomplete` | `true` | 进入课程先从第一个未学完的课时学起;`false` = 沿用平台上次位置 |
| `preferShortCourses` | `true` | 列表刷课时优先总时长更短的课程(正序);面板勾选框「优先短课程(时长正序)」可随时切换 |
| `pointsEnabled`(`localStorage`) | `true` | 每日积分模式:文档 1 / 视频 3 / 音频 2 / 微课 2(每次 3 分,封顶 24 分);面板勾选框「每日积分模式」可随时切换 |
| `maxExamTries` | `2` | 同一门课「空卷交卷」的最大次数;超过仍没计入进度就本轮跳过该课、继续下一门(记录在会话里,重启后会重新尝试) |
| `examClickCooldownMs` | `1500` | 考试页内两次点击的间隔(毫秒) |
@@ -63,6 +65,11 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
逐个进入。接口不可用(未登录、跨域、平台改版)时自动降级为「当前页按时长正序」,
再不行就回到原来的列表顺序,不会让刷课任务卡住。
每日积分模式按**课时**计数:多课时课程里每学完一节视频/文档/音频/微课各算一次,
单视频/音频/课件播放页学完也算一次。某类满额后自动换下一类;四类都满额,
或剩余额度的类型在当前目录里确认没有内容时,停止刷课并在面板/日志里汇报今日积分。
识别不出类型的课时(例如考试节)不计分;同一课时当天重复上报只算一次。
## 无头运行(Linux / Windows 服务器)
用 `runner/headless.mjs` 把整套逻辑跑在一个无头 Chromium 里:自己起浏览器、用 CDP 把构建产物
@@ -236,6 +243,7 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
| `--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` | 连续多少分钟无进展判定卡死 |
| `--prefer-short 0\|1` | `YUN_XUE_TANG_PREFER_SHORT` | `preferShort` | `1` | 是否优先短课程(时长正序) |
| `--points-mode 0\|1` | `YUN_XUE_TANG_POINTS_MODE` | `pointsMode` | `1` | 每日积分模式:文档1/视频3/音频2/微课2,封顶即停 |
| `--headless 0\|1`(旧名 `--visible`) | `YUN_XUE_TANG_HEADLESS` | `headless` | `1` | `1` = 无头;`0` = 开有界面浏览器(仅本机调试;无图形会话时被忽略并强制无头) |
| `--origin URL` | `YUN_XUE_TANG_ORIGIN` | `origin` | `https://kfmic.yunxuetang.cn` | 站点根地址(换分公司环境时改这个) |
| `--url URL` | `YUN_XUE_TANG_URL` | `url` | `<origin>/login.html` | 起始页面 |
@@ -245,6 +253,9 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
| `--extra-args "…"` | `YUN_XUE_TANG_EXTRA_ARGS` | `extraArgs` | 空 | 追加给浏览器的命令行参数(空格分隔) |
| `--log-file PATH`(旧名 `--log`) | `YUN_XUE_TANG_LOG_FILE` | `logFile` | `./run-logs/headless.log` | 日志文件路径 |
| `--log-max-bytes N`(旧名 `--log-max`) | `YUN_XUE_TANG_LOG_MAX_BYTES` | `logMaxBytes` | `5242880` | 单文件上限,超出轮转 |
| `--bark-url URL` | `YUN_XUE_TANG_BARK_URL` | `barkUrl` | 空 | Bark 推送地址(含设备 key),运行器自己收尾时推手机通知;空 = 不推送 |
| `--bark-group NAME` | `YUN_XUE_TANG_BARK_GROUP` | `barkGroup` | 空 | Bark 通知分组(App 里按组折叠) |
| `--bark-ttl N` | `YUN_XUE_TANG_BARK_TTL` | `barkTtl` | `0` | 通知在 Bark 服务端保留多少秒;`0` = 默认 |
| `--no-tui` | `YUN_XUE_TANG_TUI` | `tui` | 开 | `1`/`0`,是否在终端显示实时面板;stdout 不是 TTY 时自动关闭 |
| `--no-color` | `YUN_XUE_TANG_COLOR` | `color` | 开 | `1`/`0`,面板是否带 ANSI 颜色(也认 `NO_COLOR`) |
| `--config PATH` | `YUN_XUE_TANG_CONFIG` | — | `./config/runner.config.mjs` | 指定另一个配置文件 |
@@ -280,6 +291,41 @@ export default {
- 个人机器的差异建议放 `runner.local.mjs`(已在 `.gitignore` 里)并用 `--config ./runner.local.mjs`
- 配置文件里写 `username` / `password` 会被**忽略并告警**(凭据只认环境变量);写未知字段也会告警
### 完成提醒(Bark)
运行器**自己结束**时(正常刷完 / 达到上限 / 长时间无进展 / 连续登录失败)会推一条
[Bark](https://github.com/Finb/Bark) 手机通知,正文是今日积分、完成门数、用时和结束原因:
```json
{
"title": "云学堂助手:任务完成",
"body": "今日积分 15/24 · 文档1/1 视频3/3 音频1/2 微课0/2\n完成 4 门 · 用时 18 分 6 秒\n脚本已停止:今日积分:可用内容已学完"
}
```
配置(三选一,优先级从低到高):
```js
// config/runner.config.mjs
barkUrl: 'https://api.day.app/<你的设备 key>', // 也接受带 {title}/{body} 的完整模板
barkGroup: '云学堂助手', // 通知分组
barkTtl: 600, // 服务端保留秒数
```
```sh
YUN_XUE_TANG_BARK_URL=https://api.day.app/<key> YUN_XUE_TANG_BARK_GROUP=云学堂助手 node runner/headless.mjs
```
```sh
# 环境变量优先级最高;Docker 里写进 .env 即可(.env 不入库)
YUN_XUE_TANG_BARK_URL=https://api.day.app/<key>
```
- 手动 `Ctrl+C` 主动停止**不推送**(人在终端前,不需要再提醒);`--check` 自检也不推送。
- 推送失败只在日志里告警(网络不通 / key 错),不影响运行器退出码。
- 配了 `restartMinutes` 时,重复的同一结论(例如「今日积分已学完」)只推一次,不会每轮刷屏。
- `--help` 与启动日志里的 key 会打码成 `/***`,避免日志泄露推送权限。
退出码:`0` 正常收尾(达到 `maxCourses` / `budgetMinutes` / 无更多可学课程)、`1` 无进展卡死、
`2` 环境或参数问题(缺构建产物、缺凭据、找不到浏览器、端口被占、参数写错)、`3` 连续 5 次登录失败(见 runner/)
(多半是密码错误或站点要求验证码)。
@@ -438,6 +484,7 @@ runner/ 无头运行器(Linux / Windows,无图形
page.mjs 页面求值封装与注入后调用的表达式
session.mjs 单次会话:起浏览器 / 注入 / 自动重登 / 崩溃自愈
selfcheck.mjs --check 只读环境自检
notify.mjs 任务结束时的 Bark 手机通知
tui.mjs 终端面板(框线 + 进度条,q 退出,非 TTY 自动关闭)
study.mjs 学习统计(本次播放时长 / 获得学分)
supervisor.mjs 崩溃重启循环与退出码
@@ -471,6 +518,8 @@ docs/
| `yun-xue-tang-login-v1` | 勾选「记住密码」时的账号密码(base64 混淆,**不是加密**) |
| `yun-xue-tang-auto-play-enabled` | 「当前课程自动连播」开关 |
| `yun-xue-tang-prefer-short` | 「优先短课程(时长正序)」开关(`1` / `0`) |
| `yun-xue-tang-daily-points-mode` | 「每日积分模式」开关(`1` / `0`) |
| `yun-xue-tang-daily-points-v1` | 今日积分计数(按本地日期自动清零,含当天已计分的课时去重表) |
| `yun-xue-tang-target-catalog-url` | 目标目录 URL:决定刷哪个学院/目录的课(短课程队列的缓存键也来自它) |
| `yun-xue-tang-auto-start-after-login` | 登录后自动开始刷课的一次性标记(5 分钟内有效) |
@@ -478,6 +527,7 @@ docs/
| --- | --- |
| `yun-xue-tang-run-state-v3` | 本轮是否在跑、页码、当前课程、本轮已完成 / 待重试 / 已跳过(考试交不了)记录 |
| `yun-xue-tang-short-catalog-v1` | 短课程时长队列缓存(TTL 5 分钟) |
| `yun-xue-tang-points-inventory-v1` | 文档/音频/微课单条内容库存缓存(TTL 5 分钟) |
旧版本(v2.8.0 之前)把所有状态整块存在 `localStorage` 的 `yun-xue-tang-batch-v2` 里,
包括「是否在跑」。现在这个键只在启动时做一次性迁移:只迁进度(已完成书目、
@@ -518,6 +568,11 @@ v2.6.0 新增「优先短课程(时长正序)」:真实站点读取 5148
v2.8.0 状态分层重构:刷课开关不再进 localStorage(修「还没登录就开始刷课」)、字段名语义化、
短课程模式下页码导航所有权归一到 `chooseShortCourse`(省掉每次多跳一页+白等 3.5 秒)。
每日积分模式:按课时类型(文档/视频/音频/微课)分别计数,文档 1、视频 3、音频 2、微课 2,
每次 3 分封顶 24 分;先补文档/音频/微课单条内容,视频靠课程课时;某类满额自动换下一类,
四类都满或无内容即停。计数落 localStorage 并跨天清零,面板与无头 TUI 都显示今日积分。
离线回归见 `node dev/tests/points-test.mjs`(`npm run test:points`)。
v2.7.0 修复「进入课程有概率不自动播放」和「学完后不转下一门」:新增单视频/音频/课件播放页识别,
完成判定同时支持 `已完成 x/y`、`已完成 N%`、`已完成学习`;真机复现、修复前后对比与回归结果见
[`docs/evidence/completion-next-evidence.txt`](docs/evidence/completion-next-evidence.txt)。