更新日志 发布于 2026-11-09

xfmpress v0.4.3:构建时明确告诉你哪些插件加载了、产出了什么

2 分钟阅读 # xfmpress# 更新日志

v0.4.3 是一个小而实用的可观测性版本:xfm build 和 xfm dev 现在会在输出里告诉你哪些插件真的加载了,以及它们各自产出了什么文件。

这一版在解决什么

0.4.2 把插件拆成外部 npm 包之后,出现了一类新问题:插件装没装上、有没有被自动发现、到底跑了没有,这些信息藏在配置和 node_modules 里。「装了但没生效」是最难排查的一类故障——你以为是配置错了,其实包名拼错;你以为插件在跑,其实根本没被加载。既然插件已经是外部包,这个状态就必须在构建输出里直接可见。

变了什么

Changed:构建输出可见

xfm build 和 xfm dev 会打印实际加载的插件列表,以及每个插件产出的文件(如 sitemap.xml、robots.txt、feed.xml 等)。现在一条命令跑完,你就能确认:

  • 期望的插件是否被自动发现并加载(对照 package.json 里的 xfm-plugin-* 依赖);
  • 每个插件实际写出了哪些文件,直接对应到输出目录里能找到的产物。

没有新增任何配置项,没有行为变化——变的只是你「看到」的信息量。配合 0.4.2 加入的 xfm info(并排显示声明与自动发现的插件),插件体系的状态排查路径完整了:平时看构建输出,深入排查用 xfm info。

升级要不要动手

什么都不用做。这是一次纯输出改进,配置格式、插件加载顺序、产物内容全部不变。升级后第一次跑 xfm build 时留意一下插件清单,顺手确认一遍你的插件都如预期加载,是个好习惯。想系统了解各插件的产物和选项,可以参考插件教程。

评论