feat: v2.7.0 单视频课程自动播放、学完自动转下一门,并加入短课程优先
脚本 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 三份实跑证据与面板截图
This commit is contained in:
1 parent
7d6493bca5
commit
8200bfa0c5
8 files changed
+1257
-177
No files matched your search
@@ -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 是右侧的 <svg>,
|
||||
而 SVGSVGElement 没有 HTMLElement.click()(Chromium 实测 typeof svg.click === 'undefined'),
|
||||
svg.click() 抛 TypeError 后被 try/catch 静默吞掉,等于没点;句柄挂在标题 span /
|
||||
行容器上时,前 4 次点击都没命中,脚本就放弃并「按当前位置继续」。
|
||||
2) isLessonCompleted() 的文本兜底写成 /(已学完|已完成)$/,要求标签出现在 li 文本末尾;
|
||||
真实目录的 tag-type 在标题之前(probe2.txt:<span class="tag-type">视频</span>标题),
|
||||
标成「已学完 第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="<playwright 包目录>"
|
||||
$env:CHROME_PATH="<chromium 可执行文件>"
|
||||
node .run-tmp/align/run.mjs # 当前脚本
|
||||
$env:SCRIPT=".run-tmp/align/before.user.js"; node .run-tmp/align/run.mjs # 修复前对照
|
||||
@@ -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 计时)
|
||||
开始按钮:<button class="yxtf-button yxtf-button--primary yxtf-button--larger">开始学习</button>
|
||||
|
||||
修复前(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="<playwright 包目录>"
|
||||
$env:CHROME_PATH="<chromium 可执行文件>"
|
||||
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。
|
||||
@@ -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":"<orgId>","catalogId":"","title":"","type":"","allTag":1,"tagIds":[]}
|
||||
鉴权最小请求头(实测):
|
||||
content-type: application/json;charset=UTF-8
|
||||
token: <localStorage.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,新增「优先短课程(时长正序)」复选框,默认勾选)
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 11 KiB |
Reference in new issue
Block a user