发布注记

• 1: Farrow 0.8.0：恢复更顺畅，镜像更新
• 2: Farrow 0.7.0：简化测试环境，自动恢复故障
• 3: Farrow 0.6.0：默认 U24，更顺手的本地虚拟机体验
• 4: Farrow 0.4.0：一条命令、能用的数据盘、统一的输出
• 5: Farrow 0.5.0：显式处置、显式仓库、可复现镜像
• 6: Farrow 0.3.0：显式 Catalog 与可操作的就绪诊断
• 7: Farrow 0.2.0：选点收敛与发布完整性
• 8: RC6 开发候选：Owner-scope Tier 1 交付
• 9: 开发快照：Go 1.27 产品能力面

1 - Farrow 0.8.0：恢复更顺畅，镜像更新

Farrow 0.8.0 减少初始化中断和部分节点启动失败后的手工操作，同时更新 Debian 与 Ubuntu 镜像，保留全部旧 Catalog 工件和已有 VM 身份。

主要变化

• 宿主准备接续原命令。 交互式 start、restart、reload 可以补齐宿主工具， 恢复已确认完整的 Farrow 网络。macOS 新网络安装先完成 Homebrew 发现/安装或固定 归档下载、校验，再申请管理员认证，避免 Homebrew 清除过早获取的 sudo 凭据。
• 单个节点失败不阻断独立节点。 up、start 将宿主共享目录缺失的影响限制在 对应节点；新节点准备失败时，独立的已停止节点仍可启动。错误指出源目录和挂载点， 不创建空目录掩盖问题。restart/reload/recreate 在停止已有 VM 前先检查共享能否访问。
• 恢复保留身份。 公钥缺失时从原私钥派生；私钥丢失时给出备份恢复指引，不生成 新的登录身份。macOS vmnet 日志目录恢复保留网络归属证据，避免误报自身网段冲突。
• 失败保留上下文。 重试命令保留配置、仓库和适用参数，start 的重试仍是 start。 setup 与重试使用同一操作编号；还没有部署状态时也能读取有大小上限的事件日志。 查询未缓存镜像信息不再要求 QEMU。
• 清理准确汇总最终结果。 显式删除持久盘或 purge 不再同时声称保留和删除同一磁盘。 之前删除单个节点留下的受管磁盘，不再阻断其余实验环境的销毁。

九月镜像

内置 Catalog 2026092001 包含九个 Family、37 个工件，保留前一版全部 27 个工件。 以下新 stable 均覆盖 amd64 与 arm64：

Debian 延续离线安装的 XFS 工具与已生成的 en_US.UTF-8 locale，默认仍为 C.UTF-8。 Ubuntu 保留 Canonical 原始镜像字节，部署账户和网络由 cloud-init 配置。已有 VM 和显式 锁定的镜像版本继续使用原基础镜像。仓库与更新行为见镜像参考。

安装或升级

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.8.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.8.0 ./install.sh
export PATH="$HOME/.local/bin:$PATH"
farrow version

已有实验环境在配置所在目录先查看 farrow plan，再执行 farrow up。首次使用时， 在终端执行 farrow up，准备宿主并创建默认实验环境。

Farrow 仍处于 1.0 之前，沿用 GitHub pre-release 通道，请保留显式 FARROW_VERSION。 本版包含 macOS/Linux amd64/arm64 归档、Linux DEB/RPM、校验清单、SBOM、安装器和 Homebrew Formula。其他安装方式见快速上手。

start 仍只启动已有节点；up 应用配置并重试未完成的客机初始化，不需要独立 repair 命令。测试数据盘的既有重置策略不变：证实不可用的测试文件系统可以被清空，包括持久 数据盘，并明确报告数据丢弃。设备缺失、探测失败、忙碌挂载或宿主 I/O 故障不构成 格式化依据；根盘和宿主共享目录不属于此恢复范围。

验证与限制

两台 macOS arm64/HVF 和两台 Linux amd64/KVM 完成七系统 pro 验收，每机覆盖 Rocky Linux 9.8/10.2、Debian 12.15/13.7、Ubuntu 22.04.5/24.04.5/26.04.1。 基线候选 6d7870e 使用局域网仓库完成从零初始化；运行时候选 1c054a0 随后原位安装， 通过健康重复 up、stop/start、两轮客机 SSH、数据盘访问、Ansible 配置读取和控制节点 SSH。两台 Mac 还分别通过全部七节点 Ansible ping。VM UUID、镜像身份、健康根盘与 数据盘路径/inode 保持。临时验收 VM 已在之后清理。

以下计时是单次样本，不能视作性能分布；首次 up 包含镜像下载：

