虾大助手 v1.8.3 · 恢复老版首页签到摘要与闪退修复

虾大助手 v1.8.3 · 恢复老版首页签到摘要

Android 1.8.3 / versionCode 44，支持 Android 8.0 及以上。Windows 保持 1.8.1。

下载 Android APK · 校验文件 · Windows 1.8.1

更新内容

• 首页签到显示：对照美化前的首页，在原有自动签到快捷开关区域内显示紧凑的“当前签到”摘要和“查看签到详情”入口，不新增独立模块，不重复显示签到详情卡片。
• 签到页闪退：保留进行中与历史记录的分区标识修复，避免同一签到同时出现在两处时崩溃。
• 当前签到在前台自动刷新；手动刷新、数字码及雷达地点详情仍在签到页，原有“雷达签到坐标管理”按钮保留。

安装与验证

直接覆盖安装，不要先卸载。1.8.2 的独立模块候选未公开发布；1.8.3 也可覆盖此前交付的本地 1.8.2 包。

本轮首页与签到页 16 项界面回归通过；未改动模块沿用前一候选的 787 项全量测试证据。Lint 0 错误、36 警告，R8 Release 构建与 v2 签名验证通过。已检查 320×640 原生渲染及详情、坐标管理入口。

实际课堂签到尚未进行真机验证。详见验证记录。

虾大助手 v1.8.1 · 雷达坐标与等待策略修复

虾大助手 v1.8.1 · 雷达坐标与等待策略修复

Windows 1.8.1；Android 1.8.1 / versionCode 42，支持 Android 8.0 及以上。

Windows EXE · Android APK · SHA-256 校验文件

更新内容

• PC 雷达签到接入课程坐标：新增「雷达坐标」页，按课程保存地点、指定首选；自动与手动雷达签到只提交该课程的首选坐标一次，未配置时不提交并提示原因（与 Android 同语义）。
• PC 侧不再用 24.3/118.0、24.6/118.2 的探测坐标做盲提交；旧的距离探测实现仅保留给兼容测试调用。
• 雷达坐标页随包内置翔安校区预置地点（GCJ-02），可离线选择；桌面支持预置楼宇与手动经纬度，现场采点仍在手机端完成。
• 等待策略修复：「达到人数」「达到比例」现在都能真正修改。
  • Android：策略页补上人数/比例输入框，保存时写入对应字段；空值或超范围会提示且不允许保存。
  • Windows：人数与比例输入框改为常显（按模式启用），不会再因为切换模式而“消失”，保存后立即进入自动判定。

下载与更新

• Windows：用新 xmu-assistant.exe 覆盖桌面上的 xmu助手.exe，启动项路径与本地配置不变。
• Android：沿用原包名与固定签名，覆盖安装，请勿先卸载。

校验值

文件	SHA-256
xmu-assistant.exe	1AD92DBF02385B7EB54823E229D6D173F2BBFB1CE5DF67C4C942C8283D2D5B0A
XMU-Assistant-1.8.1.apk	EBC681B22C3DA5E037E57DAD7AEE8D7974212099D73EBF611EA93E0E39AFF4AB

验证范围

• Windows：726 项测试及 292 个子测试通过，含新增的雷达坐标库/按坐标提交/策略等待控件回归；onefile EXE 构建完成，并在隔离配置目录下启动检查通过。
• Android：781 项 Debug 单元测试通过；release 构建（R8 压缩）版本号 1.8.1 / versionCode 42，v2 签名校验通过。

自动化测试使用虚构数据和模拟传输，不代表所有设备、网络或实际业务场景均已验证。真实雷达提交仍以平台实际回执为准。

虾大助手 v1.7.4 · 双端兼容与稳定性更新

虾大助手 v1.7.4 · 双端兼容与稳定性更新

Windows 1.7.4；Android 1.7.4 / versionCode 31，支持 Android 8.0 及以上。

