发布注记

• 1: pig v1.8.1
• 2: pig v1.8.0
• 3: pig v1.7.0
• 4: pig v1.6.2
• 5: pig v1.6.1
• 6: pig v1.6.0
• 7: pig v1.5.1
• 8: pig v1.5.0
• 9: pig v1.4.2
• 10: pig v1.4.1
• 11: pig v1.4.0
• 12: pig v1.3.4
• 13: pig v1.3.3
• 14: pig v1.3.2
• 15: pig v1.3.1
• 16: pig v1.3.0
• 17: pig v1.2.0
• 18: pig v1.1.1
• 19: pig v1.1.0
• 20: pig v1.0.0
• 21: pig v0.9.0
• 22: pig v0.8.1
• 23: pig v0.8.0
• 24: pig v0.7.5
• 25: pig v0.7.4
• 26: pig v0.7.3
• 27: pig v0.7.2
• 28: pig v0.7.1
• 29: pig v0.7.0
• 30: pig v0.6.2
• 31: pig v0.6.1
• 32: pig v0.6.0
• 33: pig v0.5.0
• 34: pig v0.4.2
• 35: pig v0.4.1
• 36: pig v0.4.0
• 37: pig v0.3.4
• 38: pig v0.3.3
• 39: pig v0.3.2
• 40: pig v0.3.1
• 41: pig v0.3.0
• 42: pig v0.2.2
• 43: pig v0.2.0
• 44: pig v0.1.4
• 45: pig v0.1.3
• 46: pig v0.1.2
• 47: pig v0.1.1
• 48: pig v0.1.0
• 49: pig v0.0.1

1 - pig v1.8.1

Pig v1.8.1 是 v1.8.0 之上的安全、正确性与维护版本。 本版本加固命令初始化、提权日志访问、仓库与构建流程、发布完整性，以及结构化输出脱敏； 同时刷新内置扩展目录，并将构建工具链升级到 Go 1.27.1 与 cargo-pgrx 0.19.2。 内置 Pigsty 版本仍为 4.5.0。

CLI 安全与正确性

• 只读且不依赖配置的命令不再要求 HOME 可写，也不会把创建 ~/.pig 当作查询副作用； 叶子命令会保留自己声明的初始化策略。
• pig pg log、pig pt log 与 pig pb log 通过 sudo 切换数据库 OS 用户时完整保留参数， 并拒绝不安全的日志文件链接。
• pig do 在执行前校验 Pigsty 名称，并拒绝 Ansible 保留的集群目标。
• PostgreSQL 原生角色检测绑定到用户选中的实例，而不是无关的本机默认实例。
• 结构化结果会遮盖凭据、许可证材料与构建代理标识符，同时保持真实的失败状态。

仓库与构建加固

• 仓库添加与删除在任一请求失败时整体返回失败，对模块选择去重，并保持替换边界。
• 离线缓存包拒绝不安全路径、链接、特殊文件与不完整输入；归档解压继续采用有根、失败关闭的实现。 生产路径迁移到结构化结果后，删除了仅由测试引用的旧导出缓存包装。
• 构建源码与制品校验会拒绝不完整或不安全输入；pig build proxy 使用软件包提供的服务契约， 参数保持可选，结构化输出不再泄露秘密标识符。
• 自更新会验证发布校验和；发布工具拒绝脏工作区、错误 tag，以及覆盖不可变制品。

工具链与扩展目录

• Go 升级到 1.27.1，Logrus 升级到 1.10.2，GoReleaser 升级到 2.18.0， golangci-lint 升级到 2.13.2。
• pig build pgrx 默认安装 cargo-pgrx 0.19.2；如果某个扩展的目录元数据要求旧版 pgrx， 仍可通过 -v 显式选择。
• 内置目录从维护中的 pgext 视图刷新：新增 acdat 0.1.0，将已被取代的 pgcontext_pgvector 标记为 removed，并更新软件包版本、仓库归属、PostgreSQL 覆盖与可用性矩阵。

验证

本版本从源码提交 e3d1eb4 构建。该精确提交通过完整 CI 工作流， 覆盖随机顺序测试、命令 race 回归、vet、静态分析、死代码检查、漏洞扫描与 GoReleaser snapshot。 随后 tag 通过 Release 工作流，生成并发布 RPM、DEB、macOS 与 Linux 制品。

兼容性提醒

• 本版本没有移除 CLI 命令或参数。
• 如果旧脚本依赖只读命令顺便创建本地配置，应改为显式准备所需状态。
• pgrx 默认值变为 0.19.2；构建特定扩展时，仍以该扩展的目录元数据为准。

校验和

制品：GitHub Release · checksums.txt

2 - pig v1.8.0

Pig v1.8.0 将 Pigsty 控制节点的准备过程原生化。两条核心安装命令 pig sty boot 与 pig sty conf 现在是具备完整失败处理能力的 Go 工作流， 不再包装旧版 bootstrap 与 configure Shell 脚本。本版本继续以 575 个已打包 PostgreSQL 扩展 作为统一发布口径，内置 Pigsty 4.5.0。

原生 pig sty boot

pig sty boot 现在是一套具备事务语义与完整失败处理的原生控制节点引导流程。它不再执行 <PIGSTY_HOME>/bootstrap，HTTP 下载与归档解压也不依赖 curl、wget、tar 或 gzip。

权限与就绪检查

• 普通用户可以直接发起命令。Pig 会在一次 sudo 自重启前解析并下载显式来源； PIG_NO_SUDO=1 可禁用提权，PIG_NON_INTERACTIVE=1 可要求非交互 sudo。
• Debian 12/13 会在安装控制节点软件包前检查 locale，并在新软件包可能补齐工具后按需重试。
• 就绪判定会实际执行 ansible-playbook，发现其 Python 解释器，并检查 yaml、jmespath， 以及 cryptography 或 OpenSSL 两者之一；只有二进制文件但无法运行的 Ansible 不再产生假成功。

仓库来源与事务

