CLI
11 篇-
Barn 1.2.0 发布准备与最终验收
状态，2026-11-12：Barn 1.2.0 已作为 stable/latest 发布。下方记录最终验收结果，候选版本章节保留早期审查及其原始范围。 最终发布 标签 v1.2.0 指向 90f615804b823b4eb491101e642073dcd37a9700。源码/Mac CI与完整打包 CI在打标签前通过同一提交。437 个已审查构建输入均与候选摘要清单一致；正式打包前再次通过签名镜像目录门禁。 GitHub 签名 secrets 仍未配置，本次采用文档中的本机签名流程。Apple …
状态，2026-11-12：Barn 1.2.0 已作为 stable/latest 发布。下方记录最终验收结果，候选版本章节保留早期审查及其原始范围。 最终发布 标签 v1.2.0 指向 90f615804b823b4eb491101e642073dcd37a9700。源码/Mac CI与完整打包 CI在打标签前通过同一提交。437 个已审查构建输入均与候选摘要清单一致；正式打包前再次通过签名镜像目录门禁。 GitHub 签名 secrets 仍未配置，本次采用文档中的本机签名流程。Apple …
-
Barn 1.2.0：资源规格、根盘扩容与宿主域名
Barn 1.2.0 于 2026-11-12 发布，对应提交 90f6158。本版本新增资源覆盖、可恢复的根盘扩容、可配置生命周期并发和清单 hosts 发布。双语命令参考覆盖全部 57 个操作命令及其选项。 从 1.1.0 升级 Linux 清单未指定 CPU/内存时，默认值由 2 vCPU / 4 GiB 改为 1 vCPU / 2 GiB，已有清单也受此影响。如需保留旧默认值，请在 all.vars 中显式设置 vm_cpu: 2、vm_mem: 4GiB，保留各节点覆盖值，并在应用变更 …
Barn 1.2.0 于 2026-11-12 发布，对应提交 90f6158。本版本新增资源覆盖、可恢复的根盘扩容、可配置生命周期并发和清单 hosts 发布。双语命令参考覆盖全部 57 个操作命令及其选项。 从 1.1.0 升级 Linux 清单未指定 CPU/内存时，默认值由 2 vCPU / 4 GiB 改为 1 vCPU / 2 GiB，已有清单也受此影响。如需保留旧默认值，请在 all.vars 中显式设置 vm_cpu: 2、vm_mem: 4GiB，保留各节点覆盖值，并在应用变更 …
-
根盘原地扩容：恢复协议与真机验收
状态（2026-11-11）：未发布开发版本已实现 barn resize -D，并在 macOS/arm64 的 QEMU/HVF 客机上完成 ext4 与 XFS 验收。已发布 1.1.0 的 resize 仍只修改 CPU/内存。参数优先级见 VM 规格设计，命令契约见 根盘扩容。 使用范围 barn resize -D 128GiB meta BARN_DISK=128GiB barn resize meta 目标是根盘的绝对容量，支持扩容，不支持缩盘。已完成的同目标操作不修改镜像，也不 …
状态（2026-11-11）：未发布开发版本已实现 barn resize -D，并在 macOS/arm64 的 QEMU/HVF 客机上完成 ext4 与 XFS 验收。已发布 1.1.0 的 resize 仍只修改 CPU/内存。参数优先级见 VM 规格设计，命令契约见 根盘扩容。 使用范围 barn resize -D 128GiB meta BARN_DISK=128GiB barn resize meta 目标是根盘的绝对容量，支持扩容，不支持缩盘。已完成的同目标操作不修改镜像，也不 …
-
VM 规格参数统一设计：命令、短参数、环境变量与根盘
镜像、架构、CPU、内存、倍数和根盘组成同一组 VM 规格输入，统一名称、取值规则与来源追踪。命令声明自己接收哪些规格，以及允许应用哪些变更；解析过程只实现一份。 状态（2026-11-11）：本方案已确认，六项 CLI/环境输入、命令接入、清单生成、来源追踪、SPEC 显示和根盘原地扩容均已实现，尚未发布。工作区清单默认 1 核 / 2 GiB，已发布 Barn 1.1.0 仍默认 2 核 / 4 GiB。 六个参数，一套命名 含义 清单字段 长参数 短参数 环境变量 候选版默认值 镜像 …
镜像、架构、CPU、内存、倍数和根盘组成同一组 VM 规格输入，统一名称、取值规则与来源追踪。命令声明自己接收哪些规格，以及允许应用哪些变更；解析过程只实现一份。 状态（2026-11-11）：本方案已确认，六项 CLI/环境输入、命令接入、清单生成、来源追踪、SPEC 显示和根盘原地扩容均已实现，尚未发布。工作区清单默认 1 核 / 2 GiB，已发布 Barn 1.1.0 仍默认 2 核 / 4 GiB。 六个参数，一套命名 含义 清单字段 长参数 短参数 环境变量 候选版默认值 镜像 …
-
Main 与命令参考核对记录
核对日期：2026-11-11。 两个仓库都在 main，但工作区均不干净，也未与拉取后的远端分支一致。源码检查在本次工作区上通过；文档已补齐完整命令参考，逐项区分稳定版、本地 main 和未提交功能。 Git 与发布状态 仓库 本地 main 拉取后的 origin/main 审查开始时的状态 pgsty/barn 6ab0cd5 b2cc8da（v1.1.0） 领先 3 个提交；11 个已跟踪路径有变更，另有未跟踪的 …
核对日期：2026-11-11。 两个仓库都在 main，但工作区均不干净，也未与拉取后的远端分支一致。源码检查在本次工作区上通过；文档已补齐完整命令参考，逐项区分稳定版、本地 main 和未提交功能。 Git 与发布状态 仓库 本地 main 拉取后的 origin/main 审查开始时的状态 pgsty/barn 6ab0cd5 b2cc8da（v1.1.0） 领先 3 个提交；11 个已跟踪路径有变更，另有未跟踪的 …
-
Barn 1.1.0：镜像选择与实时进度
发布于 2026-11-09。 Barn 1.1.0 新增镜像与客机架构覆盖参数，统一实时进度表，并改进 CPU 与内存调整的恢复能力。内置签名镜像目录仍为 2026110502，涵盖 9 个发行版系列、17 个架构制品；默认镜像仍是宿主原生架构的 Ubuntu 24.04。 镜像与架构选择 plan、up、reload、recreate 和 resize 支持 --image/-I 与 --arch/-A，只覆盖本次命令的期望配置。镜像覆盖只作用于选中的节点，后续命令提示会保留节点选择、覆盖参 …
发布于 2026-11-09。 Barn 1.1.0 新增镜像与客机架构覆盖参数，统一实时进度表，并改进 CPU 与内存调整的恢复能力。内置签名镜像目录仍为 2026110502，涵盖 9 个发行版系列、17 个架构制品；默认镜像仍是宿主原生架构的 Ubuntu 24.04。 镜像与架构选择 plan、up、reload、recreate 和 resize 支持 --image/-I 与 --arch/-A，只覆盖本次命令的期望配置。镜像覆盖只作用于选中的节点，后续命令提示会保留节点选择、覆盖参 …
-
Barn 1.0.0：首个稳定版
发布日期：2026-11-05。 Barn 1.0.0 是首个稳定版。最新稳定版请参见 Barn 1.1.0。 Barn 1.0.0 完成了发布前对破坏性操作、数据盘恢复、目录完整性与进程取消的审计。本版内置签名镜像目录 revision 2026110502，其中 Debian 13 的 amd64 与 arm64 镜像均更新为 20261103.2651.1。 安装 Barn · GitHub 发布页与下载 · 变更日志 变更 整套部署重建会保留清单中缺少的节点。 不带节点参数的 barn …
发布日期：2026-11-05。 Barn 1.0.0 是首个稳定版。最新稳定版请参见 Barn 1.1.0。 Barn 1.0.0 完成了发布前对破坏性操作、数据盘恢复、目录完整性与进程取消的审计。本版内置签名镜像目录 revision 2026110502，其中 Debian 13 的 amd64 与 arm64 镜像均更新为 20261103.2651.1。 安装 Barn · GitHub 发布页与下载 · 变更日志 变更 整套部署重建会保留清单中缺少的节点。 不带节点参数的 barn …
-
保留契约，演进 CLI
Barn 已经使用 Cobra。2026-11-04 CLI 提案最值得保留的部分，是对命令语法、应用编排与外部行为的拆分。本文结合 2026-11-09 发布的 v1.1.0 源码整理这些设计；包结构拆分与较大范围的命令重组仍是提案，当前用法见 CLI 参考。 保留已有边界 cmd/barn/command_*.go 定义各命令族。每次执行都会新建 Cobra 命令树，避免参数值在多次调用间泄漏。处理函数收集 commandOutcome，由统一出口渲染文本或结构化结果；类型化错误保留退出码、 …
Barn 已经使用 Cobra。2026-11-04 CLI 提案最值得保留的部分，是对命令语法、应用编排与外部行为的拆分。本文结合 2026-11-09 发布的 v1.1.0 源码整理这些设计；包结构拆分与较大范围的命令重组仍是提案，当前用法见 CLI 参考。 保留已有边界 cmd/barn/command_*.go 定义各命令族。每次执行都会新建 Cobra 命令树，避免参数值在多次调用间泄漏。处理函数收集 commandOutcome，由统一出口渲染文本或结构化结果；类型化错误保留退出码、 …
-
Barn 0.9.3：安全扩容、按节点应用与中断恢复
发布日期：2026-10-31。 Barn 0.x 版本继续使用 GitHub 预发布频道。最新版本请参见 Barn 1.1.0。 Barn 0.9.3 聚焦于更安全的本地实验环境变更：新增只调整资源的虚拟机扩容，支持按节点独立收敛，接受清单与共享目录的普通用户路径形式，并让中断的生命周期操作可以安全恢复。 安装 Barn · 下载 0.9.3 · 源码发布说明 变更 修改 vm_cpu 或 vm_mem 后执行 barn resize [node...]。QEMU 预留容量且后端支持时会热插拔 …
发布日期：2026-10-31。 Barn 0.x 版本继续使用 GitHub 预发布频道。最新版本请参见 Barn 1.1.0。 Barn 0.9.3 聚焦于更安全的本地实验环境变更：新增只调整资源的虚拟机扩容，支持按节点独立收敛，接受清单与共享目录的普通用户路径形式，并让中断的生命周期操作可以安全恢复。 安装 Barn · 下载 0.9.3 · 源码发布说明 变更 修改 vm_cpu 或 vm_mem 后执行 barn resize [node...]。QEMU 预留容量且后端支持时会热插拔 …
-
Barn 0.9.2：签名公证的 Barn.app 与 SSH/exec 参数规范
发布日期：2026-10-30。 Barn 0.x 版本通过 GitHub 预发布渠道分发。 Barn 0.9.2 将完整的 macOS 原生客机组件纳入 Apple Silicon 下载包与 Homebrew 安装。安装一个软件包即可创建 Linux 和 macOS 虚拟机，无需安装 Go 或 Xcode。 安装 Barn · 下载 0.9.2 · 源码发布说明 变更 Darwin arm64 归档包含同一源码提交构建的 barn、barn-hosts-helper 与原生应用包 …
发布日期：2026-10-30。 Barn 0.x 版本通过 GitHub 预发布渠道分发。 Barn 0.9.2 将完整的 macOS 原生客机组件纳入 Apple Silicon 下载包与 Homebrew 安装。安装一个软件包即可创建 Linux 和 macOS 虚拟机，无需安装 Go 或 Xcode。 安装 Barn · 下载 0.9.2 · 源码发布说明 变更 Darwin arm64 归档包含同一源码提交构建的 barn、barn-hosts-helper 与原生应用包 …
-
Barn 0.4.0：一条命令、能用的数据盘、统一的输出
说明 本文为 0.4.0 历史发布记录。旧版发行附件已下线，安装当前版本请参见安装指南。 Barn 0.4.0 将首次使用收敛为一条命令，修复了 Debian 与 Ubuntu 镜像上默认数据盘因缺少 xfsprogs 无法格式化的问题，并统一了全套 CLI 的输出风格；Pigsty 清单格式、固定 IP 部署模型、状态目录结构与内置镜像目录修订版 2026082903 保持不变。 主要变化 一条命令完成首次启动。 在交互式终端中，若宿主机尚未安装固定 IP 网络，运行 barn up 会自动 …
说明 本文为 0.4.0 历史发布记录。旧版发行附件已下线，安装当前版本请参见安装指南。 Barn 0.4.0 将首次使用收敛为一条命令，修复了 Debian 与 Ubuntu 镜像上默认数据盘因缺少 xfsprogs 无法格式化的问题，并统一了全套 CLI 的输出风格；Pigsty 清单格式、固定 IP 部署模型、状态目录结构与内置镜像目录修订版 2026082903 保持不变。 主要变化 一条命令完成首次启动。 在交互式终端中，若宿主机尚未安装固定 IP 网络，运行 barn up 会自动 …