南京大学本科生选课系统自动抢课捡漏工具,支持自动登录、验证码识别、多课程循环抢课、Server 酱通知。
开源地址
https://github.com/GreenTeodoro839/NJU-xk-helper
效果图


功能特性
- 自动登录:自动完成统一身份认证登录 + 点选验证码识别
- 本地验证码识别:针对选课平台验证码训练的轻量ONNX模型,快速识别,准确率高
- 循环抢课:自动轮询选课接口,抢到后自动移除并通过 Server 酱推送通知
- Session 缓存:登录态本地缓存复用,减少重复登录
- 并发模式:
xk_quick.py支持多线程并发提交,适合开放选课瞬间抢课 - 课程查询:终端内按关键字搜索课程,翻页浏览,快速获取课程 ID
- 辅助工具:选课批次获取、Cookie 手动导入、Payload 解密
项目结构
├── xk.py # 主抢课脚本(循环模式)
├── xk_quick.py # 快速抢课脚本(并发模式)
├── README.md
├── config/
│ ├── xk.conf # 主配置文件(账号、代理等)
│ └── course.conf # 课程配置(选课批次 + 课程列表)
├── models/
│ ├── upper_model.onnx # 验证码识别模型(上方字符)
│ └── title_model.onnx # 验证码识别模型(标题字符)
├── lib/
│ ├── session_manager.py # 登录态管理(缓存/验证/刷新)
│ ├── authenticator.py # 登录流程执行(验证码获取→识别→提交)
│ ├── captcha.py # 验证码识别
│ ├── des_encrypt.py # DES 密码加密(移植自前端 JS)
│ ├── serverchan.py # Server 酱推送通知
│ └── common.py # 共享工具(配置加载、AES加密、请求头等)
└── tools/
├── get_batch_code.py # 获取选课批次代码
├── query_course.py # 课程查询工具(按关键字搜索)
├── query_course_v2.py # 课程查询工具 v2(动态获取参数,推荐)
├── import_favorites.py # 从收藏列表导入课程到 course.conf
├── input_cookie.py # 手动导入浏览器 Cookie
└── course_decrypt.py # AES Payload 解密工具环境要求
- Python 3.8 ~ 3.12
- Windows / Linux / macOS
- 校内网络或 EasyConnect VPN
安装
# 1. 克隆项目
git clone https://github.com/GreenTeodoro839/NJU-Auto-xk.git
cd NJU-Auto-xk
# 2. 创建虚拟环境
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux/macOS
source .venv/bin/activate
# 3. 安装依赖
pip install onnxruntime pillow numpy requests pycryptodome serverchan-sdk pysocks依赖说明
包名 用途 onnxruntime验证码 ONNX 模型推理 pillow图像处理 numpy矩阵计算(匹配算法) requestsHTTP 请求 pycryptodomeAES/DES 加密 serverchan-sdkServer 酱推送(可选,不装不影响运行) pysocksSOCKS5 代理支持(可选)
配置
config/xk.conf
主配置文件,JSON 格式:
{
"USER": "你的学号",
"PWD": "你的密码",
"PWD_ENCRYPT": "",
"MAX_RETRIES": "20",
"SCT_KEY": "你的Server酱SendKey",
"SCT_OPTIONS": {
"tags": "选课脚本"
},
"PROXY": "socks5://127.0.0.1:1080"
}| 字段 | 必填 | 说明 |
|---|---|---|
USER | ✅ | 学号(统一认证用户名) |
PWD | ✅ | 密码明文(脚本自动加密后提交,推荐填这个) |
PWD_ENCRYPT | ❌ | 密码加密文本(和明文二选一,获取方式见下方) |
MAX_RETRIES | ❌ | 登录最大重试次数,默认 3 |
SCT_KEY | ❌ | Server 酱 SendKey,不填则不推送 |
SCT_OPTIONS | ❌ | Server 酱附加选项 |
PROXY | ❌ | 代理地址,支持 socks5:// 和 http:// |
获取加密密码(如果不想填明文):在选课平台按 F12 打开开发者工具,选 Network,登录后找到登录请求,复制
loginPwd字段的值填入PWD_ENCRYPT。
config/course.conf
课程配置文件,JSON 格式:
{
"electiveBatchCode": "选课批次代码",
"courses": [
["教学班ID", "课程类别", "教学班类型", "备注"],
["2025202621800143001", "1", "ZY", "高等数学"]
]
}| 字段 | 说明 |
|---|---|
electiveBatchCode | 选课批次代码,通过 tools/get_batch_code.py 获取 |
courses | 课程列表,每项为 [teachingClassId, courseKind, teachingClassType, 备注],第 4 项备注可选 |
如何获取课程参数?
方法一(最省心):先在选课平台网页上收藏想抢的课程,然后一键导入:
python tools/import_favorites.py方法二(推荐):使用课程查询工具 v2,课程参数从平台动态获取,无需依赖硬编码对照表:
python tools/query_course_v2.py方法二(旧版):使用课程查询工具搜索课程名(依赖硬编码对照表):
python tools/query_course.py方法二:在浏览器选课页面按 F12,Network 面板中找到
volunteer.do请求,复制 Payload 中的 addParam,用解密工具查看:python tools/course_decrypt.py
关于 teachingClassID 和 courseKind
teachingClassID 的构成规律:学期代码 + 课程号 + 班级序号
例如 2025202621800143001 = 20252026-2(2025-2026 学年第二学期) + 18001430(课程号) + 01(第 1 个班)
courseKind(jxblx)对照表:
| 类别 | teachingClassType | courseKind |
|---|---|---|
| 专业 | ZY | 1 |
| 体育 | TY | 2 |
| 科学之光 | GG06 | 3 |
| 公选课 | GG01 | 4 |
| 美育 | MY | 5 |
| 导学/研讨/通识 | GG02 | 6, 7 |
| 悦读 | YD | 8 |
| 跨专业 | KZY | 12 |
| 大学数学 | TX01 | 13 |
| 大学英语 | TX02 | 14 |
| 思政军事类 | TX03 | 15 |
| 计算机 | TX04 | 16 |
使用方法
1. 获取选课批次代码
python tools/get_batch_code.py运行后自动将 electiveBatchCode 写入 config/course.conf。
2. 导入收藏课程(最省心)
先在选课平台网页上把想抢的课程加入收藏,然后运行:
python tools/import_favorites.py # 交互式选择导入
python tools/import_favorites.py --all # 一键导入全部收藏脚本会自动登录 → 拉取你的收藏列表 → 展示课程详情 → 选择后写入 course.conf。已在配置中的课程会自动标记并跳过。
3. 查询课程 ID(推荐 v2)
python tools/query_course_v2.pyv2 版本会自动从选课平台获取 courseKind / teachingClassType 映射,不依赖硬编码对照表。输入课程名或教师名搜索,支持翻页(u/d),输入编号查看课程 ID,然后按提示直接写入或手动填写 config/course.conf。
旧版 python tools/query_course.py 仍可使用,但课程参数依赖硬编码对照表,可能不准确。4. 运行抢课(循环模式,捡漏专用)
python xk.py脚本会自动登录 → 循环请求选课接口 → 抢到后推送通知并从 course.conf 移除 → 直到全部抢完或手动终止。
5. 运行抢课(并发模式)
python xk_quick.py适合选课系统刚开放时使用,多线程并发提交提高成功率。
6. 手动导入 Session(备用)
如果自动登录遇到困难,可以手动从浏览器复制 Cookie 和 Token:
python tools/input_cookie.py注意事项
- 需要在校内网络或通过 VPN/代理连接校园网
electiveBatchCode会随选课批次变化,每次选课前需重新获取- 脚本检测到登录失效("非法请求")时会自动重新登录
- 抢到课后会通过 Server 酱推送通知(需配置
SCT_KEY) - 每轮抢课之间有随机间隔(30~90s),避免频繁请求
辅助工具
| 工具 | 说明 |
|---|---|
tools/get_batch_code.py | 连接选课系统获取当前可用的选课批次代码 |
tools/import_favorites.py | (最省心) 从选课平台收藏列表一键导入课程,自动跳过已有课程 |
tools/query_course_v2.py | (推荐) 按关键字搜索课程,课程参数从平台动态获取 |
tools/query_course.py | 按关键字搜索课程(旧版,依赖硬编码对照表) |
tools/input_cookie.py | 从浏览器手动复制 Cookie/Token 写入缓存 |
tools/course_decrypt.py | 解密选课请求的 AES 加密 Payload,用于调试 |
免责声明
本项目仅供学习交流使用。使用本工具产生的一切后果由使用者自行承担,开发者不对因使用本工具导致的任何问题负责。请遵守学校相关规定,合理使用。



3 条评论
非常好工具,使我的网站旋转,爱来自itsc
真的是itsc吗
非常好工具,使我的课表旋转,爱来自小登