refactor: 重组目录结构,脚本收进 scripts/,配置独立成 config/
根目录原来平铺了构建脚本、运行器配置、两个 .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 通过)。
This commit is contained in:
1 parent
ae117222df
commit
c1e883d67f
32 files changed
+148
-125
No files matched your search
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
@@ -4,7 +4,7 @@
|
||||
背景
|
||||
----
|
||||
用户反馈:进入课程后不会从「第一个未学完的课时」开始,前面的课时被跳过 / 整门课学不完。
|
||||
真实站点需要登录,无法在本地直接复现,因此按 docs/evidence/probe.txt、probe2.txt、probe4.txt
|
||||
真实站点需要登录,无法在本地直接复现,因此按 docs/archive/v2.0-snapshots/probe.txt、probe2.txt、probe4.txt
|
||||
里记录的真实目录结构,复刻课程页 DOM,再用无头 Chromium 注入用户脚本跑 20 秒,
|
||||
读取目录高亮、面板状态与控制台日志。复刻页面与用例脚本在 .run-tmp/align/(本机调试用,未入库)。
|
||||
|
||||
|
||||
@@ -38,7 +38,7 @@
|
||||
- `runner/browser.mjs:hasDisplay()` 判 `DISPLAY` / `WAYLAND_DISPLAY`;
|
||||
- `runner/headless.mjs` 里 `VISIBLE = WANT_VISIBLE && hasDisplay()`,
|
||||
即**即使传了 `--visible` 也会被强制无头并打警告**;
|
||||
- `dev/real-cdp.mjs:forceHeadless()` 让三个真机测试脚本同样自动无头。
|
||||
- `dev/tests/real-cdp.mjs:forceHeadless()` 让三个真机测试脚本同样自动无头。
|
||||
2) root 运行:Chromium 拒绝启动(`Running as root without --no-sandbox is not supported`)。
|
||||
- `safetyArgs()` 在 `process.getuid()===0` 时补 `--no-sandbox --disable-setuid-sandbox --disable-gpu`;
|
||||
- `buildArgs()` 在 Linux 上恒加 `--no-sandbox --disable-setuid-sandbox`。
|
||||
@@ -125,10 +125,10 @@
|
||||
|
||||
|
||||
六、回归(改动没有破坏原有链路)
|
||||
- `npm run check`:12 个文件逐个 `node --check` 全通过(新增 runner/*.mjs 与 dev/real-run.mjs 也已纳入)。
|
||||
- `npm run check`:24 个文件逐个 `node --check` 全通过(新增 runner/*.mjs 与 dev/tests/real-run.mjs 也已纳入)。
|
||||
- `npm run test:real:headless`(真机只读断言):**24/24 通过,失败 0**。
|
||||
- `node dev/real-e2e.mjs --headless`:**12/12 通过,失败 0**(真实登录 → 新 document → 列表 16 张卡片 / 322 页)。
|
||||
- `node dev/real-run.mjs --headless --scan`:**3/3 通过,失败 0**。
|
||||
- `node dev/tests/real-e2e.mjs --headless`:**12/12 通过,失败 0**(真实登录 → 新 document → 列表 16 张卡片 / 322 页)。
|
||||
- `node dev/tests/real-run.mjs --headless --scan`:**3/3 通过,失败 0**。
|
||||
|
||||
|
||||
七、已知限制
|
||||
@@ -145,7 +145,7 @@
|
||||
入口只剩 90 行(结构见第二节表格),**不引入打包步骤**(按用户选择:保持直接 import)。
|
||||
|
||||
同时把 package.json 的 check 从「一长串 node --check a && node --check b …」
|
||||
改成 dev/check.mjs 自动遍历 runner/、dev/ 与顶层文件 —— 以前新增模块必须手改那行命令,
|
||||
改成 scripts/check.mjs 自动遍历 runner/、dev/、scripts/ 与 config/ —— 以前新增模块必须手改那行命令,
|
||||
漏改就会静默不被检查。现在输出:语法检查:20/20 个文件通过。
|
||||
|
||||
拆分过程中发现并修掉 3 个真实缺陷(都是原单文件里藏着的):
|
||||
@@ -175,8 +175,8 @@
|
||||
kill 浏览器主进程 会话异常:CDP 连接断开 → 15 秒后第 2 次尝试 → 自动重登 → 继续刷课
|
||||
SIGTERM 浏览器 code=143,残留 chrome 进程数 0
|
||||
npm run test:real:headless 24/24 通过
|
||||
node dev/real-e2e.mjs --headless 12/12 通过
|
||||
node dev/real-run.mjs --headless --scan 3/3 通过
|
||||
node dev/tests/real-e2e.mjs --headless 12/12 通过
|
||||
node dev/tests/real-run.mjs --headless --scan 3/3 通过
|
||||
|
||||
stop.mjs 的单元核查(一次性脚本,未入库):注册的收尾函数全部执行、已注销的不执行、
|
||||
重复信号不重复执行、收尾后调用 onExit(0)。
|
||||
@@ -211,7 +211,7 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
|
||||
browserInstallHint() / residentHint() 按平台出安装与常驻建议
|
||||
|
||||
browser.mjs 转发 platform.mjs 的导出(safetyArgs / hasDisplay / isRunningAsRoot 等),
|
||||
老的调用方(dev/real-cdp.mjs、dev/real-*.mjs)不需要改 import。
|
||||
老的调用方(dev/tests/real-cdp.mjs、dev/tests/real-*.mjs)不需要改 import。
|
||||
|
||||
9.2 各模块的改动点
|
||||
|
||||
@@ -229,7 +229,7 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
|
||||
config.mjs VISIBLE = WANT_VISIBLE && hasDisplay(),导出 platformName / noDisplayReason。
|
||||
supervisor.mjs 启动横幅打平台名;--visible 被忽略时用 noDisplayReason() 说原因。
|
||||
headless.mjs 注释补 Windows 用法(set / $env:)与代码结构。
|
||||
dev/real-*.mjs spawn 补 windowsHide: true。
|
||||
dev/tests/real-*.mjs spawn 补 windowsHide: true。
|
||||
|
||||
9.3 实测(Windows 11 / Chrome 155.0.8059.85 / Node v24.19.0)
|
||||
|
||||
@@ -271,13 +271,13 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
|
||||
npm run headless:check 5/5 PASS,退出码 0
|
||||
node runner/headless.mjs --max 1 已完成 1 门(用时 3 分 9 秒),退出码 0
|
||||
npm run test:real:headless 24/24 通过
|
||||
node dev/real-e2e.mjs --headless 12/12 通过
|
||||
node dev/real-run.mjs --headless --scan 3/3 通过
|
||||
npm run check(dev/check.mjs) 21/21 个文件通过
|
||||
node dev/tests/real-e2e.mjs --headless 12/12 通过
|
||||
node dev/tests/real-run.mjs --headless --scan 3/3 通过
|
||||
npm run check(scripts/check.mjs) 24/24 个文件通过
|
||||
|
||||
9.4 Windows 额外交付
|
||||
|
||||
start-headless.cmd 一键启动(自动构建 / 检查 Node / 退出码说明 + pause)
|
||||
scripts/start-headless.cmd 一键启动(自动构建 / 检查 Node / 退出码说明 + pause)
|
||||
README「无头运行」一节 改成 Linux / Windows 双栏,补「Windows 常驻三种方式」
|
||||
与按平台分的「无图形环境常见坑」表
|
||||
环境变量 YUN_XUE_TANG_HAS_DISPLAY 0/1 强制认定有无图形会话(自动判断不准时用)
|
||||
@@ -301,12 +301,12 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
|
||||
改为 [...new Set(args)] 去重后再拼 extraArgs。Windows 侧核查重复项:无。
|
||||
|
||||
======================================================================
|
||||
十、Windows 批处理启动脚本的编码陷阱(start-headless.cmd 报「不是内部或外部命令」)
|
||||
十、Windows 批处理启动脚本的编码陷阱(scripts/start-headless.cmd 报「不是内部或外部命令」)
|
||||
======================================================================
|
||||
|
||||
10.1 现象
|
||||
|
||||
双击 start-headless.cmd,控制台输出:
|
||||
双击 scripts/start-headless.cmd,控制台输出:
|
||||
'e' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'鍏?npm' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'rofile' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
@@ -334,22 +334,22 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
|
||||
|
||||
10.3 采用方案:批处理只用 ASCII,中文交给 Node 输出
|
||||
|
||||
start-headless.cmd 与 dev/start-dev.cmd 全部改写为纯 ASCII + CRLF:
|
||||
scripts/start-headless.cmd 与 scripts/start-dev.cmd 全部改写为纯 ASCII + CRLF:
|
||||
- 注释里写明「本文件必须保持纯 ASCII」及原因,避免以后有人手改回去;
|
||||
- 所有面向用户的提示(构建中 / 启动中 / 退出码含义 / 缺 Node)改用英文短句
|
||||
(如 [build] / [run] / [exit] / [error]),中文提示由 Node 侧日志输出;
|
||||
- 文件仍保留 chcp 65001,这样 Node 输出的 UTF-8 中文在控制台正常显示。
|
||||
|
||||
验证:
|
||||
file start-headless.cmd → DOS batch file, ASCII text, with CRLF line terminators
|
||||
非 ASCII 字节数 → 0(dev/start-dev.cmd 同样为 0,原为 50)
|
||||
cmd /c start-headless.cmd --check → 5/5 PASS,退出码 0
|
||||
cmd /c start-headless.cmd(错误凭据) → 连续 5 次登录失败 → [exit] code 3 → pause
|
||||
file scripts/start-headless.cmd → DOS batch file, ASCII text, with CRLF line terminators
|
||||
非 ASCII 字节数 → 0(scripts/start-dev.cmd 同样为 0,原为 50)
|
||||
cmd /c scripts\start-headless.cmd --check → 5/5 PASS,退出码 0
|
||||
cmd /c scripts\start-headless.cmd(错误凭据)→ 连续 5 次登录失败 → [exit] code 3 → pause
|
||||
|
||||
10.4 防回归:dev/check.mjs 增加批处理检查
|
||||
10.4 防回归:scripts/check.mjs 增加批处理检查
|
||||
|
||||
`npm run check` 原来只跑 node --check,对 .cmd 完全无感知(所以这个 bug 是双击才发现)。
|
||||
现在 dev/check.mjs 同时遍历 *.cmd / *.bat 并断言两件事:
|
||||
现在 scripts/check.mjs 同时遍历 *.cmd / *.bat 并断言两件事:
|
||||
1. 不含任何 >0x7F 的字节(报错时给出首次出现的偏移与上下文片段);
|
||||
2. LF 与 CRLF 数量相等(存在裸 LF 就报错)。
|
||||
自测(临时文件,验证完即删):
|
||||
|
||||
@@ -69,4 +69,4 @@ orderBy 传 studyHours 不会被服务端接受(返回默认顺序),所以
|
||||
- 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。
|
||||
|
||||
七、面板截图
|
||||
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选)
|
||||
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选;展示图随仓库入库)
|
||||
@@ -0,0 +1,193 @@
|
||||
# 云学堂助手 · 实跑报告(v2.0.3)
|
||||
|
||||
> 历史记录:本报告对应 **v2.0.3**,当时的文件名为 `yunxuetang-auto-play.user.js`。
|
||||
> 脚本现已更名为 [`yun-xue-tang-assistant.user.js`](../../yun-xue-tang-assistant.user.js),当前版本 **v2.8.0**,
|
||||
> 下文记录的修复均已包含在当前版本中。v2.6.0 新增「优先短课程(时长正序)」,
|
||||
> 实跑与回归证据见 [`docs/evidence/short-course-evidence.txt`](../../docs/evidence/short-course-evidence.txt);
|
||||
> v2.7.0 修复单视频课程不自动播放与课程完成后不转下一门,
|
||||
> 证据见 [`docs/evidence/completion-next-evidence.txt`](../../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 个真实问题,均已修复:
|
||||
1. 「2小时 8分钟 34秒」格式的倒计时解析为 `null`;
|
||||
2. 只剩分钟(「还需 5分钟」)的倒计时也解析为 `null`;
|
||||
3. 自动切节会点回当前节(目录「章」节点也包含 `.liactive`);
|
||||
4. 平台在切节后自动显示的「还需 5分钟」是**下一节**的时长,旧逻辑可能据此把已结束的上一节视频拉回开头重播。
|
||||
- 实际影响了账号进度:`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分钟」被误当成上一节还没结束
|
||||
|
||||
旧判断:
|
||||
|
||||
```js
|
||||
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`](../../docs/archive/v2.0-snapshots/advance-evidence.txt):平台进度 0→1、切节日志、最终状态
|
||||
- [`docs/archive/v2.0-snapshots/v203-advance-evidence.txt`](../../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`](../../docs/archive/v2.0-snapshots/completion-banner-evidence.txt):完成后「还需 5分钟」出现的时序
|
||||
- [`docs/evidence/countdown-regex-test.txt`](../../docs/evidence/countdown-regex-test.txt):4 种倒计时格式的解析结果
|
||||
- [`docs/archive/v2.0-snapshots/probe.txt`](../../docs/archive/v2.0-snapshots/probe.txt)、[`probe2.txt`](../../docs/archive/v2.0-snapshots/probe2.txt)、[`probe4.txt`](../../docs/archive/v2.0-snapshots/probe4.txt):目录结构与新旧切节逻辑对比
|
||||
- [`docs/archive/v2.0-snapshots/report.txt`](../../docs/archive/v2.0-snapshots/report.txt):首轮运行状态与日志摘录
|
||||
- [`docs/screenshots/watch-006.png`](../../docs/screenshots/watch-006.png):首轮播放中截图
|
||||
- [`docs/screenshots/15-after-advance.png`](../../docs/screenshots/15-after-advance.png):v2.0.2 切到第 2 节后的画面
|
||||
- [`docs/screenshots/16-v203-next.png`](../../docs/screenshots/16-v203-next.png):v2.0.3 切到第 3 节、汇总 2/3 的画面
|
||||
|
||||
> 整理仓库时已删除 `.run-tmp/`(浏览器配置目录、一次性调试脚本与其余截图,约 460 MB);
|
||||
> 报告引用到的原始抓取片段已归档到 `docs/archive/v2.0-snapshots/`,截图仍在 `docs/screenshots/`。
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 5.1 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 453 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 677 KiB |
Reference in new issue
Block a user