2.21.3

新特性

• 支持通过远程地址下载到附件库。 by @ruibaby in #7602

功能优化

• 优化编辑器拖拽功能的性能。 by @LIlGG in #7601
• 优化默认编辑器缩进逻辑。 by @LIlGG in #7600
• 将编辑器的工具箱按钮改为点击展开。 by @ruibaby in #7598
• 文章预览页面不再统计访问数据。 by @GoldenSupremeSaltedFish in #7582

问题修复

• 修复个人中心上传组件无法正常加载样式的问题。 by @ruibaby in #7606
• 修复代码输入框在全屏时，底部内容被遮挡的问题。 by @ruibaby in #7599
• 修复菜单项和文章分类可能出现无法拖动排序的问题。 by @ruibaby in #7608

依赖更新

• 升级依赖 Spring Boot 至 3.5.3。 by @JohnNiang in #7596
• 升级 Tiptap 至 2.24.x by @LIlGG in #7613

开发者相关

• 提升 UI 项目的 pnpm 版本到 10.x。 by @ruibaby in #7597

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

• https://www.halo.run/store/apps
• https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.21.2...v2.21.3

2.21.2

功能优化

• 为编辑器添加内容折叠功能。 by @ruibaby in #7594

问题修复

• 修复 2.20.1 中评论管理中内容的宽度问题。 by @ruibaby in #7586

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

• https://www.halo.run/store/apps
• https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.21.1...v2.21.2

2.21.1

功能优化

• 调整 Console 文章列表的标题区域最大宽度。 by @ruibaby in #7564
• 支持自动重写尾部包含斜杠的 URL。 by @JohnNiang in #7559

问题修复

• 修复堆叠部件中的部件可能无法显示设置按钮的问题。 by @ruibaby in #7563

开发者相关

• 重构 @halo-dev/ui-plugin-bundler-kit，以预配置的方式为插件提供 Vite 和 Rsbuild 的构建配置。 by @ruibaby in #7568

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

• https://www.halo.run/store/apps
• https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.21.0...v2.21.1

2.21.0

⚠️ 提示

• 此版本已经提升 JDK 版本至 21，意味着在开发环境和使用 jar 文件部署均需要升级 JDK 版本，Docker 部署方式无影响。
• 此版本移除了部分旧版本的迁移脚本，所以请确保当前的版本至少为 2.20.x。如果不是，建议先升级到 2.20 的最新版本运行一段时间再升级到此版本。
• 此版本移除了部分已经过时的 API，部分插件可能会受到影响。在测试阶段，常用插件已经完成适配，建议在升级 2.21 版本前后都检查一下插件是否有更新。如果你当前使用的插件还未完成兼容适配，请先向插件进行反馈。

新特性

• 支持在概览页面配置外部访问地址。 by @JohnNiang in #7459
• 支持在初始化页面设置外部访问地址。 by @JohnNiang in #7488
• 重构 Console 端仪表盘，支持响应式布局、持久化配置，支持通过插件扩展小部件。 by @ruibaby in #7496
• 为仪表盘添加堆叠小部件。 by @ruibaby in #7525
• 为仪表盘添加网页嵌入小部件。 by @ruibaby in #7516
• 文章管理列表支持显示封面图。 by @ruibaby in #7519

功能优化

• 编辑器支持为链接设置 搜索引擎忽略链接关系。 by @Nimbus3009 in #7444
• 用户搜索支持根据邮箱地址。 by @liuyiwuqing in #7441
• 优化 Console 和 UC 中数据列表的 UI 在不同尺寸设备下的表现。 by @ruibaby in #7383
• 移除插件列表的时间字段，并在插件详情中显示安装时间。 by @ruibaby in #7494
• 优化评论管理的 UI，支持查看评论的详细数据。 by @ruibaby in #7481
• 将 Console 端文章列表的发布时间改为语义化时间。 by @ruibaby in #7526
• 优化 Console 端的对话框在移动端下的样式。 by @ruibaby in #7512
• 优化 Console 的全局依赖文件名，以获得更好的缓存利用率。 by @ruibaby in #7530
• 优化移动端的菜单，支持切换 Console / UC，支持退出登录和返回到首页。 by @ruibaby in #7542
• 优化移动端下文章编辑页面的样式。 by @ruibaby in #7544
• 移除无用的依赖，软件包的体积减少近 15%。 by @JohnNiang in #7549
• 支持在附件详情弹窗中复制完整的附件地址。 by @ruibaby in #7550

问题修复

• 修复因 Locale 解析错误导致无法访问页面的问题。 by @JohnNiang in #7458
• 修复当有已选择附件时，上传新附件导致所选附件状态异常的问题。 by @ruibaby in #7487
• 修复 Console 的全局搜索能搜索出系统保留用户的问题。 by @ruibaby in #7486
• 修复模态框标题文字溢出的问题。 by @ruibaby in #7546
• 修复用户资料页面头像在 Safari 浏览器下的阴影问题。 by @ruibaby in #7551

依赖更新

• 升级依赖 Spring Boot 至 3.5.0。 by @JohnNiang in #7467
• 升级依赖 Lucene 至 10.2.1。 by @JohnNiang in #7476

