| name | release-flow |
| description | AirPlayer 项目的发布流程。当用户说「发布 vX.X.X」「准备发布」「打 tag 发布」「构建安装包/绿色包并发布」时使用。完成版本号同步、文档更新、绿色包+安装包构建、打 tag 推送一整套流程。 |
AirPlayer 发布流程
执行 AirPlayer 项目从「改完代码」到「可发布」的完整发版流程。适用于用户说「发布 vX.X.X」「准备发布」「打 tag 发布」「构建安装包和绿色包」等场景。
关键约束（必须遵守）
- 版本号遵循 SemVer：
主.次.修订（如 1.1.1）。
- 提交信息用 Conventional Commits + 简体中文，如
chore: 版本升至 v1.1.1，更新 CHANGELOG/README/发布说明。
- 禁止用版本号做提交前缀（如
v1.1.1: ...）。
- 打 tag 用附注标签：
git tag -a vX.X.X -m "AirPlayer vX.X.X"。
- 推送用
git push origin main --tags。
- 本流程全段无需询问用户确认：从版本号同步到打 tag 推送一气呵成，直接执行；仅当构建失败或遇歧义时才暂停。
流程步骤
0. 确认版本号与变更内容
- 从用户消息或上下文确定目标版本号（如
1.1.1）。
- 运行
git log v<上一版本>..HEAD --oneline 列出待发布提交，归纳为本版变更（新增/优化/修复/变更分类）。
- 若用户没给版本号，根据变更类型建议：仅修复 → 修订号+1；有新功能 → 次版本+1。
1. 同步版本号到构建文件
AirPlayer.App/AirPlayer.App.csproj：<Version>、<AssemblyVersion>、<FileVersion> 三处。
<Version>1.1.1</Version><AssemblyVersion>1.1.1.0</AssemblyVersion><FileVersion>1.1.1.0</FileVersion>
tools/installer.iss：#define MyAppVersion "1.1.1"。
2. 更新 README.md
- 版本徽章：
https://img.shields.io/badge/Version-1.1.1-brightgreen?style=for-the-badge
- 构建脚本示例版本号：
tools\build-release.ps1 -Version 1.1.1 和 publish\AirPlayer-1.1.1-win-x64\（共 2 处）。
3. 更新 CHANGELOG.md
- 在顶部（紧跟标题说明区）新增
## [X.X.X] - <YYYY-MM-DD> 条目。
- 按分类列变更：
### 新增 / ### 变更 / ### 优化 / ### 修复（按实际有内容写，无则省略该分类）。
- 文件底部补链接行：
[X.X.X]: https://github.com/joyjoyfresh/Airplayer/releases/tag/vX.X.X（插在已有链接行最上方）。
- 日期取当天（用 currentDate，不要用 Date.now()）。
4. 新建发布说明
- 新建
docs/RELEASE_NOTES vX.X.X.md，参照同目录已有 RELEASE_NOTES_v*.md 的格式。
- 必含：本版更新（对应 CHANGELOG 条目）、系统要求、下载与安装（文件名带新版本号）、使用、说明、致谢。
5. 提交版本号与文档
git add AirPlayer.App/AirPlayer.App.csproj tools/installer.iss README.md CHANGELOG.md docs/RELEASE_NOTES_vX.X.X.md
git commit -m "chore: 版本升至 vX.X.X，更新 CHANGELOG/README/发布说明"
6. 一键发布（构建 + tag + push + GitHub Release）
版本号与文档 commit 完成后，直接执行，不要停下来询问用户：
powershell.exe -ExecutionPolicy Bypass -File "tools/publish-release.ps1" -Version X.X.X
脚本自动完成以下全部步骤：
- 构建绿色包 →
publish/AirPlayer-X.X.X-win-x64.zip
- 用 Inno Setup 构建安装包 →
publish/AirPlayer-X.X.X-setup.exe（需已安装 Inno Setup 6）
git tag -a vX.X.X -m "AirPlayer vX.X.X" + git push origin main --tagsgh release create 上传两个产物 + 发布说明，自动创建 GitHub Release
构建输出较大，用 tail -10 截取末尾确认 Done! 及 Release URL 即可。
注意事项
- 若构建失败：先看错误，常见是
.NET 8 SDK 或 Windows App SDK workload 缺失。
- Inno Setup 未安装时脚本会跳过安装包并打印 Warning，仍会继续发布 zip。
gh CLI 需已安装（winget install --id GitHub.cli）并完成 gh auth login；脚本会自动在 Program Files\GitHub CLI\gh.exe 查找，不依赖 PATH。- 注意：本仓库 CLAUDE.md 提到的
rtk 在此环境不可用，直接用原命令。
- 全程不停下询问用户；仅当构建失败或遇到歧义时才暂停。
