v0.1.5

Release Note

版本

v0.1.5

重点变化

收口 issue #29 进程树治理 epic：#30/#31/#32/#33 修复 + 集成测试 + 排错文档落地。同时新增 PR 阶段轻量 smoke 门禁，避免 Windows-only 类型错误混入 tag 出包流水线。

变更明细

Added

• tauri-plugin-single-instance 防双开双起占 5409（issue #31）
• 启动前清扫残留 daemon（sysinfo + taskkill），修复 5409 端口抢占（issue #30）
• .github/workflows/ci.yml：PR 阶段跑轻量 smoke 门禁
• docs/adr/0007-daemon-process-lifecycle-cleanup.md：进程树清理决策 ADR
• docs/deployment.md §5「扫码登录异常自助排错」

Changed

• 退出从裸 child.kill() 升级为 taskkill /F /T 杀整条官方后端进程树，修复孙进程成孤儿（issue #32）
• Windows 分支也调用 child.wait() 回收 uv 子进程句柄
• CI smoke 数据目录隔离到 $ RUNNER_TEMP，避免污染 staged resources

Fixed

• 覆盖安装报 Error opening file for writing（db 被运行中进程锁住）
• Windows 编译失败：std::process::Child::id() 返回 u32 而非 Option<u32>（PR #36）
• 退出时 taskkill 调用链断档
• 重复的「空 exe 路径」单测合并

Removed

无

升级说明

下载对应平台安装包直接覆盖安装即可：

• macOS：首次打开若提示「无法验证开发者」，到 系统设置 → 隐私与安全性 → 仍要打开
• Windows：安装时若 SmartScreen 拦截，点「更多信息」→「仍要运行」

如果当前版本停留在 v0.1.4 之前且启动残留 daemon 进程导致端口占用，新版本启动时会自动清扫；若仍有异常参考 docs/deployment.md §5 排错文档。

回滚方案

1. 回退 tag：git push origin :refs/tags/v0.1.5（仓库侧撤销 release）
2. GitHub Release 标为 pre-release / 删除：gh release delete v0.1.5
3. 用户本地：卸载当前版本，从上一个稳定 release（v0.1.4）下载安装
4. 代码侧：git revert <merge-commit-of-v0.1.5> 不建议单独 revert（进程树治理属于一组协同改动），优先走「重装上一个稳定版」路径

贡献者

@RoLex