文风云

适合谁看：想让站点从前台加载文风远程网页字体的站长。

文风云默认关闭。开启并保存后，前台只为已确认可用的云字脸挂 allowlist 样式链接；网页里不会出现 API Key。自 2.0.0-rc.7 起，可以同时保存多张已确认的 wenfeng-* 脸。

手工贴 <link> 也能接文风，见文风用户文档《网页字体引用与 CDN 接入》。用插件可以少拼地址、少抄字体名。

开启前准备

在 设置 → 文派字库 → 设置 里：

1. 打开文风云。
2. 选文风服务器：仅 cn.windfonts.com、hk.windfonts.com、en.windfonts.com。
3. 从本机目录选用字体名（wenfeng-*），或填写进阶用的项目名；可确认多张脸。
4. 选字符范围。
5. （可选）填写文风 API Key，在工具页验证。

未填字体名、也未填项目名、且没有任何已确认脸时，前台不会加载样式链接。公开 /api/css 没有字体名时返回的不是 CSS。公开样式若 404，插件不会嵌入，也不会宣称已加载。

多张已确认脸（rc.7）

• 字体库集合「文风云」与块侧栏「文派字库」会列出全部已确认脸。
• 从 2.0.0-rc.6 只存单脸的站点升级后，仍保留那张脸，可继续追加。
• 从前台按脸各输出一条 allowlist 样式链接（仍不把 Key 打进 HTML）。
• 去掉某一张脸时，只移除本插件为该脸写入的全局样式条目；其它脸与其它 GS 不动。

启用之后（样式确认可用）

文风云样式确认可用后（2.0.0-rc.4 起；多脸自 rc.7）：

1. 对应字体脸进入 WordPress 字体库，集合名是「文风云」。
2. 自 2.0.0-rc.5 起，还会自动同步进用户全局样式，可在 外观 → 编辑器 → 样式 → 排版 选用。
3. 未填字体名/项目名、或 Key 未通过、样式未确认时：不加载对应前台链接，也不进该集合 / 排版同步。

不必再到字体库里手动「安装」一遍。侧栏只改当前块；全站排版走全局样式。见《编辑器与全局样式》。

若同一张字也以本站包安装：自 2.0.0-rc.8 起，能识别的包内族名会对齐成同一 wenfeng-* 短名，选型时更不容易和云字脸对不上。见《文风字体包》。

两条地址形态

填了项目名后，前台改用项目样式；公开地址可以不填字体名。

文风 API Key

Key 只在服务器上请求 https://app.windfonts.com/api/key/status 做校验。它不进入网页，也不写进样式地址，也不会出现在工具页的导出文件里。

Key 无效时，按工具页提示处理；不要把 Key 贴进主题或页面 HTML。

字符范围（四档）

字符范围决定远程字体包大小。插件不在这里切字。

字体目录

设置页目录来自本机 catalog.json（约在 wp-content/uploads/wpfonts/）。大约每月自动更新；也可点「更新字体目录」。打开设置页本身不会去打文风。

更新失败不会盖掉已有好快照。没有目录时仍可手填 wenfeng-* 字体名。

更细的目录行为见《字体目录与选用》。