将本仓库推送到 GitHub 后，Actions 会在 main 更新、拉取请求和手动触发时运行 Windows 测试及打包。只有所有步骤通过才保存下载包。
Windows 检查会将 ZIP 解压到带中文和空格的临时目录，使用包内 Python 导入应用模块、处理 JPEG，并实际启动老师和学生网页。这一步不会使用开发电脑的 Python 来冒充便携包验证。
安装包固定使用 ngrok 3.39.11，并校验官方 Windows 压缩包的 SHA-256。官方“稳定版”下载内容发生变化时，构建会直接失败，必须明确检查并更新版本与校验值后才能继续发布。
先提交并推送改动，再创建尚未使用过的版本标签，例如：
git tag v0.4
git push origin v0.4版本格式支持 v0.4 或 v0.4.1。标签自动决定 ZIP 文件名。测试成功后，Actions 会在同一仓库的 Releases 发布 ZIP 和 SHA-256 校验文件。发布失败不会自动覆盖已有 Release；请检查 Actions 日志。
未打标签的构建包位于 Actions 运行页面的 Artifacts，保留 14 天。正式交付请使用 Releases。私有仓库的下载者需要仓库访问权限；当前配置不向其他公开仓库发布。
当前仍是便携 ZIP，但新版安装入口会处理旧版切换。将新版解压到新目录后，直接双击“安装并启动学生小档案.cmd”：程序会停止旧版后台服务、迁移旧版 app/data 与 ngrok 配置、更新桌面快捷方式并启动新版。
为安全起见，在确认新版班级、学生和照片正常前仍建议保留旧目录。不要同时手动启动两个版本。
“卸载学生小档案.cmd”只停止后台服务并删除桌面快捷方式，默认保留学生资料和 ngrok 配置，避免误删。
未来如有数据库结构变化，发布前必须增加旧数据库迁移测试。不要用旧程序打开已被新版本迁移的数据库；回退时应使用升级前备份，并先保存升级后新增的资料。