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 # 修复前对照
|
||||
Reference in new issue
Block a user