UnipusAI-Helper
基于 Selenium、Fluent UI 与 OpenAI 兼容接口的 U 校园 AI 版刷课工具
特性
- GUI 控制台：显示任务清单、完成状态、运行状态、实时日志和调试开关；账号默认脱敏显示。
- 任务状态感知：扫描时读取每个任务是「已完成 / 未开始 / 进行中」，默认只勾选未完成必修。
- 断点续跑：每完成一个任务自动取消勾选，停止后剩下的勾选就是「还没做」的任务，再点开始即从卡住的那题继续。
- 双模式处理：支持「扫描任务列表」批量处理、只扫「当前单元必修」，也支持「快速处理当前页」。
- 单元编号按目录真实标题显示，
Course preview这类预习单元单列为「预备单元」，不会把后面的 Unit 挤乱。 - 多题型处理：支持单选、多选、填空、写作、选词填空、拖拽排序、下拉选择、词汇测试、听力填空、听力选择、视频选择、视频任务、视频弹窗题、词汇闪卡、Self-check 词汇勾选、My voice 文字作答、人物 A–F 匹配、翻译段落、首字母搭配填空、Wrapping up 自评清单、讨论区发帖、跟读/朗读录音题、中文括注填空（直接复用 Vocabulary 答案）、主观录音题（TTS 作答）。
- 答案格式校验：选项题会把模型回填的选项原文反查成字母；本页有题没填好时自动二次修正。
- 搭配题增强：自动读取同题组的
Learning页当答案上下文；空位多时按 8 空分批提问；题干印在输入框外的首字母会自动去掉再写入。 - 做完自动交卷：填完直接提交，日志提示「已自动提交」；找不到按钮会明确提示手动提交。
- 音视频辅助：支持本地 Whisper 转写。
- 环境检查：启动时检查 Edge、FFmpeg、网络和运行环境。
- 配置编辑器：提供独立 GUI 编辑器，减少手动修改 JSON 出错的概率。
使用方法
git clone https://github.com/YSJohnson/UnipusAI-Helper.git
cd UnipusAI-Helper
py -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt
.venv\Scripts\python.exe config_editor.py
.venv\Scripts\python.exe UnipusAI_Helper.py如果系统没有 py 命令，可将创建虚拟环境的命令改为 python -m venv .venv。先运行配置编辑器生成 config.json，保存后再启动主程序。
如需跳过环境检查：
.venv\Scripts\python.exe UnipusAI_Helper.py --skip-check配置说明
项目使用 config.json 作为本地配置文件，建议使用配置编辑器而不是手动修改。
{
"username": "",
"password": "",
"url": "https://uai.unipus.cn/sso/index.html?service=https%3A%2F%2Fucloud.unipus.cn%2Fhome",
"api_key": "",
"base_url": "",
"model": "",
"max_tokens": 32768,
"temperature": 0.3,
"token_full": "",
"debug_mode": false
}| 字段 | 必填 | 说明 |
| --- | --- | --- |
| username | 是 | U 校园 AI 版账号，用于自动登录 |
| password | 是 | U 校园 AI 版密码，用于自动登录 |
| url | 否 | 登录入口，留空或保持默认值即可 |
| api_key | 是 | 大模型接口密钥 |
| base_url | 是 | OpenAI 兼容接口地址，例如 https://api.siliconflow.cn/v1 |
| model | 是 | 接口支持的模型名称 |
| max_tokens | 否 | 最大 token 数，默认 32768。推理型模型会把预算烧在思考上，代码层下限也是 32768；模型不接受时会自动减半重试 |
| temperature | 否 | 生成温度，保持默认数值即可 |
| token_full | 否 | 认证兜底；支持旧版完整 __token JSON 或 U校园 5.0 的 JWT，正常登录时留空 |
| debug_mode | 否 | 是否开启调试日志，默认 false |
| tts_engine | 否 | 录音题语音合成后端：auto（默认，先 edge 后 sapi）/ edge / sapi / off |
| tts_voice | 否 | TTS 音色；留空用默认英语音色（en-US-AriaNeural / 系统英语语音） |
| tts_proxy | 否 | edge-tts 需要走代理时填，例如 http://127.0.0.1:7890；离线 sapi 不需要 |
录音题里的「主观题」（Exercise 2 这类只有计时录音按钮、没有原声的题）靠 TTS 作答。
装了edge-tts（pip install edge-tts，已列在requirements.txt）会优先用它，音色更自然；
没装或断网时自动回退到 Windows 自带的 System.Speech，完全离线也能出声。
使用指南
- 配置好基础信息，启动主程序并等待环境检查完成。
- 程序会自动打开浏览器并执行登录流程。
- 如果遇到验证码或人机验证，需要在浏览器中手动完成。
- 系统就绪后，控制台显示系统就绪即为登录成功。
- 先在浏览器点击
我的课程->选择你要刷的课程，打开到展示教程目录的页面。
- 可点击「扫描任务列表」，脚本会扫描所有单元所有任务并展示出来；扫描完默认勾选的是未完成必修，
- 点击「处理选中任务」即可批量全自动处理选中任务。每做完一个任务会自动取消勾选并把状态改成「已完成」；
- 或者手动打开需要做的某一个页面，进入到题目页面，点击「快速处理当前页」，脚本则只做当前页面。
- 做完后脚本会在延迟几秒后自动提交。
更新日志
点击展开完整更新日志
v3.9.0（2026-10）：Exercise 1 词汇复用 / Exercise 2 主观录音题 TTS（issue #29）
感谢 mctea01 提供账号密码并反馈 issue #29
接着 v3.8.0 的跟读适配，把 After you view 里剩下的两个子步骤补齐：
- Vocabulary 对照表复用：解析
Vocabulary页的跟读行时，把「英文原词 + 中文释义」收进
VocabularyStore，按中文归一化后建索引，支持包含/近义变体命中）。
- Exercise 1（中文括注 → 英文填空）不再让模型自由翻译：题干里
____ (老年大学)这类
- 词形一律交给模型：脚本只提供对照表，不做任何机械变位（不加
-ing、不拼-ed、不改大小写）。
-ing / -ed / 复数 / 首字母大写时就改，词干必须与表里一致」。
这样 … discovering new demands and ____ (释放新动力) 会由模型自己写成 unleashing new impetus，
遇到复数、派生词这类规则覆盖不到的变化也不会被脚本硬掰错。
- Exercise 2（主观录音题）新增 TTS 作答：这类题只有一个 02:00 计时录音按钮、没有原声可借。
- 双 TTS 后端：默认
auto，先试edge-tts（微软在线朗读，音色自然，可配代理），失败自动回退到
System.Speech（sapi，离线可用）；配置 tts_engine 可强制指定或 off 关闭。
- 录音按钮识别加兜底：
Exercise主观题的录音按钮不一定带button-record，主选择器找不到时
.button-record / .oral-record-btn / .record-btn 等，避免整题被当成「没有输入框」跳过。
- 主观题也按分数判定：自由作答停止后平台会先上传音频再评分（实测同一个 239 词语音拿到
.p-oral-personal-state 上、不在录音按钮那一层，判定逻辑一并上扩到该层；
没有分数时退回「出现可回放的 - 实测（新视野视听说教程4 / Unit 2 Viewing China）：Vocabulary 7 条跟读 7/7，得分
senior citizen's college / silver economy / unleash new impetus /
smart elderly care），词形由模型按句子语法调整，其中空 3 应为 unleashing new impetus。
| 题型 | 识别特征 | 处理方式 |
| --- | --- | --- |
| 跟读录音（Vocabulary / Exercise 1） | .oral-study-sentence 行 + .record-icon.button-record | 借题目自带原声冒充麦克风，逐条录音等评分 |
| 自由作答录音（Exercise 2） | 计时录音按钮（02:00 + 点击结束录音），行内没有 | 模型写口语稿 → TTS 合成 → 同样注入麦克风 |
| 中文括注填空（Exercise 1） | 题干 ____ (老年大学) | 命中 Vocabulary 对照表就直接填，未命中才走模型 + 对照表上下文 |
v3.8.0（2026-11）：跟读/朗读录音题适配（issue #26）
- 新增跟读/朗读录音题：新版视听说教材（
course-v2播放器）的Vocabulary、Exercise
- 实现方式：不调用任何 TTS。把题目自带的原声（
audio.question-audio.audio-origin的
src，..._96k.mp3）下载下来，在页面里 decodeAudioData 后接进
MediaStreamDestination，并覆盖 navigator.mediaDevices.getUserMedia 把这条流冒充成
麦克风输入，页面自己的录音器照常上传评分。
- 关键细节：页面录音器在开始拉流后的前约 0.6 秒会丢块并把丢失部分补成静音，直接喂原始
- 录音题不需要模型给答案，走单独的作答分支：逐条录音 → 等评分回填 → 条数齐了再交卷；
- 录音题的原声就是题目本身，不再对它做 Whisper 转写，省掉一次无用的音频预处理。
- 启动参数补
--use-fake-ui-for-media-stream、--autoplay-policy=no-user-gesture-required，
_create_driver 增加广义 except 分支，兜住驱动
握手超时（urllib3 ReadTimeoutError）后再降级兼容模式重试。
v3.7.1（2026-10）：扫描当前单元重做 / 按钮层级修正 / 列表清理
- 「扫描当前单元」重做：只读当前已经打开的单元，不再逐个点 Tab，也不会误扫成第 1 个单元；
tabActive / sliderActive 识别；
- 按钮层级对齐：「扫描当前单元」与「扫描任务列表」同为主色按钮，登录完成后一起启用
- 消除歧义：两个扫描按钮的文案固定不变，不再互相变成「重新扫描」；
- 列表清理：重新扫描时先摘除旧控件再销毁，空状态提示不会再叠在任务列表上；
- 空列表提示文案同时提到「扫描任务列表」与「扫描当前单元」两个入口。
v3.7.0（2026-10）：任务状态感知 / 断点续跑 / 匹配题与新题型适配 / 自动交卷
感谢 iceqi717 提供账号
使用体验
- 扫描时读取每个任务的「已完成 / 未开始 / 进行中」，任务行右侧显示状态标签；
- 新增「仅未完成必修」筛选，扫描完默认只勾选未完成必修；
- 每完成一个任务自动取消勾选并把状态改成「已完成」，停止后剩下的勾选就是还没做的，
- 新增「扫描当前单元必修」，只扫当前单元、不切换其它 Unit；
- 单元编号改用目录真实标题，
Course preview这类预习单元单列为「预备单元」，不再把后面的 Unit 挤乱； - 界面字号整体放大、日志区额外放大到约 130%，分组标题加粗提亮；账号默认脱敏显示；
- 日志去掉 emoji，改用
【请求】/【返回】/【等待】/【跳过】/【完成】等标签；AI 请求前后打印字数与耗时。
- 新增人物 A–F 匹配题：按
data-scoop-index切分陈述，模型只回字母，逐空写入； - 选项题会把模型回填的选项原文反查成字母；本页没填好时自动二次修正；
- 空位多的填空题按 8 空分批提问，整批返回空就 8→4→2 对半拆，最后 1–2 空换短问法重试；
- 搭配题自动读取同题组的
Learning页当答案上下文，并用「同前缀候选词」抑制误选； - 题干印在输入框外的首字母会自动去掉再写入（
un+unhappy→ 写happy）； - 填完自动提交，日志提示「已自动提交」；点不中按钮会明确提示手动提交；
max_tokens默认 32768，代码层下限 32768，模型不接受时自动减半重试。
| 题型 | 识别特征 | 处理方式 |
| --- | --- | --- |
| 人物 A–F 匹配 | 方向含 match the people / Filling the blanks with A-F | 按空位切分陈述，模型只回字母，逐空写入 |
| 翻译段落 | 方向含 Translate … into Chinese | 把原文整段喂给模型，只输出中文译文 |
| 首字母搭配填空 | 空位前有 1–4 个绿色首字母（un____ / la____） | 模型给完整单词，程序自动去掉题干已印出的前缀再写入 |
| 看视频写 summary | textarea + summarize 方向 | 转写视频后写 3–4 句英文总结 |
| Wrapping up 自评清单 | Got it 表格 + anticon-border 图标 | 逐行点「Got it」 |
| 讨论区发帖 | textarea[placeholder="我来评论"] + 发布按钮 | AI 写 60–90 词观点并发布，校验评论数 |
搭配填空题还会：读同题组 Learning 页当上下文（内容过短自动回退去读同单元 Reading the text）；
空位 >8 时分批；从题面 + 上下文给每个空列同前缀候选词；填完自动提交。
v3.6.0（2026-10）：适配新版 ipublish 播放器教材（course-v3）
新农科大学英语 这类 course-v3 教材完成初步适配，感谢 Miku196 提供的账号。
使用方式与旧版一致。
| 题型 | 播放器标记 | 处理方式 |
| --- | --- | --- |
| 单选 / 多选 | single_choice_group / multiple_choice_group | 按选项字母点击 |
| 判断 | true_false_group | 点击 T / F |
| 填空 | fill_blanks_group | 按空号写入 input（支持一个组里多道小题、多个空） |
| 选词填空 | fill_blanks_choice_group | 从候选词中选择后写入 |
| 下拉填空 | fill_blanks_dropdown_group | 点开空位抓取候选列表后交给模型选择，按文本精确点选 |
| 简答 / 翻译 / 写作 | short_answer_group / translation_group / writing_group | 写入文本作答框 |
会跳过并提示的题型：口语录音（oral_personal_state_group）、附件上传
（multi_media_upload_group）、连线匹配（text_match_group）、小组讨论（discussion_group）。
纯阅读材料（rich_text_read_group）不答题，但会作为上下文提供给模型。
v3.5.x 及更早：多选修复、任务定位、依赖与界面
- 2026-10-07 修正多选判定与选项点击（#20）
- 2026-10-07 兼容新版课程目录 node 任务结构（#16）
- 2026-09-24 适配 U校园 AI 版 5.0，移除
numpy<2.0.0限制修复 Python 3.13+ 安装失败 - 2026-09-18 修复同名任务定位与停止响应
- 2026-09-09 移除遗留代码与冗余依赖，精简代码结构
- 2026-09-04
AudioTranscriber支持use_local，修复 TypeError - 2026-07-05 v3.5.0 题型更新
- 2026-06-07 更换 Fluent UI 界面
题型适配投稿
我本身能接触到的教材有限 能适配的教材题型也有限 所以不能保证所有题型都适配 目前已知新视野大学英语1 2 3册是基本全部适配 新农科大学英语完成初步适配 其他教材可能会出现不适配的情况。
如果你遇到暂不支持的新题型/新教材 可以在 issue 中投稿页面结构 或者是联系我的邮箱私信发送账号密码（我会在最小范围内使用 这也是最快最高效的方法） 我会在有可复现材料时优先适配 也将会帮助项目变得更加完善。
材料越完整，越容易适配；只有一句“这个题型不支持”的 issue 无法判断页面结构 将被作为无效 issue 关闭。
致谢
感谢优秀的开源土壤。 感谢 UnipusAI 项目作者 Zzj-klwgxdz。这是纯命令行 + 原生 HTTP 实现的 Rust 版 U 校园 AI 版刷课脚本。 感谢原作者提供的强大解析器框架与思路，特别是其针对 U 校园 AI 版登录认证状态的处理机制。
Star⭐ 对你有帮助欢迎点个Star
License
本项目采用 GNU Affero General Public License v3.0 (AGPLv3)。 你可以自由使用、修改和分发本项目，但任何修改版或衍生作品必须以相同的 AGPLv3 协议开源。即使是作为网络服务运行（SaaS），也必须向用户公开完整的源代码。
[!WARNING]
本项目仅用于 Python 自动化、Web 页面交互、语音识别与大模型接口接入的学习研究。请遵守学校、课程平台和相关法律法规，不要将其用于违反平台规则或影响教学公平的用途。