字体目录与选用

适合谁看：在设置里选字体名，或目录空白、更新失败时来排查的人。

设置页只读本机快照，不在打开设置时去请求文风。

快照在哪

路径大致是：

wp-content/uploads/wpfonts/catalog.json

结构形如：更新时间 + 字体列表；选用时写入的是 fontFamily（例如 wenfeng-zhi-mang-xing），不是别的字段。

何时更新

• WP-Cron 大约每 30 天自动拉一次目录并写成快照。
• 也可在设置里点「更新字体目录」立刻更新。
• 手动更新有约 60 秒冷却，避免连点打爆接口。
• 首装若还没有快照，会排队做一次立即刷新（打开设置页本身仍不会去打目录）。

失败时会怎样

更新失败不会盖掉已有好快照。你仍会看到上一份目录。

没有快照时，仍可手填 wenfeng-* 字体名；装好文风字体包的站点，也可以先走本站包，不必等目录。

选用写入什么

在设置里选中一款字后，保存的是 fontFamily。公开轨拼 /api/css 时用它；和目录里的显示名可能不一样，以 wenfeng-* 为准。

自 2.0.0-rc.7 起，可把多张目录脸确认为文风云脸；字体库「文风云」与侧栏会列出全部已确认项。详见《文风云》。