根目录原来平铺了构建脚本、运行器配置、两个 .cmd 启动器和一份中文名的 实跑报告,四类东西混在一起,新人分不清哪个是源码、哪个是产物。这次按 职责分层重排: - 构建与检查脚本收进 scripts/:build.mjs、check.mjs - 一键启动器收进 scripts/:start-headless.cmd、start-dev.cmd - 运行器配置独立成 config/runner.config.mjs(日常调参不用重新 build) - 真机测试收进 dev/tests/:real-cdp / real-test / real-e2e / real-run - 运行报告改成 ASCII 名并移入 docs/reports/run-report-v203.md - v2.0.x 时期的 7 份原始抓取片段归档到 docs/archive/v2.0-snapshots/, docs/evidence/ 只留当前版本的有效证据 - 测试每次重新生成的 3 张截图(e2e-01-after-login、e2e-02-playing、 real-chrome-login)移出仓库并加入 .gitignore,改写到 .run-tmp/screenshots/; docs/screenshots/ 只保留手工挑选的 5 张展示图 路径修正:build.mjs 的 ROOT 上跳一级;dev/tests/ 四个脚本 ROOT 上跳两级、 对 runner/browser.mjs 的引用改 ../../;runner/config.mjs 默认配置文件路径改 config/runner.config.mjs;两个 .cmd 的 cd 改为仓库根、start-dev.cmd 指向 dev/serve.mjs;package.json 全部 npm scripts 同步;README、dev/README、证据 文件与源码注释里的路径一并更新。 顺带修掉测试里硬编码的 v2.7.0 断言:版本号改为从 package.json 读取。 验证:npm run build(104798 字节 / 102.3 KB)、npm run check(24/24)、 npm run test:real:headless(24/24 通过)。
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,新增「优先短课程(时长正序)」复选框,默认勾选;展示图随仓库入库)
|