发布流程（TinyCorn Studio 标准）
当用户说：“发布”、“发布 vX.Y.Z”、“推送新版本到 git”、“构建安装文件 + 发布”时适用。 运行完整流程，除非发现异常，否则不重复询问每个步骤。
前提条件
- 仓库中必须有
CHANGELOG.md（遵循 Keep a Changelog 规范），其中包含即将发布的版本的条目## [<version>] - <date>。 - 仓库中必须有构建安装文件的脚本（通常是
make-app.sh，其中包含VERSION变量）。 gh已登录并具有repo权限。- 工作树是干净的（所有功能都已提交）。
步骤
1. 升级版本（单一来源）
sed -i '' -E 's/^(VERSION=).*/\1"0.5.0"/' make-app.sh
2. 构建安装文件
./make-app.sh
ls -lh dist/
3. 更新 CHANGELOG.md
在顶部添加新条目（遵循 Keep a Changelog）：
## [0.5.0] - 2026-10-18
### Added
- ...
### Fixed
- ...
4. 提交
git add -A
git commit -m "Release v0.5.0"
5. 合并到 main（如果当前在功能分支）
git checkout main && git merge --ff-only <feature-branch>
6. 创建带注释标签并推送
git tag -a v0.5.0 -m "v0.5.0"
git push origin main --tags
7. 创建 GitHub Release 并附带安装文件
用中文编写发布说明（摘要 + “新增内容” + “安装”），保存到临时文件，然后：
gh release create v0.5.0 dist/<App>-0.5.0.dmg \
--title "v0.5.0 — <摘要>" \
--notes-file /tmp/release_notes_v0.5.0.md
8. 验证
gh release view v0.5.0
检查：标签指向正确的提交、附件已上传、说明显示正确。
自动化脚本
此仓库包含 scripts/release.sh，可对使用 make-app.sh 的 macOS 工具执行步骤 1→7：
./scripts/release.sh 0.5.0
规则
- 不要将安装文件（DMG、ZIP）提交到仓库——只将它们附加到 GitHub Releases。
dist/必须位于.gitignore中。 - CHANGELOG 和 README 必须在同一次发布中更新。
- 标签始终是带注释标签，格式为
vX.Y.Z（SemVer）。 - 发布说明用中文编写，如果应用未签名，需包含“右键 → 打开”的指导说明。
- 如果推送时遇到 403 错误：检查
gh auth status，运行gh auth setup-git，确认令牌具有对组织的权限。