szuDesktop beta0.9.5

这一版第一次提供 macOS 桌面版，以预览版随本版发布：Apple 芯片和 Intel 各一个安装包，功能与 Windows 安装版一致，但有一部分行为还没在真机上验收，欢迎试用并告诉我们哪里不对。Windows 版照常更新：人在校外不再误报「校园认证待确认」，网络诊断能认出代理软件接管了学校域名，存档多留几天备份，第一次打开更顺，说明文档和使用指南也重新写过。

macOS 桌面版（预览版）

• 下载哪个：Apple 芯片（M1 及更新）选 mac-arm64.dmg，Intel 处理器选 mac-x64.dmg；在「苹果菜单 → 关于本机」的「芯片」或「处理器」一栏可以看到自己是哪种。需要 macOS 13 或更高版本，不支持 macOS 12 及更早版本。
• 安装与第一次打开：打开 DMG，把 szuDesktop 拖进「应用程序」，再从「应用程序」里打开；直接在 DMG 窗口里运行的话，「登录 Mac 时启动」用不了。应用未经 Apple 公证，第一次打开会被系统拦下：macOS 15 及以后，先在提示框里点「完成」，再到「系统设置 → 隐私与安全性」底部找到 szuDesktop，点「仍要打开」；macOS 13 和 14 可以在「应用程序」里按住 Control 点按 szuDesktop，选「打开」。每次更新到新版本都要再放行一次。完整步骤见使用指南的安装一页。
• 功能与 Windows 安装版一致：主窗口、庭院、课程笔记、学校与飞书窗口和桌面宠物都在。托盘换成屏幕顶部的菜单栏图标，程序坞图标右键也有同样的菜单；关掉主窗口后宠物仍常驻，点程序坞图标就能找回主窗口。宠物跟着切换桌面，全屏应用里也看得到；右键或按住 Control 点按宠物打开菜单，悬停时滚动鼠标滚轮或在触控板上双指滑动调整大小。学校和飞书窗口的返回、刷新、在系统浏览器打开，都在菜单栏的「页面」菜单里。设置里可以开启「登录 Mac 时启动」（要先把应用放进「应用程序」）。
• 专注提醒用系统通知：第一次提醒时 macOS 会询问是否允许通知；通知发不出去时，改由宠物冒气泡、程序坞图标跳动提醒。
• 退出前先保存：⌘Q、程序坞里的「退出」、菜单栏图标的「退出」，以及注销和关机，都会先保存笔记和 2048 棋局；保存不住时弹框让你选择返回处理还是放弃修改。注销或关机时弹出这个框，系统会提示「szuDesktop 中断了注销」，处理完再注销即可。
• 校园网账号存进钥匙串：校园网账号存在钥匙串的 szunet 条目里，与命令行版共用。学校窗口里的登录只留在内存里，退出应用就清除，不写进钥匙串。手动保存的学校登录状态（macOS 版界面没有这个入口）有 1–2KB，而钥匙串一次最多只能完整写入 128 字节，所以这类内容加密后存在 ~/.szunet/session.enc，钥匙串里的 szunet-session 条目只放密钥。
• 校历也能自动更新：学校换了校历图时，macOS 版用系统自带的文字识别读出新学期，与 Windows 版一致；识别失败时保留原有校历，稍后重试。
• 从程序坞或启动台打开也能找到 lark-cli：用 Homebrew、npm 等常见方式安装的官方 lark-cli，不必从终端启动应用也能识别，飞书课程共学照常可用。
• 已知限制：每次更新都要重新放行一次；按 ⌘H 隐藏应用时桌面宠物也会一起隐藏，在菜单栏图标里点「显示宠物」即可只把宠物带回来；主窗口和宠物都隐藏时，专注提醒可能稍有延迟。这是第一个 macOS 版本，还没有可以升级的旧版，跨版本升级没有验证过。
• 还没在真机上验收：macOS 版的真机验收还一项都没做。浏览器下载后的首次放行、菜单栏图标与程序坞、关窗与全屏、各种退出方式先保存、学校和飞书窗口的「页面」菜单与复制粘贴、宠物的 Control 点按与多显示器、系统通知的授权与弹出、注销与登录时启动、真实钥匙串的保存与读取、macOS 13 和 14，以及在校园网里是否弹出「本地网络」授权（弹出时请选择允许，应用要靠它连接校园网认证门户），都还要在真机上逐项确认，进度见 STATUS 68.2。
• 遇到问题怎么反馈：到 Issues 选「问题反馈」，写上 macOS 版本、芯片（Apple 芯片或 Intel）、卡在哪一步和提示原文。「设置 → 关于与更新 → 反馈与建议」里可以复制不含个人信息的环境信息；网络或学校服务出问题时，再附上同一处的诊断报告。请不要附密码、Cookie 或个人成绩。

