# mm 版本管理与发布指南

## 规则（Rules）

- 使用语义化版本号：`主版本.次版本.修订号`
- 项目版本号在 `package.json` 的 `version` 字段中管理
- 框架版本管理通过 `npm version` 命令自动更新版本号和 Git 标签

## 方法（Methods）

### 步骤1：确定版本变更类型

| 变更类型 | 版本变动 | 适用场景 |
|:--------|:---------|:---------|
| 修订号 | 1.0.0 → 1.0.1 | Bug 修复、微小调整 |
| 次版本 | 1.0.0 → 1.1.0 | 新增功能（向下兼容） |
| 主版本 | 1.0.0 → 2.0.0 | 重大重构、不兼容变更 |

### 步骤2：执行版本更新

```bash
# Bug 修复
npm version patch

# 新功能
npm version minor

# 重大变更
npm version major
```

### 步骤3：更新插件/App 版本

在 `plugin.json` 或 `app.json` 中手动修改 `version` 字段：

```json
"version": "1.1.0"
```

## 技巧（Tips）

- 开发中的版本使用 `1.0.x`，稳定发布从 `1.0.0` 开始
- `npm version` 会自动创建 Git 标签，方便回溯
- 插件和 App 的版本独立管理，不与项目主版本绑定
- 生产环境发布前确认 `package.json` 的 `version` 与 Git tag 一致