# 发布说明

## 版本入口

软件版本统一维护在 `app_version.py`：

- `APP_NAME`：软件名称
- `APP_VERSION`：软件发布版本

发布新版本时，优先修改这里，不要直接改界面标题字符串。

## 版本规则

建议使用语义化版本：`主版本.次版本.修订号`

- `1.0.0`：首个正式版
- `1.1.0`：兼容性新功能
- `1.1.1`：问题修复
- `2.0.0`：不兼容变更

## Git 管理建议

- `main`：始终保持可发布状态
- 功能开发使用独立分支
- 每次发布打 Git Tag，例如 `v1.1.0`

建议命令：

```powershell
git checkout main
git pull
git checkout -b feature/xxx
```

完成功能后：

```powershell
git add .
git commit -m "feat: xxx"
git checkout main
git merge --no-ff feature/xxx
```

发布时：

```powershell
git add app_version.py RELEASE.md
git commit -m "release: v1.1.0"
git tag v1.1.0
git push
git push origin v1.1.0
```

## 打包流程

当前打包入口：`pqAutomationApp.spec`

推荐发布步骤：

1. 修改 `app_version.py` 中的 `APP_VERSION`
2. 更新本文件中的变更说明
3. 提交代码并打 Tag
4. 执行打包命令
5. 将 `dist/pqAutomationApp` 复制为带版本号的发布目录

打包命令：

```powershell
pyinstaller pqAutomationApp.spec
```

建议发布目录命名：

- `PQAutomationApp_v1.1.0`
- `PQAutomationApp_v1.1.0_20260416`

## 每次发布前检查

1. 版本号是否已更新
2. 关键功能是否回归测试
3. `dist/` 和 `build/` 是否未提交到 Git
4. 发布说明是否已更新
5. Tag 是否与版本号一致

## 变更记录模板

每次发布可按下面格式补充：

### v0.1.0

- 首次建立版本发布机制
- 软件标题显示版本号
- 增加 `.gitignore`
- 增加发布流程文档