更新内容

• 改善双端记录详情查询的兼容性，修复跨日期、跨时区处理。
• 修复 Windows 后续查询空值或失败时复用旧缓存的问题。
• 统一公开介绍及界面文案，保留原有图像、接口、包名、数据目录和启动兼容标识。
• 补充模拟流程及边界回归。

下载与更新

• Windows EXE：保留原配置，替换程序文件。
• Android APK：沿用原包名和签名，请覆盖安装，不要先卸载。
• SHA-256 校验文件：核对对应文件名及校验值。

APK 沿用仓库公开的固定调试签名，仅用于升级兼容，不能证明发布者身份；请从本仓库下载并核对校验值。

验证范围

Windows 703 项测试及 225 个子测试通过，EXE 构建、模块核对及隔离启动检查通过。Android 758 项 Debug 测试通过，release 构建、版本及签名检查通过；Lint 0 错误、36 警告，其中 30 条为依赖版本提示。

用户已反馈早期同版 Android 测试包部分实际流程成功。本发布包按最新源码重新构建，不将该反馈等同于新包真机全功能验收；Windows 完整实际流程、长期后台运行及真实通知仍待验证。详见验证记录。

xmu助手 v1.7.3 双端稳定性修复

双端稳定性修复，Windows 与 Android 统一更新至 v1.7.3。

• 双端下载校验续传范围与实际字节数，错误响应保留断点；支持带查询参数和 fragment 的课件直链。
• Windows 修复换号/重登后的旧下载事件、跨会话章节缓存、压缩下载误报、非法邮件端口及 pip 包缺少图标。
• Android 限制下载 Cookie 的发送范围，改进课表/考试缓存恢复，修复日历事件标识碰撞和旧系统成绩图片分享问题。
• 修复 Android 网络基准变体编译。

验证：Windows 481 项测试和 144 个子测试通过；Android 610 项通过，Lint 无错误（保留 6 个警告）；网络基准模式/安全测试 4 项通过。EXE 实际启动及 Android 模拟器覆盖升级验证通过。发布包不包含个人账号、Cookie、运行快照或测试截图。

Android 版本为 1.7.3 / versionCode 30，沿用原签名，支持覆盖升级；固定签名的安全说明见仓库 README，请从本仓库官方发布页获取更新。

日历 UID 规则已更新，向含旧版导入记录的日历再次导入可能出现重复事件，建议先移除旧导入。真实校园网络及 Android 真机完整流程未在本次发布中验证。

附件：Windows EXE、Android APK、SHA256SUMS.txt。

xmu助手 v1.7.2 Android 教程定位修复

修复 Android 使用教程章节按钮定位偏移。

• 教程按钮不再依赖固定像素偏移，改为跟随实际教程卡片位置滚动。
• 适配不同屏幕尺寸、系统字体缩放和教程内容变化，避免点击章节后跳到错误位置。
• Windows 程序沿用已验证的 v1.7.1，Android 版本为 1.7.2 / 29。
• Android 单元测试与 Lint 通过，正式构建成功；APK 沿用原签名，可覆盖 v1.7.1。
• 发布内容经过脱敏核查，不包含账号、Cookie、签到码、原始名单、日志或私有签名材料。

校验值见 SHA256SUMS.txt。

xmu助手 v1.7.1 签到比例统计修复

修复 Windows 和 Android 中“已取得名单却暂未获取签到进度”的问题。

• 只统计明确已签人数，迟到、请假、缺勤等只计入总人数。例如 70 已签、2 迟到、1 请假、2 缺勤显示 70/75（93.3%）。
• 详细状态优先于粗分类；遇到其他非已签状态，不再让整份人数与比例失效。
• 本人状态冲突时等待下一轮核实，避免旧列表状态覆盖明细；明确已签、迟到、请假不重复自动提交。
• Android 雷达失败不再误记为完成，继续受有界重试限制；升级历史缓存，清除旧统计口径影响。
• README、双端说明及排查交接文档已更新。

