- 扩展 AGENTS.md 版本号管理规则 - 整理 changelog.md,添加 v1.2.0 版本记录 - 更新 taolun.md,添加版本管理讨论 - 更新 memory.md,添加 CI 构建经验
This commit is contained in:
55
AGENTS.md
55
AGENTS.md
@@ -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: 稳定上线版
|
||||
|
||||
Reference in New Issue
Block a user