如何高效使用zfnew：新版正方教务系统API实用指南

在数字化校园管理日益普及的今天，zfnew作为新版正方教务系统的高效API工具，为学生提供了便捷的课表查询、成绩追踪和学校通知获取等核心功能，有效解决了传统教务系统操作繁琐的问题，让校园生活管理更加轻松高效。

核心功能详解

已实现功能亮点

• 智能登录与状态管理：自动处理登录流程并维护Cookies状态，避免重复输入账号密码的麻烦
• 个人信息快速获取：通过简洁接口获取姓名、学号、院系等基本信息，数据以JSON格式返回
• 课程表查询与导出：支持按周筛选课程安排，方便学生规划学习时间
• 成绩实时查询：及时获取最新考试成绩，无需手动刷新页面
• 校园通知聚合：集中展示学校公告、调课通知等重要信息
• 考试信息提前掌握：查询考试时间、地点和科目安排，做好充分准备

即将推出的增强功能

• 智能抢课系统：自动监控课程名额变化，实现一键抢课
• 课程评价自动化：批量完成课程评价，节省时间精力

快速部署流程

安装步骤

通过pip命令即可完成安装，无需复杂配置：

pip install zfnew

源码获取方式

如需获取项目源码进行二次开发或本地运行：

git clone https://gitcode.com/gh_mirrors/zf/zfnew

基础使用教程

初始化与登录

from zfnew import *

# 替换为学校教务系统URL
base_url = '学校教务系统的主页url'
lgn = Login(base_url=base_url)
lgn.login('账号', '密码')  # 输入账号密码
cookies = lgn.cookies  # 获取登录状态

功能调用示例

• 查询个人信息：

person = GetInfo(base_url=base_url, cookies=cookies)
print(person.get_pinfo())  # 输出个人信息JSON

• 更多功能示例：
  • 课表查询：examples/get_schedule.py
  • 成绩查询：examples/get_grade.py
  • 考试信息：examples/get_exam.py

图：正方教务系统主页面展示，支持跨设备浏览和自适应屏幕宽度（alt: 正方教务系统 教学管理平台 课表查询）

项目架构解析

核心模块介绍

• 登录模块：login.py — 处理登录逻辑与Cookies管理
• 信息查询模块：get_info.py — 实现各类信息查询功能
• 配置模块：config.py — 存储系统配置参数

目录结构说明

• zfnew/：核心功能代码目录
• examples/：各类功能调用示例代码
• doc/：项目文档和资源文件

使用注意事项

• 确保使用正确的学校教务系统URL（通常以.edu.cn结尾）
• 账号密码仅在本地使用，不会上传至服务器，保障信息安全
• 抢课等高级功能将在后续版本中推出，敬请期待

通过zfnew，学生可以轻松实现教务系统的各项操作，告别繁琐的手动操作，让校园生活更加高效便捷。无论是日常查询还是特殊时期的选课操作，zfnew都能成为你的得力助手。