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:
void committed 2026-10-22 23:04:40 +08:00
1 parent 7d6493bca5
commit 8200bfa0c5
8 files changed
+1257 -177

No files matched your search

+72
View File
@@ -0,0 +1,72 @@
云学堂助手 v2.6.0 · 优先短课程(时长正序)证据
日期:2026-10-22(Asia/Shanghai)
站点:https://kfmic.yunxuetang.cn/kng/#/list(已登录账号)
一、需求
批量刷课时,不再只按列表顺序(最新发布)选课,而是优先学习总时长更短的课程(正序)。
二、真实数据结构
列表卡片本身不显示时长。列表组件 ul.kng-list-new.__vue__ 的 kngListData 每项包含:
- title 课程名
- studyHours 课程总时长(秒)
- status 1=学习中,2=已学完,0=未开始
- id 课程 id(用于精确匹配卡片,避免同名课程点错)
列表接口:POST https://api-phx-tc.yunxuetang.cn/kng/knowledge/pagelist
?limit=6000&offset=0&orderType=desc&orderBy=createTime
请求体:
{"collegeId":"<orgId>","catalogId":"","title":"","type":"","allTag":1,"tagIds":[]}
鉴权最小请求头(实测):
content-type: application/json;charset=UTF-8
token: <localStorage.token>
yxt-orgdomain: kfmic.yunxuetang.cn
source: 501
其中 limit=6000 可一次返回全站 5148 门课程(实测 8.65 MB,6.3 秒)。
orderBy 传 studyHours 不会被服务端接受(返回默认顺序),所以脚本自行按 studyHours 正序排序。
三、真实站点读取结果(2026-10-22 20:07 左右)
课程总数:5148
未学完(status != 2):5134
最短课程:氦泄漏通用,60 秒,status=0,位于第 307 页
下一页最短:想精准触达消费者,你得了解立体用户画像!113 秒,第 73 页
再下一页:如何搭建分销体系,实现用户指数型增长?(上篇)127 秒,第 71 页
说明:平台存在同名课程(如「如何制定渠道战略」出现在多页),脚本优先按课程 id 匹配卡片。
四、真实列表页跳页 / 匹配验证
目标:{"title":"氦泄漏通用","duration":60,"status":0,"page":307}
1) 脚本读取时长队列后,jumpToPage(307) 成功,浏览器页码变为 307。
2) 第 307 页 16 张卡片的标题中确实包含「氦泄漏通用」(第 12 张)。
3) chooseShortCourse 返回 { title: "氦泄漏通用", duration: 60 },说明跨页映射与卡片匹配正确。
日志:
[云学堂助手] 正在读取课程时长,优先安排短课程…
[云学堂助手] 短课程队列已就绪:待学 5134 门;最短 1 分钟
[云学堂助手] 跳转到第 307 页
[云学堂助手] 优先短课程:转到第 307 页(1 分钟)
五、回归测试(Playwright + 本地列表 fixture,3 个用例)
命令:node .run-tmp/short-course/test-list.mjs
结果:3 PASS / 0 FAIL
[PASS] S1 短课程优先 · 跨页选全局最短
点击 D 短课(期望 D 短课)/ 页码 2(期望 2)
[PASS] S2 关闭开关 · 沿用列表顺序
点击 A 长课(期望 A 长课)/ 页码 1(期望 1)
[PASS] S3 接口失败 · 退回当前页时长正序
点击 B 中课(期望 B 中课)/ 页码 1(期望 1)
命令:node .run-tmp/short-course/test-restore.mjs
结果:PASS
[PASS] 回到列表恢复第 9 页:实际第 9 页(直接跳页,不一页页翻)
覆盖点:
- 接口可用时跨页选择全局最短;
- 面板开关关闭时恢复原有顺序;
- 接口 500 时降级为当前页 studyHours 正序;
- 已学完(status=2)课程不进入队列;
- 课程完成回到列表时,深页码(短课程优先会到 300+ 页)直接跳回,不逐页翻。
六、实现要点
- 面板新增「优先短课程(时长正序)」复选框,默认开启,保存在 localStorage `yt-prefer-short`。
- 队列缓存在 sessionStorage `yt-short-catalog-v1`,5 分钟有效,关闭标签页即清空。
- 选课时按 studyHours 升序;时长未知的排最后。
- 目标课程在其他页时先 jumpToPage,落地后按 id(不可用时按标题)匹配卡片。
- 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。
七、面板截图
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选)