验证：Windows 454 项、Android 593 项测试通过，Android Lint 无错误；双端正式构建通过。异常记录仅做少量只读实测，没有用账号试发签到。

Android 版本为 1.7.1 / 28，沿用原有签名，可覆盖同签名旧版；Windows 与 Android 均保留原有本地账号和设置。校验值见 SHA256SUMS.txt。

xmu助手 v1.7.0 双端签到人数门槛与数字签到修复

本次发布 Windows 与 Android v1.7.0，将签到人数、比例、数字码展示与自定义自动签到门槛接入双端。

新功能

• 自动签到可选择不等待人数条件、达到 N 人、达到 X% 三种模式，人数和比例由用户填写。默认不启用人数条件，原自动签到开关继续独立生效。
• Android 首页明确标注快捷开关与策略页联动，显示当前类型和人数条件；未启动监控时提示尚未生效，可直接进入策略页调整。无效的活动条件输入不能保存。
• Android 签到记录右侧显示本次点名已签人数和比例；进行中数字签到码位于卡片底部并可复制，历史数字签到码追加在右侧统计下方。
• Windows 首页与历史表显示人数、比例和数字码，CSV 导出同步增加相关字段。最近 20 条历史自动补充明细，更早记录可通过“核实所选”读取。
• 移除没有可靠数据的剩余时间占位；保留有效截止时间和平台明确结束标记的判断。

修复

• 修复 Android 数字签到实际提交失败却被提前去重、后续不再尝试的问题。明确拒绝后重新读取数字码再有限恢复；超时或服务端异常先核实本人状态，避免重复提交。每条签到最多自动尝试 3 次，成功后不重复。
• 数字签到单条资源被拒绝不再直接当作整个账号登录失效；保留失败提示，便于及时手动处理。
• 区分已提醒、等待条件、处理在途与已完成，未达门槛或缺码时继续检测，避免等待事件被去重丢弃或反复提醒。
• 停止监控、换号、关闭自动处理或修改策略后，旧任务不再按过时条件提交；Windows 保留在途请求占位，防止策略变更触发重复提交。
• 统一原始签到状态识别；人数与比例不使用历史显示的“未知状态”兜底。名单缺失或不完整不会当作达标。
• 包含会话过期识别、PushPlus 成功回执判定等此前尚未发布的修复。
• Windows 打包不再误收集其他工具的同名 ICU 库，修复 Qt 启动失败并减少安装包体积。

验证与安装

• Android：580 项测试通过，Lint 0 错误；Windows：431 项测试通过。两端读取同一组 21 个门槛边界样例。
• Android 布局检查覆盖正常宽度、窄屏、大字体与复制前导零；本轮未使用真实校园账号或真机课堂联调。
• 查看人数、获取数字码、刷新与复制本身不提交签到；后台提交仍由用户启用的自动策略决定。
• Android 延续项目既有固定签名，可覆盖同签名旧版；最终版 versionCode 为 27，高于本轮先行构建的 26。请从本仓库官方发布页获取更新。
• 下载 xmu-assistant-release.apk（Android）或 xmu-assistant.exe（Windows），完整性校验见 SHA256SUMS.txt。

xmu助手 v1.6.9 双端更新

本次发布 Windows 与 Android v1.6.9，包含此前本地 v1.6.8 的更新。

修复

• Windows：取消登录、退出或切换账号后，迟到的登录结果不会再写回账号和 Cookie，也不会影响新一轮登录。
• Windows：停止、换号或重新启动监控后，旧监控任务的消息不会再影响当前界面或触发处理。
• Android：修复旧版升级后小组件缺少登录镜像时可能在退出后后台续登的问题；有效会话仍可正常同步。
• Android：课程列表与课程课件共用缓存的异步保存按版本排序，防止旧快照晚到覆盖新数据。
• 包含 v1.6.8 更新：Android 15 签到监控前台服务改用 specialUse；Windows 临时解包目录清理增加应用所有权标记，避免误删其他应用目录。

