翱翔助手 v2.4.0

翱翔助手 v2.4.0

更新内容

• 修复校车预约更新时“未找到该用户”导致数据无法刷新的问题。
• 完善校车班次、余位读取及后台自动更新和发车提醒链路。
• 课表课程色块统一调整为约 50% 不透明度，课程详情保持纯白文字，提升可读性。
• 补充校车数据解析、同步和提醒相关回归测试。

本版本可直接覆盖 v2.3.1 安装，已有账号、课表、成绩、电费和设置数据会保留。

翱翔助手 v2.3.1

翱翔助手 v2.3.1

问题修复

• 修复手动更新成绩、课表或电费时，更新界面空白区域的点击会穿透到底层页面，意外打开课程详情或触发导航的问题。
• 修复教务接口未提供校区时，课程地点可能显示 null 或 undefined 的问题。
• 已保存的旧课表如果包含无效校区字段，会在读取时自动清理，无需重新导入课表。

支持开发

• 关于页新增微信赞赏码。
• 升级后首页会显示一次支持开发公告，之后不会重复弹出。
• 赞赏完全自愿，不赞赏也可以继续完整使用全部功能。

本版本可以直接覆盖 v2.3.0 安装，已有账号、课表、成绩、电费和设置数据都会保留。

翱翔助手 v2.3.0

翱翔助手 v2.3.0

全新界面

• 首页、课表、成绩、管理和设置页面采用统一的轻量玻璃风格，重新调整信息层级、图标、圆角和间距。
• 移除按钮和卡片上生硬的系统阴影，浅色与深色模式均使用更克制的边界和层次。
• 首页增加外观快捷切换；成绩、电费更新按钮采用不同图标和配色；今日课程显示时间、地点与教师。
• 管理页改为紧凑列表，移除课程和学期的新增、编辑、删除入口。

成绩与课表

• 成绩页突出显示总 GPA 和每门课程绩点，分数作为辅助信息展示。
• 课表页采用“本周 / 全部课程 / 月历”分段选择器，并统一学期选择、周次导航和手动更新按钮。
• 连续 2 节、3 节及更多节次保持为一个完整课程块；接口将连续课程拆成相邻记录时也会自动合并。
• 修复全角周次分隔符及复杂单双周格式解析；同一天同一课程有多段时间时，首页会显示全部课程。
• 成绩接口部分学期暂时失败时不再覆盖完整本地数据，并使用延迟重试，避免持续重复采集。

稳定性

• 改进统一认证跨域 Cookie 和登录凭据持久化，降低登录成功后同步再次失效的概率。
• 优化成绩与课表更新通知的差异识别。
• 修复深色课表小组件背景及部分桌面启动器的小组件初始化兼容问题。

本版本可以直接覆盖 v2.2.2 安装，已有账号和本地数据会保留。

翱翔助手 v2.2.2

翱翔助手 v2.2.2

小组件修复

• 课表周视图新增“全部课程”模式，可查看当前学期所有周次的课程；同一时间的多门课程会拆分为独立课程块并可分别查看详情。
• 修复 4~6(双),7~9(单)周 等混合单双周表达式的解析，分别应用每段周次的单双周规则。
• 优化课表课程块和桌面小组件的长课程名换行，地点支持多行显示。
• 修复今天没有课程、明天有多门课程时，双日课表小组件左侧出现多余空色块的问题。
• 今天或明天无课时只显示一次对应提示，后续空白行保持透明。
• 修复小尺寸课表小组件无课状态产生额外空白行的问题。

本版本可以直接覆盖 v2.2.1 安装，已有账号和本地数据会保留。

翱翔助手 v2.2.1

翱翔助手 v2.2.1

文档与说明

• 新增西工大教务学生端 API 清单，覆盖实际验证的业务接口、页面路由和源码候选接口。
• API 清单同时提供 Markdown 和 PDF 版本，补充认证方式、参数边界和安全说明。
• 课表功能致谢说明统一为参考 soaring-schedule-remake。

显示调整

• 首页、设置、通知和桌面小组件中的剩余电费单位统一显示为“度”。

翱翔助手 v2.2.0

翱翔助手 v2.2.0

结构化数据采集

• 成绩、GPA 和课表更新优先使用教务系统同源结构化接口，手动更新、登录后同步和后台自动更新使用同一套解析流程。
• 成绩请求增加 12 秒超时并按每批 4 个学期并发读取；个别学期失败不再拖住整个同步，全部失败时会自动重试。
• 修复成绩构成显示 HTML 源码的问题；同名重修课程继续只保留最高成绩，GPA 从学生画像接口读取。
• 课表准确读取完整地点、多名教师和不连续周次，并按学期起止日期及最后一门课选择当前学期；有效空课表也会保存。

