🚄 交大自由行 (BJTU Self Service)

北京交通大学校园服务 Android 客户端 —— 让校园生活触手可及

📖 项目简介

交大自由行 是一款专为北京交通大学师生打造的校园服务应用。通过自动登录 MIS 系统，将成绩查询、课程表、考试安排、作业管理、邮件查看等常用校园功能整合到一个简洁直观的界面中。

所有数据解析（包括验证码识别）均在本地完成，无需上传至第三方服务器，充分保障用户隐私安全。

✨ 功能特性

🔐 智能登录

• 免验证码自动登录 MIS 系统
• 本地 PyTorch 模型验证码识别，无需服务器参与
• 登录状态持久化，打开即用

📚 学业管理

• 成绩查询 — 按学年筛选、排序，查看成绩详情，自动计算 GPA/均分
• 课程表 — 直观的课程表预览界面，支持本科生与研究生
• 考试日程 — 考试安排一览，变动自动提醒
• 作业管理 — 查看、筛选、排序作业，支持作业上传与下载

📬 信息服务

• 校内邮箱 — 免登录查看邮箱邮件
• 校园卡余额 — 实时查看一卡通余额
• 校园网余额 — 网络使用情况一目了然

📅 日历与提醒

• 日历视图整合作业截止日期与考试时间
• 邮箱订阅功能，自动抓取智慧课程平台作业/课程报告/实验
• 剩余时间不足阈值时自动发送邮件提醒

🏫 校园工具

• 教室人数识别 — 实时查看教室人数侦测结果
• 校历下载 — 一键下载当前学年校历
• 成绩单下载 — 支持中英文成绩单快捷下载
• 应用内更新 — 启动时自动检测新版本

🏗️ 技术架构

┌─────────────────────────────────────────────┐
│                   UI 层                      │
│         Jetpack Compose + Material 3         │
│   (Screen / Component / Navigation)          │
├─────────────────────────────────────────────┤
│                 逻辑层                       │
│          ViewModel (MVVM)                    │
│          Dagger Hilt (DI)                    │
├─────────────────────────────────────────────┤
│                 数据层                       │
│    Repository → DAO → Room Database          │
│    OkHttp3 + Jsoup (网络请求与 HTML 解析)     │
│    DataStore Preferences (本地配置)           │
├─────────────────────────────────────────────┤
│                 AI 模块                      │
│    PyTorch Android (验证码本地识别)            │
└─────────────────────────────────────────────┘

主要依赖

类别	技术
UI 框架	Jetpack Compose + Material 3
依赖注入	Dagger Hilt
网络请求	OkHttp3
HTML 解析	Jsoup
本地数据库	Room
序列化	Kotlin Serialization / Gson / Moshi
AI 推理	PyTorch Android
日历组件	Kizitonwose Calendar
动画	Lottie

🚀 快速开始

环境要求

• Android Studio Hedgehog 或更高版本
• JDK 17
• Android SDK，compileSdk 34
• 设备/模拟器 Android 9.0 (API 28) 以上

构建步骤

# 1. 克隆仓库
git clone git@github.com:HFDLYS/BJTUselfService.git
cd BJTUselfService

# 2. 赋予 Gradle Wrapper 执行权限
chmod +x gradlew

# 3. 构建 Debug APK
export ANDROID_HOME=~/Android/Sdk
./gradlew assembleDebug

# 4. 安装到设备
adb install app/build/outputs/apk/debug/app-arm64-v8a-debug.apk

或者直接用 Android Studio 打开项目，点击 ▶ Run 即可。

CI/CD

项目配置了 GitHub Actions 自动化流程：

• Debug 构建 — 每次推送自动构建验证
• Release 发布 — 推送 v* 标签时自动构建、签名并发布 APK 到 GitHub Releases

📱 支持架构

当前仅打包 arm64-v8a 架构，适配绝大多数现代 Android 设备。

🔒 隐私与安全

• ✅ 验证码通过本地 PyTorch 模型识别，不上传任何数据到第三方服务器
• ✅ 账号密码仅存储在本地设备
• ✅ 教室人数侦测是唯一需要与服务器通信的功能

🤝 贡献者

感谢以下所有为本项目做出贡献的朋友们：

• optsimauth:
  • 重构了整个项目的架构，优化了代码结构
  • 以及后续若干跟进
• guh0613
  • 提供自动构建与发布
• carolyn-sun
  • 优化了工作流配置
• NAPHthalene130
  • 修复若干 bug
• B-Silva20
  • 提供了成绩自选课程计算
• wangxiaobo1747
  • 提供了自定义壁纸和桌面课程表小组件