跳转到主要内容

macOS 应用 · PostgreSQL 6.3–20devel · 开发中，尚未发布

放在手边的PostgreSQL 手册

31 条版本线的中英文手册和 Wiki 装进一个 macOS 应用，
断网也能搜索、阅读，中英文一键切到同一节。

PGSTY 开发 · 手册版权归原作者与译者

阅读文档 下载 开发日志
Crib 的搜索界面：左侧是资料分类，中间是 work_mem 的搜索结果，每条标注版本、语言和类型，右侧打开了 PostgreSQL 18.6 中文手册
搜索 work_mem：结果标注版本、语言和类型，右侧直接打开 18.6 中文手册。截图来自 2026-11-06 的开发构建。

收录内容

一次安装，31 个版本的手册都在本地

完整离线版随附全部内容和预建的搜索索引；Core 版只带 18.6，其余按需下载。

31条版本线从 6.3 到 20devel，每条固定一个版本
62套完整手册每条版本线中英文各一套
30个 Wiki 集合参数、函数、等待事件等六组条目
18.6默认版本首次启动打开中文手册，无需联网

能做什么

查得准，读得顺，记得住

搜索

先认技术名词，再搜正文

◇ 符号、大小写和中文都按原样处理

  • ->>、@@、\d+ 和 SQLSTATE 代码按精确名称优先命中
  • 中文按双字切分检索，锁、复制延迟、VACUUM 冻结 都能找到并高亮
  • 查询前缀限定版本：PG96: vacuum、[email protected]: max_connections lang:en

同一个概念在多个版本里命中时折叠成一组，展开即可逐版对比。

搜索框
# 默认在 PG 18 中文里搜
› max_connections
# 指定版本和语言
› PG96: vacuum lang:en
# 符号与 psql 命令
› ->>
› \dC
# 中文
› 复制延迟

阅读

中英文切到同一节

◇ 定位依据是手册源码里的章节标识，不靠标题猜

  • 一键在中英文之间切换，停在对应小节；没有对应小节时回到父节，并明确提示
  • 双语对照：两栏并排，按已配对的章节同步
  • 原生窗口与标签页、目录、阅读历史、页内查找

62 套手册之间有 77,580 对经过验证的章节对应。

Crib 阅读界面：左侧资料分类，中间是 PostgreSQL 18.6 中文手册的目录，右侧是手册正文

记录

笔记和更正存在自己的库里

◇ 官方原文不改一个字

  • Markdown 笔记自动保存；两处同时编辑时另存为冲突副本，不覆盖
  • 书签、标签和阅读历史；可以对选中的段落写本地更正，原文与修改并列显示
  • 个人资料可以导出、导入和备份；卸载文档版本不会删除笔记

内容更新后，笔记按原锚点重新定位；找不到的列出来等你处理。

资料库

版本按需装，坏了能退回

◇ 每个资料包都签名、带来源清单

  • pg18、pg96 等别名解析到确切版本，不拿旧小版本冒充
  • 下载、校验、建索引都在后台完成，验证通过才切换，旧窗口继续可读
  • 失败、取消或磁盘不足时保留原来的资料组合，也可以手动恢复到之前的组合

只移动别名不重建索引；只有实际更换资料包才重建。

别名解析
  pg
→ pg18
→ [email protected]
→ postgresql/manual/18 · 18.6 · r4
  en + zh-Hans · Ed25519 签名

集成

让编辑器和 AI 客户端也能查

◇ 默认关闭，只监听本机

  • 本地 API：只读已启用的文档，先验证服务端身份再发送密钥
  • 随附 CribMCP，MCP 客户端可以搜索和读取章节
  • 系统服务：在任意应用中选中文字，从“服务”菜单在 Crib 中查找

笔记、书签、片段和本地更正不对外开放。

mcp.json
{ "mcpServers": { "crib": {
    "command": "/Applications/Crib.app/Contents/MacOS/CribMCP",
    "args": ["--user-data", "<用户主目录>/Library/Application Support/Crib"]
} } }

文档

从这里开始

Crib 是什么

适合谁用，收录什么，和在线手册有什么不同。

搜索语法

版本前缀、语言和类型过滤、精确搜索与中文检索。

资料库

获取、启用、更新和回滚文档版本。

发布状态

已经做完什么，正式发布前还差什么。

常见问题

发布之前先说清楚

现在能下载吗？

还不能。Crib 只有本地开发构建，尚未完成 Developer ID 签名、Apple 公证和内容再分发许可的核对，也没有公开的资料包目录。进度见发布状态。

需要联网或注册账号吗？

不需要。手册和搜索索引随应用安装，首次启动断网即可阅读和搜索。只有下载其他版本、刷新版本目录或使用网页搜索时才联网。没有账号，也没有云同步。

支持哪些 Mac？

应用按 macOS 14 部署目标构建，目前只在 Apple Silicon、macOS 27 的开发机上实测过。macOS 14 实机和 Intel Mac 尚未测试，发布前不作支持承诺。

中文手册从哪里来？

来自 pgdoc 收录的各版本中文译本，每套手册保留自己的译者与版权声明。Wiki 来自 pg.center 的冻结快照，每条事实保留来源和版本。

收费吗？开源吗？

都还没有定。应用代码尚未选定许可证，源码暂未公开。确定后会在这里和下载页写明。

和 Dash 有什么关系？

Crib 借鉴了 Dash 的片段、系统服务和本地 API 等用法，但内容格式是自己的：.crib 资料包带双语对应、版本信息和签名，不兼容 Dash docset。

想第一时间知道发布？开发日志记录每个阶段做完了什么、还差什么。

看开发日志