岱宗盒子：西交大学生安卓校园工具箱

项目简介

岱宗盒子（xjtu-toolbox-android）是一款面向西安交通大学学生的 Android 校园工具箱，使用 Kotlin 与 Jetpack Compose 原生开发，最小支持 Android 12（minSdk 31）。它把教务、图书馆、校园卡、思源学堂等学校服务集中到一个 App 中，不经过任何自建业务中转服务器——账号凭据与校园数据只在设备和学校系统之间流动。

唯一的例外是小游戏排行榜（仅上传游戏标识、分数、昵称与设备级匿名 ID，不含学号账号，不上榜则不上传），其服务端源码位于仓库 server/leaderboard/。

主要功能

模块	能力
界面	MIUIX 原生 UI、玻璃顶栏 / 底栏、整页转场与形变动画、全局深色模式；平板、折叠屏与横屏适配
账号	CAS 登录、MFA 验证码、多账号隔离、WebVPN 自动切换、登录诊断与请求限流
日程	多学期课表、调停补课、考试安排、教材信息、自定义日程、节假日、桌面小组件、导出
成绩与学籍	未评教成绩查询、GPA 计算、学籍档案
考勤	流水与统计，请假申请 / 审批 / 撤回 / 销假，课表考勤角标
教学空间	空闲教室查询、全校课程检索、教师信息
校园生活	校园卡、付款码、加餐券、体育场馆预订
图书馆	三校区座位查询、空位推荐、预约、换座、取消与签到
思源学堂	课程、活动、作业、评分、课件与附件查看下载；直播回放观看与下载
仲英学辅	资料检索、目录浏览与文件下载
校园信息	通知聚合与站内搜索、校园黄页、体测成绩、电子教材、校历
评教	GSTE 与常规评教
课余	合成仙交大、GPA 2048 等小游戏与棋类联机对弈、课表匹配交友
社区	基于仓库 GitHub Discussions 的原生论坛，支持分区浏览、发帖、楼层与楼中楼、@ 提及、点赞、采纳答案

多账号下，各账号的课表、成绩、对话与校园卡数据相互隔离。

屁岱（AI 助手）

应用内置可自定义名称的校园 AI 助手「屁岱」。配置任意兼容 OpenAI API 格式的模型服务后，可查询课程安排、成绩、空闲教室、校园卡、通知、思源学堂、体测、仲英学辅资料等信息，并以自然语言和数据卡片形式作答。

• 多会话、流式回复，工具结果以卡片展示
• 联网搜索与网页阅读，会注明出处
• 支持设闹钟、加日历
• 可记住偏好（存在本机，聊天时一并发给模型，可在设置中查看和删除）
• 外部链接唤起时只填进输入框，由用户决定是否发送

安装与使用

项目未在 README 中提供应用商店安装方式，可从 GitHub Releases 获取构建产物。自行编译需要 Android Studio 或 Android SDK（API 37）、JDK 21 与 Git：

git clone https://github.com/yeliqin666/xjtu-toolbox-android.git
cd xjtu-toolbox-android
./gradlew assembleDebug

Windows 下使用 gradlew.bat assembleDebug，产物位于 app/build/outputs/apk/debug/。Release 构建会启用代码压缩与资源收缩，签名可通过环境变量 KEYSTORE_PATH、STORE_PASSWORD、KEY_ALIAS、KEY_PASSWORD 提供。单元测试命令为 ./gradlew testDebugUnitTest。

技术栈为 Kotlin、Jetpack Compose、MIUIX、OkHttp、Jsoup、Gson、Room、KSP、Kotlin Coroutines，并采用 Kotlin Multiplatform 划分 :app、:core、:data 等模块。

注意事项

• 本项目仅供学习与个人信息管理使用，请遵守学校各系统的使用规则。
• 学校系统接口可能调整，功能可用性以实际情况为准；请勿高频请求或尝试绕过验证码、访问控制等安全机制。
• 屁岱的请求会把相关校园数据发送给你配置的模型服务，请使用可信服务商并妥善保管 API Key。
• API Key、账号凭据与下载的个人资料均应妥善保管；提 issue 时不要粘贴账号、密码、Cookie 或 API Key。
• AI 生成内容可能有误，重要信息请以学校官方渠道为准。
• 本项目为学生个人作品，非西安交通大学官方产品，与学校无隶属关系，采用 GPL-3.0 许可。

---

本作品整理自 GitHub 开源项目 yeliqin666/xjtu-toolbox-android，原作者 @yeliqin666，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。