feat: 接入广东公需课平台（jsglpt 登录 + jsxx 进度心跳）

- 新增 platforms/gdgxk.py：base64 登录 → ssoItlmsGxkTicket 换票进 jsxx →
  /uc/store/courseRegister 取课程 → updateViewTime1 心跳上报进度（无需真播）
- platforms/__init__.py 注册；配套抓包脚本与自测脚本
- CHANGELOG / OPTIMIZATION / todo 同步，版本升到 0.0.2

OPTIMIZATION.md

@@ -171,3 +171,39 @@ GET /mod/school/wanpeng/syncSelf?courseCode=<courseCode>
 
 - 控制台没有 `[system]` 行 → 跑的是旧进程（端口被占用时新代码会提示后直接退出），先结束旧 PID 再启动。
 - 「系统日志」弹窗空白 → `GET /api/log?key=system` 有 lines 就是前端缓存问题，刷新即可；没有 lines 说明还没产生 system 日志，保存一次设置就能看到。
+
+## 广东公需课平台接入（jsglpt → jsxx）
+
+**状态**：接口链路已实测跑通（课程列表、播放注册、进度心跳都拿到 `responseCode=00`），待用真实密码登录 + 未学完课程确认端到端。
+
+### 已确认的接口
+
+- 登录：`POST https://jsglpt.gds.edu.cn/loginIn.do`，`loginUser.userName` / `loginUser.password` 都是 **base64**（账号是手机号），`loginUser.loginType=normal`；表单还有 `captcha` 字段，`GET /login/readCaptcha.action` 返回 `"data:image/png;base64,..."` 的 4 位图形验证码（是否强制尚未验证）。
+- 换票：`POST /teacher/ssoItlmsGxkTicket.action?verificaCode=true&page=` → `ITLMS-<hex>||<sig>`；带 `?ticket=` 访问 `https://jsxx.gds.edu.cn/uc/store/courseRegister` 即拿到学习平台会话，两个域名的 cookie 要一起保存。
+- 课程列表：`GET /uc/store/courseRegister`，页面里是 `showCourse('<课程id>','<课程名>')`。
+- 学习页：`GET /study/course/<课程id>?v=1`（服务端渲染、UTF-8），含 `url1`（CDN 直链 MP4）、`t`（总秒数）、`md5Uid`、`/a_<aid>/...` 上报前缀。
+- 播放注册：`POST /a_<aid>/study/video/user/updateVideoStatus1`（`_method=PUT&id=<课件id>&md5Uid=<uid>&playbackSessionId=<sid>&playbackTakeover=true`）→ `{time, md5}`。
+- 进度心跳：`POST /a_<aid>/study/video/user/<课件id>/updateViewTime1`（`_method=PUT&aid=...&isLimit=false&md5&expires&md5Uid&lastViewTime=<秒>&playbackSessionId`）。
+- 已看秒数：`GET /a_<aid>/study/video/user/getViewTime?id=&md5=&expires=&md5Uid=`，`responseData` 直接就是秒数。
+
+### 踩到的坑
+
+- 三个上报接口必须带 **Referer（指向课程页）**，否则 500 且响应体为空。
+- `isLimit` 只能传 `false` / `true`，传 `"N"` 会 400。
+- 课程列表页、学习页都是 UTF-8（别按 GBK 解，会花屏）。
+
+### 关键结论
+
+进度不靠播放器，`lastViewTime` 直接写服务端。实测把 2640 秒的课报到 2700 秒也被接受，说明可以跳着报、不必真播；默认 `speed=60`、`beat=2`，44 分钟的课约 45 秒报完。课程是否学完看 `getViewTime >= t`。
+
+### 怎么测
+
+1. 「添加账号」平台选「广东公需课」，填手机号 + 密码 → 能拉到课程列表就算登录成功。
+2. 选一门**没学完**的课 → 开始学习 → 看「课程日志」里的进度上报行，再回平台页面核对已学时长。
+3. 登录若报「平台要求图形验证码」，说明密码登录要过验证码，先改用浏览器登录后导入 cookie，再补 OCR。
+
+### 如果没生效
+
+- 400 → 看 Referer 有没有、`isLimit` 是不是 `false`。
+- 500 且空响应 → 少了 Referer，或 `md5Uid` 取错。
+- 课程列表为空 → jsxx 会话失效，重新登录（或等 `renew_session` 换票）。