根目录原来平铺了构建脚本、运行器配置、两个 .cmd 启动器和一份中文名的 实跑报告,四类东西混在一起,新人分不清哪个是源码、哪个是产物。这次按 职责分层重排: - 构建与检查脚本收进 scripts/:build.mjs、check.mjs - 一键启动器收进 scripts/:start-headless.cmd、start-dev.cmd - 运行器配置独立成 config/runner.config.mjs(日常调参不用重新 build) - 真机测试收进 dev/tests/:real-cdp / real-test / real-e2e / real-run - 运行报告改成 ASCII 名并移入 docs/reports/run-report-v203.md - v2.0.x 时期的 7 份原始抓取片段归档到 docs/archive/v2.0-snapshots/, docs/evidence/ 只留当前版本的有效证据 - 测试每次重新生成的 3 张截图(e2e-01-after-login、e2e-02-playing、 real-chrome-login)移出仓库并加入 .gitignore,改写到 .run-tmp/screenshots/; docs/screenshots/ 只保留手工挑选的 5 张展示图 路径修正:build.mjs 的 ROOT 上跳一级;dev/tests/ 四个脚本 ROOT 上跳两级、 对 runner/browser.mjs 的引用改 ../../;runner/config.mjs 默认配置文件路径改 config/runner.config.mjs;两个 .cmd 的 cd 改为仓库根、start-dev.cmd 指向 dev/serve.mjs;package.json 全部 npm scripts 同步;README、dev/README、证据 文件与源码注释里的路径一并更新。 顺带修掉测试里硬编码的 v2.7.0 断言:版本号改为从 package.json 读取。 验证:npm run build(104798 字节 / 102.3 KB)、npm run check(24/24)、 npm run test:real:headless(24/24 通过)。
11 KiB
云学堂助手 · 实跑报告(v2.0.3)
历史记录:本报告对应 v2.0.3,当时的文件名为
yunxuetang-auto-play.user.js。 脚本现已更名为yun-xue-tang-assistant.user.js,当前版本 v2.8.0, 下文记录的修复均已包含在当前版本中。v2.6.0 新增「优先短课程(时长正序)」, 实跑与回归证据见docs/evidence/short-course-evidence.txt; v2.7.0 修复单视频课程不自动播放与课程完成后不转下一门, 证据见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
结论
- 脚本在真实站点(
kfmic.yunxuetang.cn,江丰云课堂)跑通:登录 → 课程列表 → 批量选课 → 自动进入课程 → 静音 1x 播放 → 读取进度/倒计时。 - 自动切节已端到端验证通过:302 秒的第 1 节播完后平台进度
0/3 → 1/3,脚本切到第 2 节;v2.0.3 复跑又把第 2 节(305 秒)播完,进度1/3 → 2/3,切到第 3 节「下(钱百峰)」。 - 实跑共发现 4 个真实问题,均已修复:
- 「2小时 8分钟 34秒」格式的倒计时解析为
null; - 只剩分钟(「还需 5分钟」)的倒计时也解析为
null; - 自动切节会点回当前节(目录「章」节点也包含
.liactive); - 平台在切节后自动显示的「还需 5分钟」是下一节的时长,旧逻辑可能据此把已结束的上一节视频拉回开头重播。
- 「2小时 8分钟 34秒」格式的倒计时解析为
- 实际影响了账号进度:
2025坚持的力量已完成第 1、2 节,当前2/3;第 3 节在 58 秒处手动暂停。KFMI2025...本轮又播了约 221 秒,进度仍为0/8。
实跑 1:长课程 + 批量入口
| 步骤 | 实际结果 |
|---|---|
| 登录页 | https://kfmic.yunxuetang.cn/login.html,标题「登录-江丰云课堂」 |
| 课程列表 | 第 1 页 16 张卡片;前两张「已学完」被正确跳过 |
| 选中课程 | KFMI2025年品质能力强化培训(APQP/CP/FMEA)(学习中) |
| 目录 | 10 个 li = 2 个章节点 + 8 个课时;汇总「已完成 0/8」 |
| 播放 | paused=false、muted=true、playbackRate=1;currentTime 79s → 114s → 234s |
| 倒计时 | 「还需 2小时 8分钟 34秒」 |
| 停止 | 手动停在 234s,避免无人值守跑 2 小时以上 |
实跑 2:短课时验证自动切节
为了不让批量模式继续跑 2 小时的 KFMI 课程,这次把 S.current 指向短课程后开启批量逻辑(列表筛选逻辑已在实跑 1 验证)。课程来自同一列表,状态「学习中」:
2025坚持的力量(黄文杰、袁倩靖、钱百峰),总时长 880 秒,共 3 节:
| 节 | 时长 | 起始进度 |
|---|---|---|
| 上(黄文杰) | 302s | 0 |
| 中(袁倩靖) | 305s | 0 |
| 下(钱百峰) | 273s | 0 |
时间线(本地时间):
| 时间 | 事件 |
|---|---|
| 21:31:28 | 第 1 节开始播放,duration=302.4s,静音 1x |
| 21:36:33 | 平台 study/summary 返回 finishNum: 0 → 1,acqHours: 0 → 302 |
| 21:36:34.933 | 脚本日志「本节已记录,切换下一节…」 |
| 21:36:34.934 | 脚本日志「进入下一节」 |
| 21:36:40.930 | 脚本日志「学习中:…中(袁倩靖)」;汇总「已完成 1/3」 |
| 21:37:04 | 第 2 节播放到 20.6s 时手动暂停(最终停在 55.7s) |
平台接口证据:
026 study/summary finishNum=0/3 acqHours=0
049 study/summary finishNum=1/3 acqHours=302
脚本日志证据:
[21:36:34.933] [云学堂自动] 本节已记录,切换下一节…
[21:36:34.934] [云学堂自动] 进入下一节
[21:36:40.930] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
v2.0.3 复跑:第 2 节 → 第 3 节
这一轮专门验证「视频结束后不会被下一节的倒计时文案拉回重播」。为了避开目录点击,这次直接用第 2 节的 locateshare 地址进入:
| 时间 | 事件 |
|---|---|
| 21:45:37 | 第 2 节开始播放(平台自动起播),duration=304.5s;21:46:17 脚本接管时已到 40s |
| 21:50:46 | 平台 study/summary 返回 finishNum=2/3,acqHours=607(302+305) |
| 21:50:47.198 | 脚本日志「本节已记录,切换下一节…」 |
| 21:50:47.198 | 脚本日志「进入下一节」 |
| 21:50:53.198 | 脚本日志「学习中:…下(钱百峰)」,新视频 duration=273s 开始播放 |
| 21:51:01+ | 第 3 节正常计时;到 58.4s 时手动暂停 |
关键点:第 2 节结束时,页面先出现的是第 3 节的提示「还需 4分钟 33秒」(第 3 节总长 273 秒),不是上一节的剩余时间;脚本没有把它当成第 2 节还没结束,也没有 seek 回 0,而是按 video.ended 直接进入第 3 节。平台汇总从 1/3 变为 2/3。
平台接口:
073 study/summary finishNum=1/3 acqHours=342
096 study/summary finishNum=2/3 acqHours=607
测试过程中有一个插曲:第一次在批量运行中直接 goto 第 2 节地址,页面加载瞬间标题还是 loading...,脚本判定「页面课程与队列不一致」,按保护逻辑回到列表并选中了第一门未完成课程 KFMI,播了约 221 秒后才被手动停掉。正常从列表进入课程不会触发;但刷新课程页/直接改 URL 时确实可能遇到,属于已知限制,本轮未改。
问题 1:小时级倒计时解析失败
真实文案:
还需 2小时 8分钟 34秒 可完成本课程学习并获得6.52学分,加油!
旧正则 /还需(\d+)分钟(\d+)秒/ 只认「分钟+秒」,readCountdown() 返回 null。
修复(readCountdown()):改为小时/分钟/秒都可选,并至少匹配到一个数字。
问题 2:只剩分钟时也解析失败
这条文案不是上一节完成后的“剩余时间”,而是平台切到下一节后自动显示的下一节提示。实跑日志能看清顺序:
21:36:28 当前节「还需 5秒」 汇总 0/3
21:36:33 倒计时为空 汇总 1/3
21:36:48 下一节「还需 5分钟」 下一节已播放 5.6s
也就是说,5分钟 是下一节的总时长。对下一节本身来说它是有效的倒计时,但第一次修复后仍要求「秒」,所以这条会解析成 null。已把秒改为可选,并用 4 种真实格式验证:
| 文案 | 解析结果 |
|---|---|
| 还需2小时7分钟59秒… | 7679 |
| 还需5分钟… | 300 |
| 还需4分钟10秒… | 250 |
| 还需59秒… | 59 |
问题 3:自动切节会点回当前节
真实目录里「章」节点也包含 .liactive,旧代码 findIndex(li => li.querySelector('.liactive')) 先命中章节点,于是「下一节」= 当前节。
线上对比(KFMI 课程):
- 旧逻辑:
视频2025-05-29--1(当前节) - 修复后:
视频2025-05-29--2(正确下一节)
修复(findNextLessonElement() / lessonItems()):新增 lessonItems() 过滤包含子 ul 的章节点;用 active.closest('li') 定位当前课时后再取下一个。findFirstIncompleteLessonElement() 同步改用 lessonItems()。
短课时实测已证明修复有效:脚本没有点回「上(黄文杰)」,而是进入「中(袁倩靖)」。
问题 4:切节后的「还需 5分钟」被误当成上一节还没结束
旧判断:
const localDone = (cd != null && cd <= 0) ||
(v && v.ended && (cd == null || cd <= 3));
如果视频已经 ended,但页面先挂出下一节的「还需 5分钟」(cd=300),localDone 会是 false;随后 ensurePlaying() 命中 v.ended && cd > 3,把视频 currentTime = 0 并重新播放,导致本节迟迟不切走。
这次实跑在 21:36:33 时倒计时刚好为空,所以脚本正常切了;但按你指出的平台行为,这条文案不能作为上一节是否结束的依据。修复:
localDone改为v.ended || cd <= 0,video.ended是本节结束的主信号(courseTick()中的localDone)。ensurePlaying()遇到ended直接返回,不再 seek 回 0(if (v.ended) return)。- 删除只为“提前结束补时长”服务的
lastRestartAt重播分支;平台按真实时长计时,脚本本身也不快进,不需要它。
其他小修
- 视频开始播放后,面板从「点击开始学习…」恢复为「学习中:…」。
- 列表状态标签优先匹配
已学完/学习中/未开始/…,避免其它标签被误判。 - 版本号:2.0.0 → 2.0.1(前两个修复)→ 2.0.2(分钟级倒计时)→ 2.0.3(完成后提示不再触发重播)。
说明
- 平台按真实播放时长计时,倍速/快进不会减少所需时间;本次没有伪造进度。
- v2.0.2 验证了第 1 → 2 节;v2.0.3 验证了第 2 → 3 节,均实际切成功。
- 第 3 节只有 273 秒,结束提示是下一节的「4分钟 33秒」,没有正好出现「5分钟」文案;但结束判断已改为
video.ended,本次确认没有重播。 - 第 3 节停在 58 秒,没有再继续,避免把课程刷到 3/3。
- 直接改 URL/刷新课程页时,页面标题短暂为
loading...,批量逻辑可能误判为课程不一致并回到列表;正常从列表进入不受影响。 - 测试浏览器的登录配置目录已删除,未把会话留在工作区。
证据文件
docs/archive/v2.0-snapshots/advance-evidence.txt:平台进度 0→1、切节日志、最终状态docs/archive/v2.0-snapshots/v203-advance-evidence.txt:v2.0.3 第 2→3 节、平台进度 1→2、最终状态docs/archive/v2.0-snapshots/completion-banner-evidence.txt:完成后「还需 5分钟」出现的时序docs/evidence/countdown-regex-test.txt:4 种倒计时格式的解析结果docs/archive/v2.0-snapshots/probe.txt、probe2.txt、probe4.txt:目录结构与新旧切节逻辑对比docs/archive/v2.0-snapshots/report.txt:首轮运行状态与日志摘录docs/screenshots/watch-006.png:首轮播放中截图docs/screenshots/15-after-advance.png:v2.0.2 切到第 2 节后的画面docs/screenshots/16-v203-next.png:v2.0.3 切到第 3 节、汇总 2/3 的画面
整理仓库时已删除
.run-tmp/(浏览器配置目录、一次性调试脚本与其余截图,约 460 MB); 报告引用到的原始抓取片段已归档到docs/archive/v2.0-snapshots/,截图仍在docs/screenshots/。


