https://sow.pgsty.com/zh/tags/transaction/ Recent content in transaction on SOW Hugo zh-CN Fri, 28 Aug 2026 18:32:04 +0800 https://sow.pgsty.com/zh/blog/release/sow-v0.3.0/ Mon, 10 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/release/sow-v0.3.0/ <p>SOW 0.3.0 围绕性能、持久性与产品边界完成了一次集中改进：Plain 仓库生成只需一遍包体处理； Managed 仓库消除了逐对象成员查询，复用经过认证的软件包事实，并用有界组提交提升载荷。正式 交付的二进制与发布流水线也统一收敛到 SOW 实际支持的仓库工作流。</p> https://sow.pgsty.com/zh/blog/design/coordinated-publication/ Fri, 14 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/coordinated-publication/ <div class="td-callout td-callout--important" role="note"> <div class="td-callout__title"><i class="td-callout__icon fa-solid fa-circle-exclamation" aria-hidden="true"></i><span class="td-callout__label">SOW 0.4.0 已完成最终决策</span></div> <div class="td-callout__body"> <p>本记录的早期版本曾提议采用 rclone Executor、<code>publish --dry-run</code> 与独立 <code>sow audit</code> 命令。这些表面均未进入 0.4.0：SOW 不依赖 rclone，<code>publish</code> 没有 <code>--dry-run</code>，<code>sow audit</code> 也不是有效命令。</p> https://sow.pgsty.com/zh/blog/design/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/ <p>设计归档解释 SOW 为什么采纳某项契约、否决了哪些替代方案，以及结论实际达到了哪一层证据。 文章按 <code>date</code> 排列，记录设计理由首次形成可维护正文的日期；<code>lastmod</code> 记录后续编辑或与 实现对齐的日期。功能实际在哪个版本交付，仍以发布注记与源码 Tag 为准。</p> https://sow.pgsty.com/zh/blog/design/publication/ Sat, 08 Aug 2026 00:00:00 +0000 https://sow.pgsty.com/zh/blog/design/publication/ <p>构建与发布是两个独立状态迁移。构建产生与 target 无关的 Generation；发布把该 Generation 应用到一个供应商前缀，并记录足以在不猜测的前提下恢复的证据。</p> <h2 id="所有权拆分">所有权拆分 </h2> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">Repository 作用域</th> <th scope="col">Target prefix 作用域</th> </tr> </thead> <tbody> <tr> <td>Package Object</td> <td>Publication Attempt</td> </tr> <tr> <td>Desired 与 Built 状态</td> <td>Applied Checkpoint</td> </tr> <tr> <td>Generation 与 Changeset</td> <td>远端 inventory</td> </tr> <tr> <td>retained 包体/元数据引用</td> <td>grace 与删除证据</td> </tr> </tbody> </table> </div> <p>这项拆分避免把 filesystem 发布成功当成 R2 的证据，也避免一个 target 的半完成尝试污染另一个。</p> https://sow.pgsty.com/zh/docs/feature/transactions/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/feature/transactions/ <p>本页说明 Managed 模式如何防止 live 指针指向缺失内容，以及如何协调 SQLite 状态与文件系统变更。</p> <h2 id="不变式">不变式 </h2> <p><strong>在受支持的本地 POSIX 文件系统上，沿 Managed 协议指针读取的客户端只会得到完整旧视图或 完整新视图，包括进程中断之后。</strong></p> https://sow.pgsty.com/zh/docs/feature/audit/ Mon, 01 Jan 0001 00:00:00 +0000 https://sow.pgsty.com/zh/docs/feature/audit/ <p>每个读取表面回答不同问题。</p> <div class="td-table-scroll td-table-scroll--static"> <table> <thead> <tr> <th scope="col">命令</th> <th scope="col">问题</th> <th scope="col" style="text-align: right">写入？</th> </tr> </thead> <tbody> <tr> <td><code>status</code></td> <td>Repository 当前是什么状态？</td> <td style="text-align: right">否</td> </tr> <tr> <td><code>check</code></td> <td>所选 Repository 是否满足完整交付契约？</td> <td style="text-align: right">否</td> </tr> <tr> <td><code>changes</code></td> <td>两个 Built Generation 之间哪些物理文件不同？</td> <td style="text-align: right">否</td> </tr> <tr> <td><code>log</code></td> <td>记录了哪些操作与处置结果？</td> <td style="text-align: right">否</td> </tr> <tr> <td><code>retain ls</code></td> <td>哪些 Generation 是显式本地 GC root？</td> <td style="text-align: right">否</td> </tr> </tbody> </table> </div> <h2 id="status低成本状态"><code>status</code>：低成本状态 </h2> <div class="td-code td-code--untitled" id="td-code-25ca3326-fence-0" data-td-code data-td-code-auto-id data-td-language="bash" data-td-line-count="1"> <div class="td-code__viewport" id="td-code-25ca3326-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 status -r local</span></span></code></pre></div></div> </div> <p>它报告 Desired revision、Built Generation、dirty Dist、pending 包体计数、锁状态与 <code>ready_to_copy</code>。它不哈希公共树，不恢复操作，也不构建。</p>