验证与安装

• Android：532 项测试通过，Lint 0 errors；Windows 源码：390 项测试及 65 个子用例通过。
• Windows EXE 已核对包含 DPAPI、Crypto 和 QtWidgets，并在隔离配置下完成短时启动检查；EXE 约 49.60 MB，APK 约 3.97 MB。
• 使用现有工具链构建，未升级依赖。未使用真实校园账号联调，后台调度和校园网络行为仍需实际设备验证。
• Android 延续项目既有固定签名，可覆盖同签名旧版。该签名为项目公开调试签名，请仅从本仓库官方发布页获取更新。
• 下载 xmu-assistant-release.apk（Android）或 xmu-assistant.exe（Windows）。附件完整性见 SHA256SUMS.txt。

v1.6.7 Windows 桌面端凭据加密修复

v1.6.7 Windows 桌面端凭据加密修复

• 安全修复（Windows 桌面端）：凭据加密（DPAPI）在打包版中此前会间歇性失效——部分保存会把统一身份认证密码 / SMTP 授权码 / 会话 Cookie 以明文写盘，并留下误导性的「未安装 pywin32」告警（pywin32 实际已随包内置）。
• 根因：加密模块在保存时才懒加载，而 onefile 解包目录在运行中途可能失效，此时导入报「No module named 'win32crypt'」。
• 修复：改为应用启动期一次性加载并缓存，保存路径不再依赖运行中途的解包目录；若启动期即不可用，告警会带上真实原因。
• 已有的 dpapi 加密数据完全兼容，无需重新登录；此前若某次保存被写成明文，新版保存起会自动重新加密。
• 527 项 Android 测试通过（Android 端本版本无改动）；373 项 PC 测试通过（新增 2 例加密模块契约用例）。

下载

• Android 安装包（约 3.97 MB，延续原有签名，可覆盖旧版安装；Android 端本版本无功能改动）
• Windows 程序（含凭据加密修复，桌面版本号 1.6.7）
• SHA256SUMS.txt 校验文件

v1.6.6 安全加固与桌面端修复

v1.6.6 安全加固与桌面端修复

• 安全：QQ 邮箱通知的两条 SMTP 通道（465/587）补上服务器证书校验——此前标准库默认不验证证书，同一网络的攻击者可截获 QQ 授权码与提醒正文。
• 安全：教务重定向一旦离开厦大域或降级为明文 http，立即剥离会话 Cookie，不再把凭据发给跳转落点；CAS 登录链（ids.xmu.edu.cn）属校内域，不受影响。
• 隐私：云备份/换机迁移排除清单补齐——明文考试安排、签到去重集、加密凭据 prefs、外部课件目录不再进入备份（此前 API 12+ 上 allowBackup 被规则文件忽略、默认全包含）。
• 修复：pip 安装包补齐 desktop_qt 子包（此前入口点必然 ModuleNotFoundError）；PyInstaller spec 的 iconengines 过滤规则补上 plugins 段（此前从未生效，死插件一直打进包）。
• 优化：课件表整表重建改为一次预留行（去 O(n²) 行插入，批量下载过程更顺滑）；课件缓存接入进程级快照，转屏不再全量重解析大 JSON。
• 桌面端版本号自 1.5.0 同步至 1.6.6（设置页「当前版本」可见）。
• 527 项 Android 测试通过（新增重定向凭据守卫 3 例、备份排除契约 1 例、课件缓存快照契约 1 例等）。

下载

• Android 安装包（约 3.97 MB，延续原有签名，可覆盖旧版安装）
• Windows 程序（含 QQ 邮箱证书校验等修复，桌面版本号 1.6.6）
• SHA256SUMS.txt 校验文件