发布 tag 指向 320a32afa8f6fca02592215aa0d5607ca4e852b2，相对已验收运行时只更新 README 和发布说明。完整本地 make check、发布归档/软件包检查通过， 源码 CI、独立 打包 Snapshot 与 Tag 工作流也均通过。 Tag 工作流生成 20 个发布资产，其中 19 项载荷列入校验清单。 Release 已公开，使用 GitHub pre-release 通道。20 个匿名下载均返回 HTTP 200，完整 SHA-256 与 GitHub API 及已检查 草稿一致；19 项载荷全部匹配 checksums.txt。

UX 审计与 镜像更新记录 保留此前回归、原生镜像启动与升级证据。

两个官方镜像入口都提供与发布版一致的签名 Catalog。对每个入口分别执行隔离的 farrow update，均成功验证签名并激活 revision 2026092001。每端十个新增镜像对象 均返回 HTTP 200，内容长度匹配；这不是重新下载全部公开 qcow2 正文后的完整摘要验证。

公开安装器已在 macOS arm64 与 Linux amd64 的隔离用户目录安装成功，两端 CLI 均报告 0.8.0 / 320a32a，安装后的 CLI/helper 字节与各自已校验的公开归档一致。Linux 下载 通过临时 SSH 回环转发访问已有代理，验证后已关闭。默认安装及 VM/网络状态保持不变。 这些检查验证了二进制交付；通过公开安装器重新初始化宿主并启动 VM 仍待验证。

Homebrew Tap 更新 已提供 0.8.0，四平台归档校验和与公开发布一致。本地 Formula 检查、严格在线 audit 和 原生 arm64 brew fetch 通过；Homebrew CI 也在 macOS 和 Linux 上通过元数据、更新器、样式、平台和 audit 检查。本次没有重新执行 Homebrew 安装、升级或 brew test。

这是从零 6d 基线，再用 1c 原位复验生命周期，不是 1c 再次从零初始化。Homebrew 认证 顺序有修复前失败、修复后通过的回归，但修复后的全新 Formula 安装没有再次原生重放； 本轮 macOS 网络首装使用已校验的局域网后端归档。物理宿主重启、完整 Pigsty 安装、 macOS amd64 和 Linux arm64 原生运行不属于本轮覆盖范围。

macOS 目录共享仍受已测 QEMU 目录描述符行为限制。 新前置检查改进诊断，没有实现 共享支持；pro 配置不含宿主共享。控制节点中缺失的 Guest 私钥现在会被发现，即使旧的 ready 标记仍存在，但尚未实现私钥自动重新注入。管理 SSH 可以继续使用，节点间 SSH 则明确报告限制。完整的带日期验证矩阵见当前状态。

2 - Farrow 0.7.0：简化测试环境，自动恢复故障

Farrow 0.7.0 简化测试环境的启动与恢复。重复执行 farrow up 即可继续中断的工作、 重试未完成的客机初始化，并原位更新旧的客机脚本，无需重启正在运行的虚拟机。

主要变化

• 缩短首次使用路径。 交互式 up 可以创建默认配置、准备缺少的宿主工具，并恢复 已正确安装但未运行的 Farrow 网络。短检查保持安静，长任务显示进度，完成后给出简洁结果。
• 可用的环境继续运行。 数据盘、共享目录、客机主机名、节点间 SSH 和私网分别初始化。 可选功能失败时明确报告限制，保留可用的管理 SSH；后续 up 跳过健康步骤。
• 自动恢复测试数据盘。 可用文件系统直接复用；无法识别或确认损坏的文件系统会被 清空重建并重新挂载，结果明确提示旧数据已丢弃。探测失败、设备暂缺、挂载占用和底层 I/O 故障不会触发格式化。
• 减少手工排障。 不可写的共享目录降级为只读，权限修正后重复 up 恢复；已停止 虚拟机的自动 SSH 端口被占用时重新分配。镜像传输支持续传和官方源故障切换，保留摘要校验。
• 精简输出，分离提示与状态。 成功命令给出短摘要，限制按问题分组，JSON/YAML 保留 结构化结果。客机警告单独缓存，不进入 schema-2 虚拟机状态和节点工件目录，旧版本仍可 读取并管理原有环境。

升级说明

数据盘按可丢弃的测试存储处理。up 可能清空损坏的文件系统，包括 persistent 数据盘。 persistent 表示销毁、重建虚拟机时保留盘，不表示在故障恢复时保留损坏内容。有价值的数据 请存放在这些测试盘之外。此次自动清盘不涉及系统盘和宿主机共享目录。

不增加单独的 repair 命令，恢复工作统一由 up 完成。start 继续只启动已有节点， 不应用配置；--no-wait 跳过就绪检查及客机恢复步骤。

