Ahu_Plus

KO | EN

gitlite — search

#react #typescript #golang #machine-learning #rust #deep-learning #linux #nodejs #macos #windows #kubernetes #ios #openai #open-source

(★ 27)

安大加 —— 安徽大学校园助手 Android 应用 —— Kotlin + Jetpack Compose,集成 CAS SSO、教务、一卡通、学习通

Ahu_Plus 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Ahu_Plus

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://raw.githubusercontent.com/yoki-Clark/Ahu_Plus/main/LICENSE)
![Android](https://img.shields.io/badge/Android-7.0%2B-3DDC84?logo=android&logoColor=white)
![Kotlin](https://img.shields.io/badge/Kotlin-2.2.10-7F52FF?logo=kotlin&logoColor=white)
![Compose](https://img.shields.io/badge/Compose_BOM-2026.06.01-4285F4)

安徽大学校园助手 Android 应用。项目把学校门户、教务、一卡通、学习平台和若干公开数据源整合到一个 Jetpack Compose 客户端中。

本项目非安徽大学官方产品，与安徽大学无隶属关系。

## 当前能力

### 校园账号

- CAS 登录与静默续期
- 首页概览、校园卡余额、账单与消费分析
- 浴室余额、空调/照明电费、网费查询与充值
- 智慧安大支付码
- 课表、多学期切换、课表导出、课程备注和课程提醒
- 成绩、GPA、考试、培养方案、毕业完成度
- 空教室、教室课表、教学评价、考勤记录
- 学生信息、财务汇总
- 教务通知、校长信箱
- 教育邮箱：邮件列表、详情与已读管理
- 日程、系统日历同步、桌面课表 Widget

### 可选第三方服务

- 校园集市：多身份、列表/详情/评论/发帖、通知、搜索、内容导出、AI 评论
- 超星学习通：课程、章节、作业、消息、签到和后台学习服务
- WeLearn：课程树、学习进度、答题数据和后台学习服务
- 大机平台：直接校园网或 WebVPN 登录、练习/考试记录与试卷查看

第三方服务总开关及底栏入口由用户控制。首页、应用、我的固定显示；集市、学习通、WeLearn 是 3 个候选服务，其中最多固定 2 个，因此顶层最多同时显示 5 个入口。

### 公开数据

- Gitee：版本清单、开发者公告
- Open-Meteo：合肥蜀山区天气和空气质量

## 技术栈

| 项目 | 当前配置 |
|---|---|
| 语言 | Kotlin 2.2.10 |
| UI | Jetpack Compose + Material 3，Compose BOM 2026.06.01 |
| 构建 | Gradle 9.4.1、AGP 9.2.1、Daemon JVM 21 |
| Android | compileSdk/targetSdk 36，minSdk 24 |
| Java 字节码 | Java 11，启用 core library desugaring |
| 网络 | OkHttp 4.12、Conscrypt、Jsoup |
| 本地状态 | Preferences DataStore、EncryptedSharedPreferences、Gson |
| 图片/扫码 | Coil、SVG、ZXing、CameraX |
| Widget | AndroidX Glance |

项目是单 Activity、Navigation Compose、手动依赖注入架构。应用代码的 `namespace` 是 `com.ahu_plus`；为兼容已安装版本，对外 `applicationId` 仍是 `com.yourname.ahu_plus`。两者不要混用。

## 构建与测试

要求：JDK 21 可供 Gradle Daemon 使用，Android SDK 36 已安装。

```bash
./gradlew assembleDebug
./gradlew :app:testDebugUnitTest
```

Windows：

```powershell
.\gradlew.bat assembleDebug
.\gradlew.bat :app:testDebugUnitTest
```

ABI split 会生成：

- `app/build/outputs/apk/debug/app-arm64-v8a-debug.apk`
- `app/build/outputs/apk/debug/app-universal-debug.apk`

真机通常安装 arm64 包；模拟器或未知 ABI 使用 universal 包。

```bash
adb install -r app/build/outputs/apk/debug/app-arm64-v8a-debug.apk
```

构建版本由 `release/release-state.json` 单一维护。Release 签名按环境变量、Gradle
属性、未提交的 `local.properties` 顺序读取：

```properties
AHU_RELEASE_STORE_FILE=/absolute/path/to/release.jks
AHU_RELEASE_STORE_PASSWORD=...
AHU_RELEASE_KEY_ALIAS=...
AHU_RELEASE_KEY_PASSWORD=...
```

四项配置缺失、keystore 无法打开或证书指纹不在 allowlist 时，Release 构建会在
打包前失败；不会回退到 debug keystore。发布前在仓库根目录执行：

```bash
python tools/release/release.py check
python tools/release/release.py dry-run --channel beta
```

dry-run 的发布预览只写入 `build/release-dry-run/`，常规构建产物仍位于 `app/build/`；
它不会更新公开清单、提交 Git 或发布远端资产。
完整流程见 `tools/release/README.md`。

## 代码结构

```text
app/src/main/java/com/ahu_plus/
├── MainActivity.kt              # Activity、主题、更新/公告弹窗、深链入口
├── AhuPlusApplication.kt        # 手动 DI、全局初始化、仓库状态恢复
├── data/
│   ├── local/                   # DataStore、加密凭据、缓存与偏好
│   ├── model/                   # 业务模型
│   ├── network/                 # HTTP 客户端、DNS、会话重试、流量治理
│   ├── repository/              # 各系统认证与数据访问
│   ├── agenda/ calendar/        # 日程构建与系统日历同步
│   ├── announcement/ update/    # 公告和升级
│   ├── developer/               # 开发者中心与诊断
│   └── home/ weather/           # 应用注册表与天气聚合
├── notification/               # 课程/日程提醒、开机重排、Widget 调度
├── service/                    # 学习通与 WeLearn 前台服务
├── ui/
│   ├── navigation/             # login/main 两级 NavHost
│   ├── screen/                 # 业务界面与 ViewModel
│   ├── components/             # 公共 Compose 组件
│   ├── theme/                  # Material 3 设计 token
│   └── widget/                 # Glance 今日课表 Widget
└── util/                       # DES/AES、字体解析、支付签名、分享等
```

文件级索引见 [CODEMAP.md](CODEMAP.md)。

本地架构与主题文档在 `docs/`（Obsidian 知识库，不入库）；agent 检索入口为
`docs/agents/00-检索导航.md`，用户文档入口为 `docs/user/README.md`。

## 认证与网络

| 系统 | 主域名 | 认证/会话 |
|---|---|---|
| 校园门户/学生一张表 | `one.ahu.edu.cn` | CAS，`JSESSIONID` |
| 教务 Web | `jw.ahu.edu.cn` | CAS，`SESSION`/`PSTSID` |
| 教务移动端 | `jwapp.ahu.edu.cn` | 独立账号选择与 token |
| 一卡通 | `ycard.ahu.edu.cn` | CAS，JWT + Cookie |
| 智慧安大支付码 | `adwmh.ahu.edu.cn` | 独立登录，`JSESSIONID`，TLS 1.2 |
| 考勤 | `kqcard.ahu.edu.cn` | CAS，Cookie |
| 集市 | `api.zxs-bbs.cn` | 用户导入 Bearer JWT |
| 学习通 | `*.chaoxing.com` | 手机号/学号 + 密码，Cookie |
| WeLearn | `welearn.sflep.com`/`sso.sflep.com` | 独立账号，OIDC/Cookie |
| 大学计算机平台 | 内网地址或 `wvpn.ahu.edu.cn` | 独立账号、验证码、JWT/Cookie |

学校部分 HTTPS 端点使用客户端无法验证的证书，调用处必须通过 `TlsPolicy.LegacyCampusHosts` 精确列出域名；普通公网服务保持系统证书校验，`adwmh` 使用系统校验并限制 TLS 1.2。

## 本地数据

- 普通设置和业务缓存保存在 `ahu_plus_prefs` DataStore。
- 首次联网前需确认内置《隐私政策》和《免责声明与使用须知》；可在“我的 -> 关于”随时查看、撤回同意或清除全部本地数据。
- 账号、密码、会话、Bearer token 和 API key 保存在 Android Keystore 支持的 `EncryptedSharedPreferences`。
- 启动时会迁移旧版 DataStore 中的明文敏感键；加密存储不可用时，敏感值只保留在当前进程内，不回退明文持久化。
- 退出校园账号会清理校园账号数据、JWApp、学习通、WeLearn 和 CProg 账号会话；集市身份、普通设置和课程备注保留。“清除全部数据”路径会移除全部可清理凭据和缓存。

## 已知边界

- `CourseRepository.DEFAULT_SEMESTER_ID` 仍为 `112`，虽然 UI 支持拉取学期列表，但默认回退值需要随教务数据变化验证。
- 学习通的签到码、二维码和拍照签到仍有待真机抓包校准的分支，源码中保留了明确 TODO。
- 大学计算机平台的直接地址是校内明文 HTTP；自定义地址还受 Android 网络安全白名单约束。
- 课程/日程精确提醒受系统通知和精确闹钟权限影响；权限缺失时会降级，可能延迟。今日课表 Widget 使用 WorkManager 在数据变化、午夜和课程节点刷新，不申请精确闹钟。
- 自动学习、自动答题或自动签到可能违反对应平台规则，风险由使用者承担。

当前问题和修复进度以仓库 Issue 与现行源码为准；真机验收应以实际界面和网络结果为准。

## 安全与贡献

- 不要提交 `.env`、`local.properties`、keystore、token、Cookie、个人 API 响应或包含学生信息的抓包产物。
- 测试账号只通过 `AHU_TEST_USERNAME`、`AHU_TEST_PASSWORD` 等本地环境变量提供。
- 网络代码必须关闭响应体并在 IO 调度器执行。
- 修改认证、缓存、提醒或升级逻辑时必须补充对应单元测试。

安全漏洞请使用代码托管平台的私密漏洞报告能力，或发送邮件至 `2867299793@qq.com`；不要在公开 Issue 中附带凭据或个人数据。

## 许可

项目包含从 [Samueli924/chaoxing](https://github.com/Samueli924/chaoxing) 移植和演化的代码，以 [GPL-3.0](LICENSE) 发布。Fork 和重新分发必须遵守 GPL-3.0，并使用自己的签名与应用标识。

Ahu_Plus

Ahu_Plus 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Ahu_Plus

Ahu_Plus 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README