云学堂助手 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   # 修复前对照
