docs: zh/10–20 校准·逐句复审·跨版本一致化系列（41 commits）

docs/calibration-20260912-checkpoint.md

@@ -0,0 +1,70 @@
+# PG10—PG20 中文文档校准阶段总结（2026-09-12）
+
+这是正文修复检查点，全文校准与最终构建验收仍在进行。
+
+## 输入与本次提交范围
+
+- 工作区：`/Users/vonng/pgsty/pgdoc`。
+- 本轮起始基线：`738d5dea66ae054ba58610c1d95f1a85272bda3f`。
+- 本次提交父版本：`4c1790ccecfd9531b0705ff7b189003b595d54ff`；更早的校准成果已由既有的逐版检查点提交保存。
+- 英文固定为 10.23、11.22、12.22、13.23、14.24、15.19、16.15、17.11、18.6、19beta3；PG20 固定提交 `86f7c82cf1023e3599f40f939727791a7090cd44`，未升级输入。
+- 本次新增提交正文：**142 files changed, 3910 insertions(+), 4230 deletions(-)**；另附本阶段总结。
+- 相对于本轮起始基线，累计 3157 个中文源文件有变化；这个数字包括此前已提交成果，不是本次提交文件数。
+
+| 版本 | 本次正文文件数 |
+|---|---:|
+| PG10 | 11 |
+| PG11 | 11 |
+| PG12 | 11 |
+| PG13 | 11 |
+| PG14 | 12 |
+| PG15 | 12 |
+| PG16 | 12 |
+| PG17 | 12 |
+| PG18 | 12 |
+| PG19 | 19 |
+| PG20 | 19 |
+
+## 已完成的修复
+
+此前检查点已保存聚合与 JSON 表格、目录与统计、libpq、复制与备份、索引访问方法、并发控制、过程语言、SPI、扩展接口及相关参考页的分批修复。具体审核粒度见运行目录台账，不能据此推断这些大主题下每一章均已完成全文审阅。
+
+本次 142 个正文文件主要包含：
+
+- WAL 配置：恢复 PG15 被缩短的完整定义与示例，修复刷盘时间和数据量的同时条件、fsync 关闭后的持久化操作、wal_skip_threshold 说明，并保留各版 O_DIRECT、压缩算法与同步提交规则。
+- 类型转换：统一参数解析、可变参数与默认参数、首选类型、受信任用户及字面量说明；逐版保留自身操作符、算法步骤、SQL 示例与错误输出。
+- 关联术语与正文：校准字面量、受信任用户、基础类型、重建与时间点恢复；修复 quote_literal 单引号双写、PQprepare 条件、ECPG 字段说明、gexec 和正则表达式相关漏译。
+- 格式化函数：补齐 PG18—20 的 RN 与 V 说明，修正符号、隐含小数点和旧 TZ/OF 适用限制，保留各版模板与表格结构。
+- 字符串和二进制字符串：修复 format 负宽度条件、substring/overlay/position/regexp 语义、引用与转义、SQL 片段、零起始编号及 SHA-384/512 示例缺字符；补回 to_hex 负数示例；恢复 PG14/17 部分表行顺序并移除 PG14 未来文档行。
+- 位串与 JSON 类型转换术语：统一替换范围、提取条件、左端零编号、置位计数及索引词，修正 PG16—20 的 JSON 键类型限制措辞。
+
+同一英文语义单元复用审定中文；版本差异、既有标签和合法锚点分别保留。
+
+## 验证与证据边界
+
+- 本次全部 **142** 个改动文件均与最新十一版原生检查快照逐字节相同；文件 SHA256 已记录。
+- 十一版固定输入准备均成功。原始全书检查仍返回非零（PG10—13 为 3，其余为 1）；各批范围内候选分别绑定源节点处理，未把原始全书结果写成通过。
+- 格式化、字符串／二进制、位串批分别验证 5067、4948、477 个结构与语义单元关联；这些是关联记录数，不是独立缺陷数，也不是全书逐句审阅证明。
+- 已检查完整函数签名、代码和示例、表行列与跨行、内部引用及共用译文。新增位串批的 8 条签名候选均来自已审可见索引译名。
+- 仍明确保留一条 PG17 JSON 创建函数整表行序问题，待下一批对照十一版关闭；不能用已修正的单行术语代替整表验收。
+- `git diff --check` 通过。
+- 当前台账 3269 项、35959 个版本格，每项均有十一格。这些是分批追踪粒度，不能视为独立缺陷数量或最终覆盖证明。
+- **全书逐句语义校准未完成；最终 HTML、A4 PDF、US PDF 共 33 项构建完成数为 0。** 早先 PG18 预检不计最终构建。未推送、未发布。
+
+## 后续工作
+
+1. 在当前源码上逐项复核 ZCode 的 F-001—F-026，优先关闭 PG14—16 未来内容混入及其他确认缺文、错误示例；每项检查 PG10—PG20 全部适用位置。
+2. 绑定独立审核原始证据，并区分已被本次修复覆盖的问题、仍存在的问题和需细分的新问题。独立审核快照为 `4c1790c`，不能直接套用旧快照结论。
+3. 继续比较／枚举等已读未写批次及全书剩余语义审阅，完成 C17/C18/C20 全量复核。
+4. 对最终源码执行十一版完整检查与 33 项实际构建，保留日志、输入及产物哈希，并检查 HTML 和两种纸型 PDF 页面。
+
+## 本地证据与续作入口
+
+运行目录：`outputs/pg10-20-calibration-20260911-134417/`（按仓库规则忽略，不把构建缓存与大体积审计快照提交）。
+
+- `PROGRESS.md`、`TODO.md`、`CHECKPOINT.json`：真实进度、剩余范围与逐文件当前哈希。
+- `INPUTS.json`、`ledgers/`：固定英文身份、共用译文、十一版处理决定和前后片段。
+- `stage-commit-manifest.json`：本次提交 142 个正文文件与 SHA256。
+- `checkpoint-bitstring-cast/`：本次精确源码快照、完整命令、退出码与原始全书检查。
+- 各批 `*-native-validation.json`、`*-native-dispositions.json`：范围验证和逐项例外／未决说明。
+- 独立审核：`outputs/pg10-20-independent-review-20260912-0731/`，含 `PROOFREADING.md`、`findings.jsonl`、`VERSION-MATRIX.tsv` 与 `PROGRESS.md`；保持原证据不改。

