# 迁移指南
迁移指南记录需要用户采取动作的升级变化。它不是 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 ...`
```