ChoChoX
059e1de984
通过 browser-act 浏览器会话直接调用教务系统 API， 支持命令行和图形界面操作选课/退课，自适应不同选课轮次。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
101 lines
2.7 KiB
Markdown
101 lines
2.7 KiB
Markdown
# 🎓 莞工教务选课系统 CLI + GUI
|
||
|
||
通过命令行或图形界面直接操作莞工教务系统选课，无需打开浏览器手动操作。
|
||
|
||
## 原理
|
||
|
||
利用已有的 `browser-act` 浏览器会话，通过 JavaScript `fetch()` 在浏览器上下文中直接调用教务系统的 API，自动携带登录态，不需要额外认证。
|
||
|
||
## 功能
|
||
|
||
- ✅ 查看可选课轮次
|
||
- ✅ 动态探测选课中心开放了哪些标签页（选修/必修/公选/跨专业等）
|
||
- ✅ 列出课程列表（编号、名称、学分、容量、已选状态）
|
||
- ✅ 一键选课
|
||
- ✅ 一键退课
|
||
- ✅ 搜索课程（支持名称和编号）
|
||
- ✅ 图形界面（CustomTkinter）
|
||
- ✅ 自适应不同选课轮次，未来新增轮次无需改代码
|
||
|
||
## 文件结构
|
||
|
||
```
|
||
├── dgut.py # CLI 入口
|
||
├── dgut-gui.sh # GUI 快捷启动
|
||
└── dgut-gui/
|
||
├── dgut_core.py # 核心 API 模块 (CLI 和 GUI 共用)
|
||
├── dgut_gui.py # CustomTkinter 图形界面
|
||
├── start.sh # GUI 启动脚本
|
||
└── venv/ # Python 虚拟环境 (含 customtkinter)
|
||
```
|
||
|
||
## 使用前提
|
||
|
||
1. 已安装 `browser-act` CLI 工具
|
||
2. 已通过 `browser-act` 打开浏览器并登录了莞工教务系统
|
||
3. 浏览器会话处于活跃状态
|
||
|
||
## CLI 使用
|
||
|
||
```bash
|
||
# 查看可选课轮次
|
||
python3 dgut.py list-cycles
|
||
|
||
# 探测选课中心开放了哪些标签页
|
||
python3 dgut.py list-tabs
|
||
|
||
# 列出课程（默认加载第1个有数据的标签）
|
||
python3 dgut.py list-courses
|
||
|
||
# 加载指定标签的课程
|
||
python3 dgut.py list-courses 2
|
||
|
||
# 按课程编号选课
|
||
python3 dgut.py select 0410578
|
||
|
||
# 按课程名称选课
|
||
python3 dgut.py select "微信小程序"
|
||
|
||
# 退课
|
||
python3 dgut.py drop 0410531
|
||
|
||
# 搜索课程
|
||
python3 dgut.py search 鸿蒙
|
||
```
|
||
|
||
## GUI 使用
|
||
|
||
```bash
|
||
./dgut-gui.sh
|
||
# 或
|
||
./dgut-gui/start.sh
|
||
```
|
||
|
||
GUI 界面提供：
|
||
- 课程类型下拉切换（自动探测所有可用标签页）
|
||
- 实时搜索过滤
|
||
- 一键选课/退课按钮
|
||
- 操作日志显示
|
||
- 已选学分/门数统计
|
||
|
||
## 依赖
|
||
|
||
- Python 3.x
|
||
- [browser-act-cli](https://github.com/your-org/browser-act) — 浏览器自动化
|
||
- customtkinter — GUI 界面（已安装在虚拟环境中）
|
||
|
||
## 工作方式
|
||
|
||
```
|
||
你的操作 → dgut.py/dgut_gui.py → 构造 fetch() JavaScript
|
||
→ browser-act eval → 在浏览器中执行 fetch()
|
||
→ 教务系统 API → 返回 JSON 数据
|
||
→ 解析并展示结果
|
||
```
|
||
|
||
所有 API 请求的认证由浏览器会话的 Cookie 自动处理，应用本身不存储任何凭证。
|
||
|
||
## API 参考
|
||
|
||
详细 API 信息参见 [记忆文档](https://github.com/your-org/dgut-course-cli/wiki)。
|