管理 SSH 可用、但可选功能受限时返回 0。要求全部功能可用的脚本应检查 JSON/YAML 的 nodes[].warnings；数据盘重置等自动操作写入 nodes[].repairs。回退 CLI 不会恢复已丢弃 的数据，也不会回退已经安装到客机中的脚本。

旧版 0.6.0 初始化中断时，可能在安装前就删除暂存的控制节点 SSH 私钥。up 能恢复 管理访问并继续独立步骤，但密钥缺失时仍报告 control-ssh 限制；原位重试不会重新注入 私钥。需要节点间 SSH 时，先用 farrow plan 查看磁盘影响，再显式重建受影响的控制节点。

安装或升级

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.7.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.7.0 ./install.sh
farrow version
farrow up

提供 macOS/Linux 的 amd64/arm64 归档、Linux DEB/RPM、安装器、校验和、SBOM 和 Homebrew Formula。沿用 pre-1.0 规则，在 GitHub 标记为 Pre-release，安装时需指定 FARROW_VERSION。

验证范围

发布提交为 9c6d4896d93733d1cb60a7e5d8591e9a06659c9d，通过源码 CI 与独立打包 Snapshot后打 Tag。 Tag 工作流重复门禁并生成 20 个发布资产： 19 个带校验和的载荷及校验清单。检查后，20 个资产均可匿名 HTTP 200 下载，并与检查过的字节一致。

公开 macOS arm64 与 Linux amd64 安装器安装的二进制均与归档一致，并报告版本 0.7.0 与上述提交。 Ubuntu 26.04 amd64、KVM/QEMU 10.2.1、Ubuntu 24.04 Guest 隔离环境实际验证了 ext4/XFS 损坏、持久盘、 探测失败、忙碌挂载、只读共享降级和重复健康 up 保留 VM 进程。公开版 0.6.0 因管理出网探测失败而中断， 0.7.0 在 3.3 秒内接续，探测失败期间已有数据盘和 UUID 保持不变。升级后 0.6.0 二进制仍能执行 status、stop、start 与 destroy。最终 0.7.0 归档新建的 VM 无警告启动；公开安装器还在 3.2 秒内 重置了人为损坏的可丢弃 ext4 数据盘，明确提示数据丢失，同时保留 VM 进程。

特定的 0.6.0 中断现场可能在安装前删除暂存的控制节点 SSH 私钥。此升级路径中管理 SSH 会恢复， 但节点间 SSH 会明确显示 control-ssh 限制，原位重试不会重新注入私钥；需要节点间 SSH 时，先查看 farrow plan 再重建受影响的控制节点。全新 0.7.0 Guest 会正常安装该密钥。

本版本 macOS 验证包括 CLI 冒烟与交叉编译；不宣称新增 HVF Guest 重放、宿主重启、Linux arm64 或完整 Pigsty 安装验收。

3 - Farrow 0.6.0：默认 U24，更顺手的本地虚拟机体验

Farrow 0.6.0 默认使用 Ubuntu 24.04，完善本地 Pigsty 实验环境的计划、启动、扩容和重建体验。

主要变化

• 默认 Ubuntu 24.04。 新配置与内置镜像目录使用 u24:stable。目录版本 2026090501 同时纳入官方仓库已经发布的 Debian 12/13、Rocky Linux 8/9 镜像更新。
• 准备宿主前就能查看计划。 Catalog 镜像的 plan 无需先安装 QEMU 或配置网络 （已注册的 local-* 镜像仍需 qemu-img 校验缓存），展示准确镜像版本、 资源总量、待启动节点、变化字段、磁盘影响，并保留自定义 -f 路径。
• 状态和错误更清晰。 状态表直接显示镜像、CPU 与内存，异常节点不再遮住健康节点。 状态损坏报告具体文件与原因；镜像摘要错误返回 7，SSH 的 255 原样透传； --no-wait 明确说明跳过就绪检查。
• 先检查，再中断。 局部 recreate 在删除磁盘前发现同伴配置冲突；reload 在停机前 检查启动依赖。停止、销毁和运行时清理沿用现有部署锁，一致地处理状态。
• 节点名称随环境更新。 启动与删除节点后更新 Guest 内 Farrow 管理的 hosts 和控制节点 SSH 配置；同名节点重建后可以直接连接，无需手动清理 Guest 的 known_hosts。 用户 SSH 内容及全局选项的作用域得到保留。
• 减少命令行意外。 init 自定义路径给出可用的下一步命令，展示参数不再误读选项值， 整数容量与多文档 YAML 不再被静默截断。ALL_PROXY/all_proxy 提供代理回退， 同时尊重专用代理和 NO_PROXY。