• 来源覆盖本地归档、HTTP(S) URL、经过权限检查的自动 /tmp/pkg.tgz、已经提交的 /www/pigsty 仓库，以及区域在线仓库。显式来源无效时直接失败，不会悄悄转为在线引导。
• 已完成的 /www/pigsty 优先于选中的离线包。Pig 可以自行建立预期的 /www -> /data/nginx 布局，以受限解压提交离线内容，并在离线模式下只启用严格的 pigsty-local 仓库；在线模式会安装内嵌的 Pigsty 密钥，并保持仓库签名校验开启。
• 默认覆盖策略会备份仓库定义，仓库或软件包准备失败时自动恢复；--keep 使用增量策略， 在线刷新失败时可以利用现有定义重试。
• 结果会明确标记 ready、offline、online 或 existing 模式。即使 Ansible 已经可用， 显式、自动发现或已提交的离线来源仍会被准备。

收尾检查与自动化

• Pig 会探测控制节点辅助工具，为发起调用的管理员用户修复到 127.0.0.1 的密钥 SSH， 并尽可能从在线或本地内容初始化缺失的 ~/pigsty。
• locale、辅助工具、本机 SSH 与 Pigsty 目录初始化失败属于告警；显式输入无效、仓库或软件包 操作失败、安装路径不受支持，以及安装后 Ansible 仍不可用，仍然是硬错误。
• JSON/YAML 使用 pig.sty.boot/v2 结果契约，包含模式与软件包管理器、仓库策略与回滚状态、 来源路径、locale、SSH 与初始化状态、变更、告警，以及后续 conf、inventory 与 deploy 命令。

原生 pig sty conf

pig sty conf 现在是一套完整的原生 Inventory 编译流程。它不执行 ./configure，也不会 回退到原始 Shell 行为：Pig 解析一个模板、执行有边界的结构化变更、校验完整候选，最后才提交 输出文件。

安全配置流水线

• 默认模板为 conf/meta.yml；安全的斜杠分隔相对模式既可作为位置参数，也可通过 --conf 指定。绝对路径、目录穿越、路径逃逸，以及通过直接路径、符号链接、带符号链接父目录或硬链接 造成的源/输出别名都会被拒绝。
• 源模板解析与 IP 冲突检查先于外部预检；解析、变更、预检或校验失败都不会改动目标文件。
• Pig 执行原生 Inventory 校验，并在 ansible-inventory 可用时进行一次有时间边界的外部 解析；成功结果以 0600 权限原子写入。

Inventory 结构化变更

• 最多十个互不相同的 --ip 地址会同时映射到 10.10.10.10 至 10.10.10.19，VIP 等 无关地址保持不变。未指定 --ip 时，交互、非交互与输入关闭场景都有明确且确定的选择行为。
• --domain 只替换精确的 i.pigsty；CPU 少于四核的控制节点会自动从 oltp 节点与 PostgreSQL 调优配置切换为 tiny。
• 区域变更会更新 all.vars.region；china 会启用模板中已有的 Docker 与 pip 镜像。 --proxy 将可用的代理环境变量写入 all.vars.proxy_env。
• 通用模板支持 PostgreSQL 14-18 与显式指定的 19 beta，包括匹配的 locale 与 beta 仓库； 固定版本的 mssql、polar 与 pgNN 模式保留模板实际版本并产生告警。
• --generate 为每个已知凭据标识符分配一个 24 位随机值，并一致更新生效值与文档占位符； 结果只列出生成的标识符，绝不输出机密值。

预检与结果契约

• 未指定 --skip 时，预检覆盖平台、软件包管理器、控制节点资源、sudo/管理员权限、本机 SSH 与 Ansible 可用性；conf/build/ 下的构建模板有意绕过 IP 映射与管理员预检。
• JSON/YAML 使用 pig.sty.configure/v1，报告模板与输出、已选择和丢弃的地址、请求与实际 PostgreSQL 版本、已应用选项、生成的机密标识符及告警。

其他更新

• EL8 及以上软件包操作统一优先使用 DNF；本地 RPM 依赖按提供能力解析；新建软件仓库时恢复 预期的 /www 布局；自更新可容忍 latest 标记中的空白字符。
• 例行刷新扩展目录、软件包版本、元数据与可用性矩阵，发布的 PostgreSQL 扩展数量保持 575。
• CI 与发布构建使用 Go 1.26.6、固定版本的分析工具与 GoReleaser，并执行依赖校验、 工作流检查、漏洞扫描与完整发布快照构建。

兼容性提醒

• pig sty boot 不再执行 <PIGSTY_HOME>/bootstrap；依赖 Shell 脚本副作用的自动化应改为 使用原生命令及其结构化结果。
• pig sty conf --raw 已移除。请使用原生工作流；--conf MODE 仍然可用，等价的位置参数 形式为 pig sty conf MODE。
• pig sty conf --ip 可接受最多十个逗号分隔的 IPv4 地址；--skip 与 --ip 仍互斥。 大写 -O 选择 Inventory 文件，全局小写 -o 选择命令输出格式。
• EL8 及以上使用 DNF；有限的 EL7 兼容目录继续保留独立的传统 YUM 路径。

校验和

制品：GitHub Release · checksums.txt

3 - pig v1.7.0

Pig v1.7.0 是 v1.6.2 之上的仓库兼容性与目录更新版本：明确中国镜像选择语义，默认保留 DNF 原生模块过滤，恢复精简的 EL7 仓库目录，并将内置扩展快照从 572 个增加到 575 个。内置 Pigsty 版本仍为 4.5.0。

主要变化

• -m|--mirror 现在直接选择内置的 china 仓库定义。PGDG、Rocky Linux、Debian、Ubuntu、Docker 等区域路由使用维护中的镜像列表，不再进行旧版运行时 PGDG 代理改写。
• EL 仓库不再全局注入 module_hotfixes=1。确实需要覆盖模块流的 Pigsty 与 PGDG 仓库会显式启用；BaseOS、AppStream、EPEL 等普通仓库继续使用 DNF 原生模块过滤。
• EL7 保留有意精简的兼容目录：面向 x86_64 的 CentOS 7 Base/Updates/Extras/SCLo 与 EPEL 归档源，以及共享的 Pigsty 和仍受支持的 PGDG 条目。渲染 EL7 YUM 配置时会移除仅适用于 DNF 的 module_hotfixes。
• 当目录中没有匹配当前平台的仓库定义时，仓库设置会明确报告平台不受支持，而不是继续处理空仓库集合。
• 发布元数据升级到 1.7.0，内置 Pigsty 版本保持 4.5.0。

扩展目录

