Files
yun-xue-tang-assistant/docs/evidence/short-course-evidence.txt
T
void ae117222df feat: v2.8.0 无头运行器、考试自动交卷、改为退避重试不跳课
新增无头运行能力,解决 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 补无头部署章节
2026-10-25 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 `yun-xue-tang-prefer-short`。
- 队列缓存在 sessionStorage `yun-xue-tang-short-catalog-v1`,5 分钟有效,关闭标签页即清空。
- 选课时按 studyHours 升序;时长未知的排最后。
- 目标课程在其他页时先 jumpToPage,落地后按 id(不可用时按标题)匹配卡片。
- 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。
七、面板截图
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选)