长文档建议按当前分组逐页阅读；右侧辅助栏会保留当前位置和快速操作。
快速开始
本页把首次使用 Mini-HBUT 的关键路径串起来：下载与安装、首次登录、首页仪表盘、底部主 Tab、搜索、设置中心、导出中心、云同步和离线缓存。 如果只想尽快用起来，按下面顺序走即可。
1. 下载与安装
安装包以 GitHub Releases 为主入口。不同平台的包类型和系统限制不同，但安装后的应用数据目录会保留登录状态、设置和可缓存数据；覆盖安装通常不会清空本地数据。
Windows
下载 Releases 页面中的 .msi 安装包，双击安装后从开始菜单或桌面启动。首次启动会初始化本地配置和数据库。遇到 SmartScreen 提示时，确认来源为项目发布页后选择继续运行。
macOS
下载对应芯片架构的 .dmg，将应用拖入 Applications。首次打开如遇“无法验证开发者”，到系统设置的隐私与安全性中允许打开。
Linux
优先使用 AppImage；Debian/Ubuntu 可使用 .deb 包。若启动时报 WebKit 运行时缺失，需要安装系统 WebKit2GTK 相关依赖。
Android
下载 Release APK 并允许“安装未知来源应用”。覆盖安装新版不会清空本地登录信息、缓存和设置。
iOS
当前需要侧载 IPA。安装后到“设置 -> 通用 -> VPN 与设备管理”信任开发者证书；证书到期前需要续签，过期后通常表现为打开即闪退。
2. 首次登录和会话状态
登录入口在“我的”页。应用内部以学号判断是否已登录；进入需要身份的模块时，如果尚未登录，会显示“请先在个人中心登录”的提示。 登录成功后会保存 Cookie 和登录方式，下次启动会尝试自动恢复会话；如果学校会话过期，应用会尝试重新登录，失败时再要求用户手动处理。
统一身份认证
使用湖工大学号和统一身份认证密码登录。应用会获取验证码页面，调用 OCR 识别验证码后提交登录；登录成功后保存 Cookie 和必要会话信息。
学习通
使用学习通账号密码或学习通二维码完成登录。登录后应用会尝试解析学号并关联教务系统，适合学习通状态稳定但门户登录不方便的场景。
扫码临时登录
使用门户或学习通客户端扫描应用内二维码完成授权。临时登录适合短时查询，但会话恢复能力弱于账号密码登录。
3. 从首页仪表盘开始
首页是高频入口集合。当前源码中的首页模块被分成教务服务、一码通和资源三类；快捷入口默认围绕成绩、课表、空教室、电费、排名等常用服务，并支持用户自行调整。
推荐首次使用顺序
- 安装并启动应用，进入我的页完成登录。未登录时，首页仍可查看图书查询、校园地图、资料分享等不依赖身份的入口；成绩、课表、电费等需要登录的模块会提示先登录。
- 登录成功后应用进入首页仪表盘。首页会展示天气、今日安排、快捷入口、功能分类和搜索框；今日课程从课表数据生成，未登录、加载中、加载失败、今日无课程安排都会有不同状态。
- 使用搜索框搜索服务、课程、资讯。服务结果会跳转到对应模块，课程结果来自本周课表搜索条目，资讯结果来自公告/通知数据。
- 通过底部主 Tab 在首页、个人课表、论坛、通知中心、我的之间切换。进入二级模块后，页面返回按钮会回到进入前的父页面；多数功能页也提供返回仪表盘路径。
- 进入我的页的设置中心调整主题、字体、后端/OCR、通知和调试选项；进入导出中心可以导出成绩、课表、个人信息等数据。
- 启用云同步后，课表、自定义课程、设置和部分学业数据可在新设备登录后恢复；无网络或教务维护时，支持离线缓存的数据会显示上次同步内容和同步时间。
4. 继续阅读路径
相关文档
当前页面读完后，可以按下面的交叉链接继续。用户文档、开发者文档、故障排查、参考资料和历史文档会互相补充。