快速发布指南

> **文档版本**: v1.0.0
> **创建日期**: 2026-02-12
> **最后更新**: 2026-02-12
> **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组
> **状态**: [最新]

---

# 快速更新指南

> ⚡ **简化后的更新流程 - 一次更新只需2分钟！**

## &#128203; 更新类型判断

### 1. 日常开发（不更新系统版本）
- Bug修复
- 小功能优化
- UI调整
- 性能优化

**操作**：
```bash
git add .
git commit -m "fix: 修复xxx问题"
git push
```

---

### 2. 重大发布（更新系统版本）
- 新增重要功能模块
- 系统架构变更
- 重要改进升级

**操作**：

#### 步骤1：编辑 `src/config/version.ts`

```typescript
// 1. 更新当前版本号
export const SYSTEM_VERSION = "v2.1.0";

// 2. 在 VERSION_HISTORY 数组最前面添加新版本
export const VERSION_HISTORY = [
  {
    id: 0,  // 总是 0，其他版本 ID 依次递增
    version: "v2.1.0",
    date: "2026-02-03",
    type: "minor",  // major | minor | patch
    title: "版本标题",
    features: [
      "功能1",
      "功能2"
    ],
    fixes: [
      "修复1",
      "修复2"
    ],
    improvements: [
      "优化1",
      "优化2"
    ]
  },
  {
    id: 1,  // 旧版本 ID +1
    version: "v2.0.10",
    date: "2026-02-03",
    type: "minor",
    title: "原标题",
    features: [],
    fixes: [],
    improvements: []
  },
  // ... 其他历史版本
];
```

#### 步骤2：提交代码

```bash
git add src/config/version.ts
git commit -m "feat: 发布 v2.1.0 - 版本标题"
git push
```

#### 步骤3：验证

访问以下页面确认更新生效：
- 首页 `http://localhost:5000` - 查看版本号
- 更新日志 `http://localhost:5000/changelogs` - 查看版本历史

**完成！** &#127881;

---

## &#128221; 版本类型说明

| 类型 | type | 说明 | 示例 |
|-----|------|------|------|
| **重大更新** | major | 架构变更、不兼容更新 | v1.0.0 → v2.0.0 |
| **功能更新** | minor | 新增功能模块 | v2.0.0 → v2.1.0 |
| **Bug修复** | patch | Bug修复、小优化 | v2.0.0 → v2.0.1 |

---

## ⚠️ 注意事项

1. **版本 ID 必须从 0 开始递增**
   - 新版本：`id: 0`
   - 旧版本1：`id: 1`
   - 旧版本2：`id: 2`
   - ...

2. **日期格式**：YYYY-MM-DD

3. **只更新 `src/config/version.ts`**
   - 不需要更新 `CHANGELOG.md`
   - 不需要更新 `package.json`（除非要发布NPM包）
   - 不需要导入知识库（重大发布才可选）

4. **首页自动同步**
   - 修改 `src/config/version.ts` 后
   - 首页和更新日志页面自动显示最新版本
   - 无需其他操作

---

## &#128269; 常见问题

### Q: 日常开发需要更新版本号吗？
A: 不需要。只有重大发布才更新系统版本。

### Q: `CHANGELOG.md` 还需要吗？
A: 可以保留，但不是必须的。建议删除以避免冗余。

### Q: 需要导入知识库吗？
A: 不需要。只有系统重大升级（如 v2.0 → v3.0）才考虑导入。

### Q: 首页怎么显示版本？
A: 首页直接读取 `src/config/version.ts`，自动同步。

---

## &#128218; 相关文档

- [开发规范](/docs/dev/standards) - 完整的开发规范
- [更新日志](/changelogs) - 系统版本历史
- [首页知识库](/) - 查看当前版本

---

**最后更新**: 2026-02-03