• 已打包扩展数量从 572 增加到 575，没有移除项。
• 新增 3 个扩展：pg_local_cache 1.2.0、pg_statviz 0.1.0、pg_policy 0.1.0。
• 版本更新包括 biscuit 3.0.0、pg_clickhouse 0.10.0、pg_search 0.25.2、pg_turbovec 软件包 1.29.0、pg_uuid_v8 1.1.0，以及 Debian q3c 2.0.5 软件包。
• 刷新软件包元数据与可用性矩阵；需要比本版本内置快照更新的目录时，请运行 pig ext reload。

兼容性提醒

• 本版本没有移除命令或全局参数。
• -m|--mirror 现在明确选择中国区域，不再进行 PGDG 代理改写。需要固定路由时请使用 --region=default|china|europe。
• 自定义 EL 仓库如果确实需要覆盖模块流，现在必须显式设置 meta.module_hotfixes: 1；普通操作系统仓库会有意省略该设置，EL7 上则会移除它。
• EL7 已停止维护，仅提供有限兼容性；当前 PostgreSQL 与扩展软件包应优先使用 EL8 或更高版本。

校验和

制品：GitHub Release · checksums.txt

4 - pig v1.6.2

Pig v1.6.2 是 v1.6.1 之上的功能与目录更新版本：已打包扩展从 562 个增加到 572 个，新增 Grafana 仪表盘 schema v2 原生支持，并改进本地软件仓库生成流程。内置 Pigsty 版本继续锁定为 4.5.0。

主要变化

• pig sty grafana 现在同时支持传统仪表盘 JSON 与原生 dashboard.grafana.app/v2 Dashboard 资源。载入 v2 仪表盘时使用 Grafana resource API，确保标签页与 section 变量可以完整往返；导出到现有 v2 文件时保持 v2 格式，新文件默认仍使用传统格式。
• pig repo create 在 SOW 可用时优先执行 sow create --pigsty --timeout 10m -- <dir>，要求生成的 repo_complete 完成标记存在且为普通文件；Linux 上仍可回退到 createrepo_c / dpkg-scanpackages。
• macOS 现在可通过 SOW 创建本地软件仓库，默认使用当前目录且无需 sudo；Linux 默认目录仍为 /www/pigsty。
• 发布元数据升级到 1.6.2，内置 Pigsty 版本保持 4.5.0。

扩展目录

• 已打包扩展数量从 562 增加到 572，没有移除项。
• 新增 10 个扩展：pg_turbovec、pg_disorder、pg_mentat、plruby、jsonb_plruby、hstore_plruby、ltree_plruby、pg_describe、cat_tools、pg_vault_tde。
• 更新 12 个扩展版本：timescaledb 2.29.1、q3c 2.0.5、pgmnemo 0.16.1、pg_search 0.25.1、citus 14.2.0、citus_columnar 14.2.0、provsql 1.12.0、plpgsql_check 2.10.4、pg_rational 0.0.3、pgbson 2.1.0、pg_readme 0.7.1、pg_readme_test_extension 0.7.1。
• 刷新软件包元数据与可用性矩阵；运行 pig ext reload 可以用最新在线目录替换内置的发布快照。

兼容性提醒

• 本版本没有移除命令或全局参数。
• 安装 SOW 后，pig repo create 会优先使用 SOW 而非传统 Linux 生成器，并在报告成功前检查完成标记是否存在。
• 目录总数不代表每个包都适用于所有 PostgreSQL / 操作系统 / 架构组合；请在目标主机上使用 pig ext avail NAME 查看实际可用矩阵。
• 包管理器与安装脚本会使用配置的软件仓库中已经发布的最新版本，可能晚于 GitHub；需要精确获取本版本时请使用 GitHub 制品。

校验和

制品：GitHub Release · checksums.txt

5 - pig v1.6.1

pig v1.6.1 是 v1.6.0 之上的维护版本：没有新增命令，也没有参数变更， 这次发布的重点是二进制里自带的那份扩展目录。

变更内容

• 扩展目录刷新：内置的 extension.csv 依据 Pigsty 软件仓库重新生成，pig ext list 与 pig install 无需先跑一次 pig ext reload，即可对齐当前的软件包版本。
• Pigsty 版本对齐到 4.5.0：pig sty 与 pig status 报告的内嵌 Pigsty 版本随之更新。
• 版本号同步：构建元数据与 pig update 的版本字符串一并更新。

v1.6.1 发布包内置的目录覆盖 PostgreSQL 14–18 上的 562 个已打包扩展， 适用于 EL 8/9/10、Debian 12/13、Ubuntu 22/24/26，x86_64 与 aarch64 双架构。 运行 pig ext reload 后，这份发布快照可能会被更新的在线目录替换。

升级方式

pig update                 # 通过系统包管理器就地升级
pig update -v 1.6.1        # 或者指定精确版本

全新安装会直接拿到 v1.6.1：

curl -fsSL https://repo.pigsty.cc/pig | bash   # 中国大陆镜像
curl -fsSL https://repo.pigsty.io/pig | bash   # 全球站点（Cloudflare CDN）

如果只想刷新目录、不升级二进制，也可以：

pig ext reload             # 把最新目录下载到 ~/.pig/extension.csv

完整版本历史见 发布注记。

6 - pig v1.6.0

Pig v1.6.0 是一个大版本：pig pt 重写为 patronictl 原生透传，新增根级 pig inventory 命令组提供 pigsty.yml 的无损编辑与校验（附带实验性的 PostgreSQL CMDB 交换能力），pig sty grafana 提供原生 Grafana 仪表盘管理，已打包扩展目录增至 562 个。

主要变化

