From 8200bfa0c506d8afa02ca8ec44b13f43d0aa418a Mon Sep 17 00:00:00 2001 From: void Date: Thu, 22 Oct 2026 23:04:40 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20v2.7.0=20=E5=8D=95=E8=A7=86=E9=A2=91?= =?UTF-8?q?=E8=AF=BE=E7=A8=8B=E8=87=AA=E5=8A=A8=E6=92=AD=E6=94=BE=E3=80=81?= =?UTF-8?q?=E5=AD=A6=E5=AE=8C=E8=87=AA=E5=8A=A8=E8=BD=AC=E4=B8=8B=E4=B8=80?= =?UTF-8?q?=E9=97=A8=EF=BC=8C=E5=B9=B6=E5=8A=A0=E5=85=A5=E7=9F=AD=E8=AF=BE?= =?UTF-8?q?=E7=A8=8B=E4=BC=98=E5=85=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 脚本 v2.5.1 → v2.7.0 的三批改动合并提交: - 起点对齐(v2.5.2):进课后先对齐到「第一个未学完的课时」,再顺序往下学; 切换成功以目录高亮为准,失败如实提示「未能切换」 - 优先短课程(v2.6.0):批量按列表接口的 studyHours 正序跨页选课,先学短课; 接口不可用时依次降级为「当前页时长正序」「原列表顺序」;面板可随时关闭, 开关存 localStorage(yt-prefer-short),队列缓存放在 sessionStorage - 多播放页识别(v2.7.0):除 #/course/play 外,识别 #/video/play、#/audio/play、 #/ppt/play、#/document/play、#/article/play 与过渡页 #/scan, 单视频/音频课程同样自动点「开始学习」,不再停在 entering - 完成判定(v2.7.0):readSummary() 同时解析「已完成 x/y」「已完成 N%」 「已完成学习」,并支持 progressbar 的 aria-valuenow 兜底;整门课完成即回列表 选下一门,不再停在已完成页把视频从头重播 - 稳定性:新增 entryGraceMs(30s)避免慢加载被误判为课程不一致; startClickCooldownMs 从 15s 缩短到 3s,未起播可及时补点 - 文档:README 补充新能力、配置项与存储键;运行报告标注 v2.7.0; 新增 align-start / short-course / completion-next 三份实跑证据与面板截图 --- README.md | 46 +- docs/evidence/align-start-evidence.txt | 68 ++ docs/evidence/completion-next-evidence.txt | 142 +++ docs/evidence/short-course-evidence.txt | 72 ++ docs/screenshots/panel-short.png | Bin 0 -> 10997 bytes package.json | 2 +- yun-xue-tang-assistant.user.js | 1097 +++++++++++++++++--- 运行报告.md | 7 +- 8 files changed, 1257 insertions(+), 177 deletions(-) create mode 100644 docs/evidence/align-start-evidence.txt create mode 100644 docs/evidence/completion-next-evidence.txt create mode 100644 docs/evidence/short-course-evidence.txt create mode 100644 docs/screenshots/panel-short.png 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 0000000000000000000000000000000000000000..40d5bcfdf7d6c82809ea41efb57c04e6a6c1df28 GIT binary patch literal 10997 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,但个别页面把点击句柄放在 + // 文案 span 或外层 div 上。按由外到内找不到时,再找最内层的纯文字节点, + // 点击会冒泡到真正的句柄。只认可见且没有兄弟文字干扰的最内层节点。 + function findVisibleClickable(re) { + const btn = findVisibleButton(re); + if (btn && !btn.disabled) return btn; + const els = document.querySelectorAll('div, span'); + for (const el of els) { + if (el.children.length > 0) continue; + if (!isVisible(el) || !re.test(textOf(el))) continue; + if (el.closest && el.closest('button[disabled]')) continue; + return el; + } + return null; + } + + // 从播放页 URL 里取课程 id:进课过渡页(#/scan)和真正的播放页 + // (#/course/play、#/video/play…)都带 kngId。 + function courseIdFromUrl() { + const m = String(location.hash || '').match(/[?&]kngId=([^&]+)/); + if (!m) return ''; + try { return decodeURIComponent(m[1]); } catch (e) { return m[1]; } + } + + function collectDocuments(win, out) { win = win || window; out = out || []; @@ -171,11 +209,16 @@ // ======== 状态 ======== const state = { - enabled: true, // 手动打开的课程:自动连播 + enabled: true, // 手动打开的课程:自动连播 + preferShort: CFG.preferShortCourses, // 批量选课:优先时长短的课程(正序) }; try { state.enabled = localStorage.getItem(LS_ENABLED) !== '0'; } catch (e) { /* ignore */ } + try { + const v = localStorage.getItem(LS_PREFER_SHORT); + if (v === '0' || v === '1') state.preferShort = v === '1'; + } catch (e) { /* ignore */ } function defaultBatch() { return { @@ -209,6 +252,7 @@ const R = { hooked: new WeakSet(), lastCardClickAt: 0, + entryRetries: 0, // 点卡片后仍停在列表时,重试进入课程的次数 lastPageJumpAt: 0, pageChangeAt: 0, pageChangeSig: '', @@ -218,6 +262,7 @@ lastAdvanceAt: 0, manualAdvanceAt: 0, lastLessonKey: '', + doneLatchKey: '', // 本节已播完(倒计时归零/video.ended),防止平台把视频拉回开头重播 lastSummary: null, lastCountdown: null, lastProgressAt: Date.now(), @@ -230,6 +275,7 @@ alignTries: 0, alignStable: 0, alignFailed: false, + manualCourseKey: '', lastIdleClickAt: 0, idlePassed: 0, idleDialogText: '', @@ -241,10 +287,19 @@ loginAutoTried: false, loginBoundUser: null, loginBoundPwd: null, + // 短课程优先:课程时长队列(只在当前标签页会话内缓存) + shortCatalog: null, + shortCatalogLoading: false, + shortCatalogFailedAt: 0, + shortFetchStartedAt: 0, + shortJumpAt: 0, + shortNoVmSince: 0, + shortWarnedAt: 0, }; function resetCourseRuntime() { R.lastLessonKey = ''; + R.doneLatchKey = ''; R.lastSummary = null; R.lastCountdown = null; R.lastProgressAt = Date.now(); @@ -257,8 +312,10 @@ R.alignTries = 0; R.alignStable = 0; R.alignFailed = false; + R.manualCourseKey = ''; R.lastAdvanceAt = 0; R.restoreAttempts = 0; + R.entryRetries = 0; } // ======== 面板 ======== @@ -268,6 +325,8 @@ let btnSkip = null; let labelAuto = null; let labelBatch = null; + let labelShort = null; + let cbPreferShort = null; let loginBox = null; let loginUserEl = null; let loginPassEl = null; @@ -295,11 +354,13 @@ } const cbAuto = document.getElementById('yt-auto-enabled'); if (cbAuto) cbAuto.checked = state.enabled; + if (cbPreferShort) cbPreferShort.checked = state.preferShort; const onLogin = isLoginPage(); if (loginBox) loginBox.style.display = onLogin ? 'block' : 'none'; if (labelAuto) labelAuto.style.display = onLogin ? 'none' : 'flex'; if (labelBatch) labelBatch.style.display = onLogin ? 'none' : 'flex'; + if (labelShort) labelShort.style.display = onLogin ? 'none' : 'flex'; if (statsEl) statsEl.style.display = onLogin ? 'none' : 'block'; if (btnOne) { // 「停止刷课」只在播放页出现;列表页等位置始终显示「一键刷课」 @@ -466,6 +527,31 @@ labelBatch.appendChild(cbBatch); labelBatch.appendChild(document.createTextNode('自动刷课(批量)')); + labelShort = document.createElement('label'); + labelShort.style.cssText = 'display:flex;align-items:center;gap:6px;cursor:pointer;margin-top:4px;'; + cbPreferShort = document.createElement('input'); + cbPreferShort.type = 'checkbox'; + cbPreferShort.id = 'yt-prefer-short'; + cbPreferShort.checked = state.preferShort; + cbPreferShort.title = '按课程总时长从短到长选课'; + cbPreferShort.addEventListener('change', function () { + state.preferShort = cbPreferShort.checked; + try { localStorage.setItem(LS_PREFER_SHORT, state.preferShort ? '1' : '0'); } catch (e) {} + if (!state.preferShort) { + R.shortCatalog = null; + R.shortCatalogLoading = false; + R.shortCatalogFailedAt = 0; + try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) {} + setStatus('已关闭短课程优先,按列表顺序选课'); + } else { + R.shortCatalogFailedAt = 0; + setStatus('已开启短课程优先:时长正序'); + } + updatePanel(); + }); + labelShort.appendChild(cbPreferShort); + labelShort.appendChild(document.createTextNode('优先短课程(时长正序)')); + statusEl = document.createElement('div'); statusEl.id = 'yt-status'; statusEl.textContent = '待机…'; @@ -513,6 +599,7 @@ box.appendChild(btnOne); box.appendChild(labelAuto); box.appendChild(labelBatch); + box.appendChild(labelShort); box.appendChild(statusEl); box.appendChild(statsEl); box.appendChild(btnSkip); @@ -528,15 +615,27 @@ } // ======== 路由 ======== + // 平台不同内容类型进入的播放页不同: + // 多课时课程 #/course/play?kngId=… 单个视频 #/video/play?kngId=… + // 单个音频 #/audio/play?kngId=… 单个课件 #/ppt/play?kngId=… + // 以前只认 #/course/play,其它类型整页逻辑都不会跑(不自动播放、也不判完成)。 + // #/scan 是点开课程后的过渡页,也按课程页处理。 function route() { const h = location.hash || ''; if (h.indexOf('#/list') === 0) return 'list'; - if (h.indexOf('#/course/play') === 0) return 'course'; + if (h.indexOf('#/scan') === 0) return 'course'; + if (/^#\/[a-z0-9_-]+\/play(?:[?/]|$)/i.test(h)) return 'course'; return 'other'; } - function goToList() { - if (Date.now() - R.lastGoListAt < 5000) return; + // 单媒体播放页(没有多课时目录):完成判定看进度百分比/「已完成学习」, + // 不需要找下一节。 + function mediaPage() { + return /^#\/(?:video|audio|ppt|document|article)\/play(?:[?/]|$)/i.test(location.hash || ''); + } + + function goToList(force) { + if (!force && Date.now() - R.lastGoListAt < 5000) return; R.lastGoListAt = Date.now(); const url = S.listUrl || location.origin + '/kng/#/list'; if (route() === 'list') { @@ -916,6 +1015,354 @@ } } + // ======== 短课程优先(时长正序) ======== + // 列表卡片本身不显示时长,但列表组件(ul.kng-list-new.__vue__)的 kngListData + // 里每门课都带 studyHours(秒)。当前页可据此按时长排序;要进一步跨页优先, + // 再用同一套列表接口一次性读取全部课程,按 studyHours 正序排队。 + // 接口失败时逐级降级:跨页队列 → 当前页时长排序 → 原列表顺序,绝不卡住批量任务。 + + function formatDuration(seconds) { + const n = Number(seconds); + if (!Number.isFinite(n) || n <= 0) return '时长未知'; + const minutes = Math.max(1, Math.round(n / 60)); + if (minutes < 60) return minutes + ' 分钟'; + const h = Math.floor(minutes / 60); + const m = minutes % 60; + return h + ' 小时' + (m ? ' ' + m + ' 分钟' : ''); + } + + // 列表页组件:优先取直接挂载 kngListData 的父组件 + function listVm() { + const ul = document.querySelector('ul.kng-list-new'); + let vm = ul && ul.__vue__; + while (vm && !Array.isArray(vm.kngListData)) vm = vm.$parent; + return vm && Array.isArray(vm.kngListData) ? vm : null; + } + + function shortCatalogKey(vm) { + const key = { + collegeId: (vm && vm.collegeId) || '', + catalogId: (vm && vm.currentCatalogId) || '', + title: (vm && vm.searchKey) || '', + type: vm && vm.kngType != null ? vm.kngType : '', + allTag: vm && vm.tagIds && vm.tagIds.length ? 0 : 1, + tagIds: (vm && vm.tagIds) || [], + orderBy: (vm && vm.sortColumn) || 'createTime', + orderType: (vm && vm.sortType) || 'desc', + pageSize: Number(vm && vm.pageSize) || 16, + }; + return JSON.stringify(key); + } + + function readShortCatalog(key) { + try { + const raw = sessionStorage.getItem(SS_SHORT_CATALOG); + if (!raw) return null; + const obj = JSON.parse(raw); + if (!obj || obj.key !== key || !Array.isArray(obj.items)) return null; + if (Date.now() - (obj.at || 0) > SHORT_CATALOG_TTL) return null; + return obj; + } catch (e) { + return null; + } + } + + function writeShortCatalog(cat) { + if (!cat) return; + try { + sessionStorage.setItem(SS_SHORT_CATALOG, JSON.stringify(cat)); + } catch (e) { /* 容量不足时只保留内存队列 */ } + } + + function shortApiBase() { + try { + const hit = performance.getEntriesByType('resource') + .map(function (e) { return e.name; }) + .find(function (u) { return /\/kng\/knowledge\/pagelist/.test(u); }); + if (hit) return new URL(hit).origin + '/kng/knowledge/pagelist'; + } catch (e) { /* 用默认域名 */ } + return 'https://api-phx-tc.yunxuetang.cn/kng/knowledge/pagelist'; + } + + function shortCatalogRequest(vm) { + const orgId = (vm && vm.collegeId) || localStorage.getItem('orgId') || ''; + const token = localStorage.getItem('token') || ''; + if (!token) throw new Error('未找到登录 token,可能尚未登录或登录已过期'); + + const body = JSON.stringify({ + collegeId: orgId, + catalogId: (vm && vm.currentCatalogId) || '', + title: (vm && vm.searchKey) || '', + type: vm && vm.kngType != null ? vm.kngType : '', + allTag: vm && vm.tagIds && vm.tagIds.length ? 0 : 1, + tagIds: (vm && vm.tagIds) || [], + }); + const headers = { + 'content-type': 'application/json;charset=UTF-8', + accept: 'application/json, text/plain, */*', + token: token, + 'yxt-orgdomain': location.hostname, + source: '501', + }; + return { body: body, headers: headers }; + } + + // 一次性读取列表接口(limit=6000 可覆盖当前 5000+ 门课程的站点), + // 只保留「未学完」的课程,并映射到它所在的页码。 + async function fetchShortCatalog(vm) { + const key = shortCatalogKey(vm); + const pageSize = Number(vm && vm.pageSize) || 16; + const orderBy = (vm && vm.sortColumn) || 'createTime'; + const orderType = (vm && vm.sortType) || 'desc'; + const req = shortCatalogRequest(vm); + const api = shortApiBase(); + const datas = []; + let offset = 0; + let total = Infinity; + let requests = 0; + + while (offset < total && requests < 20) { + const limit = Number.isFinite(total) ? Math.min(6000, total - offset) : 6000; + if (limit <= 0) break; + const url = api + '?limit=' + limit + '&offset=' + offset + + '&orderType=' + encodeURIComponent(orderType) + + '&orderBy=' + encodeURIComponent(orderBy); + const res = await fetch(url, { method: 'POST', headers: req.headers, body: req.body }); + if (!res.ok) throw new Error('列表接口 HTTP ' + res.status); + const json = await res.json(); + const list = json && json.datas; + if (!Array.isArray(list)) throw new Error('列表接口返回格式异常'); + if (!list.length) break; + datas.push.apply(datas, list); + total = Number(json.paging && json.paging.count); + if (!Number.isFinite(total)) total = datas.length; + offset += list.length; + requests++; + } + + const items = []; + datas.forEach(function (item, index) { + if (!item || !item.title) return; + if (Number(item.status) === 2 || item.studyComplete === 1 || item.studyComplete === true) return; + const seconds = Number(item.studyHours); + items.push({ + id: item.id ? String(item.id) : '', + title: norm(item.title), + duration: Number.isFinite(seconds) && seconds > 0 ? seconds : 0, + status: item.status, + page: Math.floor(index / pageSize) + 1, + }); + }); + // 时长未知的排最后;相同时按原来的列表顺序(页码) + items.sort(function (a, b) { + const da = a.duration > 0 ? a.duration : Number.MAX_SAFE_INTEGER; + const db = b.duration > 0 ? b.duration : Number.MAX_SAFE_INTEGER; + return da === db ? a.page - b.page : da - db; + }); + + return { key: key, at: Date.now(), pageSize: pageSize, total: datas.length, items: items }; + } + + // 返回 'off' | 'loading' | 'ready' | 'failed' + function ensureShortCatalog() { + if (!state.preferShort) return 'off'; + + const vm = listVm(); + if (!vm) { + if (!R.shortNoVmSince) R.shortNoVmSince = Date.now(); + if (Date.now() - R.shortNoVmSince > 5000) { + R.shortCatalogFailedAt = Date.now(); + if (Date.now() - (R.shortWarnedAt || 0) > 10000) { + R.shortWarnedAt = Date.now(); + console.warn(TAG, '未找到课程列表组件,退回当前页时长排序'); + setStatus('未读取到课程列表数据,先按当前页时长排序'); + } + return 'failed'; + } + return 'loading'; + } + R.shortNoVmSince = 0; + + const key = shortCatalogKey(vm); + if (R.shortCatalog && R.shortCatalog.key === key && + Date.now() - (R.shortCatalog.at || 0) < SHORT_CATALOG_TTL) { + return 'ready'; + } + + if (R.shortCatalogLoading) { + if (Date.now() - R.shortFetchStartedAt > 20000) { + R.shortCatalogLoading = false; + R.shortCatalogFailedAt = Date.now(); + return 'failed'; + } + return 'loading'; + } + if (R.shortCatalogFailedAt && Date.now() - R.shortCatalogFailedAt < 30000) return 'failed'; + + const cached = readShortCatalog(key); + if (cached) { + R.shortCatalog = cached; + return 'ready'; + } + + R.shortCatalogLoading = true; + R.shortFetchStartedAt = Date.now(); + setStatus('正在读取课程时长,优先安排短课程…'); + fetchShortCatalog(vm).then(function (cat) { + R.shortCatalogLoading = false; + if (!state.preferShort) return; + R.shortCatalogFailedAt = 0; + R.shortCatalog = cat; + writeShortCatalog(cat); + const shortest = cat.items[0]; + console.log(TAG, '短课程队列已就绪:待学', cat.items.length, '门;最短', + shortest ? formatDuration(shortest.duration) : '无'); + setStatus(shortest + ? '优先短课程:共 ' + cat.items.length + ' 门待学,最短 ' + formatDuration(shortest.duration) + : '时长队列为空,按当前页继续'); + updatePanel(); + }).catch(function (e) { + R.shortCatalogLoading = false; + R.shortCatalogFailedAt = Date.now(); + if (!state.preferShort) return; + console.warn(TAG, '读取课程时长失败,退回当前页时长排序:', + e && e.message ? e.message : e); + setStatus('未能读取全部课程时长,先按当前页时长排序'); + updatePanel(); + }); + return 'loading'; + } + + function shortFallback(reason) { + R.shortCatalog = null; + R.shortCatalogFailedAt = Date.now(); + try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) { /* ignore */ } + if (Date.now() - (R.shortWarnedAt || 0) > 10000) { + R.shortWarnedAt = Date.now(); + console.warn(TAG, '短课程优先暂不可用,退回当前页时长排序:', reason); + setStatus('短课程优先暂不可用,先按当前页时长排序'); + } + } + + function pendingShortItems() { + const cat = R.shortCatalog; + if (!cat) return []; + return cat.items.filter(function (item) { + if (!item || !item.title) return false; + if (S.done[item.title] || S.failed[item.title]) return false; + return true; + }); + } + + // 列表卡片 -> 课程 id。卡片的打开逻辑按 id 跳转,而播放页 URL 带 kngId: + // 有了 id 就能在标题还没刷新时准确判断「进的是不是队列里的这门课」, + // 不再因为页面标题短暂是 loading/在线课堂 就误判并退回列表。 + function courseIdOfCard(card) { + if (!card) return ''; + const vm = listVm(); + const data = (vm && vm.kngListData) || []; + const byIndex = data[card.i]; + const t = norm(card.title); + if (byIndex && String(byIndex.id || '') && norm(byIndex.title) === t) { + return String(byIndex.id); + } + const hit = data.find(function (x) { return x && norm(x.title) === t; }); + return hit && hit.id ? String(hit.id) : ''; + } + + function durationOfCard(card, vm) { + if (!card) return 0; + const data = (vm && vm.kngListData) || []; + const hit = data.find(function (item) { return norm(item.title) === card.title; }); + const n = hit ? Number(hit.studyHours) : 0; + return Number.isFinite(n) && n > 0 ? n : 0; + } + + // 优先用课程 id 匹配卡片,避免同名课程(平台上确实有)点错; + // id 不可用时再退回标题匹配。 + function cardForShortItem(cards, item) { + if (!item) return null; + if (item.id) { + const vm = listVm(); + const data = (vm && vm.kngListData) || []; + const index = data.findIndex(function (x) { return x && String(x.id) === item.id; }); + if (index >= 0 && cards[index] && cards[index].title === item.title) return cards[index]; + } + return cards.find(function (c) { return c.title === item.title; }) || null; + } + + function sortCardsByDuration(cards, vm) { + vm = vm || listVm(); + return cards.slice().sort(function (a, b) { + const da = durationOfCard(a, vm) || Number.MAX_SAFE_INTEGER; + const db = durationOfCard(b, vm) || Number.MAX_SAFE_INTEGER; + return da - db; + }); + } + + function forgetShortCourse(title) { + const t = norm(title); + if (!t || !R.shortCatalog || !Array.isArray(R.shortCatalog.items)) return; + const before = R.shortCatalog.items.length; + R.shortCatalog.items = R.shortCatalog.items.filter(function (item) { return item.title !== t; }); + if (R.shortCatalog.items.length !== before) writeShortCatalog(R.shortCatalog); + } + + // 返回 { card } 表示本 tick 可以进入该课程;{ wait: true } 表示正在加载/翻页。 + function chooseShortCourse(cards, pending) { + if (!state.preferShort) return null; + const status = ensureShortCatalog(); + + if (status === 'loading') return { wait: true }; + + if (status === 'ready') { + const items = pendingShortItems(); + if (items.length) { + const target = items[0]; + const page = currentPage() || S.listPage || 1; + if (target.page && target.page !== page) { + if (Date.now() - R.shortJumpAt < 6000) return { wait: true }; + R.shortJumpAt = Date.now(); + if (jumpToPage(target.page)) { + S.listPage = target.page; + save(); + setStatus('优先短课程:转到第 ' + target.page + ' 页(' + + formatDuration(target.duration) + ')'); + return { wait: true }; + } + if (Date.now() - R.lastPageJumpAt < 3500) return { wait: true }; + shortFallback('无法跳转到第 ' + target.page + ' 页'); + } else { + const card = cardForShortItem(cards, target); + if (card) { + if (card.status === '已学完' || S.done[card.title] || S.failed[card.title]) { + // 缓存与实际状态不一致:剔除这一门,下一 tick 继续挑下一门 + forgetShortCourse(card.title); + return { wait: true }; + } + card.duration = target.duration; + R.shortJumpAt = 0; + return { card: card }; + } + // 刚翻到目标页时卡片可能还没渲染完 + if (Date.now() - R.shortJumpAt < 8000) return { wait: true }; + shortFallback('目标课程不在第 ' + target.page + ' 页'); + } + } + } + + // 兜底:当前页未学完课程按时长正序 + if (pending && pending.length) { + const vm = listVm(); + const sorted = sortCardsByDuration(pending, vm); + if (sorted.length) { + sorted[0].duration = durationOfCard(sorted[0], vm); + return { card: sorted[0], local: true }; + } + } + return null; + } + function listTick() { const cards = scanCards(); if (!cards.length) return; // 列表还没渲染 @@ -947,6 +1394,9 @@ S.returning = false; save(); } else if (S.listPage > page) { + // 短课程优先会直接跳到很靠后的页(例如第 307 页), + // 不能一页一页 nextPage,否则要翻几百次;优先用页码输入框直跳。 + if (jumpToPage(S.listPage)) return; nextPage(); return; } else { @@ -969,8 +1419,23 @@ // 已在进入课程的过程中:等路由跳转 if (S.current && S.phase === 'entering') { - if (Date.now() - (S.current.startedAt || 0) > 15000) { + const waited = Date.now() - (S.current.startedAt || 0); + if (waited > 15000) { failCurrent('未能进入课程页面'); + return; + } + // 列表卡片点击偶尔会落在脚本/路由就绪之前(页面毫无反应)。还停在列表时 + // 最多补点两次,而不是直接把这门课记成失败跳过。 + if (waited > 4000 && R.entryRetries < 2 && + Date.now() - R.lastCardClickAt > 4000) { + const card = cards.find(function (c) { return c.title === S.current.title; }); + if (card) { + R.entryRetries++; + R.lastCardClickAt = Date.now(); + console.log(TAG, '进入课程超时,重试点击卡片(第', R.entryRetries, '次)'); + setStatus('重新进入课程:' + truncate(S.current.title, 22)); + try { clickNode(card.li); } catch (e) { /* ignore */ } + } } return; } @@ -981,8 +1446,9 @@ if (Date.now() - R.listWithCurrentSince < 5000) return; const card = cards.find(function (c) { return c.title === S.current.title; }); - if (card && card.status === '已学完') { + if (card && /已学完|已完成|已学习/.test(card.status)) { S.done[S.current.title] = Date.now(); + forgetShortCourse(S.current.title); S.completedThisRun = (S.completedThisRun || 0) + 1; } S.current = null; @@ -997,12 +1463,24 @@ const pending = cards.filter((c) => { if (!c.title) return false; - if (c.status === '已学完') return false; + if (/已学完|已完成|已学习/.test(c.status)) return false; if (S.done[c.title]) return false; if (S.failed[c.title]) return false; return true; }); + // 优先短课程:先读时长队列,跨页挑总时长最短的未学完课程; + // 接口不可用时 chooseShortCourse 会退回当前页时长排序或原列表顺序。 + if (state.preferShort) { + const choice = chooseShortCourse(cards, pending); + if (choice && choice.wait) return; + if (choice && choice.card) { + if (Date.now() - R.lastCardClickAt < 5000) return; + startCourse(choice.card); + return; + } + } + if (pending.length) { if (Date.now() - R.lastCardClickAt < 5000) return; startCourse(pending[0]); @@ -1022,18 +1500,23 @@ const page = currentPage() || S.listPage || 1; S.current = { title: card.title, + id: courseIdOfCard(card), status: card.status, startedAt: Date.now(), page: page, + duration: card.duration || 0, }; S.listPage = page; S.phase = 'entering'; S.returning = false; R.lastCardClickAt = Date.now(); + R.shortJumpAt = 0; resetCourseRuntime(); save(); - setStatus('进入课程:' + truncate(card.title, 28)); - console.log(TAG, '进入课程', card.title, '状态', card.status); + const durationText = card.duration ? '(' + formatDuration(card.duration) + ')' : ''; + setStatus('进入课程' + durationText + ':' + truncate(card.title, 28)); + console.log(TAG, '进入课程', card.title, '状态', card.status, + card.duration ? '时长 ' + formatDuration(card.duration) : ''); try { card.li.click(); } catch (e) { @@ -1086,7 +1569,7 @@ for (const doc of collectDocuments()) { let vids; try { - vids = doc.querySelectorAll('video'); + vids = doc.querySelectorAll('video, audio'); } catch (e) { continue; } @@ -1095,10 +1578,11 @@ } function findPlayableVideo() { - const vids = [...document.querySelectorAll('video')].filter(function (v) { + const vids = [...document.querySelectorAll('video, audio')].filter(function (v) { return v.duration > 0 || v.currentSrc; }); return vids.find(function (v) { return !v.paused; }) || + vids.find(function (v) { return isVisible(v) && v.duration > 0; }) || vids.find(function (v) { return v.duration > 0; }) || vids[0] || null; } @@ -1119,12 +1603,50 @@ playVideo(v); } + // 平台完成状态有三种真实文案: + // 多课时课程:已完成 2/3 + // 单视频/音频:已完成 0% -> 已完成 67% + // 全部学完: 已完成学习 (此时进度条和倒计时都会消失) + // 旧实现只认 x/y,课程真正学完后汇总变成「已完成学习」→ 永远不判完成, + // 结果就是停在课程页、不回列表、也不进入下一门。 function readSummary() { const el = document.querySelector('[class*="course-summary"]'); if (!el) return null; - const m = textOf(el).match(/已完成(\d+)\/(\d+)/); - if (!m) return null; - return { x: Number(m[1]), y: Number(m[2]), text: m[0] }; + const t = textOf(el); + + const m = t.match(/已完成(\d+)\/(\d+)/); + if (m) { + const x = Number(m[1]); + const y = Number(m[2]); + return { + x: x, y: y, percent: y > 0 ? Math.round((x / y) * 100) : 0, + complete: y > 0 && x >= y, kind: 'ratio', text: t, + }; + } + + const pct = t.match(/已完成(\d+)%/); + if (pct) { + const x = Number(pct[1]); + return { x: x, y: 100, percent: x, complete: x >= 100, kind: 'percent', text: t }; + } + + if (/已完成学习|学习完成|已完成本课程|已学完/.test(t)) { + return { x: 100, y: 100, percent: 100, complete: true, kind: 'done', text: t }; + } + + // 兜底:个别页面没有文案,只有进度条 + const bar = el.querySelector('[role="progressbar"]'); + if (bar) { + const now = Number(bar.getAttribute('aria-valuenow')); + const max = Number(bar.getAttribute('aria-valuemax')) || 100; + if (Number.isFinite(now)) { + return { + x: now, y: max, percent: Math.round((now / max) * 100), + complete: now >= max, kind: 'percent', text: t, + }; + } + } + return null; } function readCountdown() { @@ -1154,27 +1676,37 @@ } function findNextLessonElement() { - const active = document.querySelector('.yxtulcdsdk-catalog .liactive'); - const activeLi = active ? active.closest('li') : null; + const activeLi = lessonActiveLi(); if (!activeLi) return null; const lis = lessonItems(); const idx = lis.indexOf(activeLi); - if (idx >= 0 && idx + 1 < lis.length) { - const nextLi = lis[idx + 1]; - return nextLi.querySelector('.hand') || nextLi; - } - return null; + if (idx < 0 || idx + 1 >= lis.length) return null; + // 返回 li 本身:真正的点击目标由 clickLesson 选择。以前返回内部 .hand, + // 在真实目录里那是 ,没有 click(),next.click() 会抛异常 → 切节失效。 + return lis[idx + 1]; } function isLessonCompleted(li) { try { - // 1) 完成态图标(平台用勾选 svg 标记已学完的课时) + // 1) 状态文案:目录里的标签可能在标题前(「已学完 第1节」),也可能在标题后, + // 不能只认结尾,否则一个都识别不出来 → 每次都退回第一节 + const text = textOf(li); + if (/已学完|已完成/.test(text)) return true; + + // 2) 语义属性/类名(平台改版时比 svg 路径稳定) + const hint = [ + li.getAttribute('aria-label') || '', + li.getAttribute('title') || '', + String(li.className || ''), + ].join(' '); + if (/已学完|已完成|finished|completed|is-done/i.test(hint)) return true; + + // 3) 完成态图标:平台用一个起点 M10 2.75 的实心圆 + 对勾 const ds = [...li.querySelectorAll('svg path')] .map(function (p) { return String(p.getAttribute('d') || ''); }); - if (ds.some(function (d) { return d.indexOf('M10 2.75') === 0; })) return true; - // 2) 文本兜底 - if (/(已学完|已完成)$/.test(textOf(li))) return true; - return false; + return ds.some(function (d) { + return d.replace(/,/g, ' ').indexOf('M10 2.75') >= 0; + }); } catch (e) { return false; } @@ -1182,7 +1714,7 @@ function findFirstIncompleteLessonElement() { for (const li of lessonItems()) { - if (!isLessonCompleted(li)) return li.querySelector('.hand') || li; + if (!isLessonCompleted(li)) return li; } return null; } @@ -1232,46 +1764,92 @@ } catch (e) { fireMouse(el, type.replace('pointer', 'mouse')); } } - // 第 1 次点 li 本身;第 2 次点内部句柄;第 3 次补完整鼠标事件序列; - // 第 4 次优先点该课时自带的「开始学习/继续学习」按钮 + // 目录里的展开箭头、课时状态图标都是 ,而 SVGSVGElement 并没有 + // HTMLElement 的 click() 方法:直接 el.click() 会抛 TypeError 并被静默吞掉, + // 等于“点了但什么都没发生”。任何节点都统一走这里,必要时派发鼠标事件。 + function clickNode(el) { + if (!el) return false; + try { + if (typeof el.click === 'function') { + el.click(); + return true; + } + } catch (e) { /* 落到下面的事件派发 */ } + fireMouse(el, 'click'); + return true; + } + + // 有些点击逻辑挂在 mousedown/pointerup 上,补一整套鼠标事件序列 + function fireClickSequence(el) { + if (!el) return; + firePointer(el, 'pointerdown'); + fireMouse(el, 'mousedown'); + firePointer(el, 'pointerup'); + fireMouse(el, 'mouseup'); + clickNode(el); + } + + // 课时的点击句柄可能挂在标题 span、行容器、li 或右侧状态图标任意一层, + // 这里按「由内向外」返回候选节点:点最内层标题时事件会依次冒泡到行容器和 li, + // 能覆盖这三种常见写法;状态图标(svg)放最后作兜底。 + function lessonClickNodes(li) { + const title = li.querySelector('.item') || + li.querySelector('.yxtf-tooltip') || + li.querySelector('span'); + const row = li.querySelector('[class*="flex-space-between"]') || li.querySelector('div'); + const svg = li.querySelector('svg'); + return [title, row, li, svg].filter(Boolean); + } + + // 点击第 attempt 次切换课时,逐次换目标与事件方式: + // 1) 标题 span 2) 标题 + 行容器 3) 完整鼠标序列(标题) 4) 行容器 + 课时自带按钮 + // 5) li 6) 状态图标 …… 避免前两次点偏后就直接放弃 function clickLesson(li, attempt) { - const inner = li.querySelector('.hand') || li.querySelector('a') || li.querySelector('span'); - const targets = inner && inner !== li ? [li, inner] : [li]; + if (!li) return; + const nodes = lessonClickNodes(li); + if (!nodes.length) return; + const title = nodes[0]; + const row = nodes[1] && nodes[1] !== li ? nodes[1] : null; + const svg = li.querySelector('svg'); + + if (attempt <= 2) { + clickNode(title); + if (attempt === 2 && row) clickNode(row); + return; + } if (attempt >= 4) { const startBtn = [...li.querySelectorAll('button, [role="button"], span, div')] .find(function (el) { return el.children.length <= 1 && /^(开始学习|继续学习)$/.test(textOf(el)); }); - if (startBtn) { - try { startBtn.click(); } catch (e) { /* ignore */ } - return; - } + if (startBtn) clickNode(startBtn); } - const target = targets[(attempt - 1) % targets.length]; - try { target.click(); } catch (e) { /* ignore */ } - - if (attempt >= 3) { - for (const el of targets) { - firePointer(el, 'pointerdown'); - fireMouse(el, 'mousedown'); - firePointer(el, 'pointerup'); - fireMouse(el, 'mouseup'); - fireMouse(el, 'click'); - } - } + fireClickSequence(title); + const targets = [title, row, li, svg].filter(Boolean); + const target = targets[(attempt - 3) % targets.length]; + if (target && target !== title) fireClickSequence(target); } - // 平台切课时可能弹「确认切换/退出当前学习」,自动点掉 + // 平台切课时可能弹「确认切换/退出当前学习」,自动点掉。 + // 先只在弹层里找,避免误点页面上的其它同名按钮。 function confirmLessonDialog() { - const els = [...document.querySelectorAll( - '.yxt-dialog__wrapper button, .yxt-dialog__wrapper [role="button"], [class*="dialog"] button, button' - )]; - for (const el of els) { + const pat = /^(确定|确认|是|切换|确定切换|继续切换|继续学习|继续观看|知道了)$/; + const boxes = [...document.querySelectorAll( + '.yxt-dialog__wrapper, [class*="dialog"], [class*="modal"], [role="dialog"]' + )].filter(isVisible); + let buttons = []; + for (const box of boxes) { + buttons = buttons.concat([...box.querySelectorAll('button, [role="button"]')]); + } + if (!buttons.length) { + buttons = [...document.querySelectorAll('button, [role="button"]')]; + } + for (const el of buttons) { if (!isVisible(el)) continue; - if (/^(确定|确认|继续|是|切换)$/.test(textOf(el))) { - try { el.click(); } catch (e) { /* ignore */ } + if (pat.test(textOf(el))) { + clickNode(el); return true; } } @@ -1430,6 +2008,97 @@ .trim(); } + // 对齐起点:把当前课时切到「第一个未学完的课时」。 + // 返回 true = 本 tick 已处理(正在切换 / 等待确认),调用方应直接 return; + // 返回 false = 无需对齐或已对齐,可以继续播放逻辑。 + // 成功与否以目录高亮为准(连续两个 tick 都在目标课时才算数), + // 避免面板声称已切换、实际仍停在平台上次的位置。 + function alignToFirstIncomplete() { + if (!CFG.alignToFirstIncomplete || R.initialLessonChecked) return false; + + const lis = lessonItems(); + if (!lis.length) return false; // 目录还没渲染,等下一轮 + + if (!R.phaseSince) R.phaseSince = Date.now(); + if (Date.now() - R.phaseSince < 1500) return true; // 等平台恢复完上次位置再纠正 + + const activeLi = lessonActiveLi(); + const activeIdx = activeLi ? lis.indexOf(activeLi) : -1; + const targetLi = findFirstIncompleteLessonElement(); + const targetIdx = targetLi ? lis.indexOf(targetLi) : -1; + + if (targetIdx < 0) { + // 所有课时都已完成,整门课是否结束交给 summary 判断 + R.initialLessonChecked = true; + return false; + } + + if (targetIdx === activeIdx) { + // 连续两次确认已在目标课时,才算对齐成功 + R.alignStable++; + if (R.alignStable < 2) return true; + R.initialLessonChecked = true; + R.lastLessonKey = readActiveLessonKey(); + console.log(TAG, '起点已对齐:第', targetIdx + 1, '节', truncate(textOf(targetLi), 24)); + setStatus('从第 ' + (targetIdx + 1) + ' 节开始:' + truncate(textOf(targetLi), 18)); + return false; + } + + R.alignStable = 0; + + if (R.alignTries >= 8) { + R.initialLessonChecked = true; + R.alignFailed = true; + setStatus('未能切换到第 ' + (targetIdx + 1) + ' 节,按当前位置继续'); + console.warn(TAG, '起点对齐失败:点击课时后平台未切换,目录快照:', dumpCatalog()); + return false; + } + R.alignTries++; + + // 章节折叠时子课时不可点,先展开所属章节。 + // 展开箭头通常是 ,必须用 clickNode 派发事件(svg 没有 click() 方法)。 + if (layoutAvailable() && !isVisible(targetLi)) { + let ul = targetLi.parentElement; + while (ul && ul.tagName !== 'UL') ul = ul.parentElement; + const collapsed = ul && getComputedStyle(ul).display === 'none'; + const chapterLi = ul && ul.parentElement ? ul.parentElement.closest('li') : null; + if (collapsed && chapterLi && R.alignTries <= 3) { + setStatus('展开章节:' + truncate(textOf(chapterLi), 20)); + clickNode(chapterLi.querySelector('.hand') || chapterLi); + return true; + } + } + + // 切课时平台可能弹确认框,先点掉(第 1 次不查,避免误点页面上的其他「确定」) + if (R.alignTries > 1 && confirmLessonDialog()) { + setStatus('已确认切换提示,继续…'); + return true; + } + + console.log(TAG, '对齐起点:第', activeIdx >= 0 ? (activeIdx + 1) : '?', '节 → 第', targetIdx + 1, '节', + '(第 ' + R.alignTries + ' 次)'); + setStatus('正在切换到第 ' + (targetIdx + 1) + ' 节…' + + (R.alignTries > 1 ? '(第 ' + R.alignTries + ' 次)' : '')); + clickLesson(targetLi, R.alignTries); + return true; + } + + // 手动模式没有 S.current,用课程标题判断是否换了一门课,换课时重新对齐 + function syncManualCourse() { + const key = courseTitle() || location.href; + if (R.manualCourseKey === key) return true; + R.manualCourseKey = key; + R.initialLessonChecked = false; + R.phaseSince = 0; + R.alignTries = 0; + R.alignStable = 0; + R.alignFailed = false; + R.lastLessonKey = ''; + R.doneLatchKey = ''; + R.waitStart = 0; + return true; + } + // ======== 课程页 ======== function courseTick() { R.listWithCurrentSince = 0; @@ -1438,21 +2107,43 @@ return; } + // 播放器可能是点「开始学习」后才创建的;每轮顺带接管一次, + // 新视频一出现就静音并挂上 play/ended/timeupdate 监听。 + hookAllVideos(); + + const isMedia = mediaPage(); + const urlId = courseIdFromUrl(); + const curId = S.current.id || ''; const title = courseTitle(); const nt = norm(title); const nc = norm(S.current.title); - const sameCourse = !nt || !nc || nt === nc || nt.indexOf(nc) >= 0 || nc.indexOf(nt) >= 0; - if (!sameCourse && Date.now() - S.current.startedAt > 12000) { - failCurrent('页面课程与队列不一致'); + const genericTitle = !nt || /^(loading|加载中|在线课堂|江丰云课堂|云课堂|课程详情|课程)$/.test(nt); + const titleSame = genericTitle || !nc || nt === nc || + nt.indexOf(nc) >= 0 || nc.indexOf(nt) >= 0; + // 有了 URL 里的 kngId 就以 id 为准:标题在 SPA 切页时经常短暂是 loading/ + // 在线课堂,旧逻辑会把它当成「课程不一致」在 12 秒后把课退回列表。 + const idKnown = !!(urlId && curId); + const sameCourse = idKnown ? urlId === curId : titleSame; + const graceOver = Date.now() - (S.current.startedAt || 0) > (CFG.entryGraceMs || 30000); + if (!sameCourse) { + if (graceOver) { + console.warn(TAG, '页面课程与队列不一致:队列', nc, curId, + '页面', nt, urlId, location.href); + failCurrent('页面课程与队列不一致'); + return; + } return; } - if (!sameCourse) return; if (S.phase !== 'learning') { S.phase = 'learning'; save(); } + // #/scan 只是进课过渡页:此时页面组件里可能还残留上一门课的汇总, + // 等路由切到真正的播放页再判断,避免把旧课程的「已完成学习」当成新课程完成。 + if ((location.hash || '').indexOf('#/scan') === 0) return; + // 1) 防挂机验证(每 10 分钟弹一次,120 秒内不点「继续学习」就停止计时) if (handleAntiIdle()) return; @@ -1478,9 +2169,16 @@ const summary = readSummary(); const prevSummaryX = R.lastSummary ? R.lastSummary.x : -1; if (summary) { - if (summary.y > 0 && summary.x >= summary.y) { + // 三种完成文案统一走这里:x/y 满、百分比 100%、「已完成学习」。 + // 页面切换瞬间可能读到上一门课的残留文案,连续两次读到才确认。 + if (summary.complete) { + const confirmed = !!(R.lastSummary && R.lastSummary.complete); R.lastSummary = summary; - completeCurrent(); + if (confirmed) { + completeCurrent(); + return; + } + setStatus('课程已完成,确认中…'); return; } @@ -1490,13 +2188,16 @@ const curKey = readActiveLessonKey(); R.lastSummary = summary; - if (!prevKey || curKey === prevKey) { + // 单视频/音频页的百分比是播放进度,不是「一节学完」,不能据此切节 + if (!isMedia && summary.kind !== 'percent' && (!prevKey || curKey === prevKey)) { // 平台已记账但没有自动切节 → 脚本主动切下一节 setStatus('本节已记录,切换下一节…'); advanceLesson(); return; } - setStatus('进度更新:' + summary.x + '/' + summary.y); + setStatus(summary.kind === 'percent' + ? '学习进度:' + summary.x + '%' + : '进度更新:' + summary.x + '/' + summary.y); return; } @@ -1505,72 +2206,8 @@ // 5) 对齐起点:进入课程后统一从「第一个未学完的课时」开始(即第一章第一节起顺序学), // 不沿用平台上次停留的位置。否则前面的课时会被跳过,整门课永远学不完。 - // 关键:只有“确认已经切过去”才算对齐成功,避免面板声称已切换、实际还在原课时。 - if (CFG.alignToFirstIncomplete && !R.initialLessonChecked) { - const lis = lessonItems(); - if (lis.length) { - if (!R.phaseSince) R.phaseSince = Date.now(); - if (Date.now() - R.phaseSince < 1500) return; // 等平台恢复完上次位置再纠正 - - const activeLi = lessonActiveLi(); - const targetEl = findFirstIncompleteLessonElement(); - // 目录项本身就是 .hand,这里统一归位到 li,保证与 lessonItems() 同源可比 - const targetLi = targetEl - ? (targetEl.closest ? (targetEl.closest('li') || targetEl) : targetEl) - : null; - const activeIdx = activeLi ? lis.indexOf(activeLi) : -1; - const targetIdx = targetLi ? lis.indexOf(targetLi) : -1; - - if (targetIdx < 0) { - // 所有课时都已完成,交给上面的 summary 判断整门课是否结束 - R.initialLessonChecked = true; - } else if (targetIdx === activeIdx) { - // 连续两次确认已在目标课时,才算对齐成功 - R.alignStable++; - if (R.alignStable >= 2) { - R.initialLessonChecked = true; - R.lastLessonKey = readActiveLessonKey(); - console.log(TAG, '起点已对齐:第', targetIdx + 1, '节', - truncate(textOf(targetLi), 24)); - setStatus('从第 ' + (targetIdx + 1) + ' 节开始:' + truncate(textOf(targetLi), 18)); - } - } else if (R.alignTries < 4) { - R.alignTries++; - R.alignStable = 0; - - // 章节折叠时子课时不可点,先展开所属章节 - if (layoutAvailable() && !isVisible(targetLi)) { - let ul = targetLi.parentElement; - while (ul && ul.tagName !== 'UL') ul = ul.parentElement; - const collapsed = ul && getComputedStyle(ul).display === 'none'; - const chapterLi = ul && ul.parentElement ? ul.parentElement.closest('li') : null; - if (collapsed && chapterLi && R.alignTries <= 2) { - setStatus('展开章节:' + truncate(textOf(chapterLi), 20)); - try { (chapterLi.querySelector('.hand') || chapterLi).click(); } catch (e) {} - return; - } - } - - // 切课时平台可能弹确认框,先点掉(第 1 次不查,避免误点页面上的其他「确定」) - if (R.alignTries > 1 && confirmLessonDialog()) { - setStatus('已确认切换提示,继续…'); - return; - } - - console.log(TAG, '对齐起点:第', activeIdx >= 0 ? (activeIdx + 1) : '?', '节 → 第', targetIdx + 1, '节', - '(第 ' + R.alignTries + ' 次)'); - setStatus('正在切换到第 ' + (targetIdx + 1) + ' 节…' + - (R.alignTries > 1 ? '(第 ' + R.alignTries + ' 次)' : '')); - clickLesson(targetLi, R.alignTries); - return; - } else { - R.initialLessonChecked = true; - R.alignFailed = true; - setStatus('未能切换到第 ' + (targetIdx + 1) + ' 节,按当前位置继续'); - console.warn(TAG, '起点对齐失败:点击课时后平台未切换,目录快照:', dumpCatalog()); - } - } - } + // 单视频/音频页没有目录,不走这一步。 + if (!isMedia && alignToFirstIncomplete()) return; // 6) 计时与当前章节 const cd = readCountdown(); @@ -1584,6 +2221,7 @@ const lessonKey = readActiveLessonKey(); if (lessonKey && lessonKey !== R.lastLessonKey) { R.lastLessonKey = lessonKey; + R.doneLatchKey = ''; R.waitStart = 0; R.waitSummaryX = -1; R.waitLessonKey = ''; @@ -1593,21 +2231,34 @@ // 7) 本节是否已在本地结束(必须先判断,避免把已结束的视频重新拉回开头) const v = findPlayableVideo(); - // 视频 ended 是本节结束的主信号;倒计时文案在切节后可能变成下一节的时长 - const localDone = !!(v && v.ended) || (cd != null && cd <= 0); + // 视频 ended 是本节结束的主信号;倒计时文案在切节后可能变成下一节的时长。 + // doneLatchKey 用来记住「这节已经播完」:平台在完成后会把播放器重置到 0 秒, + // video.ended 变回 false、倒计时也消失,若只看即时状态就会把视频从头重播。 + const latchKey = isMedia ? 'media' : (lessonKey || ''); + const cdDone = cd != null && cd <= 0; + const ended = !!(v && v.ended); + if (latchKey && R.doneLatchKey && R.doneLatchKey !== latchKey) R.doneLatchKey = ''; + if (latchKey && (cdDone || (ended && (cd == null || cd <= 3)))) { + R.doneLatchKey = latchKey; + } + const localDone = ended || cdDone || + (!!latchKey && R.doneLatchKey === latchKey); // 8) 播放器 if (!localDone) { if (v) { ensurePlaying(v); - if (statusEl && statusEl.textContent === '点击开始学习…') { - setStatus('学习中:' + truncate(lessonKey, 30)); + const want = '学习中:' + truncate(lessonKey || S.current.title, 30); + if (statusEl && (statusEl.textContent === '点击开始学习…' || + (isMedia && statusEl.textContent !== want))) { + setStatus(want); } } else { - const startBtn = findVisibleButton(/^(开始学习|继续学习)$/); + const startBtn = findVisibleClickable(/^(开始学习|继续学习|继续观看)$/); if (startBtn && Date.now() - R.lastStartClickAt > CFG.startClickCooldownMs) { R.lastStartClickAt = Date.now(); setStatus('点击开始学习…'); + console.log(TAG, '点击开始学习', textOf(startBtn) || startBtn.tagName); try { startBtn.click(); } catch (e) {} } } @@ -1620,7 +2271,7 @@ R.waitStart = Date.now(); R.waitSummaryX = prevSummaryX; R.waitLessonKey = lessonKey; - setStatus('本节结束,等待平台记录…'); + setStatus(isMedia ? '课程已播完,等待平台记录…' : '本节结束,等待平台记录…'); } // 10) 等待平台记录本节完成 @@ -1628,20 +2279,35 @@ const newKey = readActiveLessonKey(); const s2 = readSummary(); - // 平台自动进入了下一节 - if (R.waitLessonKey && newKey && newKey !== R.waitLessonKey) { + // 整门课已完成(含「已完成学习」/百分比 100%) + if (s2 && s2.complete) { + const confirmed = !!(R.lastSummary && R.lastSummary.complete); + R.lastSummary = s2; + if (!confirmed) { + setStatus('课程已完成,确认中…'); + return; + } + R.waitStart = 0; + R.lastProgressAt = Date.now(); + completeCurrent(); + return; + } + + // 平台自动进入了下一节(只可能发生在有目录的多课时课程) + if (!isMedia && R.waitLessonKey && newKey && newKey !== R.waitLessonKey) { R.waitStart = 0; R.lastLessonKey = newKey; + R.doneLatchKey = ''; R.lastProgressAt = Date.now(); setStatus('已自动进入下一节'); return; } // 完成数增加 → 手动切下一节 - if (s2 && s2.x > R.waitSummaryX) { + if (!isMedia && s2 && s2.x > R.waitSummaryX) { R.waitStart = 0; R.lastProgressAt = Date.now(); - if (s2.y > 0 && s2.x >= s2.y) { + if (s2.complete) { completeCurrent(); } else { advanceLesson(); @@ -1650,9 +2316,15 @@ } if (Date.now() - R.waitStart > 30000) { - R.waitStart = 0; - setStatus('平台未更新进度,尝试下一节…'); - advanceLesson(); + if (isMedia) { + // 单视频/音频:平台记账有延迟,继续等,不能把已播完的视频再拉回 0 秒 + R.waitStart = Date.now(); + setStatus('课程已播完,等待平台完成记录…'); + } else { + R.waitStart = 0; + setStatus('平台未更新进度,尝试下一节…'); + advanceLesson(); + } } return; } @@ -1663,28 +2335,55 @@ } } + // 自动切下一节:先点标题(事件会冒泡到行容器 / li 上的句柄), + // 平台没反应时再依次补点行容器、li、状态图标;每一步都先确认目标课时还没 + // 变成当前课时,避免平台自己已经切过去之后又被点回来。 + function switchLesson(li) { + if (!li) return; + const want = norm(textOf(li)); + const nodes = lessonClickNodes(li); + const svg = li.querySelector('svg'); + const steps = [ + { at: 0, run: function () { clickNode(nodes[0]); } }, + { at: 500, run: function () { if (nodes[1]) clickNode(nodes[1]); } }, + { at: 1000, run: function () { fireClickSequence(li); } }, + { at: 1500, run: function () { if (svg) fireClickSequence(svg); } }, + ]; + for (const step of steps) { + if (!step.at) { + step.run(); + continue; + } + later(function () { + if (want && readActiveLessonKey() === want) return; + step.run(); + }, step.at); + } + } + function advanceLesson() { if (Date.now() - R.lastAdvanceAt < 5000) return; R.lastAdvanceAt = Date.now(); R.lastCountdown = null; R.lastLessonKey = ''; + R.doneLatchKey = ''; R.waitStart = 0; const next = findNextLessonElement(); if (next) { setStatus('进入下一节'); - try { next.click(); } catch (e) {} + switchLesson(next); return; } const btn = findNextButton(); if (btn) { setStatus('进入下一节'); - try { btn.click(); } catch (e) {} + clickNode(btn); return; } const s = readSummary(); - if (s && s.y > 0 && s.x >= s.y) { + if (s && s.complete) { completeCurrent(); } else { setStatus('没有找到下一节,等待课程完成…'); @@ -1695,42 +2394,91 @@ function manualCourseTick() { hookAllVideos(); if (handleAntiIdle()) return; - const v = findPlayableVideo(); - if (!v) return; - if (v.ended) { - if (CFG.autoNext && Date.now() - R.manualAdvanceAt > 6000) { - R.manualAdvanceAt = Date.now(); - const next = findNextLessonElement(); - if (next) { - try { next.click(); } catch (e) {} - } else { - const btn = findNextButton(); - if (btn) try { btn.click(); } catch (e) {} - } - } + // 课程标题就绪前不做任何判断,避免在旧课程的目录上点来点去 + const title = courseTitle(); + if (!title || /^(loading|加载中)/i.test(title)) return; + + // 手动进入课程时同样先对齐到「第一个未学完的课时」;每门课只对齐一次, + // 之后用户自己点别的课时不会被拉回来 + syncManualCourse(); + if (!mediaPage() && alignToFirstIncomplete()) return; + + const lessonKey = readActiveLessonKey(); + if (lessonKey && lessonKey !== R.lastLessonKey) { + R.lastLessonKey = lessonKey; + R.doneLatchKey = ''; + setStatus('学习中:' + truncate(lessonKey, 28)); + } + + // 整门课已完成(平台汇总会变成「已完成学习」/100%):停在这里,别再重播 + const summary = readSummary(); + if (summary && summary.complete) { + try { document.querySelectorAll('video, audio').forEach(function (x) { x.pause(); }); } catch (e) {} + setStatus('课程已完成:' + truncate(S.current ? S.current.title : title, 24)); return; } - ensurePlaying(v); + const v = findPlayableVideo(); + if (!v) { + // 单视频/音频页初始只有封面和「开始学习」,手动模式也要能点开 + if (!mediaPage()) return; + const startBtn = findVisibleClickable(/^(开始学习|继续学习|继续观看)$/); + if (startBtn && Date.now() - R.lastStartClickAt > CFG.startClickCooldownMs) { + R.lastStartClickAt = Date.now(); + setStatus('点击开始学习…'); + try { startBtn.click(); } catch (e) {} + } + return; + } const cd = readCountdown(); if (cd != null) { if (R.lastCountdown == null || cd < R.lastCountdown) R.lastProgressAt = Date.now(); R.lastCountdown = cd; } + + if (v.ended || (cd != null && cd <= 0)) R.doneLatchKey = 'manual'; + const localDone = v.ended || (cd != null && cd <= 0) || R.doneLatchKey === 'manual'; + + if (localDone) { + if (CFG.autoNext && Date.now() - R.manualAdvanceAt > 6000) { + R.manualAdvanceAt = Date.now(); + const next = findNextLessonElement(); + if (next) { + switchLesson(next); + } else { + const btn = findNextButton(); + if (btn) clickNode(btn); + } + } + return; + } + + ensurePlaying(v); } // ======== 完成 / 失败 ======== function completeCurrent() { const title = S.current ? S.current.title : courseTitle(); if (title) S.done[title] = Date.now(); + if (title) forgetShortCourse(title); S.completedThisRun = (S.completedThisRun || 0) + 1; S.consecutiveFailures = 0; S.current = null; S.phase = 'idle'; S.returning = true; save(); + R.doneLatchKey = ''; + R.lastSummary = null; + // 平台在完成后会把播放器重置到 0 秒,先暂停,避免又从头播一遍 + try { + document.querySelectorAll('video, audio').forEach(function (x) { + try { x.pause(); } catch (e) {} + }); + } catch (e) {} + + console.log(TAG, '课程完成:', title, '第', S.completedThisRun, '门,返回列表选下一门'); const limit = CFG.maxCourses > 0 ? CFG.maxCourses : Infinity; if (S.completedThisRun >= limit) { @@ -1741,13 +2489,15 @@ } else { setStatus('课程完成:' + truncate(title, 26) + '(本次 ' + S.completedThisRun + ')'); } - later(goToList, 1500); + // 完成后的返回列表不能被 5 秒节流吞掉 + later(function () { goToList(true); }, 1200); } function failCurrent(reason) { const title = S.current ? S.current.title : courseTitle(); if (title) { S.failed[title] = { reason: reason, at: Date.now() }; + forgetShortCourse(title); } S.current = null; S.phase = 'idle'; @@ -1764,7 +2514,7 @@ save(); setStatus('跳过:' + truncate(title, 24) + '(' + reason + ')'); - later(goToList, 1200); + later(function () { goToList(true); }, 1000); } function stopBatch(reason) { @@ -1784,7 +2534,11 @@ if (consumePendingStart()) return; if (!S.running) { - if (route() === 'course' && state.enabled) manualCourseTick(); + if (route() === 'course' && state.enabled) { + manualCourseTick(); + } else { + R.manualCourseKey = ''; // 离开课程页后,下次进入同一门课要重新对齐 + } return; } @@ -1818,13 +2572,22 @@ try { Object.defineProperty(window, '__ytAuto', { value: { - S: S, R: R, tick: tick, save: save, route: route, + S: S, R: R, state: state, tick: tick, save: save, route: route, + mediaPage: mediaPage, courseIdFromUrl: courseIdFromUrl, readCountdown: readCountdown, readSummary: readSummary, isLoginPage: isLoginPage, loginPageTick: loginPageTick, doLoginAndStart: doLoginAndStart, fillLoginForm: fillLoginForm, startBatch: startBatch, consumePendingStart: consumePendingStart, findNextLessonElement: findNextLessonElement, lessonItems: lessonItems, dumpCatalog: dumpCatalog, clickLesson: clickLesson, + alignToFirstIncomplete: alignToFirstIncomplete, + isLessonCompleted: isLessonCompleted, + findFirstIncompleteLessonElement: findFirstIncompleteLessonElement, + listVm: listVm, shortCatalogKey: shortCatalogKey, + courseIdOfCard: courseIdOfCard, + ensureShortCatalog: ensureShortCatalog, chooseShortCourse: chooseShortCourse, + sortCardsByDuration: sortCardsByDuration, formatDuration: formatDuration, + pendingShortItems: pendingShortItems, forgetShortCourse: forgetShortCourse, }, configurable: true, }); diff --git a/运行报告.md b/运行报告.md index 51c3d54..6c9ac4c 100644 --- a/运行报告.md +++ b/运行报告.md @@ -1,8 +1,11 @@ # 云学堂助手 · 实跑报告(v2.0.3) > 历史记录:本报告对应 **v2.0.3**,当时的文件名为 `yunxuetang-auto-play.user.js`。 -> 脚本现已更名为 [`yun-xue-tang-assistant.user.js`](yun-xue-tang-assistant.user.js),当前版本 **v2.5.1**, -> 下文记录的修复均已包含在当前版本中。 +> 脚本现已更名为 [`yun-xue-tang-assistant.user.js`](yun-xue-tang-assistant.user.js),当前版本 **v2.7.0**, +> 下文记录的修复均已包含在当前版本中。v2.6.0 新增「优先短课程(时长正序)」, +> 实跑与回归证据见 [`docs/evidence/short-course-evidence.txt`](docs/evidence/short-course-evidence.txt); +> v2.7.0 修复单视频课程不自动播放与课程完成后不转下一门, +> 证据见 [`docs/evidence/completion-next-evidence.txt`](docs/evidence/completion-next-evidence.txt)。 日期:2026-10-19 21:19–21:51(Asia/Shanghai) 脚本:`yun-xue-tang-assistant.user.js`(v2.0.3 时名为 `yunxuetang-auto-play.user.js`),最终版本 **v2.0.3**