方法与术语
GUC 大典统一使用的证据边界、生命周期规则、默认值语义、Pigsty 夹具与双语术语表。
所有条目都使用同一套证据模型，避免实测值在不知不觉中变成调优传说。
证据标签
| 标签 | 含义 | 发布规则 |
|---|---|---|
| Fact | 直接实测，或可追溯到固定版本来源 | 带上版本、路径、链接或验证状态 |
| Analysis | 基于事实和公开机制推导的解释 | 展示推理，不冒充来源作者的原话 |
| Advice | 面向具体工作负载的运维建议 | 明示假设、取舍和需要验证的指标 |
| 待人工复核 | 对 Pigsty 取值理由的编辑推断 | 绝不写成维护者已经表达的理由 |
生命周期规则
- 参数全集是 PostgreSQL 9.0–19 Beta 3 各版本点
pg_settings.name的并集。 - 首次观测是矩阵中第一次出现的版本点。PG9.0 表示“研究边界时已经存在”，不代表“在 PG9.0 引入”。
- 移除版本是最后一次连续出现之后的第一个大版本，并自动检查所有更高版本均不存在。
- 引入提交是另一项 Git 事实，通过 GUC 表源码的 pickaxe 搜索获得；它不会覆盖实测存在矩阵。
默认值术语
| 术语 | 定义 |
|---|---|
boot_val |
上游 pg_settings 的 boot 值；跨大版本默认值比较使用这一列。 |
setting |
官方容器完成 initdb 后的当前值；它可能不同于 boot_val。 |
| 原始单位 | unit 列原样保留，包括 8kB 这样的块计数单位。 |
| 人类可读值 | 保守换算，仅用于显示，绝不替代原始值和单位。 |
Pigsty 夹具
对比矩阵使用 8 核、32 GiB 内存、100 GiB SSD 主库和角色默认变量，针对每个
PostgreSQL 大版本实际渲染 OLTP、OLAP、CRIT、TINY 四套完整 Patroni 模板。记录包括
源码表达式、解析值、配置层级及其与上游 boot_val 的比较。模板没有该键时明确记为
“未修改”。用户 pg_parameters 是独立的 postgresql.auto.conf 覆盖层，角色默认值为空。
对已停止维护或测试版 PostgreSQL 渲染当前 Pigsty 模板只是一种历史投影，不表示当前
Pigsty 支持该版本。
测试版边界
PostgreSQL 19 Beta 3 作为固定的预发布证据点参与参数并集以及 PG18→19 Beta 3 差异。 所有仅见于测试版的条目都会提示：名称、默认值和行为在正式发布前仍可能变化。
官方链接
爬虫逐版本抓取全部官方 runtime-config*.html 页面，记录响应哈希，并检查预期的
GUC-* ID。只有实际找到精确锚点时才发布 URL；内部或未公开参数会记录状态，不会
伪造官方链接。