• pig pt 重写为 patronictl 原生透传：所有集群命令（list、restart、switchover、failover、edit-config 等）直接转发，使用原生参数、交互确认、输出与退出码，patronictl 的新功能无需等待 pig 发版即可使用。本地保留 status、log、set、service/svc 辅助命令，新增 -c/--config-file、-d/--dcs-url、-k/--insecure 选项与 pig pt -- … 逃逸写法。
• 新增根级 pig inventory 命令组（别名 inv）：status / list / show / edit / validate / check / diff —— 无损 YAML 引擎逐字节保留注释、格式、键序与锚点；edit 先校验再原子写入，非法 YAML 不可能落盘。
• 新增 实验性 pig inventory cmdb 子命令（check / init / load / dump / enable / disable），通过原生驱动与 Pigsty 的 PostgreSQL CMDB 交换配置清单，破坏性操作带超时限界与摘要锁定的确认门。
• 新增 pig sty grafana（别名 gf）通过 HTTP 原生管理 Grafana 仪表盘：info / list / boot / load / init / dump / clean / lang / style。pig sty 命令面简化：移除 sty edit / validate / check / cmdb / dashboard / release，改用 pig inventory、pig sty grafana 与 pig sty list / get。
• 可靠性强化：仓库 / 目录 / 下载写入全部原子化（中断不再留下半截文件）；结构化输出 -o json|yaml 下 stdout 只包含结果信封，被包裹命令的输出走 stderr；退出码更精确（用法错误 → 2，缺少 --yes 确认 → 7）；Ansible 列表变量改用 JSON 编码防注入。
• 仓库刷新：MySQL 仓库升级到 8.4 LTS，新增 Percona XtraBackup（pxb84）与 MySQL Tools 仓库，Kubernetes 升级到 v1.36，LLVM apt 覆盖 Debian/Ubuntu 26，Percona TDE 改用 repo.percona.com 官方源，移除 wiltondb 仓库。
• 工具链：Go 1.26.5，新增原生 PostgreSQL 驱动（pgx v5），内置 Pigsty 版本 4.4.0。

扩展目录

• 已打包扩展数量从 531 增加到 562；PGEXT.CLOUD 总目录收录 2230 个扩展。
• 新增 33 个扩展，包括 pg_lake 家族（pg_lake、pg_lake_table、pg_lake_engine、pg_lake_iceberg、pg_lake_copy）、pg_jieba、pg_cjk_parser、pg_fts、pgmonitor、pgmemento、pg_tiktoken_c、online_advisor、pgsqlmock、plx 等。
• 移除 2 个：pg_analytics、spat；刷新 58 个扩展版本，包括 vector 0.8.5、timescaledb 2.28.3、pg_search 0.24.3、pg_tde 2.2.1、powa 5.2.0。
• 包别名与 Pigsty 同步：kafka 更名为 kafka-stack；Debian/Ubuntu 的 postgresql 别名收窄为仅 postgresql-$v（完整开发套件请用 pgsql / pgsql-full）。

兼容性提醒

• ⚠ pig pt failover <name>：位置参数现在是 集群名 而不是晋升候选成员 —— 请改用 pig pt failover CLUSTER --candidate MEMBER，升级前务必检查 failover 自动化脚本。
• pig pt 位置参数改为原生的集群优先形式（restart CLUSTER [MEMBER]）；转发命令返回 patronictl 原生退出码、由 patronictl 自行交互确认（-y 不再门禁这些命令），且不再支持 -o json（请改用原生 --format json）。pig pt config 由 pig pt set K=V 与原生 show-config / edit-config 取代。
• 结构化输出模式下，被包裹工具的输出移至 stderr，stdout 只有 JSON/YAML 信封 —— 请更新解析混合输出的脚本。
• pig inventory edit 编辑成功后会将配置文件权限收紧为 0600（文件可能包含数据库凭据）。

校验和

7 - pig v1.5.1

Pig v1.5.1 是一次构建与仓库维护版本，更新了多款 PG 内核分支包。

主要变化

• 镜像/代理模式覆盖 repo、build、sty、update、ext update 等流程；pig build rust -m 会写入 Cargo 镜像配置并使用 rsproxy.cn。
• 新增 PostgreSQL 19 beta 的 repo、tool、pgrx 显式构建开关：pig build repo --beta、pig build tool --beta、pig build pgrx -b；稳定默认值仍保持 PostgreSQL 18 与 PG14-18 窗口。
• 刷新 IvorySQL、PolarDB、OrioleDB、OpenHaloDB、Babelfish、pgEdge 套件等内核与 fork 包别名。
• 改进 Cloudberry 套件构建流程，覆盖 cloudberry、cloudberry-backup、cloudberry-pxf。
• 刷新 Cloudberry、Babelfish、OrioleDB、pgEdge、PolarDB、polarstore、zlog、libpgfeutils、libfq 等源码与包元数据。
• 改进较新 EL release 字符串处理，包括 EL9.6+ / EL10+ 上的 PGDG 仓库，以及 EPEL 在 EL10 上使用的 10z stream。
• 刷新扩展版本，包括 pg_ivm 1.15、spock 5.0.10、snowflake 2.5.0、pg_tde 2.2、decoderbufs 3.6.0、IvorySQL 5.4 包。

校验和

8 - pig v1.5.0

Pig v1.5.0 是一次面向 PostgreSQL 日常运维的版本：新增本地数据库 clone / fork 工作流，明确 pg、pt、pb、pitr 的职责边界，并收紧高风险操作的预览、确认与结构化输出行为。

主要变化

• pig pg 更聚焦本地 PostgreSQL 操作。新增 pig pg clone 用于快速创建数据库级副本，新增 pig pg fork 用于创建一次性物理实例分叉，适合本地验证、恢复演练和隔离实验。
• 恢复流程拆得更清楚：pig pitr 作为 Patroni / PostgreSQL / pgBackRest 的恢复编排入口；pig pb restore 保持为低层 pgBackRest restore 原语。恢复命令现在必须指定明确目标，并提供更具体的 plan 与恢复后指引。
• Patroni 操作更可预期：pig pt restart、reinit、switchover、failover 等高风险操作统一由 Pig 负责确认与 plan 输出；pig pt config pg 会提示是否需要 pig pt restart --pending。
• 自动化脚本更安全：结构化输出不再隐式确认破坏性操作，执行高风险动作需要显式 -y/--yes；--plan 与 next_actions 更一致，方便先预览、再执行。
• 日志与状态输出更适合排障：pg、pb、pt 的日志命令补齐 latest / tail / show / grep 等常用入口，结构化日志快照使用 JSONL 语义。
• 构建与发布默认值更新：Pig 版本为 1.5.0，内置 Pigsty 版本为 4.4.0，pig build pgrx 默认 cargo-pgrx 升级到 0.19.1。

扩展目录

• 可用扩展数量从 524 增加到 531，没有移除项。
• 新增扩展：pg_ducklake、pgdisablelogerror、pg_stat_log、pg_stat_plans、passwordpolicy、db2fce、plpgsql_wrap。
• 刷新一批已有扩展版本与包元数据，代表性更新包括 timescaledb 2.28.2、postgis 3.6.4、vector 0.8.4、biscuit 2.4.1、citus 14.1.0、orioledb 1.8、documentdb 0.113、credcheck 5.0、pgtt 4.5。
• orioledb alias 不再固定到 PG17，而是按请求的 PostgreSQL 主版本解析；EL9 ARM64 Patroni alias 也调整为 noarch 包。