升级说明

升级程序不会自动替换已有磁盘，也不会修改显式选择的镜像。旧配置若依赖隐式 Debian 13 默认值，请先在 all.vars 中加入 vm_image: d13，再使用 0.6.0 应用配置。执行变更前先看 farrow plan；farrow start 继续使用已应用状态。

CPU、内存变化仍通过 recreate 应用：根盘与非持久数据盘会被替换，持久数据盘保留。 --no-wait 跳过就绪检查和 Guest 信息刷新，之后执行 farrow up 即可补齐。 脚本应读取 --json 或 --yaml，避免依赖表格列位置；部分状态失败时仍返回健康节点与 failures 数组，退出码为 5。

安装或升级

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.6.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.6.0 ./install.sh
farrow version
farrow doctor

同一 Release 提供四个平台归档、amd64/arm64 的 DEB/RPM 软件包和 Homebrew Formula。 0.6.0 沿用 pre-1.0 发布规则，在 GitHub 标记为 Pre-release，安装器需要显式指定版本。 完整步骤见快速上手。

验证范围

生命周期与 UX 修改通过了 Claude Code Fable 5.1 / xhigh 两轮对抗性审查和完整本地 make check。隔离的 macOS arm64/HVF 环境验证了 U24 启动、扩容、控制节点到同伴的 SSH、stop/start、reload、recreate、部分状态失败和缩容；最终的 Guest SSH 作用域修复 另经真实 OpenSSH 有效配置测试验证。

Tag 工作流重复源码检查，并验证归档、软件包、SBOM、安装器、Formula、发布元数据和 校验和。这些结果不代表新增 Linux 宿主 VM 重放、宿主重启测试或完整 Pigsty 安装。

4 - Farrow 0.4.0：一条命令、能用的数据盘、统一的输出

Farrow 0.4.0 是被 0.5.0 取代的公开 pre-1.0 发布。它把首次运行压缩为一条命令，修复了 Debian 与 Ubuntu 镜像上的默认数据盘，并让全部命令使用同一套输出风格。Pigsty Inventory 格式、 固定 IP Deployment 模型、状态布局与内嵌 Catalog revision 2026082903 均未变化。

变化

• 在终端里，固定 IP 网络尚未安装时 farrow up 会自己执行 farrow setup：展示 setup 计划、在特权步骤前确认，然后继续。farrow init 的下一步提示改为 farrow up。
• vm_disks[].fs 默认值改为 auto：空白磁盘在 Guest 有 mkfs.xfs 时格式化为 XFS， 否则为 ext4，与 Pigsty 的 Vagrant 流程一致。旧的 xfs 默认值在不带 xfsprogs 的 Debian 与 Ubuntu 镜像上会失败。按旧默认值创建的 Deployment 不会被报告为漂移，持久盘 也保持兼容。
• Guest 的错误标记携带失败命令的最后一行输出，up 会报告 guest bootstrap failed during data-disks: xfs requested but mkfs.xfs is unavailable， 而不是只有退出码。
• 生命周期命令与 status 打印节点表，up 成功后给出 next: farrow ssh <node>。 没有变化时 plan 与 validate 只打印一行；image list、network status、doctor 与预检错误使用没有机器码的自然语句；spec hash 等内部信息只在 --json 中出现。 未知节点名的错误会列出现有节点。
• farrow ssh <node> -- 'df -h /data; id' 会把远程命令按 OpenSSH 的方式原样传递。

升级说明

由 0.3.0 或更早版本创建、/data 从未挂载的 d13、d12 或 Ubuntu 节点，运行一次 farrow recreate <node> 即可；这些镜像上磁盘会格式化为 ext4，Enterprise Linux 镜像上 为 XFS。在没有终端的自动化中，对未准备好的宿主机运行 up 之前仍需先执行 farrow setup --yes。

验证边界

源码 Commit 8ecb8476c7dbc934d8cbbee935ac53884d00fcdb 通过完整本地源码门禁：单测与 Race、Vet、Staticcheck、deadcode、errcheck、govulncheck、Shell 与模块检查、四目标 构建、镜像流水线与 Installer 边界、依赖许可证。Tag 工作流在公开 Release 前重复执行了 这些检查，并构建、验证了全部 Archive、原生 Package、SBOM 与 Installer。

新的首次运行路径（up 自动执行 setup）有单元测试覆盖，但本次发布前未在全新宿主机上 重放。带日期的 macOS arm64/HVF 与 Ubuntu amd64/KVM 证据仍列在状态页； 源码、打包、发布与真机证据继续作为独立门禁。

安装或升级

