# 安装与首次启动

> Crib 现在能不能装、需要什么系统、两种版本有什么区别，以及第一次打开时会发生什么。

---

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

---

> [!WARNING] 还没有公开安装包
>
> Crib 仍在开发中，没有公开下载，也没有确定价格和许可证。发布后安装包会放在[下载页](/download/)。
> 本页描述的是当前开发构建的行为。开发构建只有临时签名，没有经过 Apple 公证。

## 系统要求 {#requirements}

| 项目 | 现状 |
| --- | --- |
| 部署目标 | macOS 14 |
| 已测试 | 只在 Apple 芯片（arm64）的开发机上测试过 |
| 未测试 | 实际运行在 macOS 14 上、Intel Mac |
| 网络 | 首次启动和日常阅读、搜索都不需要；只有下载其他版本时需要 |

部署目标是编译设置，不等于已经在 macOS 14 上验证过。正式发布前会单列实测过的系统和机型。

## 两种版本 {#editions}

| | 完整离线版 | Core |
| --- | --- | --- |
| 内置手册 | 全部 31 条版本线，中英文共 62 套 | PG 18.6 中英文手册 |
| 内置 Wiki | 有 | 无，按需下载 |
| 搜索索引 | 随应用附带，覆盖全部内置内容 | 随应用附带 18.6 的索引；下载其他版本后在本机建立 |
| 其他版本 | 不需要下载 | 从签名的版本目录选择安装 |

两种版本的区别在于随应用附带多少内容。Core 下载的每个资料包都会先校验签名，再建立索引、切换到新内容；下载失败或取消时，已安装的内容照常可用。获取和管理版本见[资料库](/docs/library/)。

> [!NOTE]
>
> Core 按需下载所用的版本目录还没有在正式地址上线，在那之前 Core 无法联网下载其他版本。手头有 `.crib` 资料包文件时，可以在资料库中“导入资料包…”。

## 首次启动 {#first-launch}

1. 打开 Crib。不需要账号，也不需要联网：两种版本都直接使用随应用附带的内容和索引。
1. 窗口默认打开 PG 18 中文手册，内容版本是 18.6。搜索范围默认是“PG 18 · 简体中文 · 手册”。
1. 按 ⌘ + L 开始搜索。搜索语法见[搜索](/docs/guide/search/)。
1. 点工具栏的主页按钮（⇧ + ⌘ + H）可以回到主页，从“获取版本”“资料库”“搜索方案”“快捷键”四个入口继续设置。
{.steps}

本地 API 和三个全局快捷键默认关闭，不会在首次启动时请求权限。只有“搜索选中文字”全局快捷键需要辅助功能权限，开启时再授予。

## 个人资料放在哪里 {#user-data}

设置、片段库、笔记、书签、更正、阅读历史和下载的资料包都存放在：

```text
~/Library/Application Support/Crib/
```

这个目录不在应用包内。卸载某个文档版本不会删除挂在上面的笔记和更正。各文件的用途见[用户数据与迁移](/docs/reference/data/)。

### 从 PGDash 迁移 {#migrate-from-pgdash}

Crib 以前叫 PGDash。如果本机有 `~/Library/Application Support/PGDash/`，Crib 启动时会把它复制一份到新目录，旧目录原样保留，不修改也不删除。

- 迁移失败时，Crib 以只读方式运行：可以阅读和搜索内置内容，但笔记、书签、更正、阅读历史、下载和设置都不能修改。每次启动会重试；提示中也可以“重试迁移”或“跳过迁移…”。
- 跳过迁移后，Crib 从空白的个人资料开始，旧资料原样留在原目录。
- 已经有 Crib 资料时又发现旧资料，Crib 会提示“发现 PGDash 旧资料”，由你选择“迁移旧资料”或“不再提示”。选择迁移时，现有的 Crib 资料会整体移到一旁保留。

迁移的完整规则和恢复办法见[用户数据与迁移](/docs/reference/data/)。

---

反链：

- [文档](/docs/)
- [Crib 是什么](/docs/intro/overview/)