安装

SOW 只有一个可执行文件，不需要启用服务，也不依赖语言运行时。Release 构建目标是 Linux 与 macOS 的 amd64、arm64；Linux 另外提供 RPM 与 DEB 安装包。不支持 Windows。

在下载页选择匹配操作系统与架构的归档或 Linux 安装包。页面同时提供每个 已发布制品、对应源码 Tag 与 SHA256SUMS 的链接。

安装归档

下载一个归档与 SHA256SUMS，解压前只校验对应条目：

# Linux amd64
grep '  sow_0.5.0_linux_amd64.tar.gz$' SHA256SUMS | sha256sum -c -
tar -xzf sow_0.5.0_linux_amd64.tar.gz
sudo install -m 0755 sow /usr/local/bin/sow

macOS 选择 darwin_amd64 或 darwin_arm64，并把 sha256sum -c - 换成 shasum -a 256 -c -。没有 root 时，把二进制装到已经加入 PATH 的目录，例如 ~/.local/bin。

安装 Linux 软件包

Linux 软件包使用 1PGSTY Release 后缀：

sudo rpm -Uvh ./sow-0.5.0-1PGSTY.x86_64.rpm
sudo apt install ./sow_0.5.0-1PGSTY_amd64.deb

只执行符合本机发行版与架构的那条命令。RPM 把 License 安装到 /usr/share/licenses/sow/LICENSE；DEB 把版权/协议文件安装到 /usr/share/doc/sow/。

从源码构建

Go Module 声明使用 Go 1.27.1，元数据生成不需要 C 工具链。使用与固定版本下载一致的 v0.5.0 源码 Tag：

git clone https://github.com/pgsty/sow.git
cd sow
set -euo pipefail
SOW_TAG=v0.5.0
git checkout "$SOW_TAG"
SOW_VERSION="${SOW_TAG#v}"
CGO_ENABLED=0 go build -trimpath \
  -ldflags="-s -w -X github.com/pgsty/sow/internal/v2cli.Version=${SOW_VERSION}" \
  -o sow ./cmd/sow
sudo install -m 0755 sow /usr/local/bin/sow

这组命令使用 Release 构建参数，并把所选 Tag 的产品版本写入二进制。

校验

sow version
sow help

sow version 输出产品版本、目标 OS/架构与构建 Go 工具链；sow help 列出命令树。 归档中还包含 README.md、CHANGELOG.md、Apache-2.0 LICENSE 与 THIRD_PARTY_NOTICES。

从 0.4 升级到 0.5

通过下载页安装 SOW 0.5.0，本次变更见 0.5.0 发布注记。

SOW 0.5 使用数据库 Schema v13，新增候选包池路径的查询索引，sow/v3 配置与公共布局保持 不变。先停止写入并备份整个工作区，再在普通使用前逐个迁移 Repository：

sow repo migrate REPOSITORY -C /srv/sow
sow build -r REPOSITORY -C /srv/sow
sow check -r REPOSITORY -C /srv/sow

更新后的 RPM 认证与 APT 元数据契约需要对受影响的 Dist 重建一次。之后，未变化且具有匹配 Built 证据的 RPM 不必反复读取包体验签。迁移会增加私有数据库索引，发布历史较大时需要时间 和磁盘空间；迁移后不要再使用旧版本二进制打开数据库。sow repo migrate 会报告变化，例如 schema=12->13；重复执行显示 schema=13->13。Repository 迁移之前，其写命令以 5 退出并提示 repository schema v12 predates this binary (v13); back up the workspace, then run `sow repo migrate NAME`。

备份工具必须保留硬链接，因为 DEB 的 by-hash 条目是硬链接：Linux 上可用 GNU cp -a、 rsync -aH 或 tar；macOS 的 cp -a 不保留硬链接。

Plain 仓库新增 create --metadata-timestamp，请检查实际二进制的 create --help 是否包含 该参数。默认值仍为 0，因此仅升级二进制不会修复已发布 YUM 仓库的时间戳。替换已有维护 流程前，请按 YUM 迁移指南操作。

升级 0.3 Managed Workspace

SOW 0.4 引入了内部数据库 Schema v11 与 v12，0.5 升级到 v13。公共布局和 schema: sow/v3 配置标识均不改变， 但每个既有 v0.3 Repository 都必须在普通读写前显式迁移。备份前先停止 Workspace 全部写入：

cp -a /srv/sow /srv/sow.backup-before-upgrade   # GNU cp；其他平台请用 rsync -aH 或 tar
sow repo migrate REPOSITORY -C /srv/sow
sow build -r REPOSITORY -C /srv/sow
sow check -r REPOSITORY -C /srv/sow

对 sow.yml 中的每个 Repository 重复最后三条命令。数据库 Transition 是单向的；迁移完成后 不要再用旧版本二进制打开 Workspace。状态、Signer 与 Publication Evidence 的修复范围见 sow repo migrate。

权限与可选工具

执行用户需要读取输入软件包，并能写入 Plain 目标目录或 Managed 工作区。Managed 工作区 应放在本地 POSIX 文件系统上；锁、fsync、安全路径与原子 rename 都属于正确性契约。

软件包解析与元数据渲染都在进程内完成。只有两条可选路径需要主机工具：

• RPM 包签名 需要 rpm 与可用的 GPG 环境；
• agent:// 元数据密钥需要 gpg 与 gpg-agent。

接下来可用快速上手进入 Plain 模式，或用 第一个工作区进入 Managed 模式。