从 Farrow 0.4.0 GitHub Release 下载 Installer 与资产：

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.4.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.4.0 ./install.sh
farrow version
farrow doctor

同一 Pre-release 附带 Homebrew Formula 与 amd64/arm64 DEB/RPM 软件包。现有 Deployment 与 Catalog 状态仍可读取。

5 - Farrow 0.5.0：显式处置、显式仓库、可复现镜像

Farrow 0.5.0 是被 0.6.0 取代的公开 pre-1.0 发布。它为一次性实验室加入明确处置命令，让仓库地域 成为操作者的显式选择，并提供可复现的下一代官方 Guest 镜像准备路径。Pigsty Inventory 契约、Deployment 状态格式与内嵌 Catalog revision 2026082903 均未变化。

变化

• farrow purge（别名 farrow rm）无需确认，删除完整 Deployment、持久数据盘、 Deployment 密钥与状态，以及默认 SSH Fragment；已校验镜像缓存与宿主全局网络仍然保留。 没有 Deployment 时幂等成功，无法证明身份的遗留节点工件仍会 Fail-closed。
• Release 二进制默认使用 https://repo.pigsty.io/farrow。仅有长参数的 --mirror 选择 https://repo.pigsty.cc/farrow；优先级依次为 --repo、--mirror、FARROW_REPO、 全球默认仓库。两个官方根都保持规范的签名 Catalog 信任。
• Catalog Upstream URL 只用于溯源，不再作为回退。选定仓库必须包含 Catalog 指定的准确 qcow2，否则拉取会失败，并提示显式选择其他仓库或导入本地镜像。
• 源码新增 Debian 12/13、Rocky Linux 8/9 在 amd64/arm64 上的摘要锁定离线 Builder。 它记录准确软件包闭包、SBOM、Provenance 与 testing Manifest，并可组装未签名候选仓库， 留待真机 Smoke 与签名审查。
• 固定的源码/发布工具链升级到 Go 1.27.1、GoReleaser 2.18.0、golangci-lint 2.13.2 与当前选定的 Go 模块版本。

镜像边界

八目标矩阵修复具体 Guest 前置条件：Debian 12/13 加入显式 XFS 数据盘所需的 XFS 用户态 工具；Rocky Linux 8 加入 /usr/bin/python3、有效的 SSH Drop-in Include 与干净网卡命名 状态；Rocky Linux 9 同样清理旧网络状态。

这些是 Candidate 构建输入，不是新发布的 Catalog 工件。每份结果在完成真机启动/就绪 Smoke、双构建比较、生产签名、上传与 Catalog 发布前，始终保持未签名和 testing。

升级与处置

从 0.4.0 升级无需迁移状态、Inventory 或 Catalog，现有缓存镜像仍可使用。新的下载默认走 全球仓库，除非用 --mirror、--repo 或 FARROW_REPO 选择其他根。

purge 刻意设计为无交互操作，会不可逆删除 Deployment 磁盘与密钥。若要保留持久盘或只 删除部分节点，请继续使用带确认的 farrow destroy。

验证边界

Release 源码 Commit fc85b65ff6a24b0933b56ae1179be9ada2ba91b1 已通过完整本地源码 门禁：模块与 Shell 检查、单测与 Race、Vet、Staticcheck、deadcode、errcheck、 govulncheck、四目标构建、模拟镜像流水线边界、Installer 测试与准确依赖许可证校验； GoReleaser 2.18.0 也接受了发布配置。

Tag 工作流会独立重复这些检查，并在公开 Pre-release 前构建、验证全部 Archive、原生 Package、SBOM、Formula、Installer、Release Metadata 与 Checksum。源码门禁不会自动继承 新的真机 VM 生命周期证据，也不代表镜像 Candidate 已发布。

安装或升级

从 Farrow 0.5.0 GitHub Release 下载 Installer 与资产：

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.5.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.5.0 ./install.sh
farrow version
farrow doctor

同一 Pre-release 附带 Homebrew Formula 与 amd64/arm64 DEB/RPM 软件包。

6 - Farrow 0.3.0：显式 Catalog 与可操作的就绪诊断

Farrow 0.3.0 是被 0.4.0 取代的公开 pre-1.0 发布。它移除隐式 Catalog 刷新，把 Guest Bootstrap 失败变成可操作的逐节点结果，并在不改变 Pigsty Inventory 与固定 IP Deployment 模型的 前提下简化 CLI。

变化