docs/final-acceptance-20260912.md

@@ -0,0 +1,67 @@
+# PG10—PG20 中文文档全系列校对最终验收（2026-09-12）
+
+独立校对系列（PG18 起轮 → 横向矩阵复核 → 逐版逐句扫描收官）与修复落地全部完成后的最终收尾验收。验收对象为提交时点的 `zh/10`…`zh/20` 十一个大版本，英文基准固定为 en/10.23、11.22、12.22、13.23、14.24、15.19、16.15、17.11、18.6、19beta3 与 PG20 固定提交 `86f7c82`。
+
+## 一、系列执行总览
+
+- **逐句扫描**：PG18→19→20→17→16→15→14→13→12→11→10 共 11 轮，约 10.4 万阅读单元全部完成（PG18 11,182 / PG15 11,183 / PG13 10,688 / PG12 8,836 / PG11 8,827 / PG10 8,561 等）；每批中英对照，疑似偏差一律回到快照原文分窗核实。
+- **账本终态**：`findings.jsonl` 49 条（F-001…F-042 + F-044…F-050，F-043 并发冲突空号）= 横向矩阵 49 键 = HORIZONTAL-REVIEW.md 49 个唯一问题节，三账本计数一致。按严重程度：高 1 项（F-010 旧版混入未来内容）、中 24 项、低 22 项有效；撤回 3 项（F-027/F-028 相邻同构视图错配误报；F-012 执行期逐版枚举证伪）。
+- **修复落地**：分多轮提交收编（`d1ac51f` 跨版批次 + `docs(pgNN)` 分版批次 + EXECUTE 样板句族统一 `3a83c89`…`7c356d3` 等）；全部有效发现的修复签名在 HEAD 态清零或确认在位。
+- **设计内挂起**：F-001 链接省略的系统性余量（每版少量 EN 引用目标在 zh 无对应）——账本裁定随增量翻译逐步补齐，不属本轮缺陷。
+
+## 二、本次收尾修复（随本验收提交）
+
+| 项 | 内容 | 范围 |
+|---|---|---|
+| F-029⑯ | libpq `PG_DIAG_STATEMENT_POSITION` 描述错字"而不是**以及**字节计算"→"而不是**以**字节计算" | zh/10—20 十一版各 1 处 |
+| F-044 收尾 | jsonb `?|` 行描述补 any-of 限定"文本数组中的**任一**字符串…"（13—18 已先行提交） | zh/19、zh/20 `func/func-json.sgml` |
+| F-050 | amcheck"修复损坏"节首段还原为 EN 11—13 的 false positive 段（原为未来版本"共享缓冲区"段的重复副本；该段在 11—13 的正确位置保留在位） | zh/11、zh/12、zh/13 `amcheck.sgml` |
+| 构建自洽 | zh/14 两处重复 ID 修复：`config-setting-shell` 冗余 `<anchor>`（sect2 已带 id）删除；pg_dump `--no-synchronized-snapshots` 条目误挂 `-78`（与 `--role` 冲突）改分配空闲号 `zh18-auto-pg_dump-varlistentry-81`（en/14.24 该条目无 id，但构建 lint 要求全条目带 id；无外部入站引用） | zh/14 `config.sgml`、`ref/pg_dump.sgml` |
+| SVG 字体 | `temporal-isolation.svg` 中文文本（"会话 1/2""等待……""……继续""重新检查"）的 `font-family` 用中文字体名 `'阿里巴巴普惠体 3.0'`，PDF 管线（Batik）无法解析→字形落入 Times-Roman→严格模式构建失败；统一改为 gin.svg 已验证的拉丁名 `'Alibaba PuHuiTi 3.0',serif` | zh/19、zh/20 `images/temporal-isolation.svg`（各 5 处） |
+
+三项验证证据：
+
+- F-029⑯：全树"以及字节"0 命中；"以字符计算而不是以字节计算"十一版各恰 1 处，与 EN "positions are measured in characters not bytes" 对应。
+- F-044：十三至二十版 `?|` 行均为"任一字符串"且逐字一致；zh/10—12 旧式表保持"任意一个"（随 EN 10—12 自身句式，母本不动）；`?` 行与 `?&` 行邻行原样。
+- F-050：新段与 zh/14 母本归一化后逐字一致；"命中了共享缓冲区"段在三版仍各恰 1 处（正确列表位置，对应 EN 11—13 "detectable problems" 清单）；zh/10 多出的"软件缺陷"句经 en/10.23 比对为该版 EN 独有句（"In practice, amcheck is more likely to find software bugs…"），分版正确、无需改动。
+
+## 三、跨版本一致性与完整性验收
+
+- **签名清零扫描**（现行树全量 grep）：F-029①③⑯、F-030、F-033、F-035、F-038、F-040、F-042（`<<=` 行"被包含于或等于"十三至二十版各 1）、F-044、F-047（"递归应用程序"0，"通过递归应用这些规则"22 处 = 十版 ×2 + 母本）等旧串全部 0 命中。
+- **残留甄别三项均裁定正确**：F-033"潜在性"命中为修复后句中正常词组"潜在性能收益"；F-042"子网是否包含或等于子网"命中属合法的 `>>=` 行；F-036"单引号/小写"两句仅存于 zh/10—13（en/10.23、en/13.23 仍有该两句，PG14 起上游删除，zh/14—20 已清理）——分版边界精确。
+- **样板句族终态**：`授予EXECUTE权限`规范式全库 153 处，带空格旧式 0 处；"复制原点"0 / "复制源"589 一统；EXECUTE 授权四规范形态（超用户/pg_monitor 成员/pg_monitor 权限/10—12 短句-括注族）无混式。
+- **F-048 索引短语抽查**：`<primary>constraint exclusion</primary>` 等英文索引项已译（zh/10、zh/18 抽查各 1 处中文形态）。
+
+## 四、构建验收
+
+十一版 `make -C zh/<v> html` 全部通过（页数与上轮 FIX-LEDGER 记录一致：PG10 1010、PG11 1048、PG12 1055、PG13 1061、PG14 1082、PG15 1090、PG16 1170、PG17 1143、PG18 1148、PG19 1176、PG20 1157 页）。首轮构建仅 zh/14 报两处重复 ID 有效性错误（此前 id 迁移批次的笔误，见第二节），修复后 zh/14 重建零告警、页数不变；其余十版一贯零告警（上轮记录的 zh/14 sepgsql 悬空 xref 已在此前提交中消除）。PDF 本轮未重建，沿用系列惯例以 HTML 为构建门禁；如需可按 Makefile `zh-pdf-all` 批量产出。
+
+## 五、遗留处置（收尾轮全部关闭）
+
+1. **F-001 链接省略余量——复测闭合**：以引号无关、大小写不敏感探针（排除 zh/10 旧管线大写 linkend 与 zh/13—20 单引号 linkend 两类假阳性）对全树 11 版重测 EN→zh linkend 集合差，结果为 **0**；原审计范围（ddl/func/glossary）同样为 0。原裁定"随增量翻译逐步做"的挂起项实际已被 `8bac876` 及后续各修复轮闭合，账本从未复测而已。
+2. **zh/14 `ref/merge.sgml` 死文件——已删除**：MERGE 为 PG15 引入的命令，en/14.24 无此文件；该 683 行中文副本经 `git log` 溯源为 `3ca4516`（"bump zh docs to the latest minor version"）批量升版时从 PG15 树误带（zh/15 正本 682 行）。不在构建图内、全树零入站 `sql-merge` 引用，删除为闭环操作（未来内容三件套中仅条目自身）；删除后 zh/14 HTML 重建 1082 页零告警。全树排查确认其为唯一孤儿文件（各版 `pgdoccn-notes.sgml` 为中文文档基础设施，合法）。
+3. **PDF 构建补齐**：11 版 × A4/US 共 22 份 PDF 全部重建，与 11 版 HTML 合计 33 项构建完成，产物位于 `tmp/pdf/zh/`（gitignored）。
+4. 并发会话滚动校准仍可能产生新改动；本验收结论以提交时点快照为准。
+
+## 六、证据入口
+
+- 运行目录（gitignored）：`outputs/pg10-20-independent-review-20260912-0731/`——`findings.jsonl`、`HORIZONTAL-REVIEW.md`、`FIX-LEDGER.md`（第六节为收尾轮记录）、`PROGRESS.md`（十一轮完成报告）、`PROGRESS-pg12-session-report.md`（PG12 轮报告原稿）。
+- 阶段检查点：[calibration-20260912-checkpoint.md](calibration-20260912-checkpoint.md)。
+
+## 七、生产发布级全量校验轮（2026-09-13）
+
+在全部遗留关闭后追加的一轮全量校验，覆盖标题、锚点、译法（链接与未译内容）、标点风格四个维度，探针全部清零。
+
+**1. F-001 链接省略——逐处级善后（按 文件×linkend 出现次数比对 EN/zh）**：初测 19 组缺口全部修复——`%x` 行补"参见 transaction-id"（16—20）；jsonpath 转换说明补 "Similarly…" 两句含 xref（17—20）；pg_logical_slot_get_changes 补逻辑故障切换槽整句含链接（17—20）；random 说明句补 xref 与 random_normal（17/18）；sqljson 五处交叉引用补齐 @@/match 两行括号说明（17/18/19，措辞随各版母本；zh/20 match 行"返回错误或"正译为"失败或"）；zh/15 补 SQL/JSON 路径语言偏差清单整块（谓词偏差+正则差异两项，含 xref）。修复后探针 0。
+
+**2. 标题跨版一致性（id 锚定比对，同 EN 标题→须同 zh 标题）**：初测 14 处分歧全部统一——备库设置→备库、内核资源→内核资源使用（zh/15）；访问控制列表权限缩写→ACL 权限缩写（12—14 对齐 15—20）；配置参数→配置设置（16—20 对齐 10—15）；EXPLAIN/ANALYZE 的 FDW 例程恢复空格族（15/17—20 对齐全库 73:10 的带空格形态）；Parallel Append→并行追加（9 版对齐 zh/15 译名与"并行扫描/连接/聚合"兄弟标题）；BufferPin/IO/IPC/LWLock 大小写还原（17—19，系此前批处理误折半）；POSIX 正则表达式细节补空格（zh/19）；标题连接符 `——`→`&mdash;`（zh/19 两处，对齐 365:2 的实体约定）。修复后探针 0。
+
+**3. 锚点完备性**：EN id 缺于 zh（剥注释后）0——zh/15 补 AuthenticationSCMCredential 流程条目+消息格式条目（EN 15 独有、zh 全缺；母本 zh/14 + 按 en/15.19 新译，内层条目按惯例配 zh18-auto 号）、删除 LSN 未来词条存根（悬空 glosssee，PG16+ 内容，系 11 版中最后一处构建告警）；pg_checksums 描述节 id 归一为 EN 形态 `r1-app-pg_checksums-1`（14/15，无入站引用）；ecpg 两个"缺失"id 甄别为 EN 注释块内代码，零渲染影响。版内重复 id 0；悬空链接由构建管线验证（修复后 zh/15 零告警）。
+
+**4. 未译内容扫描**（剥代码块/内联标记后含英文虚词的散句探针）：66 个候选逐项甄别，全部为合法保留——SQL 语法产生式（CREATE TABLE/COPY 的 term）、sources.sgml 英文用法指南节标题（"May vs. Can vs. Might" 与 Unable/Bad/Illegal/Unknown 同族）、overlay() 签名格。零真缺译。
+
+**5. 标点风格**（正文全角化，代码上下文豁免）：中文邻接半角逗/分号 374 处、标签式半角冒号 599 处、散文半角冒号 60 处、句末半角句点 29 处，全部转全角；有意保留三类：格式记法"分钟:秒""主机:端口号"（半角为字面格式）、文件名". 和 .."（已有 quote 标记）、问号族（操作符表描述行的既有族内统一约定）。
+
+**6. 工具事故与恢复（如实记录）**：标点批处理的代码块掩码占位符在 9 个文件（zh/10 五件 + zh/14/15/16 的 func/docguide）泄漏，各损坏少量代码块。处置：受损文件全部恢复至 HEAD，改用按代码块边界切段的无占位符方法重放同类转换；以"代码块计数 vs HEAD + 占位符残留"双探针全树验证，异常 0；zh/15 两处有意插入独立 grep 确认在位。
+
+**7. 构建回归**：本轮改动独立重放后 11 版 HTML 全部通过（页数与基线一致，zh/15 零告警），作为 SGML 完整性门禁；PDF 按约定不在本轮范围。本轮提交边界：与并发校准会话混合的 22 个文件（其正在编辑 catalogs/func 等）未纳入本提交，留待其收口；工作树保留全部并集状态。