兼容性提醒

• 自动化执行破坏性操作时请使用 -y/--yes；结构化输出模式不会再替代人工确认。
• pig pb restore / pig pitr 需要明确指定一个恢复目标；自动 promote 类行为请使用 --target-action=promote。
• 若干易混淆短参数经过整理；日志命令的 -o json 表示 JSONL 快照，不用于 tail / follow 这类流式交互场景。

校验和

9 - pig v1.4.2

• 内置扩展目录从 510 个可用扩展刷新到 524 个，新增 14 个扩展：pg_stl、pgmnemo、psql_bm25s、pg_orca、pg_sorted_heap、graph、pgrdf、fsm_core、jsonschema、pg_durable、pg_mockable、pg_uuid_v8、pg_stat_backtrace、pg_projection。
• 更新 48 个已有扩展的软件包元数据，包括 timescaledb 2.28.0、timescaledb_toolkit 1.23.0、pg_task 2.1.29、pg_search 0.24.0、pg_clickhouse 0.3.2、pg_graphql 1.6.1、documentdb 0.112、toastinfo 1.7、wrappers 0.6.1、pgclone 4.3.2 等；没有扩展被移除或降级。
• 新增 PostgreSQL 19 beta 的安装、构建、配置支持。PG19 可以作为显式指定的安装版本使用，但自动探测、目录展示与 latest alias 的稳定默认版本仍保持为 PostgreSQL 18。
• 新增 pg19 软件包别名与 PG19 分类别名解析。PG19 分类别名借用 PostgreSQL 18 的可见性模板，并且 beta 软件包展开只包含 PGDG 来源条目。
• pig sty conf -v 19 会在模板支持时自动启用 beta 仓库模块；当模板没有针对 PG19 beta 调优，或无法自动启用 beta 仓库时，会给出明确警告。
• 修复 Patroni 集群操作：patronictl restart、reinit、switchover、failover 现在会传入解析出的 CLUSTER_NAME；pig pt list 也支持可选集群名参数。
• pig build pgrx 的默认 pgrx 版本从 0.18.0 升级到 0.18.1。
• 发布元数据更新到 v1.4.2，刷新 Go module checksum，并补充 PG19 alias / 配置生成与 Patroni cluster-scope 行为的针对性测试。

校验和

10 - pig v1.4.1

• 扩展目录更新到 510 个扩展，新增 3 个扩展，更新 17 个扩展。
• 新增 Ubuntu 26.04 resolute 支持，移除 Ubuntu 20.04 focal 支持。
• 将 el9.aarch64 特例中的 patroni / patroni-etcd 提升到 4.1.2。
• 校准上游软件仓库定义。

校验和

11 - pig v1.4.0

• 刷新扩展目录，可用扩展总数增加到 510，并更新 timescaledb 2.26.3、decoderbufs 3.5.0、pgclone 4.0.0、nominatim_fdw 1.3 等版本。
• 默认 pgrx 从 0.17.0 升级到 0.18.0，同步对齐相关 Rust 扩展构建版本。
• 为 pig build get 刷新权威源码包映射，覆盖 Cloudberry / OrioleDB 构建输入，以及 RDKit / OneSparse 相关附加源码。
• 修复 repo set 标志位隔离问题，并修正 PostgreSQL schema 级维护 SQL。
• el9.aarch64 上的 patroni 升级到 4.1.1。

校验和

12 - pig v1.3.4

扩展数量更新至 504 个。

校验和

13 - pig v1.3.3

• 扩展目录刷新，可用扩展总数增加到 481 个。
• Go 工具链从 1.26.0 升级到 1.26.2。

扩展更新

校验和

14 - pig v1.3.2

例行维护版本。

• 例行刷新部分扩展版本元数据与扩展目录条目，扩展版本更新。
• 新增 pig pg tune 子命令，可根据硬件资源与工作负载画像生成 PostgreSQL 调优参数建议。
• 为 pig build get 新增 pdu 与 pgdog 两个源码包 alias。
• 调整 pgext.cloud 的 URL 至新版本的扩展目录 pigsty.io/ext

校验和

15 - pig v1.3.1

这是从 v1.3.0 到 v1.3.1 的一次小型维护版本。

• 由于 PGDG 上游已移除 PG13 归档与分发，pig 同步移除 PG13 安装/构建支持。
• 活跃支持的 PostgreSQL 主版本现在为 14-18。
• 扩展目录刷新（461 -> 464），新增 pg_pinyin、pg_eviltransform、qos。
• Percona PPG 上游仓库更新到 18.3。
• 修复 pig build 依赖/构建同步问题，rsync 增加 --keep-dirlinks 参数。
• YUM 仓库中 Nginx 从 infra 模块拆分为独立模块索引（nginx）。

校验和

16 - pig v1.3.0

这是从 v1.2.0 到 v1.3.0 的一次工程强化与目录扩展版本：15 commits、74 files changed、代码行 +1184 / -236。

该版本重点围绕 pig build 构建链路和 ext 目录/别名能力增强，并将可用扩展数量从 451 增加到 461。

主要变化

• 构建源码下载增强（pig build get）：
  • 支持从扩展 Source 字段解析多源码（空格/换行/Tab 分隔）并去重。
  • 新增 agensgraph / agentsgraph 源码映射。
  • pgedge 构建源码改为同时下载 postgresql-17.9.tar.gz 与 spock-5.0.5.tar.gz。
• 依赖解析与安装优化（pig build dep）：
  • RPM 依赖安装可从 spec 的 pgmajorversion 宏推断 PG 主版本，spec 缺失改为显式报错。
  • DEB 依赖解析支持 Build-Depends / Build-Depends-Arch / Build-Depends-Indep 的多行、候选依赖、架构限定与 profile 清理。
  • 支持 PGVERSION 占位符自动展开（优先 --pg，其次已安装版本与扩展元数据）。
  • 依赖安装失败降级为 warning，批量流程继续执行。
