云学堂助手 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":"","catalogId":"","title":"","type":"","allTag":1,"tagIds":[]} 鉴权最小请求头(实测): content-type: application/json;charset=UTF-8 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 `yun-xue-tang-prefer-short`。 - 队列缓存在 sessionStorage `yun-xue-tang-short-catalog-v1`,5 分钟有效,关闭标签页即清空。 - 选课时按 studyHours 升序;时长未知的排最后。 - 目标课程在其他页时先 jumpToPage,落地后按 id(不可用时按标题)匹配卡片。 - 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。 七、面板截图 docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选)