云学堂助手 v2.5.2 · 起点对齐回归(本地复刻目录) ================================================== 背景 ---- 用户反馈:进入课程后不会从「第一个未学完的课时」开始,前面的课时被跳过 / 整门课学不完。 真实站点需要登录,无法在本地直接复现,因此按 docs/archive/v2.0-snapshots/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 # 修复前对照