fix: 首次进入课程自动同步加入（syncSelf）
首次进入课程时课时树回 code=500「你还没有加入学习…」，前端把它渲染成挡路弹层， 人工点掉后 SPA 自己补发 syncSelf 才落库 —— 所以第二次进同一门课就正常。 - discover_study 返回值补 course_code（trainCourse/getById.courseCode） - 新增 study_mod_get：/mod/* 只带 cookie + Referer，不带 Bearer - 新增 study_sync_self：GET /mod/school/wanpeng/syncSelf?courseCode=… - 新增 study_sync_identity：GET /mod/gjt/roleList 补一刀身份 - ensure_study_join 改为：已加入 → student/join → syncSelf + 轮询 getById → 刷新 jspx 页 - todo.md 收尾，新增 OPTIMIZATION.md 记录待实测确认项
This commit is contained in:
study-tool
@@ -1,79 +1,5 @@
|
||||
# TODO
|
||||
|
||||
## 待修复：首次进入课程会弹提示挡住，必须手动点一下才能进课程
|
||||
暂无待办。
|
||||
|
||||
**状态**：暂停（2026-10-27 18:27）。现象确认存在，但还没抓到具体弹窗，修复方案未定。
|
||||
|
||||
### 现象
|
||||
|
||||
- 一个课程/课时**第一次**进入时，页面会先出提示（弹层/遮罩/确认框），不点它进不去。
|
||||
- 手动点一下之后就能正常进入、正常播放；再进同一门课就不再出现。
|
||||
- 因为卡在这一步，自动学习流程跑不下去，只能人工点。
|
||||
|
||||
### 需要先确认（下一步的起点）
|
||||
|
||||
1. 那个提示到底是哪一层的东西，三选一：
|
||||
- 培训平台（`study.dgjy.net`）自己的「学习须知 / 继续学习 / 我已知晓」弹层；
|
||||
- 播放页 `courseVideo` 里的播放前确认（点「开始学习」才 load video）；
|
||||
- 浏览器层的 autoplay / 全屏 / 权限提示。
|
||||
2. 弹层出现的确切条件（首次进课程？首次进课时？换设备/换浏览器算不算首次？）。
|
||||
3. 点掉它之后前端发了什么请求（有没有 `period/study/log`、`student/join` 之类）。
|
||||
|
||||
### 已排查到的线索
|
||||
|
||||
- 触发点在「进入课程 → 课时」这条路径上，接口层面看不出来：
|
||||
`app.py` 的学习主流程是纯 HTTP（`study_complete_period` → `period/study/log`），
|
||||
只有 `kind == "direct"` 的直链视频才用 Playwright 开真浏览器（`play_period_to_end`，app.py:1664）。
|
||||
- `play_period_to_end` 里已经有一处「盲点确定」的补丁，说明历史上就撞过类似弹层：
|
||||
|
||||
```python
|
||||
ok = pg.query_selector(".el-message-box__btns .el-button--primary")
|
||||
if ok:
|
||||
ok.click()
|
||||
```
|
||||
|
||||
但它只在视频开始播放**之后**每 2 秒点一次，且只认 Element-UI 的 message-box；
|
||||
如果是进入页面时的 `el-dialog` 遮罩，这个选择器打不中。
|
||||
- 新版平台课程页地址（`discover()` 拿到的 `page_url`，日志里 token 打码）：
|
||||
`https://study.dgjy.net/training/trainDetails?id=<trainCourseId>&isFront=1`
|
||||
- 课程页点「继续学习」后跳到课时列表页：
|
||||
`https://study.dgjy.net/training/curriculum?id=<moocCourseId>&isFront=1&courseId=<trainCourseId>`
|
||||
视频课时在 `period/list/tree/studyLog` 里，`periodType=2`，`file.fileType=mooc_video`。
|
||||
- 播放页拼法见 app.py:1675：
|
||||
`https://study.dgjy.net/training/courseVideo?classhour=<periodId>&isJoin=1&needJoin=1&courseId=<trainCourseId>&isFront=1&trainCourseId=<trainCourseId>`
|
||||
|
||||
### 为什么这次没抓到
|
||||
|
||||
演示账号（库里唯一账号）的两门课 12 + 14 个课时**全部已 `completeTime` 有值**，
|
||||
「首次进入」的前置状态已经不在了，弹层复现不出来。
|
||||
下次要么换一个没学过的账号/课程，要么把某个课时的 `studyLog` 清掉再试。
|
||||
|
||||
### 下次的复现 + 取证办法
|
||||
|
||||
用带界面的 Playwright 窗口，把登录后的 cookie 注进去，人工在窗口里点到弹层出现：
|
||||
|
||||
1. `python -c` 跑一遍 `app.login(user, pw)`，把 `sess.cookies`（只取 `*.dgjy.net`）写成 JSON；
|
||||
2. `launch_persistent_context(headless=False)`，`ctx.add_cookies(...)`，`goto` 课程页；
|
||||
3. 同时挂：
|
||||
- `page.on("request"/"response")` 全量记录（过滤掉 png/css/font）；
|
||||
- `document.addEventListener('click', ..., true)` 记录 `target` 的 CSS 路径和文字；
|
||||
- 每 2 秒 `page.screenshot()` 一张；
|
||||
- 每 2 秒扫一次可见的 `.el-message-box / .el-dialog / [role=dialog]`，把 `innerText` 落日志。
|
||||
4. 人工点掉弹层 → 看日志里「点击前后出现了哪个 dialog 文本 + 紧随其后的请求」，就知道该自动点哪个。
|
||||
|
||||
### 修好后要做到
|
||||
|
||||
- 自动学习时不再需要人工点一下：进课程/进课时后若出现确认弹层，自动识别并点掉，
|
||||
再继续走 `period/study/log` 或 `courseVideo` 播放。
|
||||
- 只点「继续/确定/我已知晓」这类无副作用的按钮，别乱点「提交/评价」。
|
||||
- 日志里留下「已自动关闭弹层：<文字>」，方便出问题时对账。
|
||||
|
||||
### 相关代码位置
|
||||
|
||||
| 位置 | 作用 |
|
||||
| --- | --- |
|
||||
| `app.py:1664` `play_period_to_end` | 直链视频真播；已有盲点 `.el-message-box__btns .el-button--primary` |
|
||||
| `app.py:1530` `run_study_course` | 新版平台课程主流程（反馈表 / 测验 / 视频） |
|
||||
| `app.py:1013` `discover_study` | 读课程结构，产出 `page_url` / `train_id` / `courseware` |
|
||||
| `app.py:1128` `study_period_log` | 课时上报接口，`isComplete` 走这里 |
|
||||
| `app.py:633` `_discover_once` | jspx 课程页 → study `trainDetails` 的跳转与 token 落 cookie |
|
||||
（「首次进入课程弹『未加入课堂』」已修复，实测确认见 `OPTIMIZATION.md`。）
|
||||
|
||||
Reference in New Issue
Block a user