使用指南

系统要求：Windows 10（1803+）或 Windows 11，64 位系统。

安装步骤：

1. 前往 Releases 页面，下载最新版的 Mini-HBUT_x.x.x_x64-setup.exe（推荐）或 .msi 安装包。
2. 双击运行安装程序，按照向导提示完成安装。
3. 安装完成后，在开始菜单或桌面找到 Mini-HBUT 图标，点击启动。
4. 首次启动会自动初始化本地数据库和配置，等待几秒即可进入登录页面。

系统要求：macOS 10.15 (Catalina) 或更高版本，支持 Intel 和 Apple Silicon (M1/M2/M3)。

安装步骤：

1. 下载最新版的 Mini-HBUT_x.x.x_universal.dmg。
2. 双击打开 DMG 文件，将 Mini-HBUT 拖拽到 Applications 文件夹。
3. 首次打开时，macOS 可能提示「无法验证开发者」。
4. 解决方法：打开「系统设置」→「隐私与安全性」→ 找到 Mini-HBUT 的提示 → 点击「仍要打开」。
   或者在终端执行：

xattr -cr /Applications/Mini-HBUT.app

5. 之后即可正常打开应用。

系统要求：支持主流 Linux 发行版（Ubuntu 20.04+、Debian 11+、Fedora 36+ 等），需要 64 位系统和图形桌面环境。

安装方式一：AppImage（通用，推荐）

1. 下载 Mini-HBUT_x.x.x_amd64.AppImage。
2. 赋予执行权限并运行：

chmod +x Mini-HBUT_*.AppImage
./Mini-HBUT_*.AppImage

安装方式二：DEB 包（Debian/Ubuntu）

1. 下载 Mini-HBUT_x.x.x_amd64.deb。
2. 使用以下命令安装：

sudo dpkg -i Mini-HBUT_*.deb
# 如果缺少依赖
sudo apt-get install -f

3. 安装完成后在应用菜单中找到 Mini-HBUT 并启动。

系统要求：Android 7.0 (API 24) 或更高版本。

安装步骤：

1. 下载最新版的 Mini-HBUT_x.x.x_arm64.apk。
2. 在手机上打开下载的 APK 文件。
3. 如果提示「不允许安装未知来源应用」，按提示跳转到设置页面，开启「允许此来源」。
4. 按照安装向导完成安装。
5. 在主屏幕或应用列表中找到 Mini-HBUT 图标，点击启动。

由于 Mini-HBUT 暂未上架 App Store，iOS 版本需要通过侧载安装。 个人 Apple ID 免费签名只有 7 天有效期，建议优先使用支持续签的工具。

系统要求：iOS 15.0 或更高版本。

Mini-HBUT 内置自动更新检查机制：

• 桌面端（Windows/macOS/Linux）：启动时自动检查新版本，发现更新后会弹出提示框，点击即可打开下载页面。
• Android：同样启动时检查，点击更新会下载新版 APK。
• iOS：需要手动下载新 IPA 并重新侧载安装（覆盖安装即可，数据不丢失）。
• 强制更新：当服务端检测到当前版本过低时，会阻止使用并提示更新。

下载渠道（按优先级）：

1. GitHub Releases（推荐，最新最快）
2. gh-proxy 代理（国内加速镜像）
3. jsDelivr CDN 加速

Mini-HBUT 支持三种登录方式，选择你最方便的一种即可：

登录成功后进入首页仪表盘，这里是 Mini-HBUT 的核心导航区域：

• 今日课程：实时显示今天的课程安排，包括课程名称、时间和教室。
• 公告栏：显示来自服务端推送的滚动公告、置顶通知和重要提示。
• 模块导航网格：所有功能模块的快捷入口，点击即可跳转对应功能页面。
• 离线指示：当检测到网络不可用时，会显示离线标识，此时使用本地缓存数据。

查询你所有学期的课程成绩，支持多种筛选和统计方式。

