Crib 是什么

Crib 是一款 macOS 应用，把 PostgreSQL 6.3 到 20devel 共 31 条版本线的中英文手册、一份结构化的 PostgreSQL Wiki，以及你自己的笔记和更正放在同一个本地资料库里。它不需要账号，不依赖网络，也不需要连接 PostgreSQL 服务器。

它解决什么问题

查 PostgreSQL 文档时常见的几个麻烦：

• 版本对不上。 生产库还在 9.6 或 12，网上搜到的却是最新版手册。Crib 收录每条版本线，搜索时可以直接写 PG96: vacuum。
• 符号搜不到。 ->>、@@、\dC 这类写法在通用搜索引擎里会被当成标点丢掉。Crib 先按精确名称匹配，再搜正文。
• 中英文来回找。 读中文手册遇到拿不准的句子，想看英文原文，往往要重新翻目录。Crib 一键切到另一种语言的同一节，也可以两栏对照。
• 断网或内网环境。 机房、飞机、隔离网络里打不开在线文档。Crib 首次启动就能离线阅读和搜索。
• 笔记散落各处。 排障时记下的结论和手册原文分开放，过一阵就找不到出处。Crib 的笔记、书签和更正挂在具体章节上，内容更新后会重新核对位置，找不到的单独列出。

适合谁

和其他方式的区别

Crib 借鉴了 Dash 的片段库、系统服务和本地 API 等用法。区别在于内容格式：Crib 的 .crib 资料包自带双语章节对应、版本信息和签名，不使用也不兼容 Dash docset。

它不做什么

• 不连接数据库，不执行 SQL。
• 不翻译。中文内容只来自已有的中文译本；某一节没有译文时，明确显示缺失，不拿英文冒充。
• 不改写官方原文。你的更正存在个人资料库里，与原文并列显示。
• 没有云同步。个人资料可以导出、导入和备份，但不会自动上传到任何地方。

现在的状态

Crib 还在开发中，没有公开安装包。本站文档描述的是当前开发构建的行为。已经完成和尚未完成的部分见发布状态。

接下来读什么

• 收录内容 — 31 条版本线和 30 个 Wiki 集合的明细。
• 工作原理 — 资料包、搜索索引和个人资料怎样分开存放。
• 安装与首次启动 — 两个版本的区别，首次启动做了什么。