花一天翻完了 PG 生態(tài)三大組件的文檔

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

想了想，去翻譯文檔吧。

于是我花了一天時(shí)間，把 PgBouncer 連接池、pgBackRest 備份工具、Patroni 高可用模板 這三個(gè) PostgreSQL 生態(tài)中最重要的開(kāi)源組件文檔，全部翻譯成了中文。順手還把 PostgreSQL 18 的官方文檔也過(guò)了一遍——雖然還在校對(duì)中，但主體已經(jīng)出來(lái)了。

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

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

有一種說(shuō)法，搞技術(shù)的程序員英文應(yīng)該都過(guò)關(guān)，所以直接看英文文檔就行了。這話(huà)對(duì)也不對(duì)。

實(shí)際上，中國(guó)開(kāi)發(fā)者群體里，英文閱讀能力參差不齊的情況非常普遍。即便是一線(xiàn)大廠(chǎng)的工程師，也有不少人面對(duì)大段英文文檔時(shí)讀得很吃力。你不能假設(shè)每個(gè)需要用 PostgreSQL 的人，都能流暢閱讀英文技術(shù)文檔。

退一步說(shuō)，就算英語(yǔ)水平不錯(cuò)——比如像我這樣，平時(shí)英文看著也算順暢 —— 但閱讀中文的速度還是比英文快兩到三倍。這是認(rèn)知效率問(wèn)題 —— 母語(yǔ)閱讀時(shí)大腦的負(fù)荷更低，理解更直覺(jué)，查閱更爽利。特別是參考性質(zhì)的文檔，需要反復(fù)跳轉(zhuǎn)查閱，中文的效率優(yōu)勢(shì)就更加明顯了。

所以，中文文檔不是"有也行沒(méi)也行"的事，它是 PG 生態(tài)在中國(guó)落地的基礎(chǔ)設(shè)施。

現(xiàn)狀有多糟？

PostgreSQL 的官方文檔曾經(jīng)由中文社區(qū)組織翻譯，志愿者加上大學(xué)生，前前后后做了不少版本。但這種靠人力堆的模式天然有個(gè)問(wèn)題：跟不上。每次大版本發(fā)布后，翻譯要滯后半年甚至更久。到現(xiàn)在，社區(qū)維護(hù)的中文文檔進(jìn)度似乎已經(jīng)停留在了 15.7 版本——落后了三年多，已經(jīng)無(wú)人組織跟進(jìn)了。（不過(guò)我好像看到一個(gè) 18.0 的）

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

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

AI 改變了什么？

說(shuō)到底，過(guò)去翻譯文檔為什么難？因?yàn)檫@是一個(gè)需要同時(shí)具備 “技術(shù)理解力“ 和 ”語(yǔ)言表達(dá)力“ 的任務(wù)，能做好這事的人本來(lái)就不多，愿意無(wú)償投入的就更少了。這件事需要一整個(gè)翻譯組來(lái)推動(dòng)，而翻譯組需要持續(xù)的組織和協(xié)調(diào)。成本太高了。

但現(xiàn)在不一樣了。

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

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

翻譯質(zhì)量如果讓我自己打分，大概能到 85-90 分——在幾乎零邊際成本的情況下，做到閱讀理解無(wú)偏差、讀起來(lái)很流暢，我覺(jué)得這已經(jīng)是一個(gè)非常好的性?xún)r(jià)比了。

當(dāng)然，我也不是全部無(wú)腦丟給 AI。我基本上會(huì)把翻譯后的內(nèi)容整體過(guò)一遍，確保沒(méi)有硬傷，順便也當(dāng)復(fù)習(xí)一下，總的工作量跟以前完全不是一個(gè)量級(jí)。

這再一次證明了在 AI 時(shí)代，過(guò)去需要一整個(gè)公司、一大群人才能干成的事，現(xiàn)在一個(gè)人就能搞定。翻譯文檔只是其中一個(gè)縮影。社區(qū)建設(shè)，開(kāi)源維護(hù)的門(mén)檻，被徹底改變了。

后面要做什么？

翻譯完這三大組件文檔只是個(gè)開(kāi)頭。

我后面的計(jì)劃是，把 PG 生態(tài)里所有重要的組件文檔、官方博客、技術(shù)資訊，全部翻一遍，并且構(gòu)建一套自動(dòng)維護(hù)的更新工作流。這意味著——全世界所有英文 PG 社區(qū)產(chǎn)出的內(nèi)容，都可以近乎實(shí)時(shí)地同步到中文環(huán)境中。

比如，460+ 個(gè)擴(kuò)展的文檔，也可以自動(dòng)的抓取并翻譯為中文，甚至是 N 國(guó)語(yǔ)言。這件事對(duì)我來(lái)說(shuō)真的沒(méi)什么額外成本。我訂閱的 Token 如果用不完也是浪費(fèi)，正好用這種"無(wú)限量"的活兒來(lái)作為兜底填充任務(wù)。往大了說(shuō)呢？我準(zhǔn)備用這套東西來(lái) “復(fù)興” PostgreSQL 中文社區(qū)。

一個(gè)真正有生命力的技術(shù)社區(qū)，需要什么？我想過(guò)這個(gè)問(wèn)題：你得有完善的中文文檔和技術(shù)資訊，這是基座；你得有供大家交流討論的論壇，這是活力；你得有廠(chǎng)商發(fā)布信息、發(fā)布崗位的地方，這是連接產(chǎn)業(yè)的橋梁；你最好還有下載倉(cāng)庫(kù)等基礎(chǔ)設(shè)施，降低大家使用的門(mén)檻。

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

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

來(lái)看看？

目前翻譯好的文檔已經(jīng)上線(xiàn)，放在了 Pigsty 的中文文檔站上：

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

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

后面還會(huì)把 PostGIS，TimescaleDB，Citus，PGVECTOR，pg_repack 這些擴(kuò)展的文檔也集中規(guī)整翻譯一下。

本來(lái)想專(zhuān)門(mén)搞個(gè)域名來(lái)放這些 PG 生態(tài)的中文文檔，但國(guó)內(nèi)備案太折騰了，暫時(shí)先放在 Pigsty 站點(diǎn)下面。后續(xù)我會(huì)整合更多內(nèi)容，專(zhuān)門(mén)搞個(gè)域名，構(gòu)建一個(gè)完整的 PG 中文社區(qū)門(mén)戶(hù)——文檔、資訊、新聞、下載，一站搞定。

網(wǎng)站源碼是完全開(kāi)源的，翻譯質(zhì)量雖然我覺(jué)得還不錯(cuò)，但總歸難免有疏漏。非常歡迎大家來(lái)抓蟲(chóng)——發(fā)現(xiàn)任何翻譯問(wèn)題，可以直接反饋給我，或者在 GitHub 上直接提 PR。

翻譯從來(lái)不是目的。目的是讓每一個(gè)中文開(kāi)發(fā)者，都能用最低的認(rèn)知成本，獲取最好的 PostgreSQL 知識(shí)。