Repository navigation
Releases
Releases · Junpgle/HFUTCampusNet
v2.3.0
HFUTCampusNet v2.2.0 (macOS)
更新内容
📚 图书馆服务全面升级(原生重构)
- 原生 Cocoa 交互体验:彻底移除 Web 嵌入与外部网页依赖,重构为响应敏捷的纯原生布局,完美契合 macOS 视觉规范与深浅主题。
- CAS SSO 统一认证接入:打通合工大统一身份认证借阅通道,实时读取真实读者凭据。
- 读者借阅全生命周期:支持一键刷新查看【当前在借】(书名、借阅日期、应还日期、超期提醒、借阅条码)与【借阅历史】。
- 馆藏检索与校区筛选:支持题名/作者/ISBN检索校内馆藏,支持按翡翠湖校区、屯溪路校区、宣城校区即时筛选,并支持“仅看有纸质馆藏”。
- 全业务链读者操作:提供原生图书「⭐️ 收藏」、「🔖 加入书架」、「📅 图书预约」等快捷服务。
📊 智慧校园与综合服务
- EHALL 学生综合画像:接入学情、借阅、校园消费等多维度全景画像分析。
- 自习伴侣与就餐高峰量化:空闲教室模块新增食堂就餐人流拥挤度估算与分区趋势提示。
- 校历与重要日程节点:同步官方校历节点与教学周进度。
📦 macOS Universal 通用架构下载
- 支持 Apple Silicon (M1/M2/M3/M4) 与 Intel (x86_64) Mac。
- 下载解压后将
HFUTCampusNet.app拖入“访达 -> 应用程序”即可。
2026.10.19 fixed
- 修复了慧心易校电费无法读取的问题
HFUTCampusNet v2.1.0 (macOS + Windows) - 低功耗监测与 Windows 功能更新
更新内容
⚡ 低功耗监测
- 新增可配置的省电设置。
- 根据电源状态与系统睡眠、唤醒状态调整后台监测频率,减少不必要的轮询。
🛠️ 构建与发布
- 拆分 macOS 发布与 Windows 构建工作流。
v2.1.0tag 自动构建并发布 macOS Universal 应用(Apple Silicon arm64 + Intel x86_64)。- Windows 构建仅在 Windows 源码变更时触发,或通过 GitHub Actions 手动运行。
📦 macOS 下载与校验
下载 HFUTCampusNet-macOS.zip,解压后将 HFUTCampusNet.app 拖入“应用程序”文件夹。
SHA-256:7158a1e52c8db9e5fa0a5ef9a97224d56f768536d1b32c7d4c4a535660987172
Full Changelog: v2.0.0...v2.1.0
🪟 Windows 桌面版
- 新增动态主题与统一控件样式,优化设置和统一身份认证体验。
- 优化课表与学业中心,增强空教室自习伴侣。
- 修复任务栏图标右键菜单在点击其他窗口后仍常驻的问题。
- Windows x64 构建已通过 GitHub Actions。
下载 HFUTCampusNet-Windows-x64.zip,解压后运行 HFUTCampusNet.exe(独立版);HFUTCampusNet-Lightweight.exe 需要安装 .NET 8 Desktop Runtime。
SHA-256:5943D1938098B17D5F440086DA73A2F90F52CCB1B924ECEE14C2EADFEA2E0ECF
HFUTCampusNet v1.8.2 (macOS) - 原生更新日志预览、触摸板跟手滚动与 Markdown 渲染全面修复
✨ v1.8.2 更新内容
🐛 修复更新弹窗(v1.8.1 方案彻底重做)
v1.8.1 使用 WKWebView 渲染更新说明,实测在 NSAlert 中无法正常显示(内容区空白),并引发崩溃与滚动卡顿等问题。本版本改用 纯原生 NSTextView + 显式 TextKit 栈,全面修复:
- 更新日志正常展示:不再显示 Markdown 源码(
##、**等符号),也不再空白。标题、加粗、行内代码、列表、分隔线与链接均正确渲染,自动适配深色 / 浅色外观; - 触摸板滚动完全跟手:修复 NSAlert 内嵌滚动视图默认将触摸板滚动当作动画插值、导致「划完过 1~2 秒才跳到最终位置」的问题,现在滑动实时跟随手势;
- 消除布局重排卡顿:显式构建
NSTextStorage+NSLayoutManager+NSTextContainer,滚动阶段零文字重排;关闭拼写/语法/数据检测,避免滚动时触发额外文本检查; - 修复启动闪退:移除自定义
NSTextView子类(覆写init(frame:)触发 AppKit 内部重入init(frame:textContainer:)导致 Swift 运行时 trap),改用原生NSTextView,链接点击仍可通过系统默认行为用浏览器打开; - 弹窗高度自适应:按内容实际高度在 160–400pt 间自适应,短日志不浪费空间,长日志可滚动阅读。
📦 安装与升级方式
- 已安装旧版本的用户可直接在状态栏菜单点击 「检查更新...」 一键下载更新;
- 或直接下载下方
HFUTCampusNet-macOS.zip并解压,将HFUTCampusNet.app拖入/Applications(应用程序)文件夹即可运行(支持 Apple Silicon & Intel 通用架构)。
HFUTCampusNet v1.8.1 (macOS) - 更新弹窗 Markdown 渲染与滚动阅读优化
✨ v1.8.1 更新内容
🐛 修复与优化
- 更新弹窗全面重做:修复「检查更新」发现新版本时弹窗直接倾倒 Markdown 原文(显示
##、**等符号)、内容过长难以阅读的问题。更新说明现以 固定高度、可滚动的渲染面板 展示:- 支持标题、加粗、列表、行内代码、分隔线与链接等常用 Markdown 语法,自动适配深色 / 浅色外观;
- 弹窗文案精简为「当前版本 / 最新版本」两行,不再冗长;
- 点击说明中的链接会用系统浏览器打开,不会在弹窗内跳转导致丢失当前视图;
- 完整更新日志可通过 「查看完整更新日志」 按钮跳转 GitHub Release 页面查看。
- 构建脚本增强:
build.sh支持SKIP_APP_INSTALL=1环境变量,构建时跳过对/Applications内应用的覆盖安装,方便本地验证新版本功能。
ℹ️ 说明:v1.8.0 已调整为 Pre-release,正式自动更新通道自本版本 v1.8.1 起生效。
📦 安装与升级方式
- 已安装旧版本的用户可直接在状态栏菜单点击 「检查更新...」 一键下载更新;
- 或直接下载下方
HFUTCampusNet-macOS.zip并解压,将HFUTCampusNet.app拖入/Applications(应用程序)文件夹即可运行(支持 Apple Silicon & Intel 通用架构)。
HFUTCampusNet v1.8.0 (macOS) - 校园一卡通余额消费、教务学业中心(成绩/考试/GPA/教材)与小组件增强
✨ v1.8.0 更新内容
💳 校园一卡通余额与消费流水
- 一卡通实时余额与今日消费:状态栏菜单新增 「校园一卡通」 一栏,实时展示卡内可用余额、卡状态与今日消费金额(无消费时显示「今日无消费」),并支持余额偏低自动标红提醒(阈值可在设置中调整,默认 15 元);
- 消费流水与账单统计:子菜单与「历史统计」窗口新增 「校园卡与消费账单」 标签页,提供余额概览卡片、近期消费流水明细表格,以及每日消费汇总图表;
- 每日预算管理:支持设置一卡通每日预算(默认 30 元),结合消费流水直观掌握每日开销节奏。
🎓 教务学业中心(成绩 / 考试 / 培养方案 / 教材评教)
- 成绩单与 GPA 测算:新增独立的「教务学业中心」窗口(状态栏菜单 「考试与成绩」 或设置页「成绩与考试」按钮进入),支持按学期切换查看全部课程成绩明细,并自动测算 本学期加权 GPA、加权平均分、获得学分与全学程总 GPA;
- 考试与校历进度:自动同步教务排考安排,展示最近一场考试倒计时(按剩余天数自动红/橙色警示)、考试时间与考场地点,并展示学期校历进度(当前周次、距期末考试周天数等);
- 培养方案与毕业学分:同步培养方案完成情况,展示各课程类别学分要求、已修读学分与毕业学分缺口;
- 课程教材与评教:展示本学期各课程指定教材清单(含 ISBN 与版次)与期末评教状态提醒;
- 新出分监控与通知:后台定时静默同步成绩,检测到新出分时在状态栏菜单与桌面小组件醒目提示;通知默认 隐藏具体分数(可在设置中关闭该隐私保护)。
🖥️ 桌面小组件与状态栏增强
- 小组件轮播扩展至 6 屏:新增「校园一卡通余额与今日消费」「考试倒计时 / 新出分提醒」两个专属轮播屏,点击对应底部状态栏可直达一卡通账单或教务学业中心;
- 一卡通低余额自动通知:余额低于阈值时推送系统通知提醒及时充值。
🏫 课表与空教室体验优化
- 课表学期进度与校历信息:课表窗口顶部标题栏新增 学期进度百分比、距假期天数、校历起止日期、当前周次与距期末考试周天数 展示;
- 「教材与学分」快捷入口:课表窗口右上角新增按钮,一键跳转教务学业中心的教材与学分视图;
- 学期列表动态生成:空教室查询与教室课表的学期下拉列表改为按当前日期自动推算生成(不再写死学期 ID),并新增「下学期(教务暂未排课)」提示项,跨学期查询时自动限制在已排课学期内;
- 历史学期课表周次修正:查看历史学期课表时不再伪造「当前周次」,按锚点日期精确推算指定日期所属周次。
🔐 统一登录与自动同步链路升级
- 一键登录全链路扩展:统一身份认证成功后,自动依次同步 课表 → 成绩考试 → 校园卡 → 宿舍电费 → 校园网流量,全流程无需重复登录;
- 定时自动刷新:校园卡余额随校园网监测定时器自动刷新;启动时自动静默同步成绩单与排考数据;
- 账号切换清理:切换或清空账号时同步清理校园卡与教务成绩缓存,防止串号。
🐛 稳定性修复
- 修复查看历史学期课表时「当前周次」可能被错误推算的问题(学期范围外不再伪造周次);
- 修复教室课表窗口历史学期下拉选项未动态重建、按指定日期查询时学期选择可能越界的问题;
- 修复自习室伴侣将非今日查询日期的教室混入今日缓存导致冲突误判的问题;
- 优化电费菜单展示(精简房间信息冗余),统一登录步骤文案与校园卡/成绩同步节点对齐。
📦 安装与升级方式
- 已安装旧版本的用户可直接在状态栏菜单点击 「检查更新...」 一键下载更新;
- 或直接下载下方
HFUTCampusNet-macOS.zip并解压,将HFUTCampusNet.app拖入/Applications(应用程序)文件夹即可运行(支持 Apple Silicon & Intel 通用架构)。
HFUTCampusNet v1.7.0 (macOS) - 教室学期课表、空教室指定日期查询与全链路稳定性升级
✨ v1.7.0 更新内容
🏫 教室全学期课表与空教室指定日期查询
- 教室全学期课表查询:在「空教室查询」列表中新增 「教室课表」 按钮(以及右键快捷菜单),点击即可打开该教室的独立学期课表窗口:
- 支持 「按周课表」(第 1~24 周逐周查看每日具体节次、课程名、授课教师与行政班)与 「全学期总览」(自动合并整学期同一时段的固定排课并标注周次范围,如
[1-16周])两种视图切换; - 支持切换当前已排课学期与历史学期(注:教务系统仅开放已排课学期,当前查不到下学期的课)。
- 支持 「按周课表」(第 1~24 周逐周查看每日具体节次、课程名、授课教师与行政班)与 「全学期总览」(自动合并整学期同一时段的固定排课并标注周次范围,如
- 空教室「指定日期」弹窗查询:
- 在「今天 / 明天」旁新增 「指定日期」 按钮,点击弹出日期输入与日历选择面板,选好日期后点击 「查询」 才发起请求,避免输入过程中频繁触发查询;
- 内置学期范围校验与提示:选择尚未排课的下一学期日期时自动弹窗提醒拦截,若查询日期处于假期或全楼无排课则在底部状态栏醒目提示,避免误判为全天无课。
🔐 凭据安全升级与全链路稳定性加固
- macOS 钥匙串(Keychain)安全存储:将校园网密码、信息门户密码与学工号等敏感信息从
UserDefaults自动平滑迁移至系统级Keychain加密保存。 - 多线程并发安全与请求合并:为历史统计(
CampusHistoryManager)、宿舍电费(ElectricityService)、教务课表(CourseScheduleService)与空教室服务(EmptyClassroomService)引入串行同步队列与并发请求合并(Request Coalescing),彻底消除多线程读写竞态。 - 电费历史智能去噪与异常波动保护:优化电费历史采样与充值识别算法,过滤电表偶发读数抖动,提升近 7 天日均消费与预计可用天数的准确度。
- WebView 与网络生命周期加固:修复统一认证与教务登录窗口关闭后
WKWebView残留回调、轮询定时器及 URL 参数编码安全问题。
📦 安装与升级方式
- 已安装旧版本的用户可直接在状态栏菜单点击 「检查更新...」 一键下载更新;
- 或直接下载下方
HFUTCampusNet-macOS.zip并解压,将HFUTCampusNet.app拖入/Applications(应用程序)文件夹即可运行(支持 Apple Silicon & Intel 通用架构)。
HFUTCampusNet v1.6.1 (macOS) - 流量限额展示、消费保护识别与全方位稳定性修复
✨ v1.6.1 更新内容
📊 流量限额与消费保护展示优化
- 状态栏与桌面小组件流量限额化:鉴于校园网网关返回的「可用流量」偶发波动不准,状态栏自定义文本、主菜单与桌面悬浮小组件全面升级为展示 本月累计已用流量(限 200G 免费 / 400G 上限) 与 今日已用流量(限 30G);用量统计表格同步替换为 「月免费剩余 (200G)」。
- 消费保护「未设置」智能识别:修复自服务平台(
xywzz:8443)未开启消费保护或跨标签页解析时显示--的问题,现可准确区分 「未设置」 与具体消费保护限额(如0 元、20 元)。 - 跨月流量隔离与冷启动预热:新增跨月自动识别机制,避免月初 1 号将上月累计流量误作当月已用;冷启动处于校外时优先从本地当月历史与慧新易校接口恢复已用流量与账户余额。
🛠️ 核心服务与多子系统稳定性修复
- 校园网门户认证与断线重连:
- 修复非校园网环境下 JSONP 超时被误判为「未认证」从而在移动热点/校外 Wi-Fi 下反复尝试校园网登录的问题;
- 新增手动注销标记,点击「注销登录」后暂停自动重连直至用户主动连接;
- 修复系统网卡
ifi_ibytes/ifi_obytes32 位计数器满 4GB 回绕时网速瞬时异常飙升的问题。
- 宿舍电费查询与历史统计:
- 修复切换宿舍楼栋、房间号或照明/空调端口时旧房间历史记录未清理导致计算出虚假巨额日消费的问题;
- 修复设置窗口修改房间号后关闭窗口不自动触发电费刷新的问题。
- 教务周课表与空教室查询:
- 修复教务系统 CAS / 盐值静默登录未轮询全部候选密码的问题;
- 修复周课表网格晚间课程结束时间(
HHMM格式)向上取整计算偏差导致晚课色块超出底边的问题; - 修复空教室查询中「常去教学楼」筛选匹配、明日空教室剩余节次计算、跨校区换座推荐混入及单教学楼内存缓存未填充的问题。
- 桌面小组件与窗口布局自适应:
- 修复校外/离线状态下桌面小组件底部 4 槽轮播(实时网速、宿舍电费、自习空教室推荐)被冻结的问题;
- 修复历史统计窗口缩放时顶部卡片与折线图重叠的问题。
📦 安装与升级方式
- 已安装旧版本的用户可直接在状态栏菜单点击 「检查更新...」 一键下载更新;
- 或直接下载下方
HFUTCampusNet-macOS.zip并解压,将HFUTCampusNet.app拖入/Applications(应用程序)文件夹即可运行(支持 Apple Silicon & Intel 通用架构)。
HFUTCampusNet v1.6.0 (macOS) - 空教室查询与自习室伴侣、浅色模式动态适配
✨ v1.6.0 更新内容
🏫 新增:空教室查询与自习室伴侣
- 三校区全教学楼覆盖:支持 宣城校区、翡翠湖校区、屯溪路校区 所有教学楼与楼层按需快速筛选,支持翡翠湖等多楼宇校区横向平滑滚动切换。
- 08:00 - 22:00 连续占用时间轴:基于 CoreGraphics 高性能绘制全天 14 小时连续时间轴,直观区分 空白空闲、蓝色上课、红色考试 与 橙色借用/晚自习,并附带当前时刻红线指示。
- 今日全天无课教室推荐:顶部一键筛选当天
08:00 - 22:00完全无排课的教室,自习一整天无需换座。 - 驻扎自习室 & 智能换座/放书推荐:
- 点击任意教室右侧
📌 设自习室即可将其设为今日驻扎教室,状态栏主菜单实时展示该教室当前状态(如敬亭202 · 空闲至 22:00)。 - 当驻扎教室即将上课时,自动按同楼层优先、同教学楼次之、空闲时长最长原则推荐最佳换座或放书教室。
- 点击任意教室右侧
- 同步进度遮罩与时效标注:
- 点击「刷新数据」时锁定交互并展示全屏加载遮罩、实时耗时读秒与约 10 秒耐心等待提示;
- 刷新完成后顶部弹出成功/失败横幅提示,并持久化记录与展示各校区空教室上次同步时间,数据有效性一目了然。
🎨 界面与性能深度优化
- 全应用浅色/深色模式动态适配:修复浅色模式下自习教室、偏好设置、教务周课表、用量统计、桌面悬浮小组件及 CAS 登录窗口中卡片底色发黑的问题,支持随系统外观实时无缝切换。
- 极致流畅列表渲染:空教室列表重构为
NSTableView视图复用 + 预计算元数据 + CoreGraphics 直接绘制时间轴,切换校区、教学楼、楼层与时段丝滑无卡顿。 - 全新文档与界面预览:更新
README.md实机截图(状态栏总览、校园网限额与终端管理、空教室查询、校园网与宿舍电费统计)。
📦 安装与升级方式
- 已安装
v1.5.0的用户可直接在状态栏菜单点击 「检查更新...」 一键下载更新; - 或直接下载下方
HFUTCampusNet-macOS.zip并解压,将HFUTCampusNet.app拖入/Applications(应用程序)文件夹即可运行(支持 Apple Silicon & Intel 通用架构)。
HFUTCampusNet v1.5.0 (macOS) - 在线设备管理、限额进度卡片与自服务静默登录修复
✨ v1.5.0 更新内容
🚀 新增功能
- 单日/月度流量限额进度卡片:在状态栏校园网子菜单与用量统计窗口中新增单日(30GB)与每月(200GB 免费 / 400GB 封顶)可视化进度卡片与超额预警。
- 在线设备查看与一键强制下线:支持直接从自服务接口拉取当前账号下所有在线终端设备(IP、MAC、上线时间、消耗流量),并在状态栏菜单中点击一键强制注销下线。
- 软件自动检查更新 (GitHub Releases):内置版本更新检测器,支持启动后静默检查新版本及在状态栏/设置中手动检查更新。
- 全新专属应用图标:配备 macOS 风格高清
.icns应用图标。
🐛 问题修复与优化
- 修复每次启动只登录网关、不自动登录自服务授权的问题:禁用
CampusNetworkClient的系统自动HTTPCookieStorage注入,解决旧过期 Cookie 触发 302 时污染会话导致后台静默登录中断及重定向丢 Cookie 的问题。 - 修复教务课表自动同步:支持通过 CAS
TGC票据静默单点登录教务系统,自动提取studentId/semesterId/bizTypeId,并严格隔离jxglstu与cas的同名SESSIONCookie。 - 账号密码严格分离:将校园网认证/自服务密码与统一身份认证(CAS 信息门户)密码完全独立存储与自动填充。
- 菜单栏结构精简:将详细指标与显示/刷新选项收纳至二级子菜单,界面更加清爽。
📦 安装方式
- 下载下方
HFUTCampusNet-macOS.zip并解压。 - 将
HFUTCampusNet.app拖入/Applications(应用程序)文件夹即可运行(支持 Apple Silicon & Intel 通用架构)。