v0.4.1 是插件体系的一次大扩容:seo、related、llms、feed-json、minify 五个新插件全部零依赖,覆盖了静态站点最常见的「运营层」需求。配套的 afterCollect 钩子也让插件第一次能在渲染前做跨页面计算。
这一版在解决什么
0.4.0 之前的 xfmpress 解决的是「把站点建出来」,但建出来之后呢?搜索引擎需要 canonical 和 Open Graph,读者需要相关文章推荐,AI 爬虫需要 llms.txt,订阅者需要 JSON Feed,生产环境还想要干净的 HTML。这一版把这五件事都变成了开箱即用的插件。
变了什么
Added:五个新插件与 afterCollect 钩子
seo:逐页生成 canonical、Open Graph、Twitter Card 和 JSON-LD(文章页用 Article,首页用 WebSite + SearchAction)。如果你在模板里手写了canonical/og:title,插件会尊重而不覆盖;front-matter 可以设置image、canonical、noindex,或用seo: false整页跳过。related:渲染前按共享标签(3 分)、分类(2 分)、系列(3 分)给每篇文章打分,结果以page.data.related暴露给模板。related.limit/related.minScore可调;front-matter 可以传显式列表,或用related: false退出。两套主题都会在开启时渲染相关文章区块。llms:按 llmstxt.org 约定输出llms.txt和llms-full.txt(分组文章索引 + 可选全文,llms.full: false关闭全文)。feed-json:在现有 RSS 旁边输出 JSON Feed 1.1。minify:仅生产构建启用的 HTML 压缩,处理注释、行尾空白、空行和缩进,但完全不动<pre>/<code>/<textarea>/<script>/<style>的内容;minify.aggressive还会折叠标签间换行。
架构层面,新增了 afterCollect 插件钩子:它在所有页面(含分类、索引、分页页)收集完毕、渲染开始之前运行一次,插件可以借它把跨页面数据写进 page.data——related 正是靠它实现的。脚手架生成的新站点也默认启用 sitemap、rss、feed-json、search、seo、related、llms、minify 这套现代组合。
Changed:性能不再为插件让路
以前 transformHtml 类插件会关掉 worker 池,大站点跑起来明显变慢。现在 worker 池照常处理 Markdown 和模板渲染,钩子只在主线程逐页收尾,seo / minify 不再牺牲并行度。相关文章的 URL 也被折进页面哈希:某篇文章的邻居变了,增量缓存会重渲染它,而不是展示过期列表。
Fixed:dev 下插件产物 404
xfm dev 现在直接从内存服务插件产物(search.json、sitemap.xml、feed.xml、feed.json、llms.txt 等)。此前 afterBuild 在 dev 模式下根本不运行,本地预览时搜索面板会 404。另外 minify 会先把 CRLF 归一化再折叠空白,并丢弃纯空白行,避免模板与 Markdown 混合换行符导致的输出问题。
升级要不要动手
没有破坏性变更,升级后旧插件配置原样可用。新插件全部是可选的:想加强 SEO 就加 seo,想要相关文章就加 related,都只是往 plugins 数组里加一个名字。配置细节可参考站点配置教程。
评论