464个扩展开箱即用：新版 PG 扩展目录发布
今天老冯又让 Claude Code 干了一件大好事 —— 做了一个全新的 PostgreSQL 扩展目录。就放在 https://pigsty.cc/ext 这里。
说起来，这已经是第五版了。兜兜转转一大圈，又回到了第一版使用的 Hugo + Docsy 框架，重新融合到 Pigsty 主站。这个过程本身就是个故事，后面再聊。先说说这一版到底做了什么。
不只是有包，还要有文档
之前的扩展目录，核心功能是告诉你：这个扩展叫什么、元数据在哪里、二进制包怎么下载、一键安装怎么搞。你装好了就行，至于怎么用 —— 自己找文档去。
这次不一样了。在 AI 的帮助下，我们开始系统性地收集并翻译这 464 个扩展的文档，目标是让你在一个地方就能看到所有扩展最关键的使用信息。
具体来说，分两种情况：
对于文档体量巨大的"巨无霸"扩展，我们会建立专门的子站点来做翻译。比如 Citus、TimescaleDB、PostGIS 这几个，文档量本身就相当于一本书，值得单独对待。
对于大多数轻量级扩展，情况其实很简单 —— 它们的全部文档往往就是一页 README。比如 pgvector，作为 PG 生态中最炙手可热的向量数据库扩展，文档就一页纸；
再比如 pg_repack，这个在线治理表膨胀的运维利器，文档也就是一页 Markdown。
我们要做的，就是把这些 README 统统收集起来，嵌入到每个扩展的详情页面中。你不用再到处跳转、翻 GitHub，在一个集中的地方就能查阅所有扩展的核心文档。对于特别大的扩展，我们也会把信息索引聚合起来，让你有一个权威可靠的参考入口。
目前 pigsty.cc 已经完成了 PgBouncer、pgBackRest 和 Patroni 的文档翻译。后续所有扩展 —— 包括 PostgreSQL 内核本身 —— 都会逐步推进并持续维护。
这也是我们的一个愿景：成为 PG 生态中关键信息的可靠来源。
说实话，很多时候我做"正活"剩下的 AI Token 额度没烧完，就顺手拿来填这些空，算是一种兜底，也算在做公益。
同时对 Agent 友好，对人类友好
接下来聊聊这个目录是怎么设计的。
虽然技术栈兜了一圈又回到 Hugo + Docsy，但在 Claude Code 的加持下，纯静态网站也能做出非常出色的效果。设计上，老冯遵循一个核心原则：同时对 AI Agent 友好，对人类读者友好。
对 Agent 友好，意味着网页的源码是开源的、采用 Markdown 格式，而且有一个硬性要求：减少杂音。Markdown 里不应该混入大量原生 HTML 短代码或格式噪声，否则会给 Agent 的解析和阅读制造很大障碍。
对人类读者友好，意味着要把信息高效组织为美观的可视化形式，让人能直观地发现问题、聚焦关键信息。
举个具体例子：这一版我们做了一个很实用的尝试 —— 将所有扩展融合进一张大表格。在特定的 PG 版本和操作系统组合下，你可以通过单元格直接看到有多少个可用的包、来自哪个仓库，点击即可下载，非常方便。
但是老冯并没有去用很复杂的 HTML 来实现，依然用的是标准的 Markdown 格式，只是在外面套了一层短代码进行必要的内容转换。这个在 Hugo 编译的时候进行必要的内容转换，然后通过定制的 CSS 格式，让它呈现出可观的效果。
同时我们这次也提供了一系列分门别类的列表索引，从不同维度展示扩展的属性信息，方便快速检索定位。站内搜索也比之前的版本好用了不少。
另外，这次我们还将一些 PG 内核分支独有的扩展也收录了进来：
五个版本，兜兜转转回到原点
最后聊一个不那么技术、但挺有感触的话题：文档框架的选型。
这个扩展目录从第一版到现在，前后经历了五个版本：
1.Hugo + Docsy（初版，融合在 Pigsty 主站）2.Docsify3.Next.js4.Hugo + Hextra（独立站点 pgext.cloud）5.Hugo + Docsy（现在，回归 Pigsty 主站）
中间那个独立站点 pgext.cloud，因为没有备案、挂在 Cloudflare 上，有国内用户反馈访问不稳定，怀疑被墙。思来想去，还是老老实实用备案过的域名来做这件事。
第一版：基于 Hugo + Docsy （和这次一样）
第二版：基于 Docsify
第三版：基于 Next.js + Fumadocs
数据库老司机勇闯现代前端大观园 后来实在受不了动态网站的一堆破事，回归静态网站了。\
第四版：基于 Hugo + Hextra
Hextra 是另一个轻量化的，类似 Fumadocs 的主题。我很喜欢，它对于小型项目来说非常合适，比如翻译书什么的。但是对于大型文档站点来说还是有些力不从心。但是老冯的几本书，教程，小项目都很喜欢用这个框架。
这次挂在了独立站点 pgext.cloud 三，因为没有备案、挂在 Cloudflare 上，有国内用户反馈访问不稳定，怀疑被墙。思来想去，还是老老实实用备案过的域名来做这件事。
第五版： Hugo + Docsy
最终的结论其实很简单：
如果你要做静态文档站，选 Hugo 就行了。 Docsy 是 Google 出品的主题，Kubernetes 和 etcd 的文档都在用，基本功扎实，搜索好用，结构清晰，到现在还在活跃更新。轻量级的场景可以用 Hextra，重量级的就上 Docsy。如果需要做内容丰富的动态网站，Next.js 可以考虑，但它有时候确实挺重的。
Hugo 这个框架我用了快十年，从来没让我失望过。折腾了这么多新玩意，最后发现六七年前第一次选的框架就是最合适的选择。这大概也印证了一个道理：扎实的 Boring Technology 才是最好的。 网站不在于做得多炫酷，而在于里面的信息有没有价值。内容为王，始终没变。
你要说这些折腾的时间拿去做视频教程、写实战案例，是不是更有价值？也许吧。但折腾一圈回来，你知道了有哪些选择、它们各自的利弊权衡，提升了自己的 Web 设计经验与品位 —— 这本身就是一种收获。
谁说得准呢？折腾本身，也蛮有乐趣的。
\