• DEB 构建结果判定修正（pig build ext/pkg）：
  • 构建命令退出码成功即判定成功，产物发现改为 best-effort 警告，避免误判失败。
  • 成功但无产物时不再显示空包列表横幅；部分产物场景标记 warning 而非 fail。
  • 构建日志中的源码与版本显示改为读取扩展元数据真实值，避免错误拼接 name-version。
• 扩展操作输出语义改进（pig ext rm/update）：
  • 别名解析后，removed/updated 返回值改为“实际包名”，方便自动化脚本精确比对。
• 扩展目录与别名更新：
  • 新增别名：agensgraph / agens、pgedge、babelfishpg。
  • openhalodb 对齐 PG14 包命名，ivorysqldb 命名对齐。
  • fork 元数据与可用性矩阵批量刷新（含 timescaledb、pgmq、orioledb、documentdb、pg_tde、babelfishpg_* 等条目）。
• 工程与发布：
  • 版本号提升到 v1.3.0（包含 v1.2.1 过渡提交），版权年份更新到 2026，README 同步更新到 461 扩展与最新 alias 说明。

兼容性提醒

• pig ext rm/update 结构化输出中的 removed/updated 字段由扩展名切换为包名；如果你的自动化逻辑按扩展别名匹配，请同步调整。

新增扩展（451 -> 461）

完整提交列表（v1.2.0..v1.3.0）

• b8ecf8d 版本字符串更新到 1.2.1
• 55df9a4 build/get 支持多源码解析与 pgedge spock 源码
• da8e347 新增 agensgraph 和 pgedge 别名
• 86edbd7 ext rm/update 输出显示解析后的包名
• ef3c905 build/dep 改进 rpm/deb 依赖解析
• 7144e09 刷新 fork 元数据与可用性矩阵条目
• befffbf DEB 构建将成功命令视作权威结果
• 33fd517 DEB 成功但无产物时不再显示空包列表横幅
• 3b450f2 下载源码时避免将扩展名与版本错误拼接
• 33847ab ext rm/update 满足 staticcheck S1011
• b8b917d 依赖安装失败降级为 warning
• 8110c00 调整 ivorysqldb / babelfishpg 别名
• fac9faf 版本提升到 1.3.0
• 1f88f06 版权年份更新为 2026
• c804757 v1.3.0 发布提交

校验和

17 - pig v1.2.0

• 扩展目录与别名解析增强：

  • 引入动态 PG 分类别名解析，按 PG 主版本选择别名映射。
  • 引入 OS 维度别名覆盖（ansible/bootstrap），并在未知发行版回退中收敛为 PGDG-only。
  • 新增 node/infra、babelfish/cloudberry 等别名并更新扩展元数据，减少包解析歧义。

• 高风险操作计划预览：

  • 新增 pig install --plan，支持结构化执行计划输出。
  • 统一 pig pitr 与 pgBackRest repack/expire 的计划预览语义。
  • 新增 plan flag 一致性测试，确保子命令行为对齐。

• sty 原生配置能力：

  • 新增 pig sty configure 命令及完整执行流（preflight、参数处理、执行编排）。
  • 统一 sty conf/configure 行为，默认走原生实现并保留 --raw 回退。
  • 补充 configure 主流程、preflight、路由与安装联动测试，提升可维护性。

• 仓库/构建/可靠性修复：

  • 修复 repo cache 在 os.Stat 错误场景中的 nil dereference。
  • 对齐 Ubuntu 与 Debian 仓库 channel 映射，补充 reload 镜像拉取超时控制。
  • 加固 repo rm 对 dotted module 名称的安全删除与路径校验。
  • 修复 sty init 与 build 相关符号链接保留、跨设备迁移与目标目录处理问题。
  • 改进文本输出与矩阵配色渲染，修复 ext 命令空参数与空目标校验问题。

• 35 Commit，66 文件变更，代码行：+5006 / -379

• PG 扩展与内核包更新

校验和

18 - pig v1.1.1

修复

• 在迁移构建目录时保留符号链接语义，并支持跨文件系统移动。
• 正确处理被配置为文件系统根目录的 PostgreSQL 日志目录，防止解析到预期目录之外的文件。
• 允许 pig repo rm 删除名称中带点号的仓库模块，同时保留安全路径校验。
• pig sty init 解压 Pigsty 发布包时允许安全的相对符号链接。

校验和

19 - pig v1.1.0

该版本是从 v1.0.0 到 v1.1.0 的一次规划中架构级升级（79 commits，193 files 变更）， 核心目标是把 pig 从“人类可用 CLI”推进到“Agent-native 可编排 CLI”。

新增七个扩展，总可用扩展数量达到 451 个。

新功能

• Agent-native 统一输出框架落地：引入全局 --output（text/yaml/json/json-pretty），为 ext/repo/pg/pt/pb/pitr/status/version/context 等命令提供统一 Result 结构、稳定状态码与可机器解析输出。
• 引入 ANCS（Agent Native Command Schema）元数据体系：为命令补齐 type/volatility/parallel/risk/confirm/os_user/cost 等语义字段，help 在结构化模式下可直接输出命令能力树，便于 Agent 自动发现能力与风险边界。
• 新增 pig context（pig ctx）环境快照命令：一次调用聚合主机、PostgreSQL、Patroni、pgBackRest、扩展信息，专门面向 Agent 工作流做上下文注入。
• Plan 能力从 PITR 扩展到更多高风险动作：新增 pig ext add/rm --plan、pig pg stop/restart --plan、pig pt switchover/failover --plan，并统一为可审阅执行计划（动作、影响面、风险、预期结果）。
• 结构化结果覆盖进一步完善：pgbackrest info 可嵌入原生 JSON 信息，Patroni/PostgreSQL/PITR/Repo/Ext 子系统的结构化返回与辅助 DTO 统一，兼容自动化消费。
• 兼容层增强：对 pg_exporter/pg_probe/do/sty 等存量命令引入 legacy structured wrapper，在保留旧交互行为的同时提供结构化执行结果与输出捕获。
• Pigsty 版本更新至 v4.1.0

扩展更新

Bug 修复

