TechSpar v0.3.2

TechSpar v0.3.2

v0.3.2 是 v0.3.1 之后的桌面维护版本，集中发布已经进入 main、但旧安装包尚未包含的稳定性、Provider 兼容和请求契约修复。桌面包继续内置 Electron、Web 前端、编译后的 Bun/Hono sidecar 与 ONNX Runtime，最终用户不需要另行安装 Bun、Node.js、Python、PyTorch 或 pip。

下载

• macOS Apple Silicon：TechSpar-0.3.2-mac-arm64.dmg（推荐）或 TechSpar-0.3.2-mac-arm64.zip。
• Windows x64：TechSpar-0.3.2-win-x64.exe（NSIS 安装包）。
• 完整性校验：同一 Release 中的 SHA256SUMS.txt。

重点修复

• 修复桌面端读取已保存 PDF 简历时把 Node Buffer 传给 PDF.js、导致解析被拒绝的问题；存储边界现在统一返回普通 Uint8Array。
• 修复面试自评把界面值 high / low 原样提交、触发 API confidence 数字字段校验失败的问题；所有答题请求统一经过生成契约约束的序列化边界。
• 修复桌面 sidecar 使用 exit 事件过早判定进程结束的问题，改为等待 stdio 关闭后的 close 事件，避免遗漏最后的错误输出与退出状态。
• 加固 OpenAI-compatible Provider：空响应会短暂重试并给出明确的 502 错误；结构化输出会校验实际题目数量；增加 DeepSeek JSON / reasoning 兼容参数。
• 修复设置页被密码管理器误识别、往 API 配置框自动填邮箱或密码的问题；平台 Key 与用户 Key 改为显式选择，并清楚显示当前生效来源。
• 修复流式 LLM 请求漏记用量、缓存命中量未记录、订阅时间格式导致 token 汇总错误，以及续费额度累计口径错误。
• 修复窄屏下领域复盘卡片排版，并补齐前端请求体、OpenAPI 与可空字段的契约防护。

托管与自部署说明

• 托管版新增可选的订阅、额度和爱发电订单扩展；未配置 TECHSPAR_EXTENSIONS 的自部署与桌面版不会加载付费相关路由。
• 用户自己的 LLM / Embedding Key 仍按用户隔离；配置平台共享 Key 时，已填写个人 Key 的用户继续优先使用自己的配置。
• v0.3.2 不改变桌面端现有数据目录，退出旧版本后可直接覆盖安装，SQLite、用户文件和本地模型缓存会继续保留。

升级

1. 完全退出正在运行的 TechSpar v0.3.1。
2. 下载对应平台的 v0.3.2 安装包，并可使用 SHA256SUMS.txt 校验完整性。
3. 直接安装 v0.3.2；不要同时启动旧 Python 版或让两个版本写同一份数据目录。
4. 首次打开后建议验证简历 PDF、面试提交、设置页 Provider 选择和一次完整训练流程。

发布验证

• v0.3.2 tag 必须指向受保护 main 上的版本准备提交。
• 发布前执行完整 bun run check 与 bun scripts/verify-release-version.ts v0.3.2。
• GitHub Actions 分别在 macOS arm64 和 Windows x64 runner 上构建安装包，并生成 SHA256SUMS.txt。

安装与验收边界

当前公开包没有 Apple Developer ID 或 Windows Authenticode 商业签名，因此 Gatekeeper 或 SmartScreen 可能显示安全提示。自动发布流程会分别在 macOS 和 Windows runner 上构建目标平台安装包；真实安装与启动仍建议在对应目标平台验收。