安装与首次启动
Crib 现在能不能装、需要什么系统、两种版本有什么区别，以及第一次打开时会发生什么。
还没有公开安装包
Crib 仍在开发中，没有公开下载，也没有确定价格和许可证。发布后安装包会放在下载页。本页描述的是当前开发构建的行为。开发构建只有临时签名，没有经过 Apple 公证。
系统要求
| 项目 | 现状 |
|---|---|
| 部署目标 | macOS 14 |
| 已测试 | 只在 Apple 芯片（arm64）的开发机上测试过 |
| 未测试 | 实际运行在 macOS 14 上、Intel Mac |
| 网络 | 首次启动和日常阅读、搜索都不需要；只有下载其他版本时需要 |
部署目标是编译设置，不等于已经在 macOS 14 上验证过。正式发布前会单列实测过的系统和机型。
两种版本
| 完整离线版 | Core | |
|---|---|---|
| 内置手册 | 全部 31 条版本线，中英文共 62 套 | PG 18.6 中英文手册 |
| 内置 Wiki | 有 | 无，按需下载 |
| 搜索索引 | 随应用附带，覆盖全部内置内容 | 随应用附带 18.6 的索引；下载其他版本后在本机建立 |
| 其他版本 | 不需要下载 | 从签名的版本目录选择安装 |
两种版本的区别在于随应用附带多少内容。Core 下载的每个资料包都会先校验签名，再建立索引、切换到新内容；下载失败或取消时，已安装的内容照常可用。获取和管理版本见资料库。
Core 按需下载所用的版本目录还没有在正式地址上线，在那之前 Core 无法联网下载其他版本。手头有
.crib 资料包文件时，可以在资料库中“导入资料包…”。首次启动
- 打开 Crib。不需要账号，也不需要联网：两种版本都直接使用随应用附带的内容和索引。
- 窗口默认打开 PG 18 中文手册，内容版本是 18.6。搜索范围默认是“PG 18 · 简体中文 · 手册”。
- 按 ⌘ 加 L 开始搜索。搜索语法见搜索。
- 点工具栏的主页按钮（⇧ 加 ⌘ 加 H）可以回到主页，从“获取版本”“资料库”“搜索方案”“快捷键”四个入口继续设置。
本地 API 和三个全局快捷键默认关闭，不会在首次启动时请求权限。只有“搜索选中文字”全局快捷键需要辅助功能权限，开启时再授予。
个人资料放在哪里
设置、片段库、笔记、书签、更正、阅读历史和下载的资料包都存放在：
这个目录不在应用包内。卸载某个文档版本不会删除挂在上面的笔记和更正。各文件的用途见用户数据与迁移。
从 PGDash 迁移
Crib 以前叫 PGDash。如果本机有 ~/Library/Application Support/PGDash/，Crib 启动时会把它复制一份到新目录，旧目录原样保留，不修改也不删除。
- 迁移失败时，Crib 以只读方式运行：可以阅读和搜索内置内容，但笔记、书签、更正、阅读历史、下载和设置都不能修改。每次启动会重试；提示中也可以“重试迁移”或“跳过迁移…”。
- 跳过迁移后，Crib 从空白的个人资料开始，旧资料原样留在原目录。
- 已经有 Crib 资料时又发现旧资料，Crib 会提示“发现 PGDash 旧资料”，由你选择“迁移旧资料”或“不再提示”。选择迁移时，现有的 Crib 资料会整体移到一旁保留。
迁移的完整规则和恢复办法见用户数据与迁移。