david1465833828/TPSchedule
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

feat: deliver RSchedule service login exams and elastic glass navigation

Browse Source
This commit is contained in:
Codex
2026-10-13 17:06:50 +08:00
parent 9193fd8e43
commit 8f20a341c4
35 changed files with 1742 additions and 453 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+22 -14
View File
@@ -1,26 +1,36 @@
# Riverside Schedule
# RSchedule
电子科技大学研究生课表 APP，Flutter 实现，Android 0.2.1+3，Android 7.0 及以上。
电子科技大学研究生课表 APP，Flutter 实现，Android 0.3.0+4，Android 7.0 及以上。
课表周一至周日固定七列同屏，无横向滚动；课程条默认长度为125%，可在「我的 → 课表设置 → 课程条长度」调节为80%–200%，也可恢复默认；全表使用统一节次行高，同节数课程条等长。课程名最多两行，可省略，老师和教室完整换行。点击课程查看全称、老师、教室、节次、日期和上课周次。时间冲突用整列宽度的冲突列表展示，列表各项标注节次，避免窄列裁字。
三个图标标签页：课表、考试、个人设置。透明蓝色液态玻璃风格悬浮 Dock 支持点击图标或拖动选中滑块切换；按压放大、拖动拉伸、松手弹簧回弹。页面切换采用短距离移动与淡入淡出，并保留每页滚动位置。页面本身不支持左右滑动切换。课表和考试页面向下滚动隐藏 Dock，向上滚动恢复；个人设置页面保持显示。系统“减少动画”开启时减少切页与回弹动画。
底部只有日历和我的两个图标，透明液态玻璃风格悬浮 Dock，主题为蓝色，支持点击图标、拖动选中游标切换。页面本身不支持左右滑动切换。配色、课前提醒、手机日历和学期设置延续首版。
课表周一至周日固定七列同屏，无横向滚动。同节数课程条等长；课程名可省略，老师和教室完整换行，点击查看全部信息。课程条默认长度125%，在「个人设置 → 课表设置 → 课程条长度」调节80%–200%。课前提醒、手机日历及学期设置继续保留。
## 安装和导入
## 安装与学校登录
安装 `dist/Riverside-Schedule-debug.apk`。这是开发测试包；包名和原版签名保持一致，可覆盖安装并保留本地数据。
安装 `dist/RSchedule-debug.apk`，可覆盖旧版并保留本地课表与设置。内部 Dart 包名和 Android 包名保留不变以兼容升级。
在「我的 → 从文件导入」选择学校课表查询页保存的 `.html` / `.htm`，或版本1的课表 JSON。先检查预览，再确认导入。文件最多2MB，UTF-8编码。学校 HTML 中分散周次会合并为同一星期、节次、老师和教室的一条安排。
在个人设置中打开学校账户。应用先访问 [研究生系统专用认证入口](https://yjsjy.uestc.edu.cn/pyxx/jzsso/login)，学生在学校原网页填写账号、密码和验证码；应用没有自己的密码表单，不读取或注入密码。学校返回研究生系统后显示“正在查找课表，请稍候”，自动打开 [课表查询](https://yjsjy.uestc.edu.cn/pyxx/pygl/xskbcx/index/1)，识别完整表格后导入保存。
HTML 不含学期开始日，因此仍须在「我的 → 课表设置」填写实际开始日和学期周数。默认课前15分钟提醒，可选5/10/15/30/60分钟。启用通知和手机日历时按页面提示授权。
专用入口的原始302响应指向 HTTP 身份认证地址，携带研究生系统的 `service` 参数。应用将该身份认证地址转到 HTTPS 并完整保留参数。学校 HTTP 回调仅允许准确的研究生系统域名。读取或保存失败保留已有数据，可在学校认证页面重试。
学校入口连接 [研究生课表查询页面](https://yjsjy.uestc.edu.cn/pyxx/pygl/xskbcx/index/1)，提供自绘认证入口及学校官方 WebView。已根据提供的实际HTML实现解析，实时个人登录和验证码流程仍需在本人手机上验证。文件导入不会冒充学校登录。详见 [学校接入状态](docs/school-integration-status.md)。
真实账户认证及验证码仍需由本人操作验证；离线 HTML 与模拟回调测试不能代替真实账户联调。详见 [学校接入状态](docs/school-integration-status.md)。
JSON样例：[schedule.schema-v1.json](examples/schedule.schema-v1.json)。示例模式独立，不覆盖本人课表，也不创建通知或日历事件。
## 考试安排
考试页右上角可从学校更新，或导入学校考试查询页保存的 HTML。查询路径为 `/pyxx/pygl/kskcxx/index`，由用户提供的导出页面确认。考试数据独立保存，不覆盖课表，也不产生考试提醒。显示课程名称、考试时间、考场、座位号；有考核方式、考生编号或考场顺序号时一并显示。
提供的考试 HTML 含2026-2027秋学期8门课程，排考字段全部为空。当前显示“尚未安排”，不猜测考试时间和地点。未知或不完整表格拒绝导入；只有明确的无数据提示才接受空列表。原始附件与其中的学号、姓名不随源码或 APK 分发。
## 文件导入和设置
「个人设置 → 从文件导入」支持学校课表 `.html` / `.htm` 与版本1的 JSON，先预览再确认；考试文件从考试页导入。文件最多2MB，UTF-8编码；其中脚本不会执行。
HTML没有学期开始日，仍须在课表设置填写实际开始日和学期周数。默认课前15分钟提醒，可选5/10/15/30/60分钟。启用通知和手机日历时按提示授权。JSON样例：[schedule.schema-v1.json](examples/schedule.schema-v1.json)。示例课表不覆盖本人数据，不创建通知或日历事件。
## 开发
源码在 `mobile/`；内部 Dart 包名保留 `hepan_everyday`，Android包名保留 `com.example.hepan_everyday` 以兼容升级。本机工具位于 `.tools/`，不会提交进Git。
源码在 `mobile/`；工具在 `.tools/`，不提交到 Git。Android 包名保留 `com.example.hepan_everyday`。
```powershell
$env:HEPAN_TOOLCHAIN_ROOT='C:/Users/david/Desktop/app/.tools'
@@ -31,6 +41,4 @@ flutter test
flutter analyze
```
仓库根目录运行 `./scripts/build-android.ps1` 构建，成功后复制 APK 到 `dist/`。
验证记录：[0.2.1玻璃和长度设置](docs/blue-glass-and-course-length.md)、[0.2.0课表改版验证](docs/riverside-revision-validation.md)。Windows模拟器如遇图形驱动崩溃，可仅在测试启动时使用软件渲染并关闭Impeller；交付APK保留默认手机渲染配置。首版通知和日历原生验证保存在 [首版验证记录](docs/android-mvp-validation.md)。
仓库根目录运行 `./scripts/build-android.ps1` 构建。验证记录：[0.3.0登录、考试和动画](docs/rschedule-0.3-validation.md)。Windows模拟器可仅在测试启动时使用软件渲染并关闭Impeller；交付APK保留手机默认渲染配置。历史验证：[0.2.1](docs/blue-glass-and-course-length.md)、[0.2.0](docs/riverside-revision-validation.md)、[首版](docs/android-mvp-validation.md)。