diff --git a/README.md b/README.md index fffacc9..d93091e 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,9 @@ # 云学堂助手 在云学堂(`*.yunxuetang.cn`)上自动登录、按目录顺序听课、自动切节,并在课程列表页批量推进的 -Tampermonkey 用户脚本。平台按**真实播放时长**计时,脚本只负责「自动点播放、自动切下一节、 -处理防挂机弹窗」,不快进、不改进度、不伪造学时。 +Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;一门课学完会自动回列表选下一门。 +平台按**真实播放时长**计时,脚本只负责「自动点播放、自动切下一节、处理防挂机弹窗」, +不快进、不改进度、不伪造学时。 ![控制面板](docs/screenshots/panel.png) @@ -11,10 +12,13 @@ Tampermonkey 用户脚本。平台按**真实播放时长**计时,脚本只负 | 能力 | 说明 | | --- | --- | | 一键登录 | 面板里填账号密码,自动填充表单、勾选协议、点击登录;支持记住密码与自动登录 | -| 顺序听课 | 进入课程后先对齐到「第一个未学完的课时」,从第一章第一节顺序往下学 | +| 顺序听课 | 进入课程(手动打开或批量进入)后先对齐到「第一个未学完的课时」,从第一章第一节顺序往下学 | | 自动切节 | 本节播完(`video.ended` 或平台倒计时归零)后自动进入下一节,并等平台记账后再继续 | +| 完成即跳课 | 平台汇总变成 `已完成学习`、进度 100% 或 `x/y` 满时判定整门课完成,自动回列表选下一门;不会停在已完成页,也不会把播完的视频从头重播 | +| 多类型播放页 | 识别 `#/course/play`、`#/video/play`、`#/audio/play`、`#/ppt/play` 等播放页;单视频课程同样自动点「开始学习」 | | 防挂机验证 | 识别「已触发防挂机验证」弹窗并点「继续学习」;滑块/拼图类验证不绕过,提示人工处理 | | 批量刷课 | 在列表页逐门进入未学完的课程,默认本次最多 10 门,连续失败 5 门自动停止 | +| 短课程优先 | 批量模式默认按课程总时长**从短到长**选课(跨页),先完成 1 分钟的课再学 1 小时的课;面板可关闭 | | 失败隔离 | 答题/考试类课程、长时间无计时进展的课程会被跳过并记录原因,不影响后续课程 | | 进度可续 | 运行状态存在 `localStorage`,刷新、热更新后继续上次的队列和页码 | @@ -37,11 +41,21 @@ Tampermonkey 用户脚本。平台按**真实播放时长**计时,脚本只负 | `mute` | `true` | 静音播放(自动播放更稳) | | `autoNext` | `true` | 手动打开课程时,本节结束自动下一节 | | `tickMs` | `2000` | 主循环间隔 | -| `startClickCooldownMs` | `15000` | 「开始学习」重复点击冷却 | +| `startClickCooldownMs` | `3000` | 「开始学习」重复点击冷却:3 秒内没起播就补点 | +| `entryGraceMs` | `30000` | 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」 | | `stuckMs` | `5 分钟` | 连续多久没有计时进展就放弃当前课程 | | `maxCourses` | `10` | 本次最多完成多少门;`0` = 不限 | | `maxConsecutiveFailures` | `5` | 连续失败多少门后自动停止 | | `alignToFirstIncomplete` | `true` | 进入课程先从第一个未学完的课时学起;`false` = 沿用平台上次位置 | +| `preferShortCourses` | `true` | 批量选课时优先总时长更短的课程(正序);面板勾选框「优先短课程(时长正序)」可随时切换 | + +对齐起点对「一键刷课」和手动打开课程(需勾选「手动课程自动连播」)都生效, +每门课只在进入时对齐一次,之后手动点其它课时不会被拉回。 + +短课程优先开启时,批量任务启动会先读取一次列表接口里的课程总时长(首次约 5–10 秒, +结果在当前标签页缓存 5 分钟),把未学完课程按 `studyHours` 正序排队,再跳到目标页 +逐个进入。接口不可用(未登录、跨域、平台改版)时自动降级为「当前页按时长正序」, +再不行就回到原来的列表顺序,不会让批量任务卡住。 ## 开发热加载 @@ -71,17 +85,24 @@ docs/evidence/ 实跑日志与接口证据 | `yt-batch-v2` | 批量刷课队列、当前课程、页码、已完成/失败记录 | | `yt-login-v1` | 勾选「记住密码」时的账号密码(base64 混淆,**不是加密**) | | `yt-auto-play-enabled` | 「手动课程自动连播」开关 | +| `yt-prefer-short` | 「优先短课程(时长正序)」开关(`1` / `0`) | | `yt-auto-start-after-login` | 登录后自动开始刷课的一次性标记(5 分钟内有效) | +短课程队列缓存在 `sessionStorage` 的 `yt-short-catalog-v1`,关闭标签页即清空, +不写入长期存储。 + 公用电脑请不要勾选「记住密码」;面板上的「清除密码」可随时删除本机保存的凭据。 ## 已知限制 - 平台按真实播放时长计时,倍速/快进不会减少所需时间;脚本不提供这类加速。 -- 直接改 URL 或刷新课程页时,页面标题可能短暂为 `loading...`,批量逻辑存在误判并回到列表的可能; - 从列表正常进入课程不受影响。 +- 直接改 URL 或刷新课程页时,脚本优先用 URL 里的 `kngId` 校验课程;只有 URL 没有 id、 + 且页面标题超过 30 秒仍是 `loading...` 时才可能误判并回到列表。从列表正常进入不受影响。 - 验证码、滑块、拼图类验证需要人工完成,脚本不会绕过。 -- 平台改版(目录结构、弹窗、倒计时文案变化)可能导致识别失败,需要更新选择器。 +- 平台存在同名课程(同一门课出现在多个目录)。脚本按课程 id 精确点击,但完成/失败记录仍沿用 + 按标题去重的旧逻辑,同名课程不会重复安排。 +- 平台改版(目录结构、弹窗、倒计时文案、列表接口字段、完成文案变化)可能导致识别失败, + 需要更新选择器/完成判定。 ## 免责声明 @@ -91,3 +112,14 @@ docs/evidence/ 实跑日志与接口证据 真实站点(`kfmic.yunxuetang.cn`)的完整实跑过程、发现的问题与修复记录见 [运行报告.md](运行报告.md), 证据文件在 [`docs/evidence/`](docs/evidence/),截图在 [`docs/screenshots/`](docs/screenshots/)。 + +v2.5.2 修复「进入课程不从第一个未学完的课时开始」的定位过程、复刻用例与修复前后对比, +见 [`docs/evidence/align-start-evidence.txt`](docs/evidence/align-start-evidence.txt)。 + +v2.6.0 新增「优先短课程(时长正序)」:真实站点读取 5148 门课程、跨页跳到最短课程所在页的 +实跑记录与 3 个回归用例,见 [`docs/evidence/short-course-evidence.txt`](docs/evidence/short-course-evidence.txt); +面板效果见 [`docs/screenshots/panel-short.png`](docs/screenshots/panel-short.png)。 + +v2.7.0 修复「进入课程有概率不自动播放」和「学完后不转下一门」:新增单视频/音频/课件播放页识别, +完成判定同时支持 `已完成 x/y`、`已完成 N%`、`已完成学习`;真机复现、修复前后对比与回归结果见 +[`docs/evidence/completion-next-evidence.txt`](docs/evidence/completion-next-evidence.txt)。 diff --git a/docs/evidence/align-start-evidence.txt b/docs/evidence/align-start-evidence.txt new file mode 100644 index 0000000..dad0b7d --- /dev/null +++ b/docs/evidence/align-start-evidence.txt @@ -0,0 +1,68 @@ +云学堂助手 v2.5.2 · 起点对齐回归(本地复刻目录) +================================================== + +背景 +---- +用户反馈:进入课程后不会从「第一个未学完的课时」开始,前面的课时被跳过 / 整门课学不完。 +真实站点需要登录,无法在本地直接复现,因此按 docs/evidence/probe.txt、probe2.txt、probe4.txt +里记录的真实目录结构,复刻课程页 DOM,再用无头 Chromium 注入用户脚本跑 20 秒, +读取目录高亮、面板状态与控制台日志。复刻页面与用例脚本在 .run-tmp/align/(本机调试用,未入库)。 + +复刻的真实结构(来自 probe2.txt / probe4.txt) +-------------------------------------------- +- .yxtulcdsdk-catalog ul > li:章节点含子 ul,课时是叶子 li +- 课时 li > div.ml24.flex-center.flex-space-between > span.item(tag-type 在标题之前)+ 右侧 svg 状态图标 +- 完成态图标:起点 M10 2.75 的实心圆 + 对勾;未学完:空心圆;当前课时:带「!」的圆 +- 进入课程时平台停在「上次学习的位置」(用例里用 resume 参数模拟) +- 本节视频 ended 后平台把完成数 +1,脚本据此切下一节 + +用例与结果(v2.5.1 → v2.5.2) +------------------------------ +A1 批量 · 点击句柄在 li PASS → PASS +A2 批量 · 点击句柄在行容器 PASS → PASS +A3 批量 · 点击句柄在标题 span FAIL(停在平台上次位置第 5 节)→ PASS +A4 批量 · 点击句柄在状态图标 PASS(第 6 次点击才命中)→ PASS +A5 批量 · 完成态只有文字标签 FAIL(已学完被当成未学,退回第 1 节)→ PASS +A6 批量 · 全部未学 PASS → PASS +A7 批量 · 切换有确认弹窗 PASS → PASS +A8 批量 · 目标在折叠章(展开箭头是 svg) PASS → PASS(展开章节日志正常) +A9 手动 · 点击句柄在 li FAIL(完全不对齐,停在第 5 节)→ PASS +A10 手动 · 点击句柄在标题 span FAIL(同上)→ PASS +A11 批量 · 本节结束后切下一节 FAIL(记账后仍停在第 3 节)→ PASS +A12 批量 · 本节结束后切下一节(图标句柄) FAIL(同上)→ PASS +A13 手动 · 本节结束后切下一节 FAIL(未对齐,无进展)→ PASS + +汇总:v2.5.1 = 6 PASS / 7 FAIL;v2.5.2 = 13 PASS / 0 FAIL + +原因 +---- +1) clickLesson() 只点 li 和「li 内第一个 .hand」。真实目录里 .hand 是右侧的 , + 而 SVGSVGElement 没有 HTMLElement.click()(Chromium 实测 typeof svg.click === 'undefined'), + svg.click() 抛 TypeError 后被 try/catch 静默吞掉,等于没点;句柄挂在标题 span / + 行容器上时,前 4 次点击都没命中,脚本就放弃并「按当前位置继续」。 +2) isLessonCompleted() 的文本兜底写成 /(已学完|已完成)$/,要求标签出现在 li 文本末尾; + 真实目录的 tag-type 在标题之前(probe2.txt:视频标题), + 标成「已学完 第1节」时永远匹配不到 → 已学完的课时被当成未学 → 目标退回第 1 节。 +3) 起点对齐只写在 courseTick()(批量刷课)里,manualCourseTick()(手动打开课程)没有对齐。 +4) findNextLessonElement() 返回 li 内第一个 .hand(真实目录里是 svg), + advanceLesson() / manualCourseTick() 直接 next.click() → 同 (1),切节点击不生效。 + (docs 里 2.0.3 实跑看起来「切成功」,其实是平台自己播完自动连播。) + +修复(v2.5.2) +-------------- +- 新增 clickNode():HTMLElement 用 click(),svg 等没有 click() 的节点改派发 MouseEvent。 +- clickLesson() 按「标题 span → 行容器 → li → 状态图标」逐次尝试,并补 pointer/mouse 序列; + 对齐重试次数 4 → 8。 +- isLessonCompleted() 文案匹配去掉结尾锚定,并补充 aria-label/title/class 语义与图标路径兜底。 +- 起点对齐抽成 alignToFirstIncomplete(),courseTick() 与 manualCourseTick() 共用; + 手动模式按课程标题判断换课,每门课只对齐一次,标题还是 loading 时不做任何判断。 +- findNextLessonElement() 改回返回课时 li;切节用 switchLesson()(标题 → 行容器 → li → 图标, + 每步先确认还没切过去),advanceLesson() 与手动连播共用。 +- 章节展开、确认弹窗按钮统一走 clickNode();确认弹窗只在弹层内找按钮,避免误点页面其它按钮。 + +复现方式(本机) +---------------- + $env:PLAYWRIGHT_PATH="" + $env:CHROME_PATH="" + node .run-tmp/align/run.mjs # 当前脚本 + $env:SCRIPT=".run-tmp/align/before.user.js"; node .run-tmp/align/run.mjs # 修复前对照 diff --git a/docs/evidence/completion-next-evidence.txt b/docs/evidence/completion-next-evidence.txt new file mode 100644 index 0000000..0ef2436 --- /dev/null +++ b/docs/evidence/completion-next-evidence.txt @@ -0,0 +1,142 @@ +云学堂助手 v2.7.0 · 单视频自动播放 / 完成后转下一门 实跑与回归 +================================================================ + +结论 +---- +用户反馈的两个问题是同一个根因链条上的两处断点,均已在真实站点复现并修复: + +1) 进入课程「有概率」不自动播放 + - 平台的播放页不只有 #/course/play。单个视频课程点开后走的是 + #/scan?kngId=… -> #/video/play?kngId=…,音频/课件还有 #/audio/play、#/ppt/play。 + - v2.6.0 的 route() 只把 #/course/play 识别为课程页,其它播放页返回 'other', + 主循环既不跑 courseTick 也不跑 manualCourseTick:不点「开始学习」、不接管视频。 + - 真实站点「氦泄漏通用」(type=2 / fileType=video / 60 秒,列表第 307 页)复现: + 进课后 150 秒内 S.phase 一直是 entering,video=null,面板停在 + 「进入课程(1 分钟):氦泄漏通用」,done=0。 + +2) 一门课学完后不自动转到下一门 + - 平台课程真正学完时,汇总文案会从「已完成 0/1」变成 **「已完成学习」**; + 单视频页则是「已完成 0%」->「已完成 67%」-> **「已完成学习」**。 + 此时倒计时和进度条都会消失。 + - v2.6.0 的 readSummary() 只匹配 /已完成(\d+)\/(\d+)/,读不到「已完成学习」和百分比, + 永远不判完成:停在课程页、不回列表、也不选下一门;而且播放器会把视频重置到 0 秒, + v.ended 变回 false,脚本又调用 play() 从头重播。 + - 真实站点「如何搭建分销体系,实现用户指数级增长?(上篇)」(1 节 / 127 秒)复现: + 127 秒时 study/summary 已返回 finishNum=1/1、acqHours=127,页面汇总变成「已完成学习」, + 但 20 秒后 S.completedThisRun 仍为 0、S.current 未清空,video 被重新 play 到 0.5 秒。 + +真实站点证据 +------------ +复现环境:https://kfmic.yunxuetang.cn(江丰云课堂),2026-10-22,Asia/Shanghai。 +登录凭据来自用户级环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,没有写入脚本或仓库。 + +A. 单视频课程的实际路由与完成文案(#/video/play) +------------------------------------------------ + NAV /kng/#/scan?kngId=283c683a-fa98-4f69-9e08-c45116118aa1 + NAV /kng/#/video/play?kngId=283c683a-fa98-4f69-9e08-c45116118aa1&projectId=&btid=&gwnlUrl= + NET /kng/study/kngInfo {"title":"氦泄漏通用","type":2,"fileType":"video",...} + NET /kng/study/summary {"finishNum":0,"totalNum":1,...,"studyHours":60} + 页面汇总:已完成 0% -> 已完成 33% -> 已完成 67% -> 已完成学习 + 倒计时: 还需 59秒 …(从 60 秒开始,注意视频本身 107 秒,平台按 required time 计时) + 开始按钮: + + 修复前(v2.6.0)在该页连续 150 个 tick 的状态: + status=进入课程(1 分钟):氦泄漏通用 + phase=entering done=0 video=- sum=已完成0% 150 秒无变化 + +B. 多课时课程完成后汇总变成「已完成学习」 +---------------------------------------- + NET /kng/study/summary {"finishNum":0,"totalNum":1,...,"studyHours":127} + [14s] 页面汇总:已完成0/1 + [21s] 视频开始播放:video=play@0/127.1 + [148s] NET /kng/study/summary {"finishNum":1,"totalNum":1,"acqHours":127,...} + [149s] 页面汇总:已完成学习(倒计时、进度条消失) + status=学习中:视频如何搭建分销体系,实现用户指数型增长?(上) + done=0 video=PAUSE@0/127.1 + [150s] video=play@0.5/127.1 ← 平台重置后脚本又把视频从头播放 + +修复内容(v2.7.0) +------------------ +1) route() 识别全部播放页:#/course/play、#/video/play、#/audio/play、#/ppt/play、 + #/document/play、#/article/play,以及进课过渡页 #/scan。 + 新增 mediaPage() 区分「有目录的多课时课程」和「单媒体播放页」。 + +2) readSummary() 同时解析三种真实完成文案: + - 已完成 2/3 -> { x:2, y:3, complete:false, kind:'ratio' } + - 已完成 67% -> { x:67, y:100, complete:false, kind:'percent' } + - 已完成学习 -> { x:100, y:100, complete:true, kind:'done' } + 另用 [role="progressbar"] 的 aria-valuenow 兜底。 + +3) courseTick(): + - 单视频/音频页不再走目录对齐,也不把百分比进度当成「一节学完」去切节; + - 汇总 complete 时(比例满、100%、已完成学习)统一 completeCurrent(); + - 新增 doneLatchKey:倒计时归零/video.ended 后记住本节已播完, + 平台把播放器重置到 0 秒时不再自动 play,避免完成后重播; + - 单媒体页等待记账时只轮询汇总,不调用 advanceLesson()。 + +4) 进课判定改用 URL 的 kngId:startCourse() 把课程 id 写入 S.current.id, + courseTick() 优先用 kngId 比对,标题短暂是 loading.../在线课堂 时不再误判; + 宽限从 12 秒提高到 30 秒(CFG.entryGraceMs)。#/scan 只是过渡页,此时不做完成判定, + 防止读到上一门课残留的「已完成学习」。 + +5) 自动播放兜底:「开始学习」冷却 15 秒 -> 3 秒(3 秒没起播就补点); + 选择器在 button/a 之外支持最内层 div/span,并跳过 disabled 按钮; + 手动模式(手动课程自动连播)在单媒体页也会点开始; + 点课程卡片后 4 秒仍停在列表时自动补点,最多 2 次,不再直接记为失败跳过。 + +6) 完成文案连续两次读到才确认(三种完成文案统一),避免 SPA 切页瞬间 + 把上一门课的完成文案算到新课程上。completeCurrent() 改为强制返回列表 + (不受 goToList 5 秒节流影响),并先 pause 播放器;列表页把「已完成/已学习」 + 也当作完成状态过滤。 + +回归用例(本地复刻 DOM,Playwright) +------------------------------------ + node .run-tmp/align/run.mjs => 13 PASS / 0 FAIL(起点对齐 + 自动切节) + node .run-tmp/complete/run.mjs => 8 PASS / 0 FAIL + E1 首次点卡片无反应:自动补点进入课程 + U1 readSummary 解析 x/y、百分比、已完成学习 + U2 route 识别 course/video/audio/ppt/scan + V1 单视频课:自动播放 -> 完成后进入下一门 + C1 多课时课:已完成学习 -> 回列表 -> 下一门 + L1 标题 loading 但 kngId 匹配:不误判、继续播放 + T1 倒计时归零后平台重置视频:不重播,汇总更新后照常进入下一门 + D1 「开始学习」是 div 时仍能自动播放 + +真机修复后验证 +-------------- +场景 1:已完成的多课时课程(#/course/play,汇总「已完成学习」) + [11s] 课程完成:如何搭建分销体系,实现用户指数级增长?(上篇)第 1 门,返回列表选下一门 + [12s] NAV /kng/#/list + [15s] 回到列表第 1 页,继续… + [22s] 短课程队列已就绪:待学 5131 门;最短 2 分钟 + [25s] 进入课程(2 分钟):如何制定渠道战略 + [27s] 跳过:如何制定渠道战略(课程包含考试/测验章节) + [28s] 回到列表第 13 页,继续… -> 第 63 页 + [31s] 进入课程(2 分钟):APP做裂变的三大专属玩法 + [38s] 学习中:视频APP做裂变的三大专属玩法(video=0.6/132.1) + [PASS] complete=true next=APP做裂变的三大专属玩法 playing=true + +场景 2:已完成的单视频课程(#/video/play,汇总「已完成学习」) + [11s] 课程完成:氦泄漏通用 第 1 门,返回列表选下一门 + [12s] NAV /kng/#/list + [16s] 短课程队列已就绪:待学 5131 门;最短 2 分钟 + [19s] 进入课程(2 分钟):如何制定渠道战略 -> 跳过(考试/测验章节) + [25s] 进入课程(2 分钟):APP做裂变的三大专属玩法 + [32s] 学习中:视频APP做裂变的三大专属玩法(video=1.3/132.1) + [PASS] complete=true next=APP做裂变的三大专属玩法 playing=true + +复现命令(本机) +---------------- + $env:PLAYWRIGHT_PATH="" + $env:CHROME_PATH="" + node .run-tmp/align/run.mjs + node .run-tmp/complete/run.mjs + # 真机观测/验证需要 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD + $env:YUN_XUE_TANG_USR=...; $env:YUN_XUE_TANG_PWD=... + node .run-tmp/real/probe-bugs2.mjs # 修复前:video/play 全程不动作 + node .run-tmp/real/verify-fix.mjs # 修复后:两个场景 PASS + +清理说明 +-------- +- 登录态 storageState(.run-tmp/real/state.json)与调试截图只在本地调试目录,验证完成后删除。 +- 仓库内没有写入账号、密码、token 或 cookie。 diff --git a/docs/evidence/short-course-evidence.txt b/docs/evidence/short-course-evidence.txt new file mode 100644 index 0000000..aab54db --- /dev/null +++ b/docs/evidence/short-course-evidence.txt @@ -0,0 +1,72 @@ +云学堂助手 v2.6.0 · 优先短课程(时长正序)证据 +日期:2026-10-22(Asia/Shanghai) +站点:https://kfmic.yunxuetang.cn/kng/#/list(已登录账号) + +一、需求 +批量刷课时,不再只按列表顺序(最新发布)选课,而是优先学习总时长更短的课程(正序)。 + +二、真实数据结构 +列表卡片本身不显示时长。列表组件 ul.kng-list-new.__vue__ 的 kngListData 每项包含: + - title 课程名 + - studyHours 课程总时长(秒) + - status 1=学习中,2=已学完,0=未开始 + - id 课程 id(用于精确匹配卡片,避免同名课程点错) +列表接口:POST https://api-phx-tc.yunxuetang.cn/kng/knowledge/pagelist + ?limit=6000&offset=0&orderType=desc&orderBy=createTime +请求体: + {"collegeId":"","catalogId":"","title":"","type":"","allTag":1,"tagIds":[]} +鉴权最小请求头(实测): + content-type: application/json;charset=UTF-8 + token: + yxt-orgdomain: kfmic.yunxuetang.cn + source: 501 +其中 limit=6000 可一次返回全站 5148 门课程(实测 8.65 MB,6.3 秒)。 +orderBy 传 studyHours 不会被服务端接受(返回默认顺序),所以脚本自行按 studyHours 正序排序。 + +三、真实站点读取结果(2026-10-22 20:07 左右) + 课程总数:5148 + 未学完(status != 2):5134 + 最短课程:氦泄漏通用,60 秒,status=0,位于第 307 页 + 下一页最短:想精准触达消费者,你得了解立体用户画像!113 秒,第 73 页 + 再下一页:如何搭建分销体系,实现用户指数型增长?(上篇)127 秒,第 71 页 + 说明:平台存在同名课程(如「如何制定渠道战略」出现在多页),脚本优先按课程 id 匹配卡片。 + +四、真实列表页跳页 / 匹配验证 +目标:{"title":"氦泄漏通用","duration":60,"status":0,"page":307} + 1) 脚本读取时长队列后,jumpToPage(307) 成功,浏览器页码变为 307。 + 2) 第 307 页 16 张卡片的标题中确实包含「氦泄漏通用」(第 12 张)。 + 3) chooseShortCourse 返回 { title: "氦泄漏通用", duration: 60 },说明跨页映射与卡片匹配正确。 + 日志: + [云学堂助手] 正在读取课程时长,优先安排短课程… + [云学堂助手] 短课程队列已就绪:待学 5134 门;最短 1 分钟 + [云学堂助手] 跳转到第 307 页 + [云学堂助手] 优先短课程:转到第 307 页(1 分钟) + +五、回归测试(Playwright + 本地列表 fixture,3 个用例) +命令:node .run-tmp/short-course/test-list.mjs +结果:3 PASS / 0 FAIL + [PASS] S1 短课程优先 · 跨页选全局最短 + 点击 D 短课(期望 D 短课)/ 页码 2(期望 2) + [PASS] S2 关闭开关 · 沿用列表顺序 + 点击 A 长课(期望 A 长课)/ 页码 1(期望 1) + [PASS] S3 接口失败 · 退回当前页时长正序 + 点击 B 中课(期望 B 中课)/ 页码 1(期望 1) +命令:node .run-tmp/short-course/test-restore.mjs +结果:PASS + [PASS] 回到列表恢复第 9 页:实际第 9 页(直接跳页,不一页页翻) +覆盖点: + - 接口可用时跨页选择全局最短; + - 面板开关关闭时恢复原有顺序; + - 接口 500 时降级为当前页 studyHours 正序; + - 已学完(status=2)课程不进入队列; + - 课程完成回到列表时,深页码(短课程优先会到 300+ 页)直接跳回,不逐页翻。 + +六、实现要点 + - 面板新增「优先短课程(时长正序)」复选框,默认开启,保存在 localStorage `yt-prefer-short`。 + - 队列缓存在 sessionStorage `yt-short-catalog-v1`,5 分钟有效,关闭标签页即清空。 + - 选课时按 studyHours 升序;时长未知的排最后。 + - 目标课程在其他页时先 jumpToPage,落地后按 id(不可用时按标题)匹配卡片。 + - 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。 + +七、面板截图 + docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选) diff --git a/docs/screenshots/panel-short.png b/docs/screenshots/panel-short.png new file mode 100644 index 0000000..40d5bcf Binary files /dev/null and b/docs/screenshots/panel-short.png differ diff --git a/package.json b/package.json index 81c18e3..17e1fcf 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "yun-xue-tang-assistant", - "version": "2.5.1", + "version": "2.7.0", "private": true, "description": "云学堂(*.yunxuetang.cn)Tampermonkey 助手:自动登录、顺序听课、自动切节、批量刷课", "scripts": { diff --git a/yun-xue-tang-assistant.user.js b/yun-xue-tang-assistant.user.js index 9d07de9..76a7304 100644 --- a/yun-xue-tang-assistant.user.js +++ b/yun-xue-tang-assistant.user.js @@ -1,8 +1,8 @@ // ==UserScript== // @name 云学堂助手 // @namespace yun-xue-tang-assistant.local -// @version 2.5.1 -// @description 云学堂助手:自动登录、从第一节顺序听课、自动切节、处理防挂机验证,并按列表批量推进课程 +// @version 2.7.0 +// @description 云学堂助手:自动登录、从第一节顺序听课、自动切节、处理防挂机验证,并按列表批量推进课程(单视频/音频课程也支持,学完自动进入下一门,可优先短课程) // @match *://kfmic.yunxuetang.cn/* // @match *://*.yunxuetang.cn/* // @grant none @@ -23,7 +23,10 @@ * * 重要说明: * - 平台按“真实播放时长”计时,快进、倍速都不省时间,脚本只做自动播放和自动切节。 - * - 批量刷课时,进入每门课都会先对齐到「第一个未学完的课时」,即从第一章第一节起 + * - 同时支持多课时课程(#/course/play)和单视频/音频/课件播放页(#/video/play 等): + * 单视频课程会自动点「开始学习」;平台汇总变成「已完成学习」/100%/x=y 时判定整门课 + * 完成,自动回列表并进入下一门。 + * - 进入课程(批量或手动打开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起 * 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。 * 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。 * - 试跑稳定后,把下面 CFG.maxCourses 改成 0 即可不限门数(会持续很久)。 @@ -33,6 +36,11 @@ * - 验证码/滑块需要手动完成,脚本不会绕过。 * - 课程/单位如有相关规定,请自行确认风险。 * + * 短课程优先: + * - 面板勾选「优先短课程(时长正序)」后,批量刷课会先读课程列表接口里的总时长, + * 按「未学完课程的总时长从短到长」选课,而不是按列表顺序。接口不可用时会自动 + * 退回为「当前页按时长正序」,再不行就按原来的列表顺序,不会卡住批量任务。 + * * 开发热加载: * - 本文件可直接被 dev/dev-loader.user.js 热注入:脚本暴露 window.__ytDispose(), * 加载器在注入新版本前会先调用它清理定时器、监听器与面板,因此保存文件后 @@ -47,20 +55,25 @@ mute: true, // 静音(自动播放更稳) autoNext: true, // 手动打开课程时,本节结束后自动下一节 tickMs: 2000, // 主循环间隔 - startClickCooldownMs: 15000, // 「开始学习」重复点击冷却 + startClickCooldownMs: 3000, // 「开始学习」重复点击冷却(点击后 2 个 tick 内没起播就补点) + entryGraceMs: 30000, // 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」 stuckMs: 5 * 60 * 1000, // 连续多久没有计时进展就放弃当前课程 maxCourses: 10, // 本次最多完成多少门;0 = 不限 maxConsecutiveFailures: 5, // 连续失败多少门后自动停止 alignToFirstIncomplete: true, // 进入课程先从「第一个未学完的课时」学起;false = 沿用平台上次位置 + preferShortCourses: true, // 批量选课时优先总时长更短的课程(正序) }; // 版本号:与文件头 @version 保持一致,悬浮窗和控制台都用它 - const VERSION = '2.5.1'; + const VERSION = '2.7.0'; const LS_ENABLED = 'yt-auto-play-enabled'; const LS_BATCH = 'yt-batch-v2'; const LS_LOGIN = 'yt-login-v1'; const LS_PENDING = 'yt-auto-start-after-login'; + const LS_PREFER_SHORT = 'yt-prefer-short'; + const SS_SHORT_CATALOG = 'yt-short-catalog-v1'; + const SHORT_CATALOG_TTL = 5 * 60 * 1000; const PANEL_ID = 'yt-auto-panel'; const TAG = '[云学堂助手]'; @@ -155,6 +168,31 @@ return null; } + // 平台的「开始学习/继续学习」多数是