• 学期筛选：在顶部下拉框中选择学期，或选择「全部」查看所有成绩。
• 课程搜索：在搜索框中输入课程名称关键词进行实时筛选。
• 状态筛选：可以按「合格」「不合格」「补考」等状态过滤。
• 学分统计：页面顶部展示已获总学分和当前学期学分。
• 缓存机制：首次查询从服务器获取，后续使用本地缓存（缓存时间 3 天），可手动刷新。
• 变更检测：后台静默检查会比较最新成绩与缓存，发现新成绩自动推送通知。

以周视图形式展示你的课程安排，直观清晰。

• 周切换：左右滑动或点击箭头切换周次，顶部显示当前是第几周。
• 今日标记：今天的列会高亮显示。
• 课程详情：点击课程卡片查看详细信息（教师、教室、节次、周次范围）。
• 自定义课程：支持手动添加/编辑/删除自定义课程，自定义课程按学期存储，与教务课程区分显示。
• 课表导出：支持导出为 iCalendar (.ics) 格式，可导入到 Google Calendar、Outlook、Apple Calendar 等。
• 云同步：登录后自动将课表数据（含自定义课程）同步到云端，换设备时自动恢复。

查看本学期所有考试的时间、地点和状态。

• 分类显示：自动按日期排序，区分「未考」和「已考」。
• 考试详情：包括考试名称、时间、地点、座位号等信息。
• 次日提醒：后台检查发现明天有考试时会推送通知提醒。

查看你在班级、专业和年级中的绩点排名情况。

• 三维排名：分别展示班级排名、专业排名和学院排名。
• GPA 展示：显示你的平均绩点和排名百分比。
• 实时查询：每次打开时从教务系统实时获取最新排名数据。

以进度条和树形结构直观展示你的学业完成度。

• 学分统计：多维度展示总学分、必修/选修/实践学分的完成进度。
• 培养方案树：按课程模块（通识、专业基础、专业核心等）分层展示每门课程的完成状态。
• 完成标记：已修课程标绿色，未修标灰色，一目了然。

查询宿舍电费余额，支持低电量自动提醒。

• 宿舍选择：首次使用通过级联选择器选择「校区 → 楼栋 → 楼层 → 房间」，选择后自动保存。
• 余额展示：显示当前电费余额（度数）和账户金额。
• 离线缓存：无网络或服务异常时显示上次缓存的数据，并标注同步时间。
• 低电量提醒：后台检查发现余额低于 10 度时自动推送通知，智能去重避免重复打扰。
• 自动重试：查询失败时自动重试（默认 2 次），应对服务器临时不稳定。

在手机/桌面上生成和显示校园消费二维码。

• 在线模式：每隔一定时间（默认 60 秒）自动刷新二维码，保持有效性。
• 高能模式：手动刷新，适合网络不稳定或离线场景。
• 余额显示：消费后实时显示剩余金额。
• 订单状态：自动轮询检查支付/消费状态（3 秒一次），展示结果。
• 设备码：本地自动生成唯一设备码并持久化存储。

查看一码通的消费流水，支持多维度筛选和统计。

• 月份筛选：支持按月份查看最近 12 个月的交易记录。
• 收支统计：自动计算当月总收入和总支出。
• 详情展示：每笔交易显示时间、类型、金额和余额。

查找指定日期和时间段内的空闲教室。

• 时间段选择：选择日期和节次范围（如第 1-2 节、第 3-4 节等）。
• 教学楼筛选：可按教学楼过滤结果。
• 自动重试：请求失败时自动重试（默认 2 次）。

检索学校图书馆的馆藏书籍，查看详情和借阅状态。

• 关键词搜索：输入书名、作者或 ISBN 进行搜索。
• 高级筛选：支持按学科分类、出版社、出版年份等多维度筛选。
• 馆藏信息：展示每本书的馆藏位置、可借数量和在馆状态。
• 书籍详情：点击查看完整信息，包括封面、简介和目录。

连接校内 WebDAV 共享网络，浏览和下载学习资料。

