# chaoxing-welearn-auto

**Repository Path**: omni331/chaoxing-welearn-auto

## Basic Information

- **Project Name**: chaoxing-welearn-auto
- **Description**: 学习通/WE Learn 自动刷课工具包与脚本（DSH Agent 交接仓库）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-26
- **Last Updated**: 2026-10-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 学习通 / WE Learn 自动刷课工具包（Agent 交接仓库）

本仓库是「自动刷课」这条任务的**唯一事实来源**，用于在多个 Agent / 多台机器之间交接进度。
所有脚本都通过 **Kimi WebBridge**（本机 `http://127.0.0.1:10086/command`）驱动**你自己已登录的浏览器**操作，不涉及账号密码。

- Gitee：https://gitee.com/omni331/chaoxing-welearn-auto （公开）
- 本地目录：`D:\Desktop\学生工作\chaoxing-welearn-auto`

## 为什么 Gitee 上有两个仓库

| 仓库 | 负责 | 状态 |
|---|---|---|
| `omni331/welearn-autopilot` | **WE Learn 真时长 + 真作答**（另一个 DSH 会话在跑，本地目录 `D:\Desktop\学生工作\welearn-autopilot`） | ✅ 129 项全部达标（用时≥3 分钟、87 个考核项满分） |
| `omni331/chaoxing-welearn-auto`（本仓库） | **学习通章节视频任务点**（本会话） | ⏳ 进行中 |

两个仓库是**两条并行的任务流**，各自被一个 Agent 会话接管，所以没有合并：
- WE Learn 必须「标签页前台 + 真 submit + 真实计时」，做法重（CDP 隔离世界、Spartan 时长挂机），逻辑自成一体；
- 学习通是「前台 + 1 倍速播放 + 轮询 serverDone」，做法轻（一个 PowerShell 驱动 + 页内定时器）。

两者都要抢同一个 Edge 前台，所以**不要同时跑**：会互相把对方标签页挤到后台，导致计时/播放停摆。
本仓库保留 `welearn/` 目录只是留档对照（Kimi 旧方案），真正在跑的 WE Learn 代码在那个独立仓库里。

## 目录结构

| 目录/文件 | 内容 |
|---|---|
| `chaoxing-auto.ps1` | **学习通主驱动**（本仓库的核心）：读章节清单 → 逐章节直连 studentstudy（带 enc）→ 注入页内驱动器 1 倍速播放 → 卡死重载 → 完成后推 Gitee |
| `chaoxing-pack-for-dsh/` | Kimi 时期的原始工具包：nav / click / autopilot / play / focus 五个 WebBridge 请求 + 说明 |
| `welearn/` | WE Learn 旧脚本留档（`welearn-runner.py`、`welearn-fix*.py`、`welearn-probe*.py`、清单与进度、`funcs/` 逆向参考） |
| `webbridge/` | 历史 WebBridge 请求/快照 JSON（`wb-verify-result.json` 是 WE Learn 129/129 的验证结果；会话令牌已脱敏） |
| `state/chaoxing-progress.json` | 逐章节处理结果（`done` 的章节下轮自动跳过） |
| `logs/` | 每次运行的日志（不入库） |
| `push.ps1` | 一键提交并推送到 Gitee |

## 当前进度

| 任务 | 状态 |
|---|---|
| WE Learn《大学学术英语视听说教程上》(cid=260) | ✅ 129/129（见 `webbridge/wb-verify-result.json`） |
| 学习通《数字电路与逻辑设计》 | ⏳ 目录显示「已完成任务点 171/317」；剩余未完成章节中，绝大多数只剩**作业/测验**类任务点（脚本会跳过），真正待刷的是带未完成任务点视频的章节（如 6.3.1-2、13.8 等） |

## 血泪教训（务必遵守）

1. **必须 `Page.bringToFront`**：标签页一旦被挤到后台，Chrome 会把定时器冻住，WebBridge 每次调用从 1 秒变成 2~3 分钟，视频进度也不上报。驱动每 60 秒抢一次前台。
2. **studentstudy 直连必须带 `enc`**：不带就返回「enc校验失败」空页。`enc` 可以从目录页点任意章节的 URL 里取，跨章节通用、能存活数天。
3. **必须 1 倍速**，2 倍速服务器不上账。
4. **多终端提示弹窗**：浏览器里会弹出 alert「您的账号于 xx:xx 在一台 Edge 浏览器设备登入章节页面…」，挡住所有 CDP 调用；脚本会自动 `dialog accept`。挂机期间**别在手机/其他设备上开学习通**。
5. **视频卡死**（`t` 不动 / `dur:null`）→ 重新 navigate 该章节重载；驱动连续 2 次无进展就自动重载，4 次后放弃该章节。
6. 章节测验/考试类任务点**不做**，留给本人手动完成。
7. daemon 卡死（调用超时 / 502）→ `kimi-webbridge.exe restart`；驱动已内置自动重启。
8. 扩展未连接（`extension_connected:false`）→ 用户的 Edge 没开：`Start-Process msedge -ArgumentList '--profile-directory="Profile 1"'`，扩展在 **Profile 1** 下。

## 给下一个 Agent 的起手式

```powershell
# 0. daemon 与扩展
& "$env:USERPROFILE\.kimi-webbridge\bin\kimi-webbridge.exe" status   # 要 extension_connected:true
# 1. 学习通：直接跑驱动（自动跳过上轮 done 的章节；-ListOnly 只看清单，-Force 重查全部）
pwsh -NoProfile -File .\chaoxing-auto.ps1
pwsh -NoProfile -File .\chaoxing-auto.ps1 -ListOnly
# 2. 收工：pwsh -File .\push.ps1 "进度说明"
```

## 同步到 Gitee

```powershell
pwsh -File .\push.ps1 "本次改动说明"
```

`.gitignore` 已排除图片、压缩包、大体积网络抓包、日志，避免仓库膨胀；**仓库已设为公开，请勿写入证件照/学生证等个人材料，也不要写入会话令牌**（`webbridge/` 里的 `stuenc`、`enc` 已脱敏为 `REDACTED`）。