KaoBuddy v1.2.2 Windows 免安装包修复版

这是一个 Windows 免安装包补丁版，主要修复打开本地页面时首页 500 的问题。

修复

• 修复 PyInstaller 便携包在部分环境下找不到 backend/static/index.html，导致 /health 正常但首页显示 Internal Server Error 的问题。
• 启动器兼容 PyInstaller 的 _internal 运行目录布局，能从正确位置找到前端静态文件。
• 打包脚本在生成 exe 前会检查首页、manifest、service worker 和图标是否存在，避免再发布缺静态文件的包。

给用户的话

更新 exe 不会清空浏览器本地数据。继续用同一个浏览器、尽量打开原来的端口，原来的项目和知识点计划一般还在。

Windows 免安装 zip 会由 GitHub Actions 自动构建并附加到这个 Release。

KaoBuddy v1.2.1 Windows 免安装包

这是一个补丁版，修复用户反馈的多项目并行备考问题。

修复

• 多个项目之间的“补充要求”现在按项目单独保存草稿。
• 切换项目后，不会再把 A 项目的计划补充词带到 B 项目里，两个新项目可以各自生成计划。

给用户怎么更新

• 下载本页的 KaoBuddy-Windows.zip。
• 解压后双击 start-kaobuddy.bat 启动。
• 如果之前把旧版解压在同一个目录，建议先关闭旧启动窗口，再用新版文件夹启动。

验证

• 后端测试：26 passed
• 前端测试：42 passed
• GitHub CI：Python (3.11) / Node (22) passed

KaoBuddy v1.2.0 Windows 免安装包

这版有什么

这一版提供 Windows 免安装便携包。Windows 用户不用自己安装 Python 或 Node.js，下载 zip、解压、双击启动就可以用。

macOS 免安装包暂时不推荐发布：没有 Apple Developer ID 签名和公证时，下载包会被 Gatekeeper 拦截。Mac 用户先按 README 的源码运行或云部署方式使用。

下载

• Windows：下载 KaoBuddy-Windows.zip，解压后双击 start-kaobuddy.bat

启动后浏览器会自动打开 http://127.0.0.1:8000。填自己的 AI API Key，就可以创建考试项目、上传资料、生成学习计划。

注意

• 这是本机运行，关闭启动窗口 KaoBuddy 也会停止。
• Windows 包暂未做代码签名，可能会出现 SmartScreen 提示。确认是从本 Release 下载的 zip 后，可点“更多信息 → 仍要运行”。
• Railway 在线预览免费额度用完时不保证能访问，现在更推荐 Windows 用户下载便携包，Mac 用户源码运行或自己部署。

v1.1.0 — 云端预览版

从本地 PWA 到云端部署，补了一轮工程基础——CI/CD、日志、安全、错误处理、测试。

部署

• Docker 多阶段构建，Railway / Fly.io 一键部署
• Docker HEALTHCHECK + SPA fallback + 环境变量全量配置

CI/CD

• GitHub Actions 自动跑 py_compile + pytest + tsc + vite build

日志 & 安全

• 结构化 JSON 日志（request_id + 耗时 + 脱敏）
• CSP 安全头 + 全局异常处理 + 流式端点邀请码修复

健壮性 & 性能

• Error Boundary + SW 超时保护 + crypto polyfill
• 非阻塞字体加载 + PDF worker 懒加载（4.1MB → 1.5MB）

测试

• 后端 21 个 + 前端 36 个

完整变更

KaoBuddy v1.0.0 第一版

这是 KaoBuddy 的第一版：本地启动、自己填 API Key、导入资料、拆知识点、模块学习、模拟考 PDF 和临考速背。