本项目仅支持在Windows设备上运行
一键运行脚本,自动完成 Python 环境检测/静默安装、pip 镜像配置、依赖安装并启动 course_selector.py。
工具脚本需要的 credentials.json(示例见仓库同名文件)包含 token、student_id 和 turn_id 三个字段。推荐用篡改猴脚本自动抓取:
- 安装 Tampermonkey 浏览器插件(或任意兼容的用户脚本管理器)。
- 在浏览器中新建脚本,粘贴本仓库的
ahucusthelper.user.js内容后启用(或者在安装了插件后直接拖入浏览器页面)。 - 登录
https://jw.ahu.edu.cn/,页面右下角会出现一个悬浮按钮。 - 登录后点击该按钮,脚本会自动刷新一次页面,读取 cookie 中的
cs-course-select-student-token作为 token,并尝试在页面文本/存储里匹配 6 位数字作为学生 ID。 - 页面刷新完成后,浏览器会自动下载
credentials.json,直接放到项目根目录即可使用。
若未能匹配到学生 ID,可等待选课平台开放后再点击一次按钮,或自行从页面/接口响应中寻找 6 位学号填入。
轮次 ID 会随着选课窗口时间变动而改变(每个学期的不同选课阶段使用不同的轮次),需要从选课页面获取:
方式一(推荐):从选课页面自动获取
- 进入选课页面:
https://jw.ahu.edu.cn/course-selection/#/course-select/{学号}/turn/{轮次ID}/select- 需要在同一浏览器中登录教务系统
- 进入页面后,点击右下角的"导出选课凭据"按钮(同获取token时的按钮)
- 脚本会从URL中自动提取
turn_id并保存到credentials.json
方式二:手动指定
- 编辑
credentials.json手动添加turn_id字段 - 或在程序运行时根据提示手动输入轮次 ID
{
"token": "your_token_here",
"student_id": "114514",
"turn_id": "114"
}- 访问项目地址:https://github.com/MuxYang/AhuCourseSelectCLI
- 点击绿色的
Code按钮 - 选择
Download ZIP - 下载完成后解压到本地目录
如果你已经安装了 Git,可以使用以下命令克隆项目:
git clone https://github.com/MuxYang/AhuCourseSelectCLI.git
cd AhuCourseSelectCLI方式 A:双击/命令行运行 run.cmd(自动使用 pwsh 或 powershell,并使用 ExecutionPolicy Bypass)。
方式 B:手动 PowerShell(使用PowerShell Core): 您可以在 https://github.com/PowerShell/PowerShell/releases 下载最新版的PowerShell Core。
cd AhuCourseSelectCLI
pwsh ./run.ps1- 检测本机
python,若不存在则从清华镜像选择最新可用版本(按架构优先 amd64)静默安装。 - 当需要安装 Python 时,脚本会自动请求管理员权限(为所有用户安装需要管理员权限)。
- 自动写入
%APPDATA%\pip\pip.ini,使用清华镜像源。 - 通过
python -m pip安装requirements.txt中的依赖。 - 使用检测/安装到的 Python 启动
course_selector.py。
requirements.txt:
- requests
- ntplib
- 需要联网访问
https://mirrors.tuna.tsinghua.edu.cn/python/以及https://pypi.tuna.tsinghua.edu.cn/simple。 - 脚本使用静默安装参数
/quiet InstallAllUsers=1 PrependPath=1 Include_pip=1 Include_test=0。 - 若已有 Python,脚本不会重新安装,会直接复用现有版本。