# 11 月第一周：深度评审与界面重设计

> 修完一轮深度设计评审，重做界面与文案，资料包改用 .crib 扩展名。

---

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

---

这一周做了三件事。它们都还停留在本地开发构建，没有发布。

## 深度设计评审的修复 {#review}

11 月 5 日对整个项目做了一轮深度设计评审，列出了 9 个最高优先级（P0）和 8 个次高优先级（P1）问题。
本周修完了其中 8 个 P0 和全部 P1，以及各子系统的大部分中低优先级问题；复核修复本身时又发现二十多处问题，也逐项修复并补了回归测试。
源码也是在这一轮第一次进入 Git，按主题分批提交。

几处读者能感受到的变化：

- **开发签名的内容只在声明过的构建里被接受。** 开发构建在资料库标题旁显示“非正式发布”徽标；正式构建拒绝开发密钥签名的内容。
- **签名密钥可以限定用途和到期时间。** 一把密钥可以只用于资料包、出厂索引或版本目录之一，到期后不能再用于获取新内容，但已安装的内容不会因此失效。
- **本地 API 先验证服务端再发送密钥。** 如果 Crib 崩溃后端口被别的程序占用，客户端不会把访问密钥发给它。
- **个人资料库打不开时只停用个人功能。** 阅读和搜索照常工作，并提供从备份恢复或移走后新建的选项，默认什么都不删。
- **版本目录更宽容。** 某个非默认版本的条目校验失败时，只丢弃这一条并提示，不再整份目录作废。

剩下的一个 P0 是生产密钥：机制已经就位，但生产密钥、两级密钥和撤销流程还没有建立，所以经过公证的正式版暂时还不能携带可下载的内容。

## 界面与文案重设计 {#redesign}

界面换了一套设计规范，参考 Cloudflare Kumo 的设计语言和 Fluid Functionalism 的动效原则，落在 macOS 原生控件上：

- 无色相的灰阶加一种墨蓝强调色，只用于链接、当前项和主要操作；
- 图标全部改为 SF Symbols 线性图标；
- 标题用 semibold，不用粗体；平面之间用细线分隔，不叠阴影；
- 悬停变色不做动画，展开和弹出用短弹簧动画，开启“减弱动态效果”时全部取消。

阅读器的样式也改用同一套色板，顺带修好了深色模式下一部分加粗字发灰的问题。

源码中约 1,700 条中文字符串逐条按新的语气和术语表重写或确认，最长的提示从约 130 字缩到约 60 字。
原则是只在必要时说话：正常状态不提示，提示只说发生了什么、可以怎么做。比如版本目录里的 active 状态译为“常规”，
不写“受支持”，因为它只表示出现在普通列表里，不是上游的维护承诺。

本站的截图就来自重设计后的开发构建。

## 资料包改用 .crib 扩展名 {#extension}

资料包原本暂用 `.pgdocpack` 扩展名，现在新发布一律写 `.crib`，例如 `pg/18.6-r4.crib`、`pgwiki/r5.crib`。
已经签发的 `.pgdocpack` 路径写在签名目录里，作为签名身份继续有效，应用和发布工具都接受；其他扩展名一律拒绝。
包内的格式和内容哈希都没有变。见[资料包格式](/docs/library/packs/)。

## 还没做完的 {#open}

- 真实桌面窗口、工具栏、实体键盘与输入法的目测验收（本周只有离屏快照和隐藏窗口测试）；
- A01–A10 验收项绑定到最终候选构建；
- 生产密钥、Developer ID 签名与公证；
- 应用代码许可证和内容再分发许可；
- 应用图标、`.crib` 文件类型注册（双击导入）、应用自动更新、界面本地化。

完整清单见[发布状态](/docs/intro/status/)。