参考
Barn 读取的 Pigsty Inventory 与命令行的准确契约。
本参考描述 Barn 0.9.0 发布候选。Barn 只使用新名称与全新的 Barn 状态，
不提供旧开发版本的兼容或迁移层。编写脚本前先核对 barn version，
发布进度见当前状态。
- 配置：发现顺序、变量、默认值、磁盘、共享、命名与漂移。
- 命令行：命令、关键参数、输出模式与退出码。
- Mac 命令：尚未发布的
barn mac的命令、JSON 结果与失败原因。 - 镜像：签名 Catalog、别名、本地缓存、拉取、导入与清理。
- 镜像流水线：Candidate 校验与离线归一化。
Barn 不提供受支持的 Go Library API；internal/ 下的包都是实现细节。
Barn 读取的 Pigsty Inventory 字段、默认值与节点级漂移行为。
Barn 命令、关键参数、结构化输出与退出码。
barn mac 的命令与参数、机器规则、JSON 结果、失败原因、网络与文件。
签名 Catalog、内置别名、仓库选择、本地缓存校验、导入与清理。
不下载、不上传、不签名地校验或离线归一化显式 qcow2 Candidate。