# 464个扩展开箱即用：新版 PG 扩展目录发布

LLMS 索引： [llms.txt](/llms.txt)

---

今天老冯又让 Claude Code 干了一件大好事 —— 做了一个全新的 PostgreSQL 扩展目录。就放在 https://pigsty.cc/ext 这里。

说起来，这已经是第五版了。兜兜转转一大圈，又回到了第一版使用的 Hugo + Docsy 框架，重新融合到 Pigsty 主站。这个过程本身就是个故事，后面再聊。先说说这一版到底做了什么。

![图片](01.webp)

## 不只是有包，还要有文档

之前的扩展目录，核心功能是告诉你：这个扩展叫什么、元数据在哪里、二进制包怎么下载、一键安装怎么搞。你装好了就行，至于怎么用 —— 自己找文档去。

这次不一样了。在 AI 的帮助下，我们开始系统性地收集并翻译这 464 个扩展的文档，目标是让你在一个地方就能看到所有扩展最关键的使用信息。

具体来说，分两种情况：

**对于文档体量巨大的"巨无霸"扩展**，我们会建立专门的子站点来做翻译。比如 Citus、TimescaleDB、PostGIS 这几个，文档量本身就相当于一本书，值得单独对待。

**对于大多数轻量级扩展**，情况其实很简单 —— 它们的全部文档往往就是一页 README。比如 pgvector，作为 PG 生态中最炙手可热的向量数据库扩展，文档就一页纸；

![图片](02.webp)

再比如 pg_repack，这个在线治理表膨胀的运维利器，文档也就是一页 Markdown。

![图片](03.webp)

我们要做的，就是把这些 README 统统收集起来，嵌入到每个扩展的详情页面中。你不用再到处跳转、翻 GitHub，在一个集中的地方就能查阅所有扩展的核心文档。对于特别大的扩展，我们也会把信息索引聚合起来，让你有一个权威可靠的参考入口。

