v0.4.2 是 0.4.x 里唯一带破坏性变更的版本,但它换来的是一个更健康的架构:插件彻底从核心剥离,成为独立发布、按需安装的 npm 包。这一版值得认真读一遍升级说明。
这一版在解决什么
以前九个插件全部捆在核心的 lib/plugins/ 里,你不用也得装着,想自定义也只能改核心代码。「插件」和「内核」没有边界,第三方生态无从谈起。v0.4.2 把这条边界画清楚了:核心只管渲染,插件全是外部包。
变了什么
Breaking:插件不再随核心分发
lib/plugins/ 目录没有了。原来的九个插件(xfm-plugin-sitemap、-rss、-feed-json、-search、-seo、-related、-llms、-minify、-reading-stats)迁移到仓库的 packages/ 下,作为独立 npm 包分别发布。两处具体的行为变化:
- 以前写
plugins: ['rss']的站点,现在必须先npm i -D xfm-plugin-rss。好消息是缺插件不会静默回退到内置副本——构建会直接失败,并给出确切的安装命令,你照着复制就行。 xfm create生成的站点带package.json但不带任何plugins条目:新站点从零插件开始,需要什么自己加。xfm:<name>前缀和lib/plugins/<name>.js回退路径一并移除。
Added:Hexo 风格的自动发现与 site.helpers
- 站点
package.json里所有xfm-plugin-*(或@scope/xfm-plugin-*)依赖会被自动加载,无需改配置;plugins: ['rss']里的短名会解析成xfm-plugin-rss。 - 解析顺序明确:站点本地文件(
./plugins/x.js)→ 站点node_modules→ CLI 自身的node_modules,全局安装的插件也能用。 - 新增
site.helpers:一组冻结的公开 helper(absoluteUrl、withBase、normalizeBase、applyBase、plainText、markdownPlain、escapeHtml)。插件包不再深入xfm/lib/...内部取工具函数,无论 CLI 怎么安装都能正常工作。 xfm info会并排列出声明式配置和自动发现的插件。- 新增四个测试(107 → 111),覆盖自动发现、重复注册、缺插件报错,以及「核心不依赖任何插件包」这条架构约束。
Changed / Fixed
仓库改为 npm workspace(packages/*),npm publish --workspaces 一次发布整套插件,每个包有独立 README。README 和 README_CN 新增了完整的插件章节:安装命令、九个官方插件的包名/产物/选项表格、逐页 front-matter 开关,以及基于 site.helpers 的插件编写示例。顺带修了一个文档问题:部署说明里还提到早在 0.4.0 就删掉的 scripts/pages-base.js。
升级要不要动手
要动,但只有一件事:确认站点用到的每个插件都已安装为 devDependency,例如 npm i -D xfm-plugin-rss。配置里的短名写法不用改。装漏了也不危险——构建会失败并告诉你装哪个。装好之后如果想理清插件加载链路,可以看看 CLI 教程里的 xfm info 用法。
评论