https://sow.pgsty.com/zh/tags/repository/ Recent content in repository on SOW Hugo zh-CN Fri, 28 Aug 2026 18:32:04 +0800 https://sow.pgsty.com/zh/blog/design/evolution/ Mon, 10 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/evolution/ <p>本文对应 2026-08-10 围绕 Repository Core 完成的 SOW 收敛决策。它从早期规划、ADR、评审、 迁移与验证目录中提炼值得维护的结论，但不会把每份过程制品都变成另一套产品文档。</p> https://sow.pgsty.com/zh/blog/design/model/ Sat, 08 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/model/ <p>SOW 刻意把模型分层：配置表达意图，数据库记录有主状态，公共树是确定性投影。 任何一层都不能悄悄替代另一层。</p> <h2 id="对象层级">对象层级 </h2> <div class="td-code td-code--untitled" id="td-code-327f10ed-fence-0" data-td-code data-td-code-auto-id data-td-language="text" data-td-line-count="10"> <div class="td-code__viewport" id="td-code-327f10ed-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">Workspace </span></span><span class="line"><span class="cl">├── Repository </span></span><span class="line"><span class="cl">│ ├── Package Object </span></span><span class="line"><span class="cl">│ ├── Dist </span></span><span class="line"><span class="cl">│ │ └── Membership -&gt; Package Object </span></span><span class="line"><span class="cl">│ ├── Desired 状态 </span></span><span class="line"><span class="cl">│ ├── Built Generation </span></span><span class="line"><span class="cl">│ └── Retained Generation 引用 </span></span><span class="line"><span class="cl">└── Publication Target </span></span><span class="line"><span class="cl"> └── Repository + provider + prefix</span></span></code></pre></div></div> </div> <h3 id="workspace">Workspace </h3> <p>Workspace 提供发现、配置与协调，拥有 <code>sow.yml</code>、私有 <code>.sow/</code> 目录和稳定锁路径； 它不是包体去重域。</p> https://sow.pgsty.com/zh/blog/design/principles/ Sat, 08 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/principles/ <p>SOW 首先不是一个“元数据生成器”，而是一个所有权与状态迁移系统，只是它的输出恰好是 APT 与 RPM 仓库。下面这些原则让整套系统保持可推理。</p> <h2 id="每个持久事实只有一个主人">每个持久事实只有一个主人 </h2> <p>每类持久事实都只有一个作用域与权威：</p> https://sow.pgsty.com/zh/blog/design/single-payload/ Wed, 05 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/single-payload/ <p>这项决策起草于 2026-08-05 的 v0.2 发布前设计收敛阶段，并在 2026-08-08 随 SOW v0.2.0 正式交付，随后延续为 v0.3 与 v0.4 的布局契约。它记录的是架构选择，不是笼统的兼容性 PASS：协议闭包、普通软件包客户端、镜像工具、静态托管与对象存储始终属于彼此独立的证据层。</p> https://sow.pgsty.com/zh/docs/feature/managed/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/feature/managed/ <p>当同一个仓库要维护好几个月 —— 包成批到达、由策略决定谁留下、事后还得说清楚什么时候变了什么 —— 你需要的是 Managed 模式。本页讲三层模型、它产出的布局,以及命令怎么判断你说的是哪个仓库、哪个 Dist。</p> https://sow.pgsty.com/zh/docs/start/workspace/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/start/workspace/ <p>Managed 模式会持久保存配置、成员关系、Generation 与审计状态。下面从空目录开始。</p> <div class="td-steps td-max-width-on-larger-screens"> <h2 id="1-初始化工作区">初始化工作区 </h2> <div class="td-code td-code--untitled" id="td-code-fb3ccf08-fence-0" data-td-code data-td-code-auto-id data-td-language="bash" data-td-line-count="2"> <div class="td-code__viewport" id="td-code-fb3ccf08-fence-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sow init /srv/sow </span></span><span class="line"><span class="cl"><span class="nb">cd</span> /srv/sow</span></span></code></pre></div></div> </div> <p><code>init</code> 创建：</p> https://sow.pgsty.com/zh/docs/command/repo/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/command/repo/ <p>一个仓库（Repository）独占一份 <code>pool/</code>、一份 <code>dists/</code>、一个 SQLite 数据库与一个私有状态目录。它是 锁、事务恢复、Generation 编号与 Changeset 的边界——跨仓库不去重，也不承诺跨仓库原子提交。 <code>sow repo</code> 管理的就是这条边界。</p> https://sow.pgsty.com/zh/docs/reference/layout/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/reference/layout/ <p>SOW 的 Managed 布局只有一种：软件包体在 <code>pool/</code> 下只存一份，<code>dists/</code> 只保存客户端视图元数据。对外服务、复制或发布时,单位始终是完整仓库目录。</p> <h2 id="plain-模式">Plain 模式 </h2> <p><code>sow create</code> 在现有软件包旁写入索引,不修改无关文件:</p> https://sow.pgsty.com/zh/docs/start/concepts/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/start/concepts/ <h2 id="plain-还是-managed">Plain 还是 Managed </h2> <p>两条运行路径相互独立。</p> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col"></th> <th scope="col">Plain</th> <th scope="col">Managed</th> </tr> </thead> <tbody> <tr> <td>入口</td> <td><code>sow create DIR</code></td> <td><code>init</code>、<code>repo</code>、<code>dist</code>、<code>add</code>、<code>rm</code>、<code>build</code></td> </tr> <tr> <td>状态</td> <td>软件包目录</td> <td><code>sow.yml</code> 加私有 SQLite/操作日志</td> </tr> <tr> <td>公共布局</td> <td>平面 RPM/DEB 索引</td> <td>Repository <code>pool/ + dists/</code></td> </tr> <tr> <td>格式</td> <td>RPM 与 DEB 可共存于一个目录</td> <td>每个 Dist 一种格式</td> </tr> <tr> <td>架构视图</td> <td>无</td> <td>有</td> </tr> <tr> <td>策略与审计</td> <td>无</td> <td>有</td> </tr> <tr> <td>元数据签名与发布目标</td> <td>无</td> <td>有</td> </tr> </tbody> </table> </div> <p>目录内容已经等于目标仓库时使用 Plain。需要由 SOW 管理成员、策略、Generation、签名、 审计或发布时使用 Managed。</p>