新增无头运行能力,解决 Linux 无图形化服务器上无法常驻的问题;同时改掉 "遇到考试课/无进展课就跳过"的策略,改为在同门课上退避重试。 - runner/:自己起无头 Chromium,用 CDP 把构建产物注入页面主世界(等价 @grant none),不装插件、不需要桌面环境或 Xvfb;含浏览器探测与启动参数、 持久化 profile、陈旧 SingletonLock 清理、优雅退出、日志轮转、启动预检 - runner.config.mjs / start-headless.cmd:通用配置 + Windows 一键入口; 凭据只走 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD 环境变量 - src/exam.js:含考试章节的课程自动进考试 → 开始/继续 → 空卷提交 → 确定, 交卷后靠平台记账推进课程;maxExamTries 限制同门课交卷次数,防不记账时死循环 - 去掉跳过与黑名单:没学完就退避重试(30s 起翻倍,最长 5 分钟), 同门课超过 maxCourseRetries 次才停整轮并提示,替代原 maxConsecutiveFailures - 每完成一门都重新拉列表接口取平台实时状态再选下一门,避免用陈旧队列 - 学习进度改存 sessionStorage(yun-xue-tang-run-state-v3),整页跳转/刷新可续; 运行开关不跨会话,浏览器重启后必须显式开跑 - dev/:新增 real-cdp / real-run / real-test / real-e2e 实跑脚本与 check.mjs 统一静态检查(JS 22 + 批处理 2),替代逐文件 node --check - docs/evidence/headless-linux-evidence.txt + 实跑截图,README 补无头部署章节
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 `yun-xue-tang-prefer-short`。
|
||
- 队列缓存在 sessionStorage `yun-xue-tang-short-catalog-v1`,5 分钟有效,关闭标签页即清空。
|
||
- 选课时按 studyHours 升序;时长未知的排最后。
|
||
- 目标课程在其他页时先 jumpToPage,落地后按 id(不可用时按标题)匹配卡片。
|
||
- 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。
|
||
|
||
七、面板截图
|
||
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选)
|