本次WordPress主题更新新增默认关闭的AI工具箱，提供文章摘要生成、标签建议功能，配套供应商配置、密钥加密、调用护栏等管控能力；同时系统性优化移动端首屏体验，涵盖图片适配下发、渲染资源调整、数据库查询优化，修复了SEO、时间显示等多类历史问题，也明确了相关升级注意事项。
本次更新带来了 AI 工具箱（文章摘要与标签建议），并针对移动端首屏体验做了一轮系统性的优化——图片按屏幕尺寸下发、渲染阻塞资源前移或卸载、多处数据库查询由 N+1 改为聚合。同时修复了一批影响 SEO 与时间显示的历史问题。
新功能
AI 工具箱
主题选项新增独立的「AI」分组，默认关闭。开启并填入 API Key 后可用两个模块：
- 文章摘要：在文章顶部输出摘要卡，支持「概览 / 导读 / 一句话」三种风格，前台带打字机呈现效果。后台文章编辑页提供元框，可手动生成与重新生成，也可设置为文章更新时自动生成，并可选择同步写入 WordPress 摘要字段。
- 标签建议：编辑器侧栏面板，根据正文内容推荐标签，可限制推荐数量，并可选择用于回填 SEO 关键词。
支撑这两个模块的是主题自带的一层轻量 AI 客户端，站长可控的部分包括：
- 供应商配置：内置 OpenAI 兼容协议适配，可配置接口地址与模型；另有一组备用供应商配置，主供应商失败时按模块分别指定是否回落。
- 密钥加密存储：API Key 不以明文落库。
- 调用护栏：单次请求与单个任务的输入 Token 上限、每月 Token 总量上限，超限即拒绝调用；对自定义接口地址做 SSRF 校验，避免被指向内网。
- 成本可见：可按模型配置输入/输出单价（含默认单价兜底），调用日志记录用量与费用，日志保留天数可设置。
- 长文分块：超出上下文长度的文章自动分块处理。
- 命令行入口：提供 WP-CLI 命令，可批量为已有文章生成摘要或标签。
摘要卡已登记进公共组件的变量作用域，因此在全部 14 套皮肤下都能自动跟随配色，无需逐皮肤适配。
图片按屏幕尺寸下发
新增「基础设置 → 性能优化 → 图片按屏幕尺寸下发」（默认开启）。
此前主题有三类图片绕过了 WordPress 的图片输出函数，既没有 srcset 也没有尺寸后缀，手机上会为一个几百像素宽的位置下载整张原图（实测某站首页焦点图为 1.99 MB 的 PNG）。本版：
- 为这些图片补齐
srcset，让浏览器按实际需要挑选尺寸； - 修正
sizes申报值。WordPress 默认申报100vw，会导致手机照样挑最大的候选图，现改为按图片在版面中的真实宽度申报； - 新增「移动端图片画质」三档（默认「均衡」），通过等效限制像素密度上限进一步压缩移动端流量；
- 新增「图片 CDN 地址模板」，可将图片 URL 改写到自建 CDN。
该模块的附件反查结果会缓存在文章元数据里，第二次渲染起不产生额外查询；实测开关开启前后每页查询数持平（首页 100、搜索页 57、文章页 69）。
优化
首屏渲染
针对「浏览器标题已经变了、正文还是一片空白」这类渲染被阻塞的现象：
- 新增「jQuery 移到页脚」开关（默认开启）。此前主题会把 jQuery（gzip 后约 31 KB）作为同步脚本打印在
</head>之前，直接阻塞解析与首次绘制。 - 评论相关脚本改为仅在存在评论表单的页面加载，且落到页脚。
- 按页面实际内容卸载用不到的资源：没有图片的页面不再加载灯箱，没有代码块的页面不再加载代码高亮，弹层组件只在文章页与说说页保留。短代码渲染出的图片会被兜底识别，不会误卸。
- 图标字体补上
font-display: swap，此前等同于block，字体未就绪时图标位置为空白。 - 资源域预连接补上上传目录所在域名，首图不必再多等一次 TLS 握手。
实测（移动端 UA、本地环境）：head 中的同步 JS 由 1 个降为 0，渲染阻塞的 CSS 由 16 个降为 12 个，整页 JS 由 15 个降为 8 个。
数据库查询
多处 N+1 查询改为聚合查询，页面查询数明显下降：
- 归档统计的年、月两条分组查询合并为一条；
- 文章评论数改为聚合查询并按主查询批量预热；
- 走心评论的四项统计合并为一条查询，列表页预热文章对象缓存；
- 评论排名徽章改为批量预热评论计数；
- IP 地理库的定时任务在频率已符合预期时不再重复写入选项表。
字体
- 全站字体收敛为三个统一令牌（正文 / 标题 / 界面），各皮肤在自己的作用域内覆盖，跨 Mac 与 Windows 的中文回落链一并补齐（补入苹方、微软雅黑、思源宋体等），避免 Windows 下掉字。
- 自定义字体改为「头尾注入」：用户字体插入字体栈最前、用户回落追加到最后，皮肤原有字体栈完整保留在中段，兼顾覆盖效果与中文回落。
- 自定义字体样式表改为异步加载，不再阻塞首屏渲染。
兼容性
- 区块升级到 apiVersion 3：WordPress 6.9 起旧版区块 API 已弃用，且会让整个编辑器退回非 iframe 模式。主题的 20 个区块与搜索区块一并升级，编辑器画布样式按 iframe 通道重新分流，消除了后台「样式被错误加入 iframe」的告警。
- 与 SEO 插件共存：检测到 Yoast SEO、Rank Math、All in One SEO、SEOPress 时，主题的 SEO 输出（含 canonical、Open Graph、结构化数据）整体让位，避免重复标签互相干扰。
- 避免与统计类插件函数冲突：主题原有一个全局裸函数名
parse_user_agent()，与部分统计、防护插件的同名内置函数冲突时会导致致命错误。现已加上主题前缀。 - 火山引擎 ImageX 图床 SDK 升级至 v1.0.174。
构建
发布流水线在打包前压缩 assets/ 下的 CSS 与 JS。典型文章页的这部分资源体积（gzip 后）由约 67 KB 降至约 42 KB，减少约 38%。仓库内的源文件保持原样，不影响二次开发。
修复
- 修复全站缺失 canonical 链接。主题早期移除了 WordPress 自带的 canonical 输出，但 SEO 增强模块误以为核心仍在输出，导致启用后全站没有任何 canonical，
?replytocom、?utm_*及各类分页都被搜索引擎当作独立 URL。此问题自 SEO 增强模块上线起一直存在，对收录影响较大，建议尽快升级。 - 修复归档页 Open Graph 信息指向首篇文章。分类页、标签页、作者页、日期页、搜索页的
og:url与og:title原先直接读取全局文章对象，而该对象已被 WordPress 设为本页第一篇文章，导致这些页面对外自称某篇具体文章。同时作者页、日期页、搜索页不再输出空的描述标签。 - 修复特色页面时间未按站点时区计算。榜首评论人、友链最近访客、走心评论的「本月」统计、心情记录、文章热度图、随机文章、站点看板建站天数、热点文章时间窗口等处混用了原生时间函数与 WordPress 时区函数，导致日期分界按 UTC 计算，或时区偏移被重复叠加。现已统一口径。
- 修复 Gutenberg 粘贴 Markdown 时代码块语言识别失效或错位。从聊天窗口、编辑器复制的 Markdown 一定会附带一份 HTML 格式，此前一旦检测到就会放弃转换，围栏中标注的语言被丢弃；混合内容下还可能整体错位一格，把 PHP 标成 bash 且无任何提示。现改为只依据纯文本判断，并放宽了围栏的识别范围（列表项内的缩进围栏、波浪号围栏、四个以上反引号、语言后带附加参数的写法），同时改为按代码内容对齐而非按序号对齐。
- 修复皮肤的正文列表样式污染插件列表。皮肤为正文列表定制的项目符号原先命中正文内所有列表，包括插件输出的功能列表——这类列表常把链接做成弹性布局并自带内边距，导致项目符号明显偏上，且插件自设的无符号样式被覆盖，多出一段缩进和一个多余的圆点。现已收窄到编辑器与区块编辑器产出的散文列表。涉及全部 13 套皮肤。
- 修复金融皮肤三处显示问题：移除标题前遗留的红色竖条及其配套缩进；系列短码的序号方牌中数字偏下（同一处样板在书页、电子书、复古、朱砂、Web1998 五套皮肤中完全相同，一并修复）；系列卡的展开/收起箭头在红色标题牌上呈现深红压深红、几乎看不见。
- 友链页的后台提示条改为可关闭。
升级说明
- AI 工具箱默认关闭，不会影响现有站点。需要使用时在「主题选项 → AI」开启总开关、勾选合规确认项，并填入供应商接口地址、模型与 API Key。建议同时设置每月 Token 上限，以免产生意外费用。
- 「jQuery 移到页脚」默认开启。如果你在页头插入过依赖 jQuery 的自定义代码，升级后可能报错；请把该自定义代码改到页脚，或在「基础设置 → 性能优化」中关闭此开关。
- 「图片按屏幕尺寸下发」默认开启。若你的图片托管方式较特殊（例如全部走外链且无对应附件记录），可在同一处关闭。移动端画质默认为「均衡」，追求画质可调为「原图」。
- 如果你在子主题或自定义代码中调用过
parse_user_agent()，请改为kratos_parse_user_agent()。 - 区块编辑器相关改动面向 WordPress 6.3 及以上版本的区块 API，建议将 WordPress 升级到较新版本以获得完整的编辑器体验。
- 若站点已安装 Yoast SEO 等 SEO 插件，主题的 SEO 输出将自动让位，主题选项中的 SEO 相关设置会不再生效，这是预期行为。
下载及预览
GitHub：https://github.com/lifengdi/kratos-plus/releases
Gitee：https://gitee.com/lifengdi/kratos-plus/releases
主题预览：https://www.lifengdi.com/
除非注明，否则均为李锋镝的博客原创文章，转载必须以链接形式标明本文链接
文章评论