参考

本节汇总 Barn 1.2.0 的全部命令、配置字段、输出格式与镜像仓库规则；版本表标明相对 1.1.0 的新增功能。需要按步骤上手操作时，请先阅读使用指南。

• 命令参考 — 全部 Linux 与 macOS 命令、完整选项表、默认值、示例与可用版本
• Linux 配置 — 清单发现顺序、变量继承、默认值、数据盘、目录共享与节点漂移规则
• CLI 契约 — 全局参数、Linux 生命周期命令、JSON/YAML 结构化输出与退出码
• Mac 运行时参考 — barn mac 子命令、虚拟机设置、JSON 输出结构、失败原因与文件布局
• Linux 镜像 — 内置镜像目录 2026110502、版本别名、仓库验签、本地导入与缓存清理
• 镜像流水线 — 面向贡献者的 Linux qcow2 候选镜像校验与离线归一化工具

Barn 的对外接口是 barn 命令行（可通过 barn version 与 barn <command> --help 查看当前安装版本）；Go 仓库 internal/ 下的包属于内部实现。镜像表对应 Barn 1.2.0 二进制内置的镜像目录快照，日常运行 barn update 即可激活更新的签名仓库元数据，无需升级可执行文件。构建与发布门禁详见发布工程。