摘要:展开

南京大学本科生选课系统自动抢课捡漏工具,支持自动登录、验证码识别、多课程循环抢课、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 解密工具

环境要求

安装

# 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)对照表:

类别teachingClassTypecourseKind
专业ZY1
体育TY2
科学之光GG063
公选课GG014
美育MY5
导学/研讨/通识GG026, 7
悦读YD8
跨专业KZY12
大学数学TX0113
大学英语TX0214
思政军事类TX0315
计算机TX0416

使用方法

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.py

v2 版本会自动从选课平台获取 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,用于调试

免责声明

本项目仅供学习交流使用。使用本工具产生的一切后果由使用者自行承担,开发者不对因使用本工具导致的任何问题负责。请遵守学校相关规定,合理使用。

最后修改:2026 年 03 月 08 日
如果觉得我的文章对你有用,请随意转载