• 安全修复：修复 pig build proxy 在异常地址输入下的解析 panic 问题。
• 安全修复：修复 pig pg log 文件名路径穿越风险，阻止通过 ../../ 访问日志目录外文件。
• 安全加固：加强 installer/repo 路径处理与引号处理，降低路径注入与异常路径误用风险。
• 构建链路可靠性修复：pig build get/pkg/ext 在下载或构建失败时正确传递错误并返回非零退出码；修复 DEB 构建中 pg_ver 不匹配导致的误报失败。
• 仓库与目录刷新修复：ext/repo reload 支持静默镜像回退；repo add/set/rm 在缓存更新失败时正确返回错误状态。
• 扩展管理修复：ext update 调整为显式目标更新并修复状态漂移问题；ext import 将请求的 DEB 资源下载到指定 repo 目录。
• 输出与可观察性修复：修复结构化输出 exit code 与文本渲染一致性问题；修复 pg status 权限处理与解析稳定性问题。

校验和

20 - pig v1.0.0

本版本引入三组主要的新子命令（pig pg、pig pt、pig pb），用于管理 PostgreSQL、Patroni 和 pgBackRest，同时新增编排式 PITR 命令，并增强扩展可用性显示。

新增命令

• pig pg - PostgreSQL 实例管理

  • pg init/start/stop/restart/reload/status - 控制与管理 PostgreSQL 实例
  • pg role/promote - 检测和切换实例角色（主库/从库）
  • pg psql/ps/kill - 连接与会话管理
  • pg vacuum/analyze/freeze/repack - 数据库维护操作
  • pg log - 日志查看（list/tail/cat/less）

• pig pt - Patroni 集群管理

  • pt list/config - 查看集群状态与配置
  • pt restart/reload/reinit - 管理集群成员
  • pt switchover/failover - 集群切换操作
  • pt pause/resume - 控制自动故障切换
  • pt start/stop/status/log - Patroni 服务管理

• pig pb - pgBackRest 备份管理

  • pb info/ls - 查看备份信息
  • pb backup/restore/expire - 备份操作
  • pb create/upgrade/delete - Stanza 管理
  • pb check/start/stop/log - 控制操作

• pig pitr - 编排式时间点恢复

  • 自动协调 Patroni/PostgreSQL
  • 多种恢复目标：时间、LSN、XID、还原点
  • 支持计划预览模式与恢复后指引

新功能

• 为 pig ext avail 和 pig ext ls 添加可用性矩阵

改进

• 统一 pg/pt/pb 命令别名风格
• 规范化错误消息格式
• 代码重构与清理

Bug 修复

• 修复 UTIL 扩展分类缺失问题

校验和

21 - pig v0.9.0

变更

• 将 pig sty install 重命名为 pig sty deploy，使命令名称准确表达其执行 Pigsty 部署 playbook 的行为。
• 为 pig sty conf 增加 -g、-p 与 -o 参数，与该版本中的 configure 脚本保持一致。
• 在 pgsql-full 软件包别名中保留 llvmjit。

校验和

22 - pig v0.8.1

修复

• 将 v0.8.0 中移除的 llvmjit 恢复到 pgsql-full 软件包别名。
• 将发布版本更新为 v0.8.1。

校验和

23 - pig v0.8.0

扩展更新

• 扩展总数达到 440 个
• 新增扩展：pg_ai_query 0.1.1
• 新增扩展：pg_textsearch 0.1.0
• 新增扩展：pg_clickhouse 0.1.0
• pg_biscuit 从 1.0 升级至 2.0.1（切换至新仓库，更名为 biscuit）
• pg_search 从 0.20.3 升级至 0.20.5
• pg_duckdb 升级至官方正式版 1.1.1
• vchord_bm25 从 0.2.2 升级至 0.3.0
• pg_semver 从 0.40.0 升级至 0.41.0
• pg_timeseries 从 0.1.7 升级至 0.1.8
• 修复 debian/ubuntu pg18 扩展问题：supautils、pg_summarize、pg_vectorize、pg_tiktoken、pg_tzf、pglite_fusion、pgsmcrypto、pgx_ulid、plprql
• pigsty 版本号同步至 4.0.0

仓库更新

• 因上游变更移除 pgdg yum sysupdate 仓库
• 因上游变更移除 pgdg yum llvmjit 软件包
• 修复 el9.aarch64 上 patroni 3.0.4 重复软件包问题
• 为 el 仓库定义添加优先级，docker 仓库不可用时自动跳过
• 添加 epel 10 / pgdg 9/10 操作系统小版本热修复

校验和

24 - pig v0.7.5

扩展更新

• timescaledb 2.23.1 -> 2.24.0
• pg_search 0.20.0 -> 0.20.3
• convert 0.0.4 -> 0.0.5
• pglinter 1.0.0 -> 1.0.1
• pgdd 0.6.0 -> 0.6.1
• pg_session_jwt 0.3.3 -> 0.4.0
• pg_anon 2.4.1 -> 2.5.1
• pg_enigma 0.4.0 -> 0.5.0
• wrappers 0.5.6 -> 0.5.7
• pg_vectorize 0.25.0 -> 0.26.0

仓库更新

使用修复后的阿里云 PGDG 镜像仓库

校验和

25 - pig v0.7.4

• 更新扩展版本与元数据：pg_search，pgmq，pg_stat_monitor
• 更新 PGDG 仓库 URL 变化，extras 仓库现在位于 yum 仓库顶层
• 将 ivorysql 更新至 5.0 版本，与 PG 18 兼容
• 将 Percona Postgres TDE 内核更新至 18.1

Checksums

26 - pig v0.7.3

• 新增 pig repo reload 命令，更新仓库元数据
• 修复 EL PGDG sysupdate aarch64 仓库问题。
• 修复 EL10.aarch64 PGDG 仓库重命名问题。
• 订正了若干扩展版本
• 更新 Pigsty 版本至 3.7.0

校验和

27 - pig v0.7.2

• 批量更新扩展，数量达到 437 个

• 新增 PGDG EL10 Sysupdate 仓库

• 新增 LLVM APT 仓库

• 在 pig build 命令中使用可选的本地 extension.csv 扩展定义问题。

• 更新的扩展： vchord pg_later pgvectorscale pglite_fusion pgx_ulid pg_search citus timescaledb pg_profile pg_stat_monitor documentdb

• 新增的扩展：pglinter pg_typeid pg_enigma pg_retry pg_biscuit pg_weighted_statistics

校验和

28 - pig v0.7.1