• up、plan 与普通 image 命令只使用一份当前本地 Catalog 快照，绝不隐式获取 Catalog 元数据。farrow update 显式获取配置仓库；image sync 激活精确 URL 或文件。
• Guest Bootstrap 原子写入失败阶段。部分操作报告每个失败节点、阶段与错误；就绪失败 会直接指向 farrow logs <node>。
• 已运行 Guest 可在不重启 QEMU 的情况下复查。生命周期部分失败后，SSH 客户端配置仍会 根据全部 committed 节点重建。
• Netplan 按确定性 MAC 匹配且不再重命名接口。vm_disks[].fs: auto 优先 XFS，必要时 回退到 ext4。
• 删除冗余 ss 命令与含义模糊的根/参数短写；image reset 取代 reset-manifest，旧名称仍是别名。

验证边界

源码 Commit da6d02426da93c677c94c67fec4eb4fcecf4766a 通过完整本地源码门禁与 GoReleaser 全量 Snapshot：单测与 Race、Vet、Staticcheck、govulncheck、四目标构建、 镜像流水线与 Installer 边界、Archive/Package 一致性、依赖许可证、SBOM 和 Linux 原生 Package 校验。Tag 工作流在公开 Release 前重复执行了这些检查。

本发布不声称新增真机 VM Replay。带日期的 macOS arm64/HVF 与 Ubuntu amd64/KVM 证据 仍列在状态页；源码、打包、发布与真机证据继续作为独立门禁。

安装或升级

从 Farrow 0.3.0 GitHub Release 下载 Installer 与资产：

curl -fLO https://github.com/pgsty/farrow/releases/download/v0.3.0/install.sh
chmod +x install.sh
FARROW_VERSION=0.3.0 ./install.sh
farrow version
farrow doctor

同一 Pre-release 附带 Homebrew Formula 与 amd64/arm64 DEB/RPM 软件包。现有 0.1/0.2 Deployment 与 Catalog 状态仍可读取；Catalog 刷新从本版本开始始终显式。

7 - Farrow 0.2.0：选点收敛与发布完整性

Farrow 0.2.0 是被 0.3.0 取代的公开 pre-1.0 发布。它保留 0.1.0 引入的 Pigsty Inventory 与 磁盘 Deployment 格式，同时修复最终真机重放中发现的网络与选点收敛边界。

主要变化

• 10.0.0.0/8 等较宽 VPN 排除路由不再误拦 Farrow 自有的 10.10.10.0/24；相同或更具体的外部路由、重叠接口、已占用地址与自有路由缺失 仍然 Fail Closed。
• farrow up <node> 只下载并准备选中的节点。Inventory 中没有 State 的 desired peer 显示为 absent；SSH/hosts/provision、UUID/端口分配、生命周期与持久盘校验 使用 committed 节点集合，同时保留后续扩容意图。
• 新 Guest 写入 # farrow-deployment-host；添加当前 hosts 行前，会同时清理该标记 与 0.1.0 发布过的 # farrow-project-host。
• 未发布中间版本中的命令取消、结构化输出、确认、reload、诊断脱敏、Installer 保留策略与依赖图精简，全部直接进入 0.2.0。

真机与发布证据

准确源码 Commit 在 MonoProxy 在线时完成 macOS arm64/HVF 重放：选点创建 u24-1、 SSH、stop/start、增量创建已缓存的 el9-1、两节点 SSH、五个显式 absent peer 与 whole destroy 全部通过。在 Ubuntu 26.04 amd64/KVM 上，当前 Linux 二进制无变更地 审计了一套现存四节点 Deployment，并进入控制 Guest。

本地 make check、源码 CI 与完整 Packaging Workflow 均通过。Tag Workflow 构建 四平台 Archive、amd64/arm64 DEB 与 RPM、SPDX SBOM、Homebrew Formula、Installer、 Checksum 与 Release Metadata。GitHub Actions 将这些已验证 CI 产物上传为草稿，经检查后公开；不附加应用 签名或 Provenance Bundle。

签名镜像 Catalog 仍为 Revision 2026082903，包含 9 个 Family 与 27 个分架构工件。 默认仓库继续使用 https://repo.pigsty.cc/farrow；repo.pgsty.com/farrow 是独立验收 通过的源站/备用入口，不是编译默认值。

安装或升级

从 Farrow 0.2.0 GitHub Release 下载 install.sh 与对应构件：

chmod +x install.sh
FARROW_VERSION=0.2.0 ./install.sh
farrow version
farrow doctor

0.1.0 Deployment State 可直接读取。保留 VM 在线时运行一次 farrow status，可收敛 任何发布前进程出生身份；现有 Guest 在重建时采用新的 /etc/hosts 标记。

Farrow 尚未达到 1.0，因此 GitHub 会把 0.2.0 标为 Pre-release。

8 - RC6 开发候选：Owner-scope Tier 1 交付

