核心概念

了解两种运行模式，以及工作区、仓库、Dist、包池与构建快照的关系。

选择模式

需求	Plain	Managed
为软件包目录生成索引	`sow create DIR`	用 `sow add` 导入软件包
保存配置与成员关系	目录内容就是状态	`sow.yml` 与私有 SQLite 数据库
组织软件包	一个平面目录，可同时包含 RPM 与 DEB	具名 Dist，每个 Dist 一种格式
生成架构视图	不支持	支持
过滤软件包、限制版本数	`sow prune DIR`（RPM 按 `NAME + ARCH` 保留最新版）与 `--pigsty` 清理	每个 Dist 单独配置
签名 RPM 软件包	支持	支持
签名仓库元数据	在 SOW 外单独签名	在 `sow.yml` 配置密钥
记录构建快照与发布状态	在 SOW 外管理	内置

如果目录已包含全部待发布软件包，使用 Plain。如果需要由 SOW 持续管理成员与仓库，使用 Managed。

工作区（Workspace） 保存一个或多个仓库的配置与私有状态。

仓库（Repository） 拥有自己的包池、Dist、构建历史与发布目标。对外提供完整的 pool/ 与 dists/ 目录树；把 sow.yml 和 .sow/ 留在 HTTP 文档根目录之外。

Dist 选择一种格式的软件包。例如，el9 放 RPM，bookworm 放 DEB。名称由你指定；SOW 不会检查软件包是否兼容名称所指的操作系统。

架构视图 保存某个架构的元数据。SOW 把 RPM noarch 与 DEB all 包加入每个适用的视图。

SOW 用完整包文件的 SHA-256 标识 包对象（Package Object），从包内元数据读取包名、版本与架构。

同一个仓库内，每个接受的软件包在 pool/ 下只有一条路径。多个 Dist 可以引用这条路径。不同仓库使用各自的包池。

RPM 元数据通过相对路径引用包池，APT Packages 使用相对于仓库根目录的路径。对外服务或复制时，保留完整仓库目录树。

部分镜像工具（包括默认 dnf reposync）拒绝 RPM 中指向父目录的路径。为这些工具使用 sow export rpm-leaf 导出独立 RPM 仓库。

期望成员（Desired membership） 是每个 Dist 选中的软件包集合。 Generation（构建快照） 标识一次已完成的构建及其文件清单。Built Generation 指当前已完成的构建。包文件保存在共享包池中，每次构建无需另存一份。

add / rm → 期望成员 → build → 构建快照

add 和 rm 默认在更新成员后构建受影响的 Dist。使用 --skip 时只更新成员。完成一批跳过构建的变更后，或修改构建、签名配置后，执行 sow build。

使用 sow log 查看失败或中断的操作记录。

加载评论需要启用 JavaScript。在 GitHub 上查看讨论。