• 全新的网站： /ext/
• 修复了不必要的 sudo 使用问题，现在可以方便的在容器中使用
• 允许 pig ext link 命令使用形如 pg17 pg18 的参数形式
• 新增环境变量 PIG_NO_SUDO，强制不使用 sudo 执行命令
• RPM 变更日志：为几乎所有扩展新增 PG 18 支持
• DEB 变更日志：为几乎所有扩展新增 PG 18 支持
• Infra 变更日志：例行更新至最新版本

校验和

29 - pig v0.7.0

• 提供针对 Debian 13 和 EL 10 发行版的支持
• 大批量扩展更新至最新版本，带有 PostgreSQL 18 支持。
• 几乎所有 Rust 扩展现已通过 pgrx 0.16.1 支持 PG 18
• pig build 命令彻底重做
  • pig build pkg <pkg> 现在会一条龙完成扩展的下载，依赖安装，构建
  • pig build pgrx 命令现在从 pig build rust 中分离
  • pig build pgrx [-v pgrx_version] 现在可以直接使用现有的 PG 安装
  • pig build dep 现在会处理 EL 和 Debian 系统下的扩展依赖
  • pig build ext 命令现在有了更为紧凑和美观的输出，可在 EL 下不依赖 build 脚本直接构建 RPM
  • pig build spec 现在支持直接从 Pigsty 仓库下载 spec 文件包
  • pig build repo / pig repo add / pig repo set 现在默认使用 node,pgsql,infra 仓库模块，取代原本的 node,pgdg,pigsty
• 大量优化了错误日志记录。
• 基于 hugo 与 hextra 全新目录网站

校验和

30 - pig v0.6.2

• 使用 PG 18 官方正式仓库取代原本的 Testing Beta 仓库 instead of testing repo
• 在接收 Pigsty 版本字符串的时候，自动添加 v 前缀
• 改进了网络检查与下载的逻辑

校验和

31 - pig v0.6.1

• 新增 el10 与 debian 13 trixie 的支持存根
• 专门的新文档网站： /ext/pig/
• 使用 go 1.25 重新构建，新增 CI/CD 管道
• 在中国大陆使用 PIGSTY PGDG 镜像
• 移除空的 pgdg-el10fix 仓库
• 使用 Pigsty Babelfish 镜像
• 修复 EL 10 专用的 EPEL 仓库
• pig version 输出构建环境信息

32 - pig v0.6.0

• 新扩展目录：https://ext.pgsty.com
• 新子命令：pig install 简化 pig ext install
• 添加新内核支持：带 pg_tde 的 percona
• 添加新包：Google GenAI MCP 数据库工具箱
• 添加新仓库：percona 仓库和 clickhouse 仓库
• 将扩展摘要信息链接更改为 ext.pgsty.com
• 修复 orioledb 在 Debian/Ubuntu 系统上的问题
• 修复 EL 发行版上的 epel 仓库
• 将 golang 升级到 1.24.5
• 将 pigsty 升级到 v3.6.0

校验和

33 - pig v0.5.0

• 将扩展列表更新至 422 个
• 新扩展：来自 AWS 的 pgactive
• 将 timescaledb 升级到 2.20.3
• 将 citus 升级到 13.1.0
• 将 vchord 升级到 0.4.3
• 修复错误：pgvectorscale debian/ubuntu pg17 失败
• 将 kubernetes 仓库升级到 1.33
• 将默认 pigsty 版本升级到 3.5.0

校验和

34 - pig v0.4.2

• 将扩展列表更新至 421 个
• 为 Debian / Ubuntu 添加 openhalo/orioledb 支持
• pgdd 0.6.0 (pgrx 0.14.1)
• convert 0.0.4 (pgrx 0.14.1)
• pg_idkit 0.3.0 (pgrx 0.14.1)
• pg_tokenizer.rs 0.1.0 (pgrx 0.13.1)
• pg_render 0.1.2 (pgrx 0.12.8)
• pgx_ulid 0.2.0 (pgrx 0.12.7)
• pg_ivm 1.11.0 适用于 debian/ubuntu
• orioledb 1.4.0 beta11
• 重新添加 el7 仓库

校验和

35 - pig v0.4.1

• 将扩展列表更新至 414 个
• 在 pig ext scan 映射中添加 citus_wal2json 和 citus_pgoutput
• 添加 PG 18 beta 仓库
• 添加 PG 18 包别名

36 - pig v0.4.0

• 更新扩展列表，可用扩展达到 407 个
• 添加 pig do 子命令用于执行 Pigsty playbook 任务
• 添加 pig pt 子命令用于包装 Patroni 命令行工具
• 添加扩展别名：openhalo 和 orioledb
• 添加 gitlab-ce / gitlab-ee 仓库区分
• 使用最新 Go 1.24.2 构建并升级依赖项版本
• 修复特定条件下 pig ext status 的 panic 问题
• 修复 pig ext scan 无法匹配多个扩展的问题

37 - pig v0.3.4

curl https://repo.pigsty.io/pig | bash -s 0.3.4

• 常规扩展元数据更新
• 使用阿里云 epel 镜像代替损坏的清华大学 tuna 镜像
• 升级 pigsty 版本字符串
• 在仓库列表中添加 gitlab 仓库

38 - pig v0.3.3

• 添加 pig build dep 命令安装扩展构建依赖项
• 更新默认仓库列表
• 为 mssql 模块（babelfish）使用 pigsty.io 镜像
• 将 docker 模块合并到 infra
• 从 el7 目标中移除 pg16/17
• 允许在 el7 中安装扩展
• 更新包别名

39 - pig v0.3.2

增强功能

• 新扩展
• 使用 upx 减少二进制大小
• 移除嵌入的 pigsty 以减少二进制大小

40 - pig v0.3.1

常规错误修复

• 修复仓库格式字符串
• 修复扩展信息链接
• 更新 pg_mooncake 元数据

41 - pig v0.3.0

pig 项目现在有了新的 主页，以及 PostgreSQL 扩展 目录。

42 - pig v0.2.2

Pig v0.2.2 中提供 404 个扩展

43 - pig v0.2.0

44 - pig v0.1.4

45 - pig v0.1.3

v0.1.3，常规更新，现在可用 390 个扩展！

46 - pig v0.1.2

351 个 PostgreSQL 扩展，包括强大的 postgresql-anonymizer 2.0

47 - pig v0.1.1

更新扩展列表。

48 - pig v0.1.0

pig CLI v0.1 发布

49 - pig v0.0.1

创世发布