# 郑州财经学院青果教务系统工具

**Repository Path**: WWR650/ZZIFE_Kingo_tool

## Basic Information

- **Project Name**: 郑州财经学院青果教务系统工具
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-11-23
- **Last Updated**: 2025-12-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
    <h1>郑州财经学院青果教务工具</h1>
    <h2>ZZIFE_Kingo_tool</h2>
</div>

## ✨介绍

### 支持

- 通过统一认证平台登陆
- 账号管理
  - ✅支持本地存储多账号
  - ✅支持程序内添加账号、修改账号、删除账号
- 交互
  - ✅以终端界面进行交互
- 协议实现
  - ✅使用 [requests](https://github.com/psf/requests) 分别进行协议模拟，故无需浏览器
  - ~~✅基于 [ddddocr](https://github.com/sml2h3/ddddocr) 对验证码进行识别，准确率高，无需人力识别验证码，解放双眼（bushi）~~
- 课表
  - ✅使用post请求课表表单，速度可达毫秒级，省去亲自打开浏览器查询课表的麻烦
  - ✅可选择学期查询课表
  - ✅查询到的课表用浏览器展示，兼容性好，理论上任意电脑均可用
  - ✅课表本地存储，可自行手动打开（用浏览器打开kb.html文件即可）
  - ✅查询成绩
  - ✅查询培养计划
  - ✅生成报错log文件
  - ✅支持一键教评（默认A）

### 将实现

以下功能将逐步被添加

- ⭕查询考试安排表（目前官网还无法查询，所以爬不到接口）

## ❤️贡献

若发现程序存在任何 bug 或有好的想法，欢迎提交 Issue，提交 bug 反馈时需要带上报错信息截图（截全），并说明触发条件

[Issue](https://gitee.com/shengxiadeshengxia/zzife_booker_library/issues) 为本项目的唯一反馈渠道

## 🚀构建

### 💻本地化构建项目

使用 Python 版本 >= 3.11.x

clone 项目到本地，并使用venv

```bash
git clone git@gitee.com:shengxiadeshengxia/zzife_booker_library.git
cd ZZIFE_Kingo_tool
```

创建虚拟环境，进入虚拟环境，安装依赖包

```bash
python3 -m venv 环境名称
环境名称\Scripts\activate
pip install requirements.txt -r
```

运行主程序

```bash
python main.py
```

## 🆕更新

- 2025/12/13：
  - 修正readme构建内容

- 2025/12/7：
  - 支持从统一认证平台登陆
  - 修改加密模式（MD5 -> AES）
  - 修改部分logger
  - 添加cas登陆信息提取

---

- 2024/12/17：
  - 现已支持一键教评

---

- 2024/12/15：
  - 现已支持查询成绩、培养计划、生成log
  - 重构代码，代码可读性提升

---

## ⚠️注意

- 该项目用于郑州财经学院青果教务系统，而该教务系统开放于学校内网，需连接校园网使用
- 该项目理论上可拓展于别的使用青果教务系统的学校，只需改动部分代码即可
- 该项目params加密方法直接使用教务系统js文件，该文件为青果教务系统公模文件，理论可用于其他学校
- 使用本项目造成的任何后果与本人无关
- 该项目原理请，访问 [博客](https://wwr650.github.io/)