SXU helper

welcome to SXU helper

image

关于本项目

github地址：https://github.com/xu-zih/sxujw_helper

本项目是python 程序设计实验课大作业，使用以下工具和第三方库

• flet
• School_SDK（new-school-sdk)
• pdm + uv + git
• dashscope

项目搭建环境

• 使用git + Github（远程托管）管理代码库
• 由pdm + uv（pdm的实验性加速组件）进行包管理

实现功能

• 基础功能：查询当前学期课表、查询上学期成绩
• 特色功能：接入了第三方API的学生手册助手

GUI

全新的跨平台UI框架：Flet（python上Flutter的实现）

一套代码，多个平台。

我们使用2种方式构建自定义UI组件

• 从现有组件继承，通过添加自定义函数和修改函数实现，实现新功能
• 构造build函数，通过build函数从自定义类中构造出一个组件

课表查询 + 成绩查询

爬取数据

初始实现：Selenium爬取

在尝试使用request库重写的同时，我们找到了正方教务系统的第三方API实现 new-school-sdk。

升级实现：引入new-school-sdk

• 基于request库的基础爬取
• 使用pytorch工具进行验证码自动识别

数据存储

我们对爬取的结果进行了解析。为课程、课程表等元素都构造了相应的对象，内部由List、Dict等结构存储数据。

学生手册助手 + 菜单界面

菜单界面

• 使用flet 组件，容器包裹侧边弹出式导航栏

  # 创建菜单按钮，用于打开导航抽屉
        menu_button = ft.IconButton(
            icon=ft.icons.MENU,
            icon_color="white",  # 设置图标颜色
            on_click=lambda e: (setattr(drawer, "open", True), page.update())  # 打开导航抽屉
        )
  row_content = ft.Row(
            controls=[menu_button, github_icon],
            alignment=ft.MainAxisAlignment.SPACE_BETWEEN,  # 水平分布元素，间隔平均
            spacing=10,  # 控件间距
        )
  menu_container = ft.Container(
            content=row_content,
            bgcolor=ft.colors.ON_SECONDARY_CONTAINER,  # 设置背景颜色
            padding=20,
            alignment=ft.alignment.center_left,
            # width=page.width,  # 使容器宽度与页面一致
            border_radius=ft.border_radius.only(bottom_left=10, bottom_right=10),   # 设置圆角
            height=80,  # 设置容器高度
        )

        # 创建主页面视图，并设置drawer
        main_view = ft.View(
            "/",
            controls=[
                menu_container,
                ft.Container(
                    content=ft.Text("欢迎使用 SXU helper!已实现功能如下：", size=30, weight=ft.FontWeight.BOLD),
                    padding=20,
                    alignment=ft.alignment.center,
                    width=page.width,
                ),
                features_row,
            ],
            drawer=drawer  # 在主页面视图中添加导航抽屉
        )

学生手册助手

• 使用阿里云百炼平台，创建智能体应用，将学生手册电子版作为AI知识库，让AI的回答基于此

  

  1731895666829

• 使用api调用

详情查看/src/gui/ai.py,本项目的api-key几日后注销

多端部署

支持任意系统

本地

git clone https://github.com/xu-zih/sxujw_helper.git
cd sxujw_helper
pdm install
pdm run /wrc/gui.py

Web

Flet App

其它（未测试）