文风字体包

适合谁看：想把字体文件放在自己站点上，不从文风远程加载的站长。

文风字体包：把文风已经切好的 zip 装到本站，由本站托管。切分字体仍在文风完成（wenfeng.org / app.windfonts.com），插件不切字。

怎么装

1. 打开 设置 → 文派字库 的「字体包」页。
2. 把 zip 拖进去（或选择文件）即可安装。
3. 安装后按需启用。未启用的包不会进前台。

文件落在：

wp-content/uploads/wpfonts/packages/

安装时的命名（rc.8）

自 2.0.0-rc.8 起，安装时会尽量把包内族名对齐目录约定的 wenfeng-{short}，方便与文风云、字体目录共用同一套短名。

插件会依次读取：

1. 包内 meta.json / metadata.json / font.json 的 fontFamily（或 font_family）
2. 若没有可用目录名，再读解压后的 result.css 里第一条 @font-face 的 font-family

识别规则：

对齐成功时：

• 包 id、字体库 slug、全局样式 slug 都用这个 wenfeng-*（不再套一层 wpfonts-pkg-）
• 写入的 local.css 会把 @font-face 的 font-family 改成同一短名；url() 里的 woff2 文件名与字体文件本身不改名
• 页面上的显示名仍可用元数据里的中文名，或 zip 文件名

认不出目录名、只能走 zip 名回退时：字体库 slug 继续用原来的 wpfonts-pkg- 前缀。

已经装好的旧包目录不会被改写；要得到 wenfeng-* 登记，请在 rc.8（含）以上重新安装该 zip。插件仍然不切字、也不上传字体。

启用之后

启用文风字体包后（2.0.0-rc.4 起；命名对齐自 rc.8）：

1. 字体进入 WordPress 字体库，集合名是「文风字体」（Windfonts）。
2. 自 2.0.0-rc.5 起，还会自动同步进用户全局样式，可在 外观 → 编辑器 → 样式 → 排版 选用。
3. 未启用的包：不进前台，也不进该字体库集合 / 排版同步。

不必再到字体库里手动「安装」一遍。侧栏选用见《编辑器与全局样式》。

包健康说明（rc.7）

字体包页会用中文说明常见异常，例如：

• 缺少 local.css：包目录里没有可用的本地样式入口。
• 没有可用的 woff2：样式里找不到能加载的字体文件。
• 已启用但不会加载：开关开着，但上述问题导致前台仍不会挂上该包。

注意：uploads 目录里还有别的、未读到的包文件夹，不会把本来健康的已登记包装成「坏包」。健康提示只针对插件已识别、正在管理的那几份。

和文风云的关系

• 与文风云开关互不影响。
• 可以只装包、不开文风云；也可以两边都开。
• 启用后的包，前台加载本站的 local.css，不依赖文风远程样式链接。
• 自 rc.8 起，能对齐的本站包与云字脸共用 wenfeng-* 短名，选型时更不容易对不上。

管理

每个包可以：

• 启用 / 停用：控制是否对前台生效；停用后插件会只移除本插件写入的全局样式条目
• 删除：卸掉本站这份文件（不影响文风侧的源包）

卸载插件时，默认不删已安装的文风字体包；需要的话在文件系统里自行清理 uploads/wpfonts/packages/。卸载也不删除用户全局样式，见《编辑器与全局样式》。

导出与导入（见工具页）

自 2.0.0-rc.7 起，可在 设置 → 文派字库 → 工具 导出 / 导入：已启用包的元数据 + 已确认的文风云脸。文件不含 API Key；若整份文件里仍带有 Key，导入会整份拒绝。详见《常见问题》。