refactor: 重构版本号管理规则,更新文档
All checks were successful
Release / build (push) Successful in 6m29s

- 扩展 AGENTS.md 版本号管理规则
- 整理 changelog.md,添加 v1.2.0 版本记录
- 更新 taolun.md,添加版本管理讨论
- 更新 memory.md,添加 CI 构建经验
This commit is contained in:
2026-04-08 02:57:21 +08:00
parent e6ff8a887c
commit 063b14add7
4 changed files with 187 additions and 541 deletions

View File

@@ -590,9 +590,58 @@ func TestTranslator_Translate(t *testing.T) {
- 知识纠正: [memory.md](memory.md)
### 版本号管理
- 格式:主版本.次版本.修订版本(00-99)
- 更新时机测试完成后git操作前
- 递增规则:小修复第三位+1新功能第二位+1重大变更第一位+1
#### 版本格式
- 格式:`主版本.次版本.修订版本`(如 1.2.0
- 修订版本00-99超过99时递增次版本
#### 版本阶段定义
- **开发版 (0.x)**: 功能开发中可能有API变更
- **测试版 (x.0.0-beta/N)**: 功能冻结,准备测试
- **正式版 (1.0+)**: 稳定版API向后兼容
#### 版本号含义
| 位置 | 含义 | 何时递增 |
|------|------|----------|
| 主版本 | 重大架构变化/不兼容变更 | 重大重构、API不兼容 |
| 次版本 | 新功能、向后兼容 | 添加新功能模块 |
| 修订版本 | Bug修复、细节优化 | 小修复、样式调整 |
#### v1.2.0 发布标准TUI基础功能完成
- ✅ TUI交互界面
- ✅ 多行输入textarea + Ctrl+J换行
- ✅ 翻译卡片展示
- ✅ 状态栏信息
- ✅ 帮助信息Ctrl+H
- ✅ Logo版本号自动注入
- ✅ 支持至少1个厂商SiliconFlow
- ✅ 跨平台编译支持build.sh
- ✅ CI自动构建Release
#### 分支策略(简化版)
- **main**: 稳定分支,所有功能合并到这里
- **feature-xxx**: 功能分支从main创建开发完成后合并回main
- **合并方式**: 使用 `--no-ff` 保留分支历史
- **流程**: feature -> 合并main -> 测试 -> 打标签 -> 推送 -> 删除feature
#### 标签命名规范
- 正式版:`v1.2.3`
- 测试版:`v1.0.0-beta``v1.0.0-rc1`
#### 版本发布流程
1. 功能开发完成
2. 更新 changelog.md添加版本记录
3. 更新 taolun.md添加讨论记录
4. 本地测试通过
5. 合并到 main使用 --no-ff
6. 创建 annotated 标签:`git tag -a v1.2.0 -m "版本说明"`
7. 推送代码和标签:`git push && git push origin v1.2.0`
8. CI 自动构建 Release
#### 禁止事项
- 禁止删除已发布的正式版本标签
- 禁止修改已发布的 Release 内容
- 禁止在 main 分支直接发布正式版(需经过功能分支测试)
### 分支策略
- main: 稳定上线版