目前 pigsty.cc 已经[完成了 PgBouncer、pgBackRest 和 Patroni 的文档翻译](https://mp.weixin.qq.com/s?__biz=MzU5ODAyNTM5Ng==&mid=2247491396&idx=1&sn=db1796eb86174ab3b1eb8c7f37220def&scene=21#wechat_redirect)。后续所有扩展 —— 包括 PostgreSQL 内核本身 —— 都会逐步推进并持续维护。

[花一天翻完了 PG 生态三大组件的文档](https://mp.weixin.qq.com/s?__biz=MzU5ODAyNTM5Ng==&mid=2247491396&idx=1&sn=db1796eb86174ab3b1eb8c7f37220def&scene=21#wechat_redirect)

这也是我们的一个愿景：**成为 PG 生态中关键信息的可靠来源。**

说实话，很多时候我做"正活"剩下的 AI Token 额度没烧完，就顺手拿来填这些空，算是一种兜底，也算在做公益。

## 同时对 Agent 友好，对人类友好

接下来聊聊这个目录是怎么设计的。

虽然技术栈兜了一圈又回到 Hugo + Docsy，但在 Claude Code 的加持下，纯静态网站也能做出非常出色的效果。设计上，老冯遵循一个核心原则：**同时对 AI Agent 友好，对人类读者友好。**

**对 Agent 友好**，意味着网页的源码是开源的、采用 Markdown 格式，而且有一个硬性要求：减少杂音。Markdown 里不应该混入大量原生 HTML 短代码或格式噪声，否则会给 Agent 的解析和阅读制造很大障碍。

**对人类读者友好**，意味着要把信息高效组织为美观的可视化形式，让人能直观地发现问题、聚焦关键信息。

![图片](04.webp)

举个具体例子：这一版我们做了一个很实用的尝试 —— 将所有扩展融合进一张大表格。在特定的 PG 版本和操作系统组合下，你可以通过单元格直接看到有多少个可用的包、来自哪个仓库，点击即可下载，非常方便。

但是老冯并没有去用很复杂的 HTML 来实现，依然用的是标准的 Markdown 格式，只是在外面套了一层短代码进行必要的内容转换。这个在 Hugo 编译的时候进行必要的内容转换，然后通过定制的 CSS 格式，让它呈现出可观的效果。

![图片](05.webp)

同时我们这次也提供了一系列分门别类的列表索引，从不同维度展示扩展的属性信息，方便快速检索定位。站内搜索也比之前的版本好用了不少。

![图片](06.webp)

![图片](07.webp)

![图片](08.webp)

![图片](09.webp)

![图片](10.webp)

![图片](11.webp)

![图片](12.webp)

另外，这次我们还将一些 PG 内核分支独有的扩展也收录了进来：

![图片](13.webp)

## 五个版本，兜兜转转回到原点

最后聊一个不那么技术、但挺有感触的话题：文档框架的选型。

这个扩展目录从第一版到现在，前后经历了五个版本：

1.Hugo + Docsy（初版，融合在 Pigsty 主站）2.Docsify3.Next.js4.Hugo + Hextra（独立站点 pgext.cloud）5.Hugo + Docsy（现在，回归 Pigsty 主站）

中间那个独立站点 pgext.cloud，因为没有备案、挂在 Cloudflare 上，有国内用户反馈访问不稳定，怀疑被墙。思来想去，还是老老实实用备案过的域名来做这件事。

第一版：基于 Hugo + Docsy （和这次一样）

![图片](14.webp)

第二版：基于 Docsify

![图片](15.webp)

[小猪骑大象：PG内核与扩展包管理神器](/pg/pig/)

第三版：基于 Next.js + Fumadocs

![图片](16.webp)[数据库老司机勇闯现代前端大观园](/db/dba-meets-frontend/) 后来实在受不了动态网站的一堆破事，回归静态网站了。\

第四版：基于 Hugo + Hextra

![图片](17.webp)

[PG扩展云，免翻免费解锁PG完全体](https://mp.weixin.qq.com/s?__biz=MzU5ODAyNTM5Ng==&mid=2247490551&idx=1&sn=e85d76039ecaa41576f58cd1fe49e048&scene=21#wechat_redirect)

Hextra 是另一个轻量化的，类似 Fumadocs 的主题。我很喜欢，它对于小型项目来说非常合适，比如翻译书什么的。但是对于大型文档站点来说还是有些力不从心。但是老冯的几本书，教程，小项目都很喜欢用这个框架。

这次挂在了独立站点 pgext.cloud 三，因为没有备案、挂在 Cloudflare 上，有国内用户反馈访问不稳定，怀疑被墙。思来想去，还是老老实实用备案过的域名来做这件事。

第五版： Hugo + Docsy

![图片](14.webp)

最终的结论其实很简单：

**如果你要做静态文档站，选 Hugo 就行了。** Docsy 是 Google 出品的主题，Kubernetes 和 etcd 的文档都在用，基本功扎实，搜索好用，结构清晰，到现在还在活跃更新。轻量级的场景可以用 Hextra，重量级的就上 Docsy。如果需要做内容丰富的动态网站，Next.js 可以考虑，但它有时候确实挺重的。

Hugo 这个框架我用了快十年，从来没让我失望过。折腾了这么多新玩意，最后发现六七年前第一次选的框架就是最合适的选择。这大概也印证了一个道理：**扎实的 Boring Technology 才是最好的。** 网站不在于做得多炫酷，而在于里面的信息有没有价值。内容为王，始终没变。

你要说这些折腾的时间拿去做视频教程、写实战案例，是不是更有价值？也许吧。但折腾一圈回来，你知道了有哪些选择、它们各自的利弊权衡，提升了自己的 Web 设计经验与品位 —— 这本身就是一种收获。

谁说得准呢？折腾本身，也蛮有乐趣的。

![图片](18.webp)\