Files
yun-xue-tang-assistant/docs/evidence/short-course-evidence.txt
T
void 8200bfa0c5 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 三份实跑证据与面板截图
2026-10-22 23:04:40 +08:00

73 lines
4.1 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
云学堂助手 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,新增「优先短课程(时长正序)」复选框,默认勾选)