zh/10/adminpack.sgml

@@ -15,7 +15,7 @@
   <title><filename>adminpack</filename> 函数</title>
   <tgroup cols="3">
    <thead>
-    <row><entry>Name</entry> <entry>返回类型</entry> <entry>
+    <row><entry>名称</entry> <entry>返回类型</entry> <entry>
         描述
        </entry>
     </row>
@@ -57,7 +57,7 @@
   <primary>pg_file_rename</primary>
  </indexterm>
  <para>
-  <function>pg_file_rename</function>重命名文件。如果省略<parameter>archivename</parameter>或其值为 NULL，则它只是将<parameter>oldname</parameter>重命名为<parameter>newname</parameter>（后者必须尚不存在）。如果提供了<parameter>archivename</parameter>，它会先将<parameter>newname</parameter>重命名为<parameter>archivename</parameter>（后者必须尚不存在），然后再将<parameter>oldname</parameter>重命名为<parameter>newname</parameter>。如果第二个重命名步骤失败，它会在报告错误之前尝试将<parameter>archivename</parameter>再改回<parameter>newname</parameter>。成功时返回 true；如果源文件不存在或不可写，则返回 false；其他情况会抛出错误。
+  <function>pg_file_rename</function>重命名文件。如果省略<parameter>archivename</parameter>或其值为空值，则它只是将<parameter>oldname</parameter>重命名为<parameter>newname</parameter>（后者必须尚不存在）。如果提供了<parameter>archivename</parameter>，它会先将<parameter>newname</parameter>重命名为<parameter>archivename</parameter>（后者必须尚不存在），然后再将<parameter>oldname</parameter>重命名为<parameter>newname</parameter>。如果第二个重命名步骤失败，它会在报告错误之前尝试将<parameter>archivename</parameter>再改回<parameter>newname</parameter>。成功时返回 true；如果源文件不存在或不可写，则返回 false；其他情况会抛出错误。
  </para>
 
  <indexterm>