后台更新

• 后台采集使用私有虚拟显示维持不可见 WebView，成功后才记录本次更新时间，失败不会伪装成完成。
• 已在 vivo 真机验证：从最近任务划掉应用后，系统可以按时重新启动同步、恢复被清空的课表、关闭进行中通知并发送课程变化通知。
• vivo/iQOO 的后台权限设置新增“后台耗电”入口。请在系统页面为翱翔助手选择“允许后台耗电”，否则 OriginOS 可能冻结同步进程。

开发文档

• 新增 docs/API.md，记录教务和一卡通数据路径、请求参数、关键响应字段、采集状态协议、失败回退及敏感信息边界。

翱翔助手 v2.1.3

翱翔助手 v2.1.3

自动更新刷新

• 后台更新成绩、课表或电费后，已经打开的应用会立即重载数据并刷新首页及对应页面。
• 从后台返回应用或点击更新通知进入时，会补查更新版本，避免出现“通知有变化但页面仍为空或显示旧数据”。
• 页面刷新沿用原位替换方式，不会先清空当前页面。

变化通知

• 本地成绩或课表被清空后重新同步时，恢复的数据会按全部新增内容生成通知。
• 成绩和课表均会列出发生变化的课程；课程较多时显示总数。

小组件预览

• 为 GPA 1×1、剩余电费 1×1、GPA 与电费 2×1/4×1、首页数据概览 2×2/4×1 补充系统选择器预览图。
• 预览包含示例数据和尺寸标注，并兼容使用 previewImage 的旧桌面启动器。

翱翔助手 v2.1.2

翱翔助手 v2.1.2

桌面小组件

• 新增 GPA、剩余电费、GPA 与电费组合、首页数据概览小组件，支持 1×1、2×1、4×1 和 2×2 尺寸。
• 首页数据概览宽版调整为 4×1，保留 GPA、加权成绩、课程数和剩余电费四项数据。
• 修正 1×1 剩余电费组件数值偏右的问题。
• 手动或后台更新成绩、电费后，小组件会立即同步刷新；退出登录后会清空对应数据。

友谊校区作息

• 课程地点包含“友谊”即可自动识别为友谊校区。
• 5月1日-9月30日 使用友谊校区夏季作息，10月1日-4月30日 使用冬季作息。
• 首页今日课程、周课表课程块和桌面课表小组件会显示对应校区的准确时间。
• 当周全部课程都在友谊校区时，周课表左侧时间同步切换；混合校区时保留长安时间轴，各课程仍显示自身时间。

翱翔助手 v2.1.1

翱翔助手 v2.1.1

登录与采集

• 除主动退出或切换账号外不再清除认证 Cookie，登录和采集成功后立即持久化会话，避免后续更新重复触发短信风控。
• 成绩、课表或电费采集遇到登录失效、短信验证码或安全验证时，会切换到可见的统一认证页面。
• 人工认证通过后保留同一会话，自动继续原采集任务，并遵循该采集项原有的网页显示设置。
• 补充当前地址、页面完成及历史跳转的多重认证状态检测，兼容部分手机 WebView 遗漏重定向回调的情况。

后台权限

• 移除无效的“检查并授权”按钮，各项权限改为使用独立设置入口。
• 从系统设置返回后立即原位刷新可检测的权限状态。
• 厂商自启动权限因 Android 不提供统一检测接口，状态明确显示为“无法检测，请自行确认”。

翱翔助手 v2.1.0

翎翔助手 v2.1.0

课表同步

• 课表同步优先读取教务系统结构化数据，并兼容不同账户的页面加载时机和模板差异。
• 自动识别全部学期及网页中的学期起始日期，按当前日期选择正确课表。
• 学期结束时间根据最后一门课计算，且至少保留两周；只有超出结束日期才会切换到下一学期。
• 手动更新课表时不再因页面文字误判而跳回教务首页。

登录与采集

• 放宽统一身份认证成功判定：进入 uis.nwpu.edu.cn 后跳出该站点即视为认证通过，同时支持任意有效的教务学生页面。
• 隐藏的密码框不再被误判为登录页，只有明确的账号或密码错误才计入登录失败。
• 设置页新增“手动更新”二级页，可分别选择电费、成绩和课表采集时是否显示网页；后台自动更新始终隐藏网页。

后台更新

• 新增通知、精确定时、电池优化豁免及厂商自启动/后台运行权限检查。
• 使用系统精确闹钟在下次同步时唤醒应用，应用退到后台或进程退出后仍保留更新计划。
• 权限检查结果改为原位刷新，解决“检查并授权”和返回设置页时的闪烁。

其他修复

• 修复检查更新时 GitCode 空发布描述显示为 null 的问题。