开始/文档总览
长文档建议按当前分组逐页阅读；右侧辅助栏会保留当前位置和快速操作。
文档中心
欢迎来到 Mini-HBUT 文档中心！这里包含从入门使用到技术深入的全部内容，帮助你快速上手并充分利用 Mini-HBUT 的所有功能。
Mini-HBUT 是什么
Mini-HBUT 是一款专为湖北工业大学学生设计的跨平台一站式校园助手， 支持 Windows、macOS、Linux、Android 和 iOS 全平台。
核心功能包括：
- 成绩查询与 GPA 分析、绩点排名对比
- 智能课表管理、考试安排自动提醒
- 电费余额查询与低电量告警
- 空教室查询、校园地图、图书馆搜索
- AI 学习助手、校园码生成、云同步
- 后台静默检查、成绩/考试/电费推送通知
亮点特性
跨平台：一套代码覆盖 Windows、macOS、Linux、Android、iOS 五大平台。
离线可用：三层缓存策略保证断网也能查看已加载的数据。
后台通知：成绩更新、考试提醒、电费告警自动推送到系统通知栏。
云同步：一键同步设置和数据到云端，换设备也能秒恢复。
隐私优先：所有数据本地存储，不收集任何个人信息。
完全开源：GPL v3 协议，代码公开透明。
文档导航
快速开始
下载与安装、首次登录、首页仪表盘、搜索、底部主 Tab 和常用入口。
用户手册
普通用户阅读路径、全局导航、功能分类地图和通用状态说明。
教务服务
成绩、课表、考试、排名、选课、空教室、校历、学业进度和培养方案。
校园生活
校园码、电费、交易流水、图书馆、校园地图、资料分享和天气。
社区与通知
论坛、通知中心、课程提醒、电费提醒、后台任务和 Widget 差异。
扩展模块
更多模块、模块宿主、超星签到、在线学习入口状态和小游戏模块。
设置与数据
设置中心、主题字体、缓存、云同步、导出和远程配置对用户体验的影响。
故障排查
登录、安装、网络、后台通知、数据隐私、平台差异和反馈入口。
开发者总览
仓库结构、开发环境、阅读顺序和贡献入口。
架构与数据流
Vue 入口、视图分发、状态恢复、API/缓存/降级和数据库关系。
平台与 Tauri
平台桥接、Tauri commands、Rust modules、HTTP client 和能力矩阵。
模块系统
模块中心、远程 catalog、manifest、iframe 宿主和模块构建链。
构建发布
npm scripts、Tauri build、Capacitor sync、release manifest 和热更新。
安全与隐私
Cookie、密码、token、SQLite、云同步、自定义 JS、调试桥和热更新边界。
参考资料
API、Tauri / HTTP Bridge、配置字段、文件索引、脚本索引和工程规范入口。
最新能力（v1.3.6）
后台静默检查
课表静默刷新 + 新成绩检测 + 考试提醒 + 电费监控，启动即执行一次全量检查。
AI 学习助手
接入多家大模型（DeepSeek / Qwen / Gemini / GLM），支持流式回复与 LaTeX 公式渲染。
移动端后台任务
Capacitor Background Fetch 支持进程被杀后周期联网检查，含开机自动拉起。
云同步
基于 Cloudflare Workers + KV 的端到端加密云数据同步，支持设置与学业数据。
资源共享
基于 WebDAV 的校园学习资源共享网络，支持文件上传/下载与在线预览。
按需加载 CDN
pdf.js / xgplayer / KaTeX 等大型库首次使用时自动下载并持久化缓存到 IndexedDB。
版本信息
当前版本：v1.3.6
技术栈：Vue 3 + Tauri 2.x（桌面端）+ Capacitor 6.x（移动端）
支持平台：Windows / macOS / Linux / Android / iOS
开源协议：GPL v3
推荐阅读路径
相关文档
当前页面读完后，可以按下面的交叉链接继续。用户文档、开发者文档、故障排查、参考资料和历史文档会互相补充。