• 文件浏览：以文件管理器的形式浏览远程目录结构。
• 在线预览：
  • PDF 文件：使用 pdf.js 在线预览
  • Office 文件：通过代理服务转换预览
  • 图片：直接在线查看
  • 视频：使用 XGPlayer 播放器
• 文件下载：支持单文件下载，可配置下载并发线程数。
• CDN 缓存：预览所需的 pdf.js、xgplayer 等库首次使用时自动下载并缓存，后续离线可用。

将你的学业数据导出为多种格式，方便保存和分享。

• 成绩单导出：导出为图片或 JSON 格式。
• 课表导出：导出为 iCalendar (.ics) 文件，可导入各大日历应用。
• 个人信息导出：导出基本学籍信息。
• 批量导出：支持在导出中心一站式操作所有模块的导出。

查看学校校历安排，了解学期时间节点。

• 学期周次显示，当前周高亮标记。
• 假期安排与节假日识别。
• 开学/放假日期一目了然。

查询全校开设的课程安排，适合选课参考和旁听。

• 高级筛选：按学年/学期、院系、专业、年级、班级等条件组合查询。
• 分页展示：支持查看 3000+ 课程的完整列表。
• 课程信息：展示授课教师、上课时间地点、班级等详细信息。

查看学校的校园地图，支持缩放和拖拽操作。

• 远程加载高清校园地图并缓存到本地。
• 支持手势缩放和平移查看。
• 集成微信小程序版地图入口。

查看你的学籍信息和登录安全记录。

• 基本信息：学号、姓名、学院、专业、班级、身份证号等。
• 登录记录：查看历史登录设备、IP 地址和登录地点。
• App 授权：查看已授权的第三方应用列表。

内置 AI 对话功能，支持多个大模型切换。

• 可用模型：Qwen-Plus、Qwen-Max、DeepSeek-R1、Doubao1.5-Pro（通过远程配置可扩展）。
• 流式对话：使用 SSE（Server-Sent Events）流式传输，实时显示 AI 回复。
• Markdown 渲染：AI 回复支持完整的 Markdown 格式，包括代码高亮和 LaTeX 数学公式。
• 历史记录：对话历史自动保存在本地，支持查看和继续历史会话。

Mini-HBUT 可以在后台定期检查你的学业数据变化，并在发现新内容时推送通知。

Mini-HBUT 支持将你的数据同步到云端（Cloudflare Workers），实现跨设备数据共享。

• 同步的数据：
  • 应用设置（UI 配置、字体、登录偏好）
  • 自定义课程（按学期存储）
  • 学业数据（成绩、排名、课表缓存）
• 自动同步：
  • 首次在新设备登录时自动下载云端数据并应用
  • 每次登录后自动上传最新数据到云端
• 冷却机制：为避免频繁请求，上传和下载分别有冷却时间（默认上传 120 秒、下载 10 秒）。
• 学号验证：通过 10 位学号标识用户数据，上传/下载需要通过 challenge 认证。

Mini-HBUT 提供丰富的字体和主题个性化选项。

可用字体：

CDN 线路：字体通过 CDN 加载，支持切换线路：

• 自动（推荐）：自动选择最快的 CDN（jsDelivr → unpkg 降级）
• jsDelivr：国内一般较快
• unpkg：备用线路

字体下载后会缓存到 IndexedDB，后续使用无需重新下载。

主题预设：

除主题颜色外，还可以自定义卡片风格（毛玻璃/实色/描边）、导航样式（浮动/胶囊/紧凑）、界面密度（舒适/均衡/紧凑）、图标风格（双色/线条/单色）、背景装饰（网格/颗粒/无）等。

Mini-HBUT 桌面端内置了一个本地 HTTP 服务（默认 http://127.0.0.1:4399）， 你可以通过这个接口在外部程序中调用 Mini-HBUT 的能力。

统一响应格式：

// 成功
{ "success": true, "data": { ... }, "error": null, "time": "2026-03-10 12:00:00" }

// 失败
{ "success": false, "data": null, "error": { "kind": "请求失败", "message": "登录失效" }, "time": "..." }

主要接口列表：