开发者相关

• 更新最低运行环境为 Java 21。 by @JohnNiang in #7451
• 添加用户登录/登出事件。 by @liuyiwuqing in #7440
• UI 组件添加 VEntityContainer 组件，以优化数据列表的样式。 by @ruibaby in #7383
• 提供根据分组获取和更新用户预设的 API。 by @JohnNiang in #7495
• 提供更易用的存储策略配置查询和更新接口。 by @JohnNiang in #7527
• @halo-dev/ui-plugin-bundler-kit 支持自定义 outDir 和 manifestPath。 by @ruibaby in #7552
• Console 页面数据列表的字段和操作选项支持扩展。 by @ruibaby in #7553

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

• https://www.halo.run/store/apps
• https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.20.21...v2.21.0

2.21.0-beta.2

⚠️ 提示

建议在升级到此版本前，先查阅 2.21.0 Alpha 版本的更新日志：

• v2.21.0-alpha.1
• v2.21.0-alpha.2

新特性

• 为仪表盘添加堆叠小部件。 by @ruibaby in #7525
• 为仪表盘添加网页嵌入小部件。 by @ruibaby in #7516
• 文章管理列表支持显示封面图。 by @ruibaby in #7519

功能优化

• 将 Console 端文章列表的发布时间改为语义化时间。 by @ruibaby in #7526
• 优化 Console 端的对话框在移动端下的样式。 by @ruibaby in #7512
• 优化 Console 的全局依赖文件名，以获得更好的缓存利用率。 by @ruibaby in #7530

开发者相关

• 提供更易用的存储策略配置查询和更新接口。 by @JohnNiang in #7527

Full Changelog: v2.21.0-beta.1...v2.21.0-beta.2

2.21.0-beta.1

⚠️ 提示

建议在升级到此版本前，先查阅 2.21.0 Alpha 版本的更新日志：

• v2.21.0-alpha.1
• v2.21.0-alpha.2

新特性

• 重构 Console 端仪表盘，支持响应式布局、持久化配置，支持通过插件扩展小部件。 by @ruibaby in #7496

功能优化

• 移除插件列表的时间字段，并在插件详情中显示安装时间。 by @ruibaby in #7494
• 优化评论管理的 UI，支持查看评论的详细数据。 by @ruibaby in #7481

开发者相关

• 提供根据分组获取和更新用户预设的 API。 by @JohnNiang in #7495

Full Changelog: v2.21.0-alpha.2...v2.21.0-beta.1

2.21.0-alpha.2

⚠️ 提示

此版本为 2.21.0 的早期版本，不适用于生产环境。这个版本移除了一些过时 API 和一些不兼容改动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。具体改动方案请查阅 v2.21.0-alpha.1 中的适配列表和破坏性更新列表。

新特性

• 支持在初始化页面设置外部访问地址。 by @JohnNiang in #7488

问题修复

• 修复 2.21.0-alpha.1 中 Console 的全局搜索样式问题。 by @ruibaby in #7485
• 修复 2.21.0-alpha.1 中概览页面的外部访问地址异常提示的显示时机问题。 by @ruibaby in #7484
• 修复当有已选择附件时，上传新附件导致所选附件状态异常的问题。 by @ruibaby in #7487
• 修复 Console 的全局搜索能搜索出系统保留用户的问题。 by @ruibaby in #7486

Full Changelog: v2.21.0-alpha.1...v2.21.0-alpha.2

2.21.0-alpha.1

⚠️ 提示

此版本为 2.21.0 的早期版本，不适用于生产环境。这个版本移除了一些过时 API 和一些不兼容改动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。具体改动方案请查阅下方的适配列表和破坏性更新列表。

从 2.21.0 开始，Halo 开发环境的最低运行环境为 Java 21。

新特性

• 支持在概览页面配置外部访问地址。 by @JohnNiang in #7459

功能优化

• 编辑器支持为链接设置 搜索引擎忽略链接关系。 by @Nimbus3009 in #7444
• 用户搜索支持根据邮箱地址。 by @liuyiwuqing in #7441
• 优化 Console 和 UC 中数据列表的 UI 在不同尺寸设备下的表现。 by @ruibaby in #7383

问题修复

• 修复因 Locale 解析错误导致无法访问页面的问题。 by @JohnNiang in #7458

依赖更新

• 升级依赖 Spring Boot 至 3.5.0。 by @JohnNiang in #7467
• 升级依赖 Lucene 至 10.2.1。 by @JohnNiang in #7476

开发者相关

• 更新最低运行环境为 Java 21。 by @JohnNiang in #7451
• 添加用户登录/登出事件。 by @liuyiwuqing in #7440
• UI 组件添加 VEntityContainer 组件，以优化数据列表的样式。 by @ruibaby in #7383

适配列表

VEntity 组件

此版本为了优化使用 VEntity 组件渲染的数据列表样式，引入了新的 VEntityContainer 组件，适配方式为在所有 VEntity 组件外使用
VEntityContainer 组件包裹，以下是具体步骤和示例：

