SOW：论母猪的产后护理
内容提要
SOW 是 Go 编写的自包含 APT/YUM 仓库管理器，用于解决 Pigsty 维护十万级 RPM/DEB 制品的问题。它提供 Plain 与 Managed 两种模式：Plain 模式一条命令生成仓库；Managed 模式以状态机管理包池、快照与增量发布，采用“包体→元数据→指针→删除”原子协议，支持文件系统与 R2，性能大幅提升。项目经推倒重来，v0.3 聚焦大仓库性能，未来将完善上游同步、增量交付、CDN 与保留策略。
延伸解读
从脚本到状态机：仓库治理的范式转变
文章指出，当仓库规模达到十万级制品时，传统脚本方式会暴露出一系列问题：无法保证原子性、难以追踪变更、容易误删对象。SOW 的 Managed 模式将仓库抽象为状态机，引入 Desired、Built、Generation 等概念，把隐含规则显式化。这种转变意味着仓库维护从“凭经验操作”升级为“可检查、可恢复、可审计”的工程契约，尤其适合需要长期稳定运行的大型发行版。
原子发布协议：payload → metadata → pointer → de
SOW 通过严格的发布顺序确保客户端不会读到半成品仓库。先上传不可变包体，再写入以校验和命名的元数据，最后才切换 repomd.xml 或 Release 等入口指针。只有旧指针不再引用且满足保留策略后，才删除旧对象。这一协议在文件系统上依赖原子重命名和持久日志，在对象存储上则通过 commit intent 和 checkpoint 实现前滚。其核心价值是让读者要么看到完整旧代，要么看到完整新代，避免 404 或校验失败。
性能优化：从全量扫描到增量比较
面对十万级对象，传统同步工具常因全量遍历和校验而耗时十几分钟。SOW 0.3 通过多项优化提升效率：Plain 模式每个包只读取一次并并行处理；Managed 模式将包事实缓存在 SQLite 中，暖构建仅检查文件指纹，避免重复哈希。基准显示，5,000 个对象的成员展开从 4.1 秒降至 33 毫秒，50,000 个对象从十分钟以上降至约 300 毫秒。这些改进让日常小改动保持低成本，是工具能否长期使用的关键。
推倒重来的启示：最小闭环与独立验收
SOW 第一版功能庞大但耦合严重，导致正确性难以独立验证。作者选择推倒重来，先构建 Plain 和 Managed 的最小闭环，再逐步扩展。这种“一次只拿回一个边界清楚、能独立验收的能力”的策略，虽然看似更慢，实则更快。它确保每一层都有独立契约和失败语义，避免“什么都有一点，但没有哪一层能单独说清楚”的陷阱。对于基础设施工具开发，这一经验值得借鉴。
Q&A
SOW 是什么？它主要解决什么问题？
SOW 是一个用 Go 编写的自包含 APT/YUM 软件仓库管理器，旨在解决 Pigsty 维护十万级 RPM/DEB 制品时遇到的仓库治理难题，如对象存储成本、全量比较开销、在线仓库半成品暴露以及缺乏版本与快照管理。
SOW 的 Plain 模式和 Managed 模式有什么区别？
Plain 模式以包目录为唯一事实，一条命令生成仓库，索引可随时重建，不保存操作日志；Managed 模式将仓库视为状态机，管理包池、快照与增量发布，采用“包体→元数据→指针→删除”原子协议，支持文件系统与 R2，适合长期维护。
SOW 如何保证仓库更新时客户端不会读到半成品？
SOW 采用“包体→元数据→指针→删除”的发布顺序：先放入不可变包体，再写元数据与 by-hash 索引，最后才切换 repomd.xml、Release/InRelease 等客户端入口指针。客户端沿生效指针访问时，引用的内容一定已存在，因此只会看到完整旧代或完整新代。
SOW 在性能上做了哪些优化？效果如何？
Plain 路径每个包只读取、哈希、解析一次，支持有界并发；Managed 路径将包事实缓存在 SQLite 中，暖构建仅检查文件指纹，避免重复读取。基准中，5000 个对象的成员展开从约 4.1 秒降至 33 毫秒；50000 个对象从十分钟以上降至约 300 毫秒。
SOW 项目为什么经历过推倒重来？
第一版（v0.1.0）功能野心大，但仓库模型、云厂商、CDN、边缘运行时与迁移流程耦合过紧，导致正确性难以独立验证，小改动牵动大量验收矩阵。因此作者决定推倒重来，第二版从最小闭环（Plain Create、Managed Control Plane）重新构建，逐层独立验收。
SOW 未来的发展路线图包括哪些方向？
SOW 未来主要有四条线：上游仓库同步（消费 APT/YUM 上游索引并纳入统一模型）、更完整的增量交付（扩展对象存储与同步供应商覆盖）、CDN 与缓存控制（绑定精确 Generation 的 purge 与失败恢复）、版本与保留策略（用 Dist、Generation、retain 等组合表达发布节奏）。
