464個擴展開箱即用：新版 PG 擴展目錄發(fā)布

今天老馮又讓 Claude Code 干了一件大好事 —— 做了一個全新的 PostgreSQL 擴展目錄。就放在 https://pigsty.cc/ext 這里。

說起來，這已經是第五版了。兜兜轉轉一大圈，又回到了第一版使用的 Hugo + Docsy 框架，重新融合到 Pigsty 主站。這個過程本身就是個故事，后面再聊。先說說這一版到底做了什么。

不只是有包，還要有文檔

之前的擴展目錄，核心功能是告訴你：這個擴展叫什么、元數據在哪里、二進制包怎么下載、一鍵安裝怎么搞。你裝好了就行，至于怎么用 —— 自己找文檔去。

這次不一樣了。在 AI 的幫助下，我們開始系統(tǒng)性地收集并翻譯這 464 個擴展的文檔，目標是讓你在一個地方就能看到所有擴展最關鍵的使用信息。

具體來說，分兩種情況：

對于文檔體量巨大的"巨無霸"擴展，我們會建立專門的子站點來做翻譯。比如 Citus、TimescaleDB、PostGIS 這幾個，文檔量本身就相當于一本書，值得單獨對待。

對于大多數輕量級擴展，情況其實很簡單 —— 它們的全部文檔往往就是一頁 README。比如 pgvector，作為 PG 生態(tài)中最炙手可熱的向量數據庫擴展，文檔就一頁紙；

再比如 pg_repack，這個在線治理表膨脹的運維利器，文檔也就是一頁 Markdown。

我們要做的，就是把這些 README 統(tǒng)統(tǒng)收集起來，嵌入到每個擴展的詳情頁面中。你不用再到處跳轉、翻 GitHub，在一個集中的地方就能查閱所有擴展的核心文檔。對于特別大的擴展，我們也會把信息索引聚合起來，讓你有一個權威可靠的參考入口。

目前 pigsty.cc 已經。后續(xù)所有擴展 —— 包括 PostgreSQL 內核本身 —— 都會逐步推進并持續(xù)維護。

這也是我們的一個愿景：成為 PG 生態(tài)中關鍵信息的可靠來源。

說實話，很多時候我做"正活"剩下的 AI Token 額度沒燒完，就順手拿來填這些空，算是一種兜底，也算在做公益。

同時對 Agent 友好，對人類友好

接下來聊聊這個目錄是怎么設計的。

雖然技術棧兜了一圈又回到 Hugo + Docsy，但在 Claude Code 的加持下，純靜態(tài)網站也能做出非常出色的效果。設計上，老馮遵循一個核心原則：同時對 AI Agent 友好，對人類讀者友好。

對 Agent 友好，意味著網頁的源碼是開源的、采用 Markdown 格式，而且有一個硬性要求：減少雜音。Markdown 里不應該混入大量原生 HTML 短代碼或格式噪聲，否則會給 Agent 的解析和閱讀制造很大障礙。

對人類讀者友好，意味著要把信息高效組織為美觀的可視化形式，讓人能直觀地發(fā)現問題、聚焦關鍵信息。

舉個具體例子：這一版我們做了一個很實用的嘗試 —— 將所有擴展融合進一張大表格。在特定的 PG 版本和操作系統(tǒng)組合下，你可以通過單元格直接看到有多少個可用的包、來自哪個倉庫，點擊即可下載，非常方便。

但是老馮并沒有去用很復雜的 HTML 來實現，依然用的是標準的 Markdown 格式，只是在外面套了一層短代碼進行必要的內容轉換。這個在 Hugo 編譯的時候進行必要的內容轉換，然后通過定制的 CSS 格式，讓它呈現出可觀的效果。

同時我們這次也提供了一系列分門別類的列表索引，從不同維度展示擴展的屬性信息，方便快速檢索定位。站內搜索也比之前的版本好用了不少。

另外，這次我們還將一些 PG 內核分支獨有的擴展也收錄了進來：

五個版本，兜兜轉轉回到原點

最后聊一個不那么技術、但挺有感觸的話題：文檔框架的選型。

這個擴展目錄從第一版到現在，前后經歷了五個版本：

1.Hugo + Docsy（初版，融合在 Pigsty 主站）2.Docsify3.Next.js4.Hugo + Hextra（獨立站點 pgext.cloud）5.Hugo + Docsy（現在，回歸 Pigsty 主站）

中間那個獨立站點 pgext.cloud，因為沒有備案、掛在 Cloudflare 上，有國內用戶反饋訪問不穩(wěn)定，懷疑被墻。思來想去，還是老老實實用備案過的域名來做這件事。

第一版：基于 Hugo + Docsy （和這次一樣）

第二版：基于 Docsify

第三版：基于 Next.js + Fumadocs

后來實在受不了動態(tài)網站的一堆破事，回歸靜態(tài)網站了。

第四版：基于 Hugo + Hextra

Hextra 是另一個輕量化的，類似 Fumadocs 的主題。我很喜歡，它對于小型項目來說非常合適，比如翻譯書什么的。但是對于大型文檔站點來說還是有些力不從心。但是老馮的幾本書，教程，小項目都很喜歡用這個框架。

這次掛在了獨立站點 pgext.cloud 三，因為沒有備案、掛在 Cloudflare 上，有國內用戶反饋訪問不穩(wěn)定，懷疑被墻。思來想去，還是老老實實用備案過的域名來做這件事。

第五版： Hugo + Docsy

最終的結論其實很簡單：

如果你要做靜態(tài)文檔站，選 Hugo 就行了。Docsy是 Google 出品的主題，Kubernetes 和 etcd 的文檔都在用，基本功扎實，搜索好用，結構清晰，到現在還在活躍更新。輕量級的場景可以用 Hextra，重量級的就上 Docsy。如果需要做內容豐富的動態(tài)網站，Next.js 可以考慮，但它有時候確實挺重的。

Hugo 這個框架我用了快十年，從來沒讓我失望過。折騰了這么多新玩意，最后發(fā)現六七年前第一次選的框架就是最合適的選擇。這大概也印證了一個道理：扎實的 Boring Technology 才是最好的。網站不在于做得多炫酷，而在于里面的信息有沒有價值。內容為王，始終沒變。

你要說這些折騰的時間拿去做視頻教程、寫實戰(zhàn)案例，是不是更有價值？也許吧。但折騰一圈回來，你知道了有哪些選擇、它們各自的利弊權衡，提升了自己的 Web 設計經驗與品位 —— 這本身就是一種收獲。

誰說得準呢？折騰本身，也蠻有樂趣的。