@@ -80,7 +80,7 @@
   <title>已弃用的<filename>adminpack</filename>函数</title>
   <tgroup cols="3">
    <thead>
-    <row><entry>Name</entry> <entry>返回类型</entry> <entry>
+    <row><entry>名称</entry> <entry>返回类型</entry> <entry>
         描述
        </entry>
     </row>

zh/10/amcheck.sgml

@@ -123,7 +123,7 @@ ORDER BY c.relpages DESC LIMIT 10;
     </para>
     <para>
      这也包括因操作系统排序规则的比较规则发生变化而引起的问题。
-     像<type>text</type>这类可排序类型的数据值之间的比较必须是不可变的
+     像<type>text</type>这类支持排序规则的类型的 datum 之间的比较必须是不可变的
      （正如用于 B-树索引扫描的所有比较都必须不可变一样），
      这就意味着操作系统排序规则绝不能发生变化。
      虽然这种情况比较少见，但操作系统排序规则的更新确实可能导致此类问题。

zh/10/auth-delay.sgml

@@ -1,7 +1,7 @@
 <!-- doc/src/sgml/auth-delay.sgml -->
 
 <sect1 id="auth-delay" xreflabel="auth_delay">
- <title>auth_delay &mdash; 在认证失败时暂停</title>
+ <title>auth_delay</title>
 
  <indexterm zone="auth-delay">
   <primary>auth_delay</primary>