如果本项目帮到了你，可以在右上角点亮 Star，谢谢你！

实现了课程学习和根据题库自动考试，支持多用户多线程运行，自动验证码识别（需要源码运行，安装 ddddocr）。

运行前后会自动合并题库，如果一次没满分可以再考一次。可将 answer/answer.json 文件提交 PR 一起完善题库。

1. 安装 Python 3（可选使用 uv）和 Git

2. 克隆本仓库

git clone --depth 1 https://github.com/hangone/WeBan

3. 安装依赖

pip install -r requirements.txt # 或 uv sync

4. 运行

python main.py # 或 uv run main.py

从 Releases 下载文件运行，根据提示输入信息。下载缓慢可以用 https://gh-proxy.com/ 加速下载。

• Online 模式：体积小，首次运行需联网下载依赖
• Bundle 模式：体积大，完全打包依赖运行

软件使用 config.toml 配置文件（首次运行会自动从远程下载模板）。账号级配置可覆盖全局设置。

[settings]
# 学习模式：
# false = 不学习，跳过所有学习任务
# true  = 正常学习，默认跳过已完成内容
# force = 强制学习，已完成内容也会重新学习，全部学完后继续循环
study_mode = "true"

# 考试模式：
# false = 不考试，跳过所有考试任务
# true  = 正常考试，已及格/已完成的考试默认跳过
# perfect = 达到满分为止，如果只剩一次考试机会且题库无法完全匹配则会停止
# force = 强制考试，即使已及格也继续参加考试，除非没有考试机会了
exam_mode = "true"

# 遇到题库中没有的题目时是否随机作答：
# true  = 单选随机，多选全选
# false = 在终端中等待手动输入答案
random_answer = true

# 每个学习任务的最少停留时长（秒）
# 过快不会记录学习进度，数值越大越稳妥，但整体耗时也会越长
study_time = 30

# 每道考试题的答题等待时长（秒）
# 格式："基础等待时间,随机等待上限"
exam_question_time = "3,3"

# 允许提交试卷的最低题库匹配率（百分比）
# 当匹配率低于此值且 random_answer = false 时，程序会放弃交卷
exam_submit_match_rate = 90

# 多账号并发时允许的最大线程数
# 实际并发数 = min(账号数, max_workers)
max_workers = 5

# 浏览器可执行文件路径
# 留空则自动检测系统中已安装的 Chrome
browser_path = ""

# 是否启用调试日志
# 开启后会输出请求体、响应体等详细信息
debug = false

[[account]]
# 学校名称（必填）
tenant_name = ""
# 用户名
username = ""
# 密码（默认和用户名一样）
password = ""

# 支持在账号级别覆盖全局设置，例如：
# study_mode = "force"

• 课程学习：自动遍历项目 → 分类 → 课程，模拟翻页、答题、等待学习时长后完课
• 自动考试：基于题库自动答题，支持单选/多选，未匹配题目可随机作答或手动输入
• 验证码识别：自动识别滑块验证码（需源码运行 + ddddocr），腾讯点选验证码需手动操作
• 多账号并发：支持配置多个账号，可多线程同时执行
• 题库同步：考试前后自动从服务器同步题库，支持多用户共享
• 断点续考：追求满分模式下，一次未满分可再次考试
• 进度监控：完课后自动检查进度是否更新，未更新则警告提示
• 调试模式：开启 debug 可查看完整请求/响应日志

• 部分无法直接登录的学校/Token 登录方法

有些从迎新系统跳转的可以试试账号密码都是学号，也可以尝试使用 Token 登录，在电脑浏览器登录后按 F12 或者 Ctrl+Shift+I 打开开发者工具，找到本地存储，复制 user 的内容到 config.json 配置文件

• 学习

1. 学习时长太低不会计入进度
2. 有腾讯云验证码的还不支持自动完成，会弹出浏览器窗口手动操作
3. 学习进度不更新可能是被风控，遇到了需要验证码的课程，请去网页上完成一次后重试

• 考试

1. 据观察，考试未提交是不会消耗考试次数的

• Coaixy/weiban-tool 提供题库和一些代码思路
• pooneyy/WeibanQuestionsBank 提供题库

1. 本项目仅供学习交流使用，请勿用于商业用途，否则后果自负。

2. 欢迎 Star 喵，欢迎 PR 喵。

3. 截图时注意打码个人信息。

4. 如果看不懂上面说的也可以直接扫码备注学校和账号密码（建议留言微信号），乐意效劳。

   微信	支付宝