# 从 PGDash 改名为 Crib

> 哪些名字变了，哪些签名身份保持不变，旧的用户资料怎样迁移。

---

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

---

Crib 开发前期叫 PGDash。2026 年 10 月 28 日决定正式改名为 Crib，10 月 31 日在本地完成迁移并验证。
如果你没用过 PGDash 的开发构建，这篇可以跳过。

## 改了什么 {#renamed}

| 项目 | 原来 | 现在 |
| --- | --- | --- |
| 应用 | `PGDash.app` | `Crib.app` |
| Bundle ID | `com.pgsty.pgdash.*` | `com.pgsty.crib` |
| 用户目录 | `~/Library/Application Support/PGDash` | `~/Library/Application Support/Crib` |
| 深链接 | `pgdash://` | `crib://` |
| MCP 程序与配置键 | `PGDashMCP`、`pgdash` | `CribMCP`、`crib` |
| 环境变量 | `PGDASH_*` | `CRIB_*` |
| 导出文件名 | `PGDash-*` | `Crib-*` |
| 签名版本目录 | `pgdash-signed-catalog-1` | `crib-signed-catalog-1`（v3） |

## 没有改的 {#kept}

已经签名的内容不能改名，否则签名和哈希就对不上了。下面这些标识保持原样，它们只是格式的名字，不代表产品名：

- 资料包清单里的切分规则 `pgdash-han2-v1` 和格式版本；
- 资料包内的章节键、锚点和内容哈希；
- 阅读器读取资料包用的内部地址 `pgdoc://`；
- 2026-11-06 之前签发的 `.pgdocpack` 文件路径。

旧的 v1、v2 版本目录照样能验证和读取；从旧目录到 v3 目录，签名修订号继续递增，不因改名归零，防止有人用旧目录做回滚。

## 旧资料怎样迁移 {#migration}

Crib 第一次启动时，如果发现旧的 PGDash 用户目录、而 Crib 目录还不存在，就做一次迁移：

1. 把旧目录中的所有文件复制到一个临时目录，包括不认识的文件和全部会话；
2. 个人资料库用 SQLite 在线备份复制，正在写入的 WAL 数据也能完整带上；
3. 核对文件清单、哈希和数据库完整性，全部通过才原子地启用新目录；
4. 记录一份迁移回执，重复启动不会再用旧数据覆盖新数据。

旧目录始终只读，不修改也不删除。迁移失败时，Crib 不往新目录写任何东西，下次启动再试；也可以选择跳过迁移。
旧的 API 访问密钥不会被带过来，需要在 Crib 里重新启用本地 API。

细节见[用户数据与迁移](/docs/reference/data/)。

## 兼容旧的写法 {#compat}

- PGDash 时期复制的 `pgdash://` 链接仍能打开；新复制的链接一律是 `crib://`。
- `PGDASH_*` 环境变量仍会读取，同名的 `CRIB_*` 优先。
- 旧的片段导出文件按内容格式识别，不看文件名，可以直接导入。
- MCP 客户端里的旧配置不会被自动改写，请在 Crib 的“设置 → 集成”重新复制一份。