花一天翻完了 PG 生態三大組件的文檔

最近 Pigsty v4 剛發布完，手頭突然空了下來。正好一看，這周的 Claude Token 額度快到期了，不用也是白扔。一時心癢，想著得找個活兒把它揮霍掉。

想了想，去翻譯文檔吧。

于是我花了一天時間，把 PgBouncer 連接池、pgBackRest 備份工具、Patroni 高可用模板 這三個 PostgreSQL 生態中最重要的開源組件文檔，全部翻譯成了中文。順手還把 PostgreSQL 18 的官方文檔也過了一遍——雖然還在校對中，但主體已經出來了。

說實話，干完之后我自己都有點恍惚：這事兒要擱幾年前，怕是得組織一群志愿者忙活好幾個月。文檔放在這里：https://pigsty.cc/docs/

中文文檔，到底重不重要？

有一種說法，搞技術的程序員英文應該都過關，所以直接看英文文檔就行了。這話對也不對。

實際上，中國開發者群體里，英文閱讀能力參差不齊的情況非常普遍。即便是一線大廠的工程師，也有不少人面對大段英文文檔時讀得很吃力。你不能假設每個需要用 PostgreSQL 的人，都能流暢閱讀英文技術文檔。

退一步說，就算英語水平不錯——比如像我這樣，平時英文看著也算順暢 —— 但閱讀中文的速度還是比英文快兩到三倍。這是認知效率問題 —— 母語閱讀時大腦的負荷更低，理解更直覺，查閱更爽利。特別是參考性質的文檔，需要反復跳轉查閱，中文的效率優勢就更加明顯了。

所以，中文文檔不是"有也行沒也行"的事，它是 PG 生態在中國落地的基礎設施。

現狀有多糟？

PostgreSQL 的官方文檔曾經由中文社區組織翻譯，志愿者加上大學生，前前后后做了不少版本。但這種靠人力堆的模式天然有個問題：跟不上。每次大版本發布后，翻譯要滯后半年甚至更久。到現在，社區維護的中文文檔進度似乎已經停留在了 15.7 版本——落后了三年多，已經無人組織跟進了。（不過我好像看到一個 18.0 的）

至于 PgBouncer、Patroni、pgBackRest 這些核心組件的中文文檔？更是幾乎空白。零星能找到的一些翻譯，Patroni 的中文文檔版本還停留在 2.1.1， pgbouncer 的停留在 1.7.2 ，基本上已經不具備參考價值，pgbackrest 的根本沒有，只能搜出老馮七八年前翻譯的第一版。

這不是中文社區不努力。翻譯文檔是一件吃力不討好的苦差事：工作量大、技術門檻高、沒有直接回報、而且版本一更新就白干。靠愛發電這種事，終究難以為繼。

AI 改變了什么？

說到底，過去翻譯文檔為什么難？因為這是一個需要同時具備 “技術理解力“ 和 ”語言表達力“ 的任務，能做好這事的人本來就不多，愿意無償投入的就更少了。這件事需要一整個翻譯組來推動，而翻譯組需要持續的組織和協調。成本太高了。

但現在不一樣了。

有了 AI，翻譯文檔這件事的本質變成了什么？——燒 Token。

只要你有一套成熟穩定的工作流，剩下的就是把文檔丟進去跑。我的 Token 訂閱額度放那兒不用也會過期，不如干點有意義的事。一天的時間，三大組件的完整文檔翻譯就搞定了。

翻譯質量如果讓我自己打分，大概能到 85-90 分——在幾乎零邊際成本的情況下，做到閱讀理解無偏差、讀起來很流暢，我覺得這已經是一個非常好的性價比了。

當然，我也不是全部無腦丟給 AI。我基本上會把翻譯后的內容整體過一遍，確保沒有硬傷，順便也當復習一下，總的工作量跟以前完全不是一個量級。

這再一次證明了在 AI 時代，過去需要一整個公司、一大群人才能干成的事，現在一個人就能搞定。翻譯文檔只是其中一個縮影。社區建設，開源維護的門檻，被徹底改變了。

后面要做什么？

翻譯完這三大組件文檔只是個開頭。

我后面的計劃是，把 PG 生態里所有重要的組件文檔、官方博客、技術資訊，全部翻一遍，并且構建一套自動維護的更新工作流。這意味著——全世界所有英文 PG 社區產出的內容，都可以近乎實時地同步到中文環境中。

比如，460+ 個擴展的文檔，也可以自動的抓取并翻譯為中文，甚至是 N 國語言。這件事對我來說真的沒什么額外成本。我訂閱的 Token 如果用不完也是浪費，正好用這種"無限量"的活兒來作為兜底填充任務。往大了說呢？我準備用這套東西來 “復興” PostgreSQL 中文社區。

一個真正有生命力的技術社區，需要什么？我想過這個問題：你得有完善的中文文檔和技術資訊，這是基座；你得有供大家交流討論的論壇，這是活力；你得有廠商發布信息、發布崗位的地方，這是連接產業的橋梁；你最好還有下載倉庫等基礎設施，降低大家使用的門檻。

最核心的是，你需要有自己的核心價值主張，有一個研發的東西作為凝聚核。那么現在想想看，這些其實都不難搞定了。這些事情，以前想做心有余而力不足。現在有了 AI 加持，我坐在這里一邊沖浪一邊"出嘴"派活，Token 有的是，很多過去想都不敢想的事情，變得可以一個人輕松支棱起來了。

有人可能會問：在 AI Agent 的時代，以后都是 Agent 去讀文檔了，還需要中文翻譯嗎？甚至連文檔站都不需要了，項目里寫個 llm.txt 就完了。也許吧。但至少現在，我自己天天還得翻 PG 文檔。在 Agent 真正替代人類閱讀之前，這件事依然大有裨益。

來看看？

目前翻譯好的文檔已經上線，放在了 Pigsty 的中文文檔站上：

?PgBouncer 中文文檔：連接池配置、管理與使用的完整翻譯?Patroni 中文文檔：高可用集群管理的完整翻譯?pgBackRest 中文文檔：備份與恢復工具的完整翻譯?PostgreSQL 18 文檔：主體翻譯完成，校對進行中，翻譯的是最新的 18.3 這個會專門弄個子域名掛上去。

文檔站地址：https://pigsty.cc/docs/

后面還會把 PostGIS，TimescaleDB，Citus，PGVECTOR，pg_repack 這些擴展的文檔也集中規整翻譯一下。

本來想專門搞個域名來放這些 PG 生態的中文文檔，但國內備案太折騰了，暫時先放在 Pigsty 站點下面。后續我會整合更多內容，專門搞個域名，構建一個完整的 PG 中文社區門戶——文檔、資訊、新聞、下載，一站搞定。

網站源碼是完全開源的，翻譯質量雖然我覺得還不錯，但總歸難免有疏漏。非常歡迎大家來抓蟲——發現任何翻譯問題，可以直接反饋給我，或者在 GitHub 上直接提 PR。

翻譯從來不是目的。目的是讓每一個中文開發者，都能用最低的認知成本，獲取最好的 PostgreSQL 知識。