MyGoNavi/docs/需求追踪/需求进度追踪-发布脚本测试版号与Mac打包无交互-20260424.md

需求进度追踪 - 发布脚本测试版号与 Mac 打包无交互

1. 需求摘要

• 需求名称：发布脚本测试版号与 Mac 打包无交互
• 提出日期：2026-04-24
• 负责人：Codex
• 目标：
  • build-release.sh 不再触发 macOS DMG/Finder 排版交互。
  • build-release.sh 与开发态应用内版本号统一使用测试版号来源。
• 非目标：
  • 不调整 GitHub Release 工作流。
  • 不修改正式发布 tag 版本策略。

2. 范围与验收

• 范围：
  • 发布脚本 build-release.sh
  • 版本解析逻辑 internal/app/version.go
  • 共享测试版号文件
• 验收标准：
  • bash build-release.sh 的 macOS 打包不再调用 create-dmg 或触发 Finder 排版。
  • 本地开发态版本显示与发布脚本默认版本号一致。
  • 保留环境变量覆盖版本号能力。
• 依赖与约束：
  • 维持现有 Windows/Linux 构建逻辑不变。

3. 里程碑与进度

• 阶段 1（需求澄清）：确认去掉 DMG 排版，统一测试版号来源
• 阶段 2（影响分析）：锁定 build-release.sh 与 internal/app/version.go
• 阶段 3（方案设计）：共享 version/dev-version.txt，macOS 改 ZIP 打包
• 阶段 4（实施计划）：先补版本回归测试，再改实现
• 阶段 5（实现与自检）：
• 阶段 6（评审与交付）：
• 阶段 7（发布与观察）：

4. 变更清单

• 已完成：
  • 新增共享测试版号文件。
  • 新增版本回归测试。
  • 改造发布脚本 macOS 打包为无交互 ZIP。
• 进行中：
  • 自检验证。
• 待处理：
  • 无。

5. 风险与阻塞

• 风险：
  • 正式发版若未覆盖 GONAVI_VERSION，默认会使用测试版号。
• 阻塞：
  • 无。
• 缓解措施：
  • 允许通过 GONAVI_VERSION 环境变量显式覆盖。

6. 决策记录

• 决策 1：以 version/dev-version.txt 作为本地开发/测试共享版本号来源。
• 决策 2：发布脚本的 macOS 产物改为 ZIP，避免 create-dmg 的 Finder 交互。

7. 验证记录

• 验证项：
  • 版本回归测试
  • 发布脚本语法检查
  • 发布脚本运行输出
• 结果：
  • 进行中
• 证据（日志/截图/链接）：
  • 待补充

8. 下一步

• 下一步行动：
  • 跑通回归测试和脚本验证，确认输出产物与版本号
• 负责人：
  • Codex