dsh-cx-learn

cx-learn

> 把「超星学习通看课」变成一个可调度、可观测、可随时停止的 DSH 插件。

用 CDP（Chrome DevTools Protocol）驱动一个真实的 Chromium，自动推进课程视频：

恢复播放、关掉防挂机弹窗、自然结束自动切下一节、跳过已完成的小节。

它不答题、不写后端、不伪造进度：

• 视频内的随堂题按选项顺序盲试（不计入课程成绩），答错换下一个；
• 章节测验 / 作业只识别、只记录，连标签都不点；
• 一旦页面出现人脸识别 / 活体 / 验证码，立即停止，不做任何绕过。

---

功能

| 能力 | 说明 |

|---|---|

| P0 播放态检测 | 视频被暂停就恢复播放；自动关掉防挂机弹窗 |

| P1 自动切节 | 本节播完自动切下一节；切节后校验播放器确实换了内容 |

| P2 随堂题盲试 | 只点 .ans-videoquiz 里的选项；遇到「回看」惩罚或次数耗尽立即停 |

| P3 跳过已完成 | 按任务点级证据判断，已看完的小节直接跳过 |

| P4 章节模式 | 单章节 / 章节连播，可限制每轮新增看完的节数 |

| 扫码登录 | 设置页直接显示二维码，手机学习通扫一次 |

| 会话复用 | 一段连续使用期内，内核与登录态不销毁，可连刷多门课 |

| 人工审阅队列 | 识别到的题目进队列（不含答案），可一键生成对话框草稿 |

安全边界（不可协商）

1. 章节测验 / 作业绝不触碰 —— 不点选项、不提交、连标签都不点。

2. 随堂题盲试是唯一的自动作答例外（不计成绩）。

3. 人脸 / 活体 / 验证码 → 立即停止，不绕过。

4. 不调用学习通任何进度写接口、不伪造上报。

5. 识别不出来不停机（题目分类不确定时记录并继续）；只有确定性死循环才停。

环境要求

• DSH（DeepSeek Harness）>= 0.2.0-rc.1
• Node.js >= 22
• 一个 Chromium 系浏览器内核（Chrome / Edge / Chromium / chrome-headless-shell）

插件本身零 npm 依赖，引擎只用 Node 内置模块。

运行实例

设置页：课程业务区（播放模式、每轮最多新看节数、保存配置）与运行控制（开始看课 / 停止），下面是实时日志。

安装

方式一：插件市场

在 DSH 的插件管理页搜索 cx-learn，安装后启用。

方式二：本地链接（开发）

git clone https://github.com/forgotfish/dsh-cx-learn.git
cd cx-learn
dsh plugin --profile web add link:$PWD

重启对应的 DSH 实例生效。

快速上手

1. 准备浏览器内核（见下节），或用系统自带的 Chrome / Edge。

2. 打开 DSH → 设置 → 学习通看课。

3. 点「开始登录」→ 约 10 秒后点「刷新二维码」→ 用手机学习通扫码确认。

4. 点「读取我的课程」→ 选一门课（会自动带上 clazzid / enc）。

5. 点「保存配置」→「开始看课」。

运行状态、内核健康、最近日志都在同一页；题目进「待处理题目」，超过 3 条自动折叠。

浏览器内核

按以下顺序探测：

1. 设置页里填的自定义路径

2. 共享内核目录（CX_BROWSER_ROOT 或 $DSH_HOME/cx-learn/browsers）

3. 系统已安装的 Chrome / Edge

内核目录结构：

browsers/
├── chrome-linux64/
│   └── chrome
└── chrome-headless-shell-linux64/
    └── chrome-headless-shell

> 部分精简版 Chromium 缺 H.264/AAC 解码，播放某些课程会失败；完整 chrome 更稳。