从 PGDash 改名为 Crib

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

改了什么

没有改的

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

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

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

旧资料怎样迁移

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

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

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

细节见用户数据与迁移。

兼容旧的写法

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