# 02-版本管理策略

合理的版本管理是插件维护的基础。

---

## 🎯 语义化版本（SemVer）

版本格式：`主版本.次版本.修订号`

| 版本变化 | 说明 | 示例 |
|---------|------|------|
| 主版本（Major） | 破坏性变更 | 1.0.0 → 2.0.0 |
| 次版本（Minor） | 新功能，向后兼容 | 1.0.0 → 1.1.0 |
| 修订号（Patch） | Bug 修复 | 1.0.0 → 1.0.1 |

---

## 📋 版本示例

| 版本 | 含义 |
|-----|------|
| `1.0.0` | 首个正式版 |
| `1.1.0` | 新增功能 |
| `1.1.1` | 修复 Bug |
| `2.0.0-beta` | 2.0 测试版 |
| `2.0.0-rc1` | 2.0 候选版 |

---

## 🔄 版本更新流程

### 1. 更新版本号

```json
// plugin.json
{
  "version": "1.1.0"
}
```

### 2. 更新 CHANGELOG.md

```markdown
## [1.1.0] - 2024-04-13

### 新增
- 添加天气预警功能
- 支持多城市管理

### 修复
- 修复定位失败问题
```

### 3. 创建 Git 标签

```bash
git add .
git commit -m "Release v1.1.0"
git tag -a v1.1.0 -m "Release version 1.1.0"
git push origin main --tags
```

---

## 💡 最佳实践

- 使用 GitHub Releases 管理版本
- 每个版本都写更新日志
- 测试版使用 `-beta`、`-alpha` 后缀
- 保持向后兼容，避免频繁主版本升级

---

*最后更新：2026年4月*