Piglet 1.0.0-rc.6 是单一 Native-QEMU 路径的 Owner-scope 本地开发候选。它在两条 Tier 1 宿主上关闭了要求的 Quick 与准确四节点 full 场景，并加入 Durable 特权网络事务。 它刻意不是公开 Release。

冻结身份

四个要求的产品场景

最终八台 Full Profile Guest 全部报告 Ubuntu 24.04.4。断言完成后，项目通过 Piglet Destroy； 共享 Image Cache、Project Marker 与 Key 刻意保留。

Durable 原生网络

Network Install/Uninstall 现在使用一套 root-owned Strict-prefix Transaction：

• Root Plan 返回与 Owner/Host/Prestate 绑定的 Token；
• Apply 在宿主全局锁内重新规划，只接受该 Token；
• 第一次修改前发布类型化、Fsync Journal；
• 每个固定 Action 在验证准确 Postcondition 后 Checkpoint；
• 中断后普通 Private 修改阻止，直到显式 Forward 或 Rollback Recovery Plan 单独经 Token 批准。

Darwin 完成真实中断 Forward Recovery，最终处于默认 Host Mode 的 Protected/Healthy 状态。 Linux 在最终 Adversarial Patch 前完成真实 Install、Rollback/Retry、四节点运行、Uninstall 与宿主 恢复。最终 Patch 关闭 Socket State 规范化、过宽 Systemd Enable、NetworkManager 顺序与 Field-scoped Recovery Effect 问题，随后通过整合 Source/Race Gate。

按 Owner 最终指令，最后 Patch 后没有再运行 VM 或网络测试。因此 Post-audit Linux Install/Uninstall/Reinstall Replay 明确为未运行；本页不会把 Source/Race Evidence 升格成 原生结果。

macOS Shared Mode 与子网冲突

受支持默认仍是 socket_vmnet Host Mode。Shared Mode 在证明空闲的替代子网上通过双节点契约， 但它是显式 Fallback，不是隔离边界。

历史默认子网失败为 VMNET_SHARING_SERVICE_BUSY (1009)。VirtualBox 是合理污染候选，但未被 证明为该事故 Owner。最终迁移前立即观察到的子网 Interface 是旧 Piglet 创建的 bridge100。 Preflight 现在按身份拒绝外部 Interface，不会因为 .1/24 地址匹配而接管。操作者可以移除已确认 Owner，或把整套实验室迁移到一份带 Warning 的规范 RFC1918 /24；Piglet 永远不会只修改 Guest 地址，也不会随机选择逃生子网。

可复现本地 Archive

两棵独立本地 RC6 输出均通过严格 Release Verifier，四个 Archive、Checksum、Release Metadata 与 Formula 字节一致：

Formula 只是惰性 Build Artifact。更早候选执行过离线 RPM/DEB Consumption 与临时 Cosign/SLSA Round Trip，但这些只属于机制证据，不能改名为 RC6 Publication/Signing。

公开 GA 仍需完成

• 两条 Tier 1 的 Literal Reboot 持久性；
• macOS amd64 与 Linux arm64 的当前原生 Smoke；
• 刻意延期的 Linux 最终网络 Replay；
• 剩余 Image Normalization、字节可复现决策、Hosting 与主备 Manifest Key Custody；
• 生产 Release Identity、Signing/Attestation、公开 Homebrew/Linux Package 渠道与干净宿主消费；
• 持久 Owner-operated macOS HVF Runner 与明确发布授权。

当前维护边界见教程、设计与 当前状态。

9 - 开发快照：Go 1.27 产品能力面

Piglet 的 2026-08-24 源码快照已经远不止最初的 QEMU Spike。它现在提供一套连贯本地 VM 产品： 零配置 Quick、固定地址私有实验室、13 份 Piglet 自有 Profile、可审计 Pigsty Inventory 边界、 显式持久化/状态迁移、诊断与可复现 Release Toolchain。

它仍是开发快照，不是稳定 Release。

一套原生 Runtime

Piglet 在 macOS 通过 HVF、Linux 通过 KVM 直接驱动原生 QEMU，并负责严格 Spec Resolution、 镜像/qcow2 校验、纯 Go NoCloud CIDATA、QMP/进程身份、SSH 就绪、原子状态、Journal、Event、 Repair 与有界删除。QEMU 以调用用户运行，也不会静默回退 TCG。

没有第二 Provider/Runtime 路径，也没有任意 QEMU 参数逃生口。

两条 Tier 1 上的 Quick

保留的 Go 1.27 Quick 运行覆盖 macOS arm64 与 Linux amd64 公开无 YAML 路径。契约是 meta/dba、2 vCPU、4 GiB、64 GiB 根盘、稀疏 64 GiB /data、User NAT、SSH 与四条 回环转发约定。