升级 ⁠@halo-dev/components 包至 2.21.0 版本：

# 临时地址，等待 2.21.0 正式发布之后，可改为 @halo-dev/[email protected]
pnpm i https://pkg.pr.new/@halo-dev/components@7383

示例：

<script lang="ts" setup>
import { VEntity, VEntityContainer } from "@halo-dev/components"
</script>

<template>
  <VEntityContainer>
    <VEntity />
    <VEntity />
  </VEntityContainer>
</template>

完整更改方式可参考：https://github.com/halo-dev/plugin-feed/pull/66/files

破坏性更新

• 移除过时类 run.halo.app.extension.router.selector.FieldCriteriaPredicateConverter 和
  run.halo.app.extension.router.selector.LabelCriteriaPredicateConverter，推荐用
  run.halo.app.extension.router.selector.SelectorConverter 替代。
• 移除过时类 run.halo.app.search.SearchParam，推荐用 run.halo.app.search.SearchOption 替代。
• 移除过时类 run.halo.app.search.post.PostDoc 和 run.halo.app.search.post.PostHit，推荐用
  run.halo.app.search.HaloDocument 替代。
• 移除 Plugin 过时字段 spec.pluginClass，推荐在插件定义文件中移除此字段。
• 移除 Plugin 过时字段 spec.website，推荐使用 spec.homepage 替代。
• 移除 Plugin 过时字段 spec.require，推荐使用 spec.requires 替代。
• 移除 SystemSetting.AuthProvider 过时字段 enabled，已经由 SystemSetting.AuthProvider 的 states 字段替代。
• 移除 run.halo.app.extension.ExtensionMatcher 过时方法 getGvk、getLabelSelector 和 getFieldSelector。
• 移动方法 run.halo.app.extension.MetadataOperator#metadataDeepEquals 至
  run.halo.app.extension.MetadataOperator#equals。
• 移除 run.halo.app.extension.router.QueryParamBuildUtil 过时方法 buildParametersFromType，推荐使用
  org.springdoc.core.fn.builders.operation.Builder#parameter 替代。
• 移除 run.halo.app.extension.router.SortableRequest 过时方法 toPredicate，推荐使用
  run.halo.app.extension.router.SortableRequest#toListOptions 替代。
• 移除 run.halo.app.extension.router.selector.SelectorUtil 过时方法 labelSelectorsToPredicate、
  fieldSelectorToPredicate 和 labelAndFieldSelectorToPredicate，推荐使用
  run.halo.app.extension.router.selector.SelectorUtil#labelAndFieldSelectorToListOptions 替代。
• 移除 run.halo.app.theme.finders.TagFinder 过时方法 list(Integer, Integer, Predicate, Predicate)，推荐使用
  run.halo.app.theme.finders.TagFinder#list(Integer, Integer) 替代。
• 移除 run.halo.app.plugin.BasePlugin 过时构造函数 BasePlugin(PluginWrapper)，推荐使用 BasePlugin(PluginContext)
  替代。
• 移除接口 GET&PUT /apis/api.console.halo.run/v1alpha1/plugins/{name}/config，推荐使用
  GET&PUT /apis/api.console.halo.run/v1alpha1/plugins/{name}/json-config 替代。
• 移除接口 GET&PUT /apis/api.console.halo.run/v1alpha1/themes/{name}/config，推荐使用
  GET&PUT /apis/api.console.halo.run/v1alpha1/themes/{name}/json-config 替代。
• 移除接口 POST /apis/api.halo.run/v1alpha1/indices/post，推荐使用 POST /apis/api.halo.run/v1alpha1/indices/-/search
  替代。
• 移除接口 POST /apis/api.console.halo.run/v1alpha1/indices/post，推荐使用
  POST /apis/api.console.halo.run/v1alpha1/indices/-/rebuild 替代。

最后，请确保更新 plugin.yaml 中的 requires 字段为 >=2.21.0。

Full Changelog: v2.20.21...v2.21.0-alpha.1

2.20.21 LTS

功能优化

• 重构菜单项的拖动排序功能，增强使用体验。 by @ruibaby in #7423
• 重构文章分类的拖动排序功能，增强使用体验。 by @ruibaby in #7424

问题修复

• 修复文章详情页访问规则为 /?p={slug} 时无法访问的问题。 by @JohnNiang in #7430

开发者相关

• 导出与编辑器扩展相关的类型定义。 by @ruibaby in #7425

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

• https://www.halo.run/store/apps
• https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.20.20...v2.20.21

2.20.20 LTS

功能优化

• 标签管理界面支持根据文章量排序。 by @chengzhongxue in #7414
• 登出页面支持通过 redirect_uri 参数自定义重定向位置。 by @JohnNiang in #7418

问题修复

• 修复无法设置长度超过 72 个字符的密码的问题。 by @JohnNiang in #7407
• 修复个人中心处可能出现登录设备查询异常的问题。 by @JohnNiang in #7408
• 修复访问不存在的分类或者文章页面时始终抛出异常的问题。 by @JohnNiang in #7419

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：

• https://www.halo.run/store/apps
• https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.20.19...v2.20.20