AutoNet4AHU - 安徽大学校园网自动登录工具

这是一个用于安徽大学校园网自动登录的工具，可以在网络连接时自动进行校园网认证，避免手动登录的麻烦。

Author: Biubush from AHU

目录

• 项目特点
• 系统要求
• 软件截图
  • 主界面
  • 企业微信通知
• 项目结构
  • 登录核心模块
  • 图形用户界面
• 技术栈
• 使用方法
  • 直接使用已编译程序
  • 仅使用核心模块
• 配置文件说明
• 企业微信通知配置
• 安装与编译
  • 准备工作
  • 下载项目代码
  • 编译登录核心模块
  • 编译UI模块
  • 编译结果
  • 注意事项
• 计划任务工作原理
• 常见问题
• 注意事项
• 贡献指南
• 许可证

项目特点

• 自动创建Windows计划任务，实现网络连接时自动登录
• 图形界面客户端，全程自动化，零学习成本
• 用户数据本地私有化，数据安全
• 自动检测校园网连接并进行登录认证
• 支持企业微信webhook通知功能，可以接收登录状态通知
• 轻量级核心模块，可单独使用
• 使用PySide6和Fluent设计风格，提供现代化UI体验

系统要求

• Windows 10/11 操作系统
• Python 3.8 或更高版本（如使用源码）
• 已连接到安徽大学校园网Wi-Fi或有线网络环境

软件截图

主界面

主程序界面，用于配置学号、密码和企业微信webhook

企业微信通知

企业微信接收到的登录通知

项目结构

项目主要分为两个主要模块：

1. 登录核心模块 (loginCore)

核心功能实现，包括：

• main.py - 主程序入口，处理配置加载和登录流程
• portal.py - 实现校园网ePortal登录功能
• notify.py - 通知模块，实现企业微信webhook消息推送
• requirements.txt - 核心模块依赖列表
• build.bat - 核心模块编译脚本

2. 图形用户界面 (UI)

使用PySide6和Fluent设计风格的图形界面，提供友好的配置体验：

• ui.py - 图形界面实现，包含配置保存和Windows计划任务管理
• register_task.bat - 注册Windows计划任务的批处理脚本
• unregister_task.bat - 卸载Windows计划任务的批处理脚本
• task_template.xml - Windows计划任务模板
• ahu_eportal.vbs - 用于无窗口运行的VBS脚本
• requirements.txt - UI模块依赖列表
• build.bat - UI模块编译脚本
• icon.ico - 应用图标

技术栈

• 后端：Python，使用requests库进行HTTP请求
• 前端：PySide6 (Qt for Python)，使用PySide6-Fluent-Widgets提供现代化UI风格
• 自动化：Windows任务计划程序，实现无人值守自动登录
• 通知：企业微信webhook机器人API
• 编译工具：Nuitka，将Python代码编译为可执行文件

使用方法

直接使用已编译程序

1. 从发布页面下载最新版本的可执行文件
2. 解压后运行AutoNet4AHU.exe
3. 在界面中填入学号和密码
4. 可选：添加企业微信webhook地址（用于接收登录状态通知）
5. 点击"注册计划"按钮，将自动创建Windows计划任务
6. 完成设置后，每次连接网络时将自动尝试登录校园网

仅使用核心模块

如果不需要图形界面，可以直接使用核心模块：

1. 在loginCore目录下创建config.json文件，格式如下：

   {
       "student_id": "你的学号",
       "password": "你的密码",
       "webhook_urls": ["可选的企业微信webhook地址"]
   }

2. 运行python main.py即可登录校园网

配置文件说明

配置文件config.json包含以下字段：

• student_id: 学号
• password: 密码
• webhook_urls: 企业微信webhook URL列表，用于接收登录通知

配置文件示例：

{
    "student_id": "S25xxxxxxx",
    "password": "your_password",
    "webhook_urls": [
        "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx"
    ]
}

企业微信通知配置

要使用企业微信通知功能：

1. 在企业微信应用中创建一个群聊机器人
2. 复制机器人的Webhook URL
3. 将该URL填入程序配置中
4. 登录成功后，机器人将推送登录状态通知到群聊

详细说明请参考企业微信文档

安装与编译

完整的安装与编译步骤如下，使用虚拟环境进行隔离：

1. 准备工作

首先确保已安装Python 3.8或更高版本，并已安装pip包管理工具。

# 安装虚拟环境工具
pip install virtualenv
# 安装Nuitka编译工具
pip install nuitka

2. 下载项目代码

git clone https://github.com/biubush/AutoNet4AHU.git
cd AutoNet4AHU

3. 编译登录核心模块

使用虚拟环境隔离loginCore模块依赖：

# 创建loginCore的虚拟环境
python -m virtualenv loginCore_env

# 激活虚拟环境
# Windows:
loginCore_env\Scripts\activate
# Linux/Mac:
# source loginCore_env/bin/activate

# 安装核心模块依赖
cd loginCore
pip install -r requirements.txt

# 编译核心模块
build.bat
# 编译完成后会在UI目录下生成login.exe文件

# 返回项目根目录并退出虚拟环境
cd ..
deactivate

4. 编译UI模块

使用虚拟环境隔离UI模块依赖：

# 创建UI的虚拟环境
python -m virtualenv UI_env

# 激活虚拟环境
# Windows:
UI_env\Scripts\activate
# Linux/Mac:
# source UI_env/bin/activate

# 安装UI模块依赖
cd UI
pip install -r requirements.txt

# 编译UI模块
build.bat
# 编译完成后会在项目根目录下生成AutoNet4AHU文件夹和AutoNet4AHU.zip文件

# 返回项目根目录并退出虚拟环境
cd ..
deactivate

5. 编译结果

编译完成后，将在项目根目录下生成：

• AutoNet4AHU 文件夹：包含完整的可执行程序及所需文件
• AutoNet4AHU.zip：可直接分发的压缩包

编译过程中会自动：

1. 处理UTF-8编码，确保中文显示正常
2. 将登录核心模块(login.exe)复制到UI输出目录中
3. 复制计划任务相关文件到输出目录
4. 编译完成后自动清理临时文件夹(dist)
5. 生成可分发的zip压缩包

注意事项

• 使用虚拟环境可以避免依赖冲突问题
• 必须先编译登录核心模块，再编译UI模块
• 编译过程需要联网下载依赖
• 首次编译可能需要较长时间，请耐心等待
• 如果编译过程中出错，请检查Python环境和依赖安装情况

计划任务工作原理

注册计划任务后，Windows将在以下情况下自动运行登录程序：

1. 系统启动时
2. 网络连接状态变化时
3. 每隔3分钟定时执行一次

这确保了在连接校园网后能自动执行登录认证，同时定时检查确保始终保持登录状态，无需手动操作。

常见问题

• 登录失败：请检查学号和密码是否正确
• 计划任务注册失败：尝试以管理员身份运行程序
• 通知未收到：检查webhook URL是否正确，网络是否正常

注意事项

• 本工具仅适用于安徽大学校园网环境
• 账号密码保存在本地配置文件中，请确保计算机安全
• 如遇校园网认证系统更新，可能需要更新本工具
• 建议自行理解项目代码及其逻辑架构后自行修改编译，使用预编译的程序造成的任何损失由用户自己负责

贡献指南

欢迎提交Issue和Pull Request帮助改进此项目。

许可证

该项目采用MIT许可证发布。