Windows 版：照常升级，安装包更小

• 升级与数据保留：先完整退出旧版（包括正在运行的便携版），下载新的安装包直接运行、装到原来的位置。庭院、学习记录、加密保存的账号配置和桌面伙伴设置都会保留，安装版和便携版继续共用同一份本机记录。升级前建议在「设置 → 存档与隐私」点「导出庭院与待办」和「备份课程笔记」。
• 安装包小了约 10MB：安装包改为整体压缩，本机构建从约 108.5MB 降到约 97.8MB；安装、升级和卸载的方式不变。
• 少写一份用不上的缓存：主窗口不再每次启动都往磁盘写一份用不上的页面缓存。

校外提示与网络诊断

• 人在校外不再误报「校园认证待确认」：外网正常、只是没找到校园网认证页面时，校园网页和首页改为一行灰色说明「外网正常；没有检测到校园网认证页面（不在校园网内时属正常）」，不再常驻黄色提示把你引去运行诊断。只有判定你在教学区或宿舍区、却查不到认证状态时，才保留黄色提示和诊断引导。
• 提示代理软件接管了学校域名：开着 Clash 这类代理的 Fake-IP 模式时，学校域名会被解析成 198.18 开头的假地址，认证门户和学校系统因此连不上。网络诊断（桌面版和 szunet diag）现在会在建议里说明这一点（连不上外网时排在最前），外网正常时「校园认证」一栏的灰色说明后面也会带上这句；课表、成绩、学校登录和场地查询连不上时也会给出同样的提示：把 szu.edu.cn 设为直连，Fake-IP 模式还要把它加进「不分配假 IP」的名单。诊断结果旁边加了「校园网指南」链接。
• 复制诊断报告：「设置 → 关于与更新 → 反馈与建议」新增默认折叠的诊断报告，先预览再复制。报告只含结构：判区、外网、两类认证门户是否可达、学校域名是否被代理接管、最近一次网络诊断的结论（接入点编号、IP 和长串数字已隐去），以及各项学校服务最近一次请求的状态类别、条数和字段是否出现；不含账号、卡号、密码、IP、Cookie、成绩、课表或公告内容，应用不会自动上传。

存档防丢

• 存档多留几天的备份：庭院存档和课程笔记除了 .bak，每天第一次保存时还会把上一个使用日结束时的样子另存为 <文件名>.bak-年-月-日，保留最近 3 个使用日；主文件和 .bak 都坏了时，会依次用这些备份恢复。误删了笔记里的一段、而 .bak 已经被新的保存覆盖时，可以完整退出应用后手动换回某一天。
• 旧版本不再悄悄丢掉新存档的内容：以后的版本如果改了存档结构，用旧版本打开时会明确拒绝读取、提示先更新应用，原文件不会被改动。

首次体验、学校公告与界面

• 第一次打开更顺：关掉欢迎引导后首页不再立刻显示「欢迎回来」。建档当天首页保持首访的样子，「今天谁陪你？」伙伴栏展开，主按钮直接「开始 5 分钟」专注；欢迎框第二个按钮改为「先专注 5 分钟」，点了就开始 5 分钟专注并打开专注页；庭院的「下一步」先提示建档时种下的第一颗萝卜。欢迎图换成现在的伙伴。
• 学校公告先选学院：第一次打开「校园服务 → 学校公告」时先请你选学院，不再默认显示教务部栏目里的旧通知。设置里填了「学院」（原「学院 / 一句话」）会直接用它，研究生默认看研究生院；某个栏目最新一条已是一个多月以前时，列表顶部会写明「最新一条发布于 N 个月前」。
• 页面名称统一、字更清楚：导航、页标题和页面顶部的路径用同一个名字，路径从「今日」开始；设置里的「安静陪伴」改叫「勿扰」（与托盘一致），「桌面宠物」改叫「桌面伙伴」，「学习书屋」「课程笔记」「饱食」等叫法统一。界面文字不再小于 12px。托盘和伙伴菜单里的旧叫法（如「宠物」「饱腹」）还没改。
• 更容易找到使用指南：页面底部的「使用指南」按钮改名「欢迎引导」，旁边新增「使用指南 ↗」打开完整的使用指南；「设置 → 关于与更新」里的功能状态改为链接到 README 的功能表。

说明文档与使用指南

