命令行参考 on SOW

sow create

Mon, 01 Jan 0001 00:00:00 +0000

sow create 把一个已经放着 .rpm / .deb 的目录变成平面仓库（flat repository）：在包旁边写出索引文件。它就是 Plain 平面模式的全部——没有 sow.yml、没有 SQLite、不做工作区发现。本页讲清扫描规则、原子的 --pigsty 兼容操作，以及 --sign-with 的 RPM 包签名。

sow init

Mon, 01 Jan 0001 00:00:00 +0000

sow init 创建根级 sow.yml 与私有状态目录 .sow/，这两样东西让一个目录成为工作区（Workspace）。它同时也是手写配置的收敛命令：如果 sow.yml 里已经声明了 Repository 与 Dist，init 会把还不存在的那些实体化出来，已完成的原样跳过。

sow config

Mon, 01 Jan 0001 00:00:00 +0000

sow config 有两个只读子命令。config check 是对 sow.yml 的全量预检——每次手工改完配置以及在 CI 里都该跑一遍。config show 打印 SOW 实际算出来的配置，用它确认默认值、继承的架构与规范化别名是不是按你预期解析的。

sow repo

Mon, 01 Jan 0001 00:00:00 +0000

一个仓库（Repository）独占一份 pool/、一份 dists/、一个 SQLite 数据库与一个私有状态目录。它是锁、事务恢复、Generation 编号与 Changeset 的边界——跨仓库不去重，也不承诺跨仓库原子提交。 sow repo 管理的就是这条边界。

sow dist

Mon, 01 Jan 0001 00:00:00 +0000

Dist 是一个仓库内、单一格式（rpm 或 deb）的具名包集合。客户端指向的就是它。一个仓库可以同时拥有 RPM Dist 与 DEB Dist，两者共用一份 pool/，但渲染进完全独立的 dists/ 子树。

sow add

Mon, 01 Jan 0001 00:00:00 +0000

sow add 是主要的写入路径。它解析你指定的包，从包头推导格式与架构，执行 Dist 的成员策略，并且—— 除非你加 --skip——在返回前重建全部受影响的索引。命令退出码为 0 时，客户端已经能看到新包了。

sow rm

Mon, 01 Jan 0001 00:00:00 +0000

sow rm 把包从你选定的 Dist 的期望成员集中拿掉，并默认立即重建受影响的索引。它绝不从 pool/ 删除字节——成员关系与内容是两个概念，而且系统没有垃圾回收。

语法

sow rm PACKAGE... [-c|--check] [--skip] [-j|--jobs N] [-C|--workdir DIR] [-r|--repo NAME] [-d|--dist NAME]... [-T|--timeout DUR | -N|--no-wait] [--json]

参数

参数	说明	默认
`-c, --check`	只预览：计算并打印方案，不写任何东西	关闭
`--skip`	只更新期望状态，不构建	关闭
`-j, --jobs N`	并发 worker 数	逻辑 CPU 数
`-C, --workdir DIR`	工作区发现的起始目录	当前目录
`-r, --repo NAME`	选择一个仓库	按选择规则
`-d, --dist NAME`	选择一个 Dist；可重复	按选择规则
`-T, --timeout DUR`	等待锁的最长时间；`0` 无限等待	`0`
`-N, --no-wait`	锁被占用时立即失败	false
`--json`	输出版本化 JSON envelope	false

--check 与 --skip 互斥：

sow ls / show / where

Mon, 01 Jan 0001 00:00:00 +0000

三条命令回答三个不同的问题。ls 列出一个 Dist 应该包含什么，show 详细查看某一个包对象，where 找出哪些 Dist（跨仓库）在提供某个包。三者都是只读的，不取写锁，共用同一套 --json envelope。

sow build / status / check / changes

Mon, 01 Jan 0001 00:00:00 +0000

一个概念一条命令。status 是便宜的读，check 是完整校验，build 是唯一会改变公开树的命令， changes 给出两代之间的物理文件差分。四条放在一页，因为你几乎总是一起用它们。

sow log

Mon, 01 Jan 0001 00:00:00 +0000

仓库内的每条写命令，都会先在该仓库的 SQLite 中提交一条应用级 Operation，然后才产生任何外部文件副作用。这条记录让崩溃恢复成为可能——而当 Operation 进入终态之后，同一条记录就是你的审计轨迹。 sow log 读的就是它。