面向高校教学场景的 Android 质感课表应用，深度整合 HyperOS 焦点通知与实时活动系统。
官方站点 · 界面展示 · 使用文档 · 下载安装 · 版本发布 · 教务适配
轻屿课表以「非侵入式日程感知」为核心设计理念，将教学周历、分阶段动态提醒、通知栏常驻、桌面小组件与系统级灵动胶囊紧密协同。无需频繁开启应用，即可在锁屏、状态栏与桌面上即时获取准确的课程进程。
详细界面演示与设计规范请参阅 官方站点。
- HyperOS 超级岛联动：深度接入小米 HyperOS 焦点通知系统，支持灵动胶囊毫秒级调度与大卡片展开，展开行内容支持自定义显隐与排序。
- 分阶段智能调度：支持上课前、课中进行、临近下课多阶段动态流转与差异化视觉反馈。
- 桌面小组件矩阵：提供今日课程、多规格课程概览（2×2 / 2×4）等小组件，与原生数据快照实时同步。
- 系统闹钟批量编排：基于真实节次作息，通过系统时钟服务一键编排并批量注册早八上课闹钟。
- 多层次玻璃拟态：内置实体卡片、高斯磨砂、柔光玻璃与基于 Impeller Fragment Shader 自研的液态玻璃材质。
- 界面结构自适应：支持经典布局与液态玻璃底部导航（玻璃坞）双重形态自由切换。
- 壁纸系统独立布局：支持自定义壁纸位置拖拽微调与历史壁纸缓存管理，切换课表不破坏当前视觉方案。
- 多语言环境支持：原生支持简体中文、繁体中文（台湾 / 香港）、英语、日语、韩语。
- 多课表独立隔离：多套课表数据沙箱隔离与毫秒级即时切换，提醒系统与桌面部件实时跟随。
- 双人情侣课表协同：支持课表交叉合并比对，智能识别同名同时段课程并聚合呈现，支持桌面组件透出。
- 无网面对面传输：集成多帧喷泉码（Fountain Codes）二维码传输协议，无网络环境下实现完整课表秒级互传。
- 通用格式导入与导出：支持标准
.ics日历格式互转与全量数据加密备份迁移。
- 全周期学业分析：提供周视图与学期视图双维度学时分布与走势分析。
- 课程密度热力图：直观反映一周日程负荷峰值与空余时段分布。
- 多维结构统计：按授课教师、教学场地及多课表维度展开结构化汇总。
当前安装包主要针对 arm64-v8a 架构进行编译优化，最低兼容 Android 8.0（API Level 26）。
| 发布渠道 | 渠道类型 | 说明 |
|---|---|---|
| 蒲公英下载 | 国内快速下载通道 | 适合国内移动网络环境，支持手机直接扫码或高速直链免登录下载 |
| GitHub Releases | 官方全量发布渠道 | 正式版与预发布版首发渠道，含完整发布日志与校验文件 |
| GitCode 镜像 | 国内代码与发布镜像 | 国内代码托管镜像，同步提供安装包发布附件 |
提示：应用内已集成多更新源检测服务，用户可根据自身网络环境自由切换更新通道。
轻屿课表支持主流高校教务系统的网页鉴权导入。适配规则由独立生态仓库持续维护：
- 教务适配中心：Mutx163/qingyu_warehouse
- 标准格式兼容：尚未适配教务系统的高校，推荐使用标准
.ics日历文件导入或通过全量数据备份进行迁移。 - 共建规范：欢迎高校开发者参与教务解析脚本编写，具体接入协议与开发指南请参考教务仓库规范。
为确保 HyperOS 超级岛胶囊、实时通知与后台调度服务的稳定运行，建议在系统设置中为本应用授予以下权限：
- 通知与焦点通知权限：允许发送常驻通知及在 HyperOS 状态栏展示灵动胶囊；
- 后台无限制与自启动：防止系统电源优化机制在锁屏或息屏状态下中断节次轮询调度；
- 免打扰访问权限（可选）：若启用了上课前自动静音或免打扰自动化策略，需授予此权限。
相关配置指引亦可在应用内「设置 - 维护与自检 - 后台保活」中查阅与验证。
| 运行环境 / 工具链 | 推荐版本 | 最低兼容版本 |
|---|---|---|
| Flutter SDK | 3.44.8 | 3.44.2 |
| Dart SDK | 3.12.2+ | >= 3.12.2 < 4.0.0 |
| JDK | 17 | 17 |
| Android SDK | API 36 (compileSdk / targetSdk) | API 26 (minSdk) |
| Android NDK | 28.2.13676358 | 28.x |
| Gradle | 8.14 | 8.10+ |
| AGP | 8.11.1 | 8.10+ |
# 获取项目依赖
flutter pub get
# 启动开发环境调试（使用 dev flavor）
flutter run -d android --flavor dev# 执行单元测试与架构守卫测试
flutter test
# 执行静态代码分析
flutter analyze --no-fatal-infos# 构建正式版 release APK (arm64-v8a)
flutter build apk --release --flavor prod --target-platform android-arm64| 命名标识 | 作用域与类型 | 规范说明 |
|---|---|---|
mikcb |
GitHub 仓库命名 | 项目主代码仓库标识 |
university_timetable |
Dart Package Name | 项目基础业务包名（pubspec.yaml 标识符） |
com.mutx163.qingyu |
Android Application ID | Android 原生包名及应用系统唯一标识 |
| 轻屿课表 | 产品可见名称 | 面向终端用户的正式产品名称 |
- UI 框架：Flutter (Material 3 + flutter_miuix HyperOS 风格组件套件)
- 状态管理：Provider
- 图形渲染：自研 Liquid Glass Fragment Shader（运行于 Impeller 渲染后端）
- 系统底层集成：Android Notification / Ongoing Promoted Activity / Foreground Service / AlarmClock
- 数据离线传输：
fountain_codes+mobile_scanner - 工程集成与监控：GitHub Actions CI/CD · 友盟移动统计 (U-APM)
- 贡献指南 (CONTRIBUTING.md)
- 行为准则 (CODE_OF_CONDUCT.md)
- 安全策略 (SECURITY.md)
- 隐私合规声明 (docs/PRIVACY.md)
- 第三方开源许可 (docs/THIRD_PARTY_LICENSES.md)
- 发布流程规范 (docs/RELEASE.md)
- 国际化协作规范 (docs/WEB_AND_L10N_WORKFLOW.md)
感谢所有为轻屿课表生态贡献力量的开发者与高校志愿者：
教务解析脚本依托于 qingyu_warehouse，持续同步自上游开源项目 shiguang_warehouse。特向所有参与高校教务解析规则适配的贡献者致以崇高敬意：
以下开发者直接向教务适配仓库提交过代码，谨此致谢：
(教务适配贡献者名单由自动化构建任务定期同步生成)
本项目源码采用 GNU General Public License v3.0 (GPL-3.0-or-later) 协议授权。
随应用集成的第三方 SDK 及依赖库许可证清单请参阅 docs/THIRD_PARTY_LICENSES.md。