• 重新整理说明文档：README 改为面向用户的概览，功能状态统一为「可用 / 部分可用 / 测试中 / 不支持」四档，已知限制集中在一处说明；校园网认证、接入点编号自动发现等尚未现场验收的能力如实标为测试中或部分可用。新增中文使用指南，分安装与更新、快速上手、庭院与伙伴、学习、校园服务、校园网与命令行、数据与隐私、常见问题；安装一页写了 macOS 版的下载、放行、更新和卸载。构建、检查与发布规则移入 CONTRIBUTING.md；英文 README 同步改写。
• 便携版的快速开始变短、入口更正：ZIP 里的「README-快速开始.txt」只留十来行要紧的说明（怎么打开、第一次做什么、数据和密码存在哪、测试版的边界），其余链接到使用指南；预约入口改为界面上实际的「校园服务 → 学习空间 → 打开学校预约」。

命令行 szunet

• 注销修复：szunet logout 现在和 login 一样使用 --ac-id、--ip 和这张网上次认证成功用的接入点编号。以前注销会忽略它们：给了 --ip 仍去解析域名，解析不到时注销失败。
• 诊断认出代理：szunet diag 会给出上面的代理提示；detect --json、diag --json 新增 srun_dns_fake_ip，表示学校域名是否被代理的 Fake-IP 接管。
• macOS 上保存过长的密码时不再弄丢原有账号：以前超过钥匙串写入上限时，会先覆盖原来的条目、再报「读回不一致」；现在写入前就拒绝并说明原因，原有账号保持不变。约 80 个字符以内的密码不受影响。
• 更正 szunet autostart 的说明：帮助以前说界面版开机后会「持续盯着网络状态、掉线自动补登」，实际只在启动时用已保存的账号连一次网，之后不会自动重连；说明已改正，行为没有变化。

验收边界：Go 测试、界面与桌面检查、Windows 从上一版安装包升级的安装与数据保留冒烟，以及两个 macOS 安装包的自动冒烟，均以本版本 CI 结果为准；自动检查不能代替真机验收，macOS 版的真机验收一项都还没做，上面「还没在真机上验收」列出的各项都待逐项确认。校园网在教学区和宿舍区的现场认证、学校账号的课表与成绩、预约完整流程和学院琴房权限仍需真实账号单独验收，本版不会因为界面和入口完成就宣称这些业务通过。Windows 安装包仍未签名，macOS 版未经 Apple 公证，都没有自动更新；校内后端和云同步未部署。

---

下载

• szuDesktop-Setup-0.9.5.exe — Windows 安装版（Electron 窗口），旁边是同名 .sha256 校验文件
• szuDesktop-0.9.5-mac-arm64.dmg — macOS 版，Apple 芯片（M1 及更新）选这个，旁边是同名 .sha256 校验文件
• szuDesktop-0.9.5-mac-x64.dmg — macOS 版，Intel 处理器选这个，旁边是同名 .sha256 校验文件
• szudesktop-beta0.9.5-windows-amd64.zip — 解压即用，旁边是同名 .sha256 校验文件
• szudesktop-windows-amd64.exe — 单文件版，与 ZIP 里的程序逐字节一致，旁边是同名 .sha256 校验文件
• 命令行版：szunet-windows-amd64.exe、szunet-darwin-amd64、szunet-darwin-arm64、szunet-linux-amd64、szunet-linux-arm64，各带同名 .sha256 校验文件

macOS 版未经 Apple 公证，需要 macOS 13 或更高版本；首次打开时到「系统设置 → 隐私与安全性」点「仍要打开」。

macOS 版目前是预览版：已通过自动化的打包、安装和启动检查，但浏览器下载后的首次放行、注销与登录时启动、系统通知、钥匙串、多显示器、macOS 13 和 14、校园网里的「本地网络」授权等，还没有人在真机上逐项验收（进度）。遇到问题请在 GitHub Issues 选「问题反馈」（需要 GitHub 账号），写明芯片（Apple 芯片或 Intel）和 macOS 版本。

What's Changed

• docs: sync beta0.9.4 release status and downloads by @Alakazamc in #27
• docs: 重构 README，新增 docs/guide 使用指南 by @Alakazamc in #28
• feat: macOS 桌面版（Electron DMG，Apple 芯片与 Intel） by @Alakazamc in #29
• fix(ci): Rosetta 下的 x64 DMG 冒烟放宽单次启动总时限 by @Alakazamc in #31
• feat: 第一批优化：校外不再误报、存档防丢、首次体验、诊断报告、安装包瘦身与任务列表整理 by @Alakazamc in #30
• release: beta0.9.5 发版准备（macOS 预览版 DMG） by @Alakazamc in #32

Full Changelog: beta0.9.4...beta0.9.5