脚本 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 三份实跑证据与面板截图
73 lines
4.1 KiB
Plaintext
73 lines
4.1 KiB
Plaintext
云学堂助手 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,新增「优先短课程(时长正序)」复选框,默认勾选)
|