产品支持 Plan、Up、Status、SSH/Exec、Stop/Start/Restart、漂移分类、受保护 Recreate/Destroy、 No-wait、持久盘保留、密钥退役、日志、Repair 与脱敏 Debug Bundle。

这些 Forward 不会安装应用；Pigsty/PostgreSQL Bootstrap 仍是独立集成门槛。

Private Lab 与宿主网络

Private 模式现在在两类 Tier 1 宿主上都有公开 Preflight/Status/Install/Uninstall。macOS 使用固定 socket_vmnet v1.2.2，默认 Host Mode，并有 Shared/FD 路径证据。Linux 使用可逆 systemd-networkd/NetworkManager/bridge-helper 事务。两者都让 QEMU 保持非特权，并在全局租约 活跃时阻止 Uninstall。

默认 10.10.10.0/24 可以被一个显式规范 RFC1918 /24 替代。Profile、宿主 Install、租约、 状态、节点地址与 Pigsty Inventory 必须一起迁移，不会随机选择冲突逃生网段。

保留的四节点 full 与 MinIO 运行在两个 Tier 1 路径验证固定 IP、控制节点独占横向 SSH、管理 互联网、存储身份、Stop/Start 持久与干净 Destroy。更早运行还覆盖 Crash Recovery 与 30/30 Soak。MinIO Profile 运行验证的是 16 块 VM 数据盘，不是 MinIO 应用。

Schema-3 自有 Profile 与 Pigsty Inventory

13 份内置 Profile 共 85 个节点，全部使用 dba。普通节点一块 128 GiB /data；MinIO 节点 四块 32 GiB 磁盘。Catalog Schema 3 自有管理 Scalability、Image Policy 与 Pigsty Inventory Binding，并包含 Direct 与 build_subset Mode。

piglet pigsty inventory 读取真实 Pigsty Source Tree，对 Host/VIP/Admin/Service Address 语义分类 校验，Rebase 协调自定义子网，并可原子发布 0600 Marker-owned 输出。pigsty-vm 通过一组小型 类型化环境变量暴露同一 Profile、网络、生命周期与 Inventory 契约。

Wrapper 没有 Provider Fallback。运维回滚是上一版已验证 Piglet Artifact 与匹配 State Backup。

持久化、升级与自动化

标记 persistent: true 的磁盘会在普通 Destroy 与兼容 Recreate 后保留。当前安全契约要求 独立 TTY Phrase，或 destroy --force --delete-persistent --yes-delete-persistent；项目密钥有独立默认 Dry-run 的 project purge-keys --yes 边界。

Schema 0→1 迁移只允许停止、要求无租约、先备份、原子并显式通过 project upgrade-state --dry-run|--yes 执行。更高 Schema 会拒绝，不会降级。

Private 节点 Selector、--no-wait、稳定 JSON、类型化退出码、Shell Completion、SSH Config、 Marker-owned Hosts Block、逐节点日志与脱敏 Support Bundle 构成当前操作者/自动化界面。

镜像与 Release 机制

内置正式镜像集合是 el9、el10、d12、d13、u22、u24、u26，覆盖两个 Tier 1 原生架构。保留矩阵记录每个架构报告 7/7；EL8 因 arm64 Kernel 无法满足已测试原生 HVF 契约而 退出 v1。生产镜像渠道与托管责任落实前，条目继续保持 testing。

源码可以构建并校验四种原生 Archive、Homebrew Formula、Linux amd64/arm64 RPM 与 DEB、 Checksum、SPDX SBOM、组合 Release Assembly，以及 Cosign Signature/SLSA Provenance 正向与 Tamper 测试。测试快照的隔离 Package Install/Verify/Remove 与两轮可复现通过；已检入 Release Workflow 尚未针对真实 Tag 执行。

证据必须跟随准确字节

在该快照时间点，Catalog Schema 3 与 Inventory 集成晚于已保留 full/MinIO 运行，因此准确 当前 Profile 仍需原生刷新；自定义子网 Hosts 发布、落实 storage.data_root/ ssh.wait_timeout 与通用 Quick User 也仍开放。

RC6 后续关闭了这些实现与准确 Profile 缺口。历史原生运行仍只对自身真实执行过的字节与行为 有效。

v1.0 前仍需完成

该快照中的准确 Profile、Pigsty Bootstrap 与 Rocky 9.8 Private-host Gate 后续已经运行。当前 剩余门槛是生产 Image/Manifest/Release 托管、持久 Runner Ownership、真实 Reboot Recovery、 Tier 2 原生 Smoke、已发布 Package 消费，以及真实签名/证明 Tag-bound Release。

当前维护边界见教程、设计与 当前状态。