云学堂助手 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 `yun-xue-tang-prefer-short`。
  - 队列缓存在 sessionStorage `yun-xue-tang-short-catalog-v1`，5 分钟有效，关闭标签页即清空。
  - 选课时按 studyHours 升序；时长未知的排最后。
  - 目标课程在其他页时先 jumpToPage，落地后按 id（不可用时按标题）匹配卡片。
  - 失败降级链：跨页队列 → 当前页时长排序 → 原列表顺序，不会卡住批量任务。

七、面板截图
  docs/screenshots/panel-short.png（v2.6.0，新增「优先短课程（时长正序）」复选框，默认勾选；展示图随仓库入库）
