轻屿课表

一个面向校园场景的 Android 课表应用。

🌐 官网：https://mutx.ccwu.cc · 下载最新版本

轻屿课表的重点不是单纯展示课程，而是把课表、提醒、通知、小组件和 HyperOS 超级岛串成一条完整链路。它关注的是“接下来要上什么课、现在这节课进行到哪、能不能不打开应用就知道状态”。

命名说明

名称	说明
仓库 mikcb	GitHub 仓库名
Dart 包 university_timetable	历史包名（pubspec），与仓库名不同
Android 包名 com.mutx163.qingyu	应用 ID
产品名「轻屿课表」	用户可见名称

项目定位

• 面向 Android 维护，重点适配小米 / HyperOS 设备
• 适合希望把课程提醒接进系统通知体验的学生用户
• 支持一人维护多套课表，适合不同学期、身份或课程方案并行管理
• 支持教务系统网页登录导入、.ics 导入、完整备份导出与恢复

核心能力

• 周视图课表，支持左右滑动切周和一键回本周
• 日课表视图，与周视图并列切换，聚焦当天安排
• 多课表独立保存、快速切换，通知与超级岛跟随当前课表
• 课程增删改查，支持课程简称、颜色、单双周、备注等信息
• 时间模板系统，可按学校作息自定义节次时间
• 上课前、课中、下课前提醒分阶段配置
• 上课闹钟：基于系统时钟应用，按真实课表批量添加（适合早八）
• HyperOS / 小米超级岛、通知栏、焦点通知联动
• 今日桌面小组件与课程快照同步，另有课程统计 2×2 / 2×4 小组件
• 应用形态可选：经典界面 / 玻璃坞（液态玻璃底部导航）
• 自定义壁纸与液态玻璃质感，课程卡片支持真折射玻璃样式
• 课程统计：学期/周双视图、趋势、热力图、教师与教室排行、成就与多课表对比
• 二维码面对面传输（喷泉码多帧，无需网络）
• 教务系统网页登录导入、.ics 导入与导出、完整备份导出、恢复为当前课表或新课表
• 界面支持简体中文、繁体中文（台湾 / 香港）、英文、日文、韩文
• 关于页读取 GitHub Releases，支持应用内更新检测

教务导入与适配

• 当前应用已经支持一部分学校的教务系统网页登录导入，适配脚本来自 qingyu_warehouse
• 如果你的学校暂时还没有适配，仍然可以先走 .ics 导入或完整备份迁移
• 教务适配仓库：https://github.com/Mutx163/qingyu_warehouse
• 如果你会网页调试、抓包、JavaScript 或愿意维护自己学校的教务系统，欢迎直接参与适配补充

为什么做这个

很多课表应用解决的是“录入课程”和“查看课程”，但真正高频的使用场景是：

• 还有多久上课
• 现在这节课上到哪了
• 下一节在哪
• 不打开应用能不能就看到

轻屿课表主要在解决这类问题，尤其把提醒链路做得更细，把系统通知体验和课表本身连起来。

下载与更新

• 发布页：https://github.com/Mutx163/mikcb/releases
• 正式包当前以 arm64-v8a 为主
• 应用内可读取 GitHub Releases，显示版本号、更新时间和下载入口
• 发行流程见 docs/RELEASE.md

运行、检查与构建

本仓库当前只保留 Android 发布和维护所需内容。

环境版本

版本真源：.fvmrc 与 GitHub Actions。当前稳定版为 Flutter 3.44.8，最低支持 Flutter 3.44.2 / Dart 3.12.2。

工具	版本
Flutter（当前稳定）	3.44.8
Flutter（最低支持）	3.44.2
Dart SDK	>=3.12.2 <4.0.0
JDK	17
Android SDK	compileSdk 36 / targetSdk 36 / minSdk 26
Android NDK	28.2.13676358
Gradle	8.14
Android Gradle Plugin	8.11.1
Kotlin	2.2.20

本地开发

flutter pub get
flutter run -d android --flavor dev

质量检查

flutter test
flutter analyze --no-fatal-infos

发布构建

flutter build apk --release --flavor prod --target-platform android-arm64

相关文档

• 贡献指南：CONTRIBUTING.md
• 行为准则：CODE_OF_CONDUCT.md
• 安全报告：SECURITY.md
• 隐私说明：docs/PRIVACY.md
• 第三方许可：docs/THIRD_PARTY_LICENSES.md
• 产品说明（存档）：docs/PRODUCT.md
• 发布流程：docs/RELEASE.md
• 网站与国际化协作约定：docs/WEB_AND_L10N_WORKFLOW.md
• 变更日志：GitHub Releases / docs/releases/

技术栈

• Flutter
• Provider
• SharedPreferences
• liquid_glass_widgets（液态玻璃界面）
• fl_chart（统计图表）
• flutter_miuix（HyperOS 风格组件）
• mobile_scanner / fountain_codes（二维码传输）
• Android Notification / Foreground Service / AlarmClock
• GitHub Actions
• GitHub Releases
• 友盟移动统计 / U-APM

使用建议

如果你主要使用超级岛或实时通知，建议在系统里同时打开这些能力：

• 通知权限
• 自启动
• 电池无限制
• 焦点通知 / promoted ongoing 权限

这些说明已经放进应用内的“使用引导与权限”页面。

当前状态

项目仍在持续迭代，目前重点放在：

• Android 端提醒链路稳定性（分阶段提醒与上课闹钟）
• 玻璃坞应用形态与液态玻璃视觉打磨
• 课程统计与桌面小组件能力扩展
• HyperOS / 超级岛显示细节
• 教务导入、传输、备份和更新体验完善

许可证

本仓库源码使用 GNU General Public License v3.0（SPDX: GPL-3.0-or-later）。

随应用分发的第三方 SDK 与资源许可见 docs/THIRD_PARTY_LICENSES.md。