# 迁移指南

迁移指南记录需要用户采取动作的升级变化。它不是 changelog 的替代品：changelog 记录发生了什么，迁移指南说明用户如何升级。

## 版本索引

- [`0.1.x` 基线](0.1.md)：当前稳定性基线、兼容边界和未来破坏性变更记录模板。

## 记录规则

当变更满足任一条件时，必须更新对应版本迁移文档：

- 删除、重命名或改变文档化公共 API。
- 改变 `rzcli` 命令、参数、退出码语义或脚本可解析输出。
- 改变生成代码的公开类型、trait、repository 方法或默认依赖 feature。
- 改变配置字段、默认值、单位或外部 adapter 失败策略。
- 改变 metrics/logging/tracing 字段名或低基数标签枚举。
- 提升 MSRV 或改变默认 feature matrix。

## 条目模板

```markdown
### 标题

- 影响版本：`0.x.y` -> `0.x.z`
- 影响范围：crate API / CLI / generated code / config / feature / observability
- 破坏性：是 / 否
- 旧行为：...
- 新行为：...
- 迁移步骤：
  1. ...
  2. ...
- 验证命令：`cargo test ...`
```
