高校教务系统（正方 jwglxt 等）是学生查询课表、成绩、考试安排的唯一官方入口，
但普遍存在四个现实问题：一是登录需 RSA 加密加密并对接 CSRF 令牌，页面为服务端
渲染的复杂表格，手机浏览器打开体验极差；二是课表的单双周、分段奇偶、调休与临时
停课信息只能靠学生自己推算，极易看错；三是成绩与绩点口径混乱，挂科课程常被错误
计入"已获得学分"，导致学生无法与学校数字对账；四是空教室只能逐节次手工查询，
效率极低。学生每周都要反复核对课表与空教室，却缺少一个能在手机上清晰查看、并可
一键导入系统日历的工具。本项目立项，即为解决高校学生在课表、成绩、考试、空教室
四类高频信息上的查询成本问题。
项目按"教务系统适配层 + 核心解析层 + 多端展示层"三层架构实现，包含六个功能模块。
一、多校适配模块：内置正方教务系统新版（jwglxt，RSA 加密登录）与老版（ASP.NET
视图状态）两套适配器及演示数据适配器；提供只读探测与字段名自动推断工具，接入一
所新学校只需编写一份 TOML 配置，无需改动业务代码。
二、课表模块：登录后抓取并解析校方返回的 HTML 表格，正确处理 rowspan 连堂、一格
多课、中文周次表达式（含单双周、分段奇偶、排除周），支持按周切换、今天与正在上
课高亮、一键生成课表图片。
三、学业信息模块：查询全部学期成绩并支持平均学分绩点，优先采用教务处官方口径、
自算值仅作兜底并在界面标注来源，拆分"已获得学分"与"未通过学分"以与学校数字对账；
考试安排展示考场、座位与倒计时。
四、空闲教室模块：支持按教室或楼栋查询全天空闲教室，并发查询 15 个节次约 3 秒
返回。
五、导出模块：支持 JSON、CSV、Excel、ICS 四种格式；日历按周展开，正确处理单双
周与停课，考试日程默认带提醒。
六、多端入口：零依赖单文件网页版、原生微信小程序、命令行三种入口；服务端同时提
供 FastAPI 版与纯标准库版且接口完全一致。另有部署自检与一键部署模块（Caddy +
systemd），以及不代存学生明文密码的会话安全设计。后端核心仅用 Python 标准库实
现 HTTP 会话、RSA 加密与 HTML 解析，可在离线内网环境直接运行。
项目按适配层、核心解析层、多端展示层三层实现。多校适配模块内置正方教务系统新版
与老版两套适配器，提供只读探测与字段名推断工具，接入新学校只需一份 TOML 配置。
课表模块抓取并解析校方 HTML 表格，正确处理连堂、一格多课、单双周与分段奇偶周次，
支持按周切换与当前课程高亮。学业信息模块查询全部学期成绩与平均学分绩点（优先教
务处官方口径），并展示考试考场与倒计时。另有空闲教室查询、JSON/CSV/Excel/ICS
四格式导出，以及网页版、微信小程序、命令行三种入口。
评论