2.1.0

⚠️ 注意

2.0 由于架构的变动，无法直接从 1.x 升级，请查阅文档后再进行迁移。

新特性

• 支持重置主题和插件的设置选项。 by @ruibaby in halo-dev/console#777 @guqing in #2964
• Console 端支持扩展集成其他编辑器。 by @ruibaby in halo-dev/console#781
• Console 端支持设置 Favicon。 by @ruibaby in halo-dev/console#788
• 为部分模型提供元数据设置的设置。 by @ruibaby in halo-dev/console#770 @guqing in #3028 #3076
• 支持在工作目录添加自定义配置。 by @JohnNiang in #2935
• 主题端支持作者归档页面。 by @guqing in #2923
• 支持命令行参数启动 Halo。 by @JohnNiang in #2942
• 主题端支持异常模板页面。 by @guqing in #2925
• CategoryFinder 添加根据分类查询子分类树结构的方法。 by @chengfeiyue in #2995
• 添加原生 MariaDB 驱动的支持。 by @codychau in #2787
• 支持系统异常的多语言输出。 by @JohnNiang in #3042
• 菜单项支持设置打开方式。 by @ruibaby in halo-dev/console#805 #3072
• 完善静态资源的缓存策略。 by @JohnNiang in #3074

功能优化

• 重构访问量统计逻辑，修复文章访问量无法迁移的问题。 by @guqing in #2870
• Console 端登录页面支持自动聚焦输入框。 by @Aanko in halo-dev/console#742
• 优化 Console 端接口请求异常提示。 by @ruibaby in halo-dev/console#744
• 优化主题升级入口的文字。 by @Joydevelop in halo-dev/console#747
• 优化 Console 端的主题和插件详情页面切换选项卡时的页面闪动问题。 by @ruibaby in halo-dev/console#748
• 完善 Console 端用户角色的相关逻辑。 by @ruibaby in halo-dev/console#749
• Console 端为部分图标按钮添加操作提示，提升可访问性。 by @Aanko in halo-dev/console#745
• 优化 Console 端上传组件的异常提示信息。 by @ruibaby in halo-dev/console#769
• 禁止 Console 端部分表单使用 Enter 提交，统一组合键（Ctrl + Enter）。 by @wzrove in halo-dev/console#766
• Console 端的主题管理列表添加启用和升级的支持。 by @ruibaby in halo-dev/console#774
• 优化 Console 端数据列表的操作按钮样式。 by @ruibaby in halo-dev/console#780
• 优化 Console 端的插件卸载选项布局。 by @ruibaby in halo-dev/console#779
• 优化 Console 端状态提示的样式。 by @ruibaby in halo-dev/console#782
• 完善 Console 端的部分操作反馈提示。 by @ruibaby in halo-dev/console#785
• 优化菜单和菜单项的编辑表单标题文字。 by @chengfeiyue in halo-dev/console#794
• 优化 Console 端文章管理列表的布局，修复当分类设置过多时的样式问题。 by @ruibaby in halo-dev/console#789
• 重构 Console 端文章和自定义页面的设置表单布局，支持提交时验证表单。 by @ruibaby in halo-dev/console#791
• 优化 Console 端的用户和角色列表，如果包含正在删除的内容会自动刷新。 by @ruibaby in halo-dev/console#797
• 重构 Console 端角色编辑的表单，取消多选项卡的设计。 by @ruibaby in halo-dev/console#795
• Console 端的评论回复 Emoji 组件数据改为异步加载，优化整体的加载性能。 by @ruibaby in halo-dev/console#798
• Console 端的默认编辑器改为异步加载，优化整体的加载性能。 by @ruibaby in halo-dev/console#800
• 优化 Console 端上传附件的功能，支持缓存选择的分组和策略。 by @ruibaby in halo-dev/console#784
• 移除 Console 端使用 yaml 编辑用户信息的功能。 by @ruibaby in halo-dev/console#799
• 归档数据的月份改为按月降序。 by @liaocp666 in #2959
• 持久化并归档历史日志。 by @JohnNiang in #3021

问题修复

• 修复 Console 端无法正常创建自定义链接类型菜单项的问题。 by @ruibaby in halo-dev/console#743
• 修复 Console 端激活主题之后页面没有更新数据的问题。 by @ruibaby in halo-dev/console#746
• 修复在 Console 端停止插件时，仍然获取设置选项导致显示失败提示的问题。 by @ruibaby in halo-dev/console#750
• 修复 Console 端文章设置中的发布时间为空字符串时，无法保存的问题。 by @ruibaby in halo-dev/console#763
• 修复 Console 端默认编辑器的嵌入网页在编辑文章时无法回显的问题。 by @ruibaby in halo-dev/console#773
• 修复 Console 端系统设置页面切换选项卡无法正常加载表单的问题。 by @ruibaby in halo-dev/console#787
• 修复首次初始化之后，Console 没有加载已激活主题的问题。 by @ruibaby in halo-dev/console#790
• 修复因文章过长导致无法保存数据的问题。 by @JohnNiang in #2833
• 修复文章列表查询时的类型转换错误。 by @guqing in #2854
• 修复每个角色都显示系统保留标签的问题。 by @JohnNiang in #2865
• 修复自定义页面没有统计访问量的问题。 by @guqing in #2918
• 修改 HTTP 请求体最大字节数的限制，修复保存大内容文章异常的问题。 by @ruibaby in #2936
• 修复插件开发模式下后续增加的 fixedPluginPath 项无法被加载的问题。 by @guqing in #2941
• 修复插件 Logo 为相对路径时先启用再停后就无法加载 Logo 的问题。 by @guqing in #2940
• 修复开启评论审核的情况下无法显示评论回复的问题。 by @minliacom in #2954
• 解决访问分析工具无法显示 referer 的问题。 by @JohnNiang in #2972
• 修复主题升级后没有清理主题引擎缓存的问题。 by @minliacom in #2970
• 修复编译为可执行 JAR 之后运行无法初始化主题的问题。 by @minliacom in #2991
• 修复附件权限定义的错误。 by @JohnNiang in #3024
• 修复 Console 端已登录用户无法访问个人资料页面的问题。 by @ruibaby in halo-dev/console#796 @JohnNiang in #3067
• 修复 Console 端保存文章设置导致发布时间丢失的问题。 by @ruibaby in halo-dev/console#807
• 修复 Console 端在 Safari 浏览器登录之后无反应的问题。 by @ruibaby in halo-dev/console#804

重要变更

• HaloPluginManager 移除 getRootApplicationContext 方法。 by @guqing in #2949

依赖更新

• 升级 Spring Boot 至 3.0.1。 by @minliacom in #3031
• 更新默认主题的版本为 1.1.1。 by @ruibaby in #3082

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.0.0...v2.1.0

2.0.3

⚠️ 注意

2.0 由于架构的变动，无法直接从 1.x 升级，请查阅文档后再进行迁移。

新特性

• 持久化并归档历史日志。@JohnNiang #3023

功能优化

• 优化 Console 端状态提示的样式。@ruibaby halo-dev/console#783
• 优化 Console 端上传组件的异常提示信息。@ruibaby halo-dev/console#786

问题修复

• 修复首次初始化之后，Console 没有加载已激活主题的问题。@ruibaby halo-dev/console#793
• 修复 Console 端在 Safari 浏览器登录之后无反应的问题。@ruibaby halo-dev/console#808
• 修复 Console 端保存文章设置导致发布时间丢失的问题。@ruibaby in halo-dev/console#809
• 修改 HTTP 请求体最大字节数的限制，修复保存大内容文章异常的问题。@ruibaby #3000
• 修复 Jar 包部署时无法初始化主题的问题。@minliacom #3009
• 修复附件权限定义的错误。@JohnNiang #3044
• 修复查询文章列表可能出现的空指针异常。@guqing #3075

依赖更新

• 升级 Spring Boot 至 3.0.1。@minliacom #3032

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.0.2...v2.0.3

2.1.0-rc.1

⚠️ 注意

2.0 由于架构的变动，无法直接从 1.x 升级，请查阅文档后再进行迁移。

问题修复

• 修复 Console 端无法正常创建自定义链接类型菜单项的问题。 by @ruibaby in halo-dev/console#743
• 修复 Console 端激活主题之后页面没有更新数据的问题。 by @ruibaby in halo-dev/console#746
• 修复在 Console 端停止插件时，仍然获取设置选项导致显示失败提示的问题。 by @ruibaby in halo-dev/console#750
• 修复 Console 端文章设置中的发布时间为空字符串时，无法保存的问题。 by @ruibaby in halo-dev/console#763
• 修复 Console 端默认编辑器的嵌入网页在编辑文章时无法回显的问题。 by @ruibaby in halo-dev/console#773
• 修复 Console 端系统设置页面切换选项卡无法正常加载表单的问题。 by @ruibaby in halo-dev/console#787
• 修复首次初始化之后，Console 没有加载已激活主题的问题。 by @ruibaby in halo-dev/console#790
• 修复因文章过长导致无法保存数据的问题。 by @JohnNiang in #2833
• 修复文章列表查询时的类型转换错误。 by @guqing in #2854
• 修复每个角色都显示系统保留标签的问题。 by @JohnNiang in #2865
• 修复自定义页面没有统计访问量的问题。 by @guqing in #2918
• 修改 HTTP 请求体最大字节数的限制，修复保存大内容文章异常的问题。 by @ruibaby in #2936
• 修复插件开发模式下后续增加的 fixedPluginPath 项无法被加载的问题。 by @guqing in #2941
• 修复插件 Logo 为相对路径时先启用再停后就无法加载 Logo 的问题。 by @guqing in #2940
• 修复开启评论审核的情况下无法显示评论回复的问题。 by @minliacom in #2954
• 解决访问分析工具无法显示 referer 的问题。 by @JohnNiang in #2972
• 修复主题升级后没有清理主题引擎缓存的问题。 by @minliacom in #2970
• 修复编译为可执行 JAR 之后运行无法初始化主题的问题。 by @minliacom in #2991
• 修复附件权限定义的错误。 by @JohnNiang in #3024

功能优化

• 重构访问量统计逻辑，修复文章访问量无法迁移的问题。 by @guqing in #2870
• Console 端登录页面支持自动聚焦输入框。 by @Aanko in halo-dev/console#742
• 优化 Console 端接口请求异常提示。 by @ruibaby in halo-dev/console#744
• 优化主题升级入口的文字。 by @Joydevelop in halo-dev/console#747
• 优化 Console 端的主题和插件详情页面切换选项卡时的页面闪动问题。 by @ruibaby in halo-dev/console#748
• 完善 Console 端用户角色的相关逻辑。 by @ruibaby in halo-dev/console#749
• Console 端为部分图标按钮添加操作提示，提升可访问性。 by @Aanko in halo-dev/console#745
• 优化 Console 端上传组件的异常提示信息。 by @ruibaby in halo-dev/console#769
• 禁止 Console 端部分表单使用 Enter 提交，统一组合键（Ctrl + Enter）。 by @wzrove in halo-dev/console#766
• Console 端的主题管理列表添加启用和升级的支持。 by @ruibaby in halo-dev/console#774
• 优化 Console 端数据列表的操作按钮样式。 by @ruibaby in halo-dev/console#780
• 优化 Console 端的插件卸载选项布局。 by @ruibaby in halo-dev/console#779
• 优化 Console 端状态提示的样式。 by @ruibaby in halo-dev/console#782
• 完善 Console 端的部分操作反馈提示。 by @ruibaby in halo-dev/console#785
• 优化菜单和菜单项的编辑表单标题文字。 by @chengfeiyue in halo-dev/console#794
• 优化 Console 端文章管理列表的布局，修复当分类设置过多时的样式问题。 by @ruibaby in halo-dev/console#789
• 重构 Console 端文章和自定义页面的设置表单布局，支持提交时验证表单。 by @ruibaby in halo-dev/console#791
• 优化 Console 端的用户和角色列表，如果包含正在删除的内容会自动刷新。 by @ruibaby in halo-dev/console#797
• 重构 Console 端角色编辑的表单，取消多选项卡的设计。 by @ruibaby in halo-dev/console#795
• Console 端的评论回复 Emoji 组件数据改为异步加载，优化整体的加载性能。 by @ruibaby in halo-dev/console#798
• Console 端的默认编辑器改为异步加载，优化整体的加载性能。 by @ruibaby in halo-dev/console#800
• 优化 Console 端上传附件的功能，支持缓存选择的分组和策略。 by @ruibaby in halo-dev/console#784
• 移除 Console 端使用 yaml 编辑用户信息的功能。 by @ruibaby in halo-dev/console#799
• 归档数据的月份改为按月降序。 by @liaocp666 in #2959
• 持久化并归档历史日志。 by @JohnNiang in #3021

新特性

• 支持重置主题和插件的设置选项。 by @ruibaby in halo-dev/console#777 @guqing in #2964
• Console 端支持扩展集成其他编辑器。 by @ruibaby in halo-dev/console#781
• Console 端支持设置 Favicon。 by @ruibaby in halo-dev/console#788
• 为部分模型提供元数据设置的设置。 by @ruibaby in halo-dev/console#770 @guqing in #3028
• 支持在工作目录添加自定义配置。 by @JohnNiang in #2935
• 主题端支持作者归档页面。 by @guqing in #2923
• 支持命令行参数启动 Halo。 by @JohnNiang in #2942
• 主题端支持异常模板页面。 by @guqing in #2925
• CategoryFinder 添加根据分类查询子分类树结构的方法。 by @chengfeiyue in #2995
• 添加原生 MariaDB 驱动的支持。 by @codychau in #2787
• 支持系统异常的多语言输出。 by @JohnNiang in #3042

重要变更

• HaloPluginManager 移除 getRootApplicationContext 方法。 by @guqing in #2949

依赖更新

• 升级 Spring Boot 至 3.0.1。 by @minliacom in #3031
• 更新默认主题的版本为 1.1.0。 by @ruibaby in #3051

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.0.0...v2.1.0-rc.1

2.0.2

⚠️ 注意

2.0 由于架构的变动，无法直接从 1.x 升级，请查阅文档后再进行迁移。

问题修复

• 修复归档数据没有按月降序的问题。 by @liaocp666 in #2975
• 修复开启评论审核的情况下无法显示评论回复的问题。 by @minliacom in #2965
• 修复自定义页面没有统计访问量的问题。 by @guqing in #2920
• 修复 Console 端编辑器嵌入网页不会回显的问题。 by @ruibaby in halo-dev/console#773
• 修复 Console 端全局搜索组件在卸载组件之后没有移除键盘事件的问题。 by @wzrove in halo-dev/console#767
• 修复 Console 端文章设置中的发布时间为空字符串时，无法保存的问题。 by @ruibaby in halo-dev/console#763

新特性

• 支持 Docker 命令行参数启动 Halo。 by @JohnNiang in #2952
• 支持在工作目录添加自定义配置。 by @JohnNiang in #2950

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.0.1...v2.0.2

2.0.1

⚠️ 注意

2.0 由于架构的变动，无法直接从 1.x 升级，迁移请查阅迁移文档：https://docs.halo.run/getting-started/migrate-from-1.x

问题修复

• 修复 Console 端无法正常创建自定义链接类型菜单项的问题。 @ruibaby in halo-dev/console#743
• 修复 Console 端激活主题之后页面没有更新数据的问题。 @ruibaby in halo-dev/console#746
• 修复在 Console 端停止插件时，仍然获取设置选项导致显示失败提示的问题。 @ruibaby in halo-dev/console#750
• 修复因文章过长导致无法保存数据的问题。 @JohnNiang in #2833
• 修复 Console 端文章如果包含多个贡献者时，列表加载异常的问题。 @guqing in #2854

功能优化

• 优化 Console 端的主题和插件详情页面切换选项卡时的页面闪动问题。 @ruibaby in halo-dev/console#748
• 完善 Console 端用户角色的相关逻辑。 @ruibaby in halo-dev/console#749 @JohnNiang in #2865
• 优化 Console 端接口请求异常提示。 @ruibaby in halo-dev/console#744

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.0.0...v2.0.1

2.0.0

⚠️ 注意

2.0 由于架构的变动，无法直接从 1.x 升级，迁移请查阅迁移文档：https://docs.halo.run/getting-started/migrate-from-1.x

主要特性

• 支持多用户与权限。
• 支持插件机制。
• 提供 Extension API，以便插件更方便地持久化数据。
• 重新设计的主题机制，提供更加灵活地设置表单配置。
• 重新设计的附件系统，引入分组和存储策略的概念，可通过插件支持多种云存储的策略。
• 重新设计的评论系统，支持登录访问。
• 重新设计的后台管理系统。
• 默认提供富文本编辑器。
• 支持 PostgreSQL / MySQL / MariaDB / H2 数据库。
• 支持搜索引擎。

重要变更

• 无法兼容 1.x 版本的数据库，所以无法平滑升级。
• 默认的模板引擎改为 Thymeleaf，所以无法兼容 1.x 的主题。Halo 官方维护的主题将逐步移植到 2.0。
• 不再内置友情链接/图库/日志功能，后续会以插件的形式提供。
• 不再内置站点地图/订阅链接的功能，后续会以插件的形式提供。
• 不再内置备份的功能，后续会以插件的形式提供。
• 不再内置云存储的功能，后续会提供常用云存储的插件。
• 不再默认提供 Markdown 编辑器，但后续会在当前的富文本编辑器支持编写 Markdown，也可以通过插件提供单独的 Markdown 编辑器。
• 后台管理入口修改为 /console。

文档

https://docs.halo.run

资源

适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

2.0.0-rc.2

Warning
当前版本为非正式发布版本，无法从 1.5 和 1.6 直接升级到当前版本，也不建议在生产环境使用，欢迎大家测试并反馈。

另外，在 Halo 2.0 正式发布的时候，我们会提供完整的升级指南。

自 v2.0.0-rc.1 发布以来的变更如下：

问题修复

• 修复重载主题配置时，如果之前没有设置 settingName 会导致重载失效的问题。 @guqing in #2745 @ruibaby in halo-dev/console#711
• 修复通过导入的方式创建的文章无法建立搜索引擎索引的问题。 @JohnNiang in #2791
• 修复 Console 端当菜单项被删除时，没有更新菜单的问题。 @ruibaby in halo-dev/console#725
• 修复在 Console 端角色编辑时，如果在权限勾选界面，无法提交表单的问题。 @ruibaby in halo-dev/console#717
• 修复在 Console 端选择未分组的分组时，上传附件会将分组设置为 ungrouped 的问题。 @ruibaby in halo-dev/console#716

主要特性

• Console 端编辑器优化，支持表格、嵌入网页、图片放大缩小、任务列表等功能。 @ruibaby in halo-dev/console#719 halo-dev/console#722
• Console 端添加自动计算文章标签文字颜色的支持。 @ruibaby in halo-dev/console#721
• Console 端支持在文章管理列表显示文章置顶标识。 @ruibaby in halo-dev/console#720
• Console 端支持在登录会话失效之后打开登录弹窗。 @ruibaby in halo-dev/console#715
• Console 端部分包含了主题端路由的数据列表添加跳转按钮或者链接。 @ruibaby in halo-dev/console#712

重要变更

• 评论和回复支持设置 approvedTime 属性。 @guqing in #2746 @ruibaby in halo-dev/console#713
• 优化 Console 端确认弹框的提示文案。 @wan92hen in halo-dev/console#723

依赖变更

• 升级依赖 SpringDoc OpenAPI 至 2.0.0。@JohnNiang in #2769
• 升级依赖 Spring Boot 至 3.0.0。@JohnNiang in #2768
• 升级依赖 pf4j 至 3.8.0。@guqing in #2772

其他资源

• 适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.0.0-rc.1...v2.0.0-rc.2

2.0.0-rc.1

Warning
当前版本为非正式发布版本，无法从 1.5 和 1.6 直接升级到当前版本，也不建议在生产环境使用，欢迎大家测试并反馈。

另外，在 Halo 2.0 正式发布的时候，我们会提供完整的升级指南。

自 v2.0.0-beta.2 发布以来的变更如下：

问题修复

• 修复插件以开发模式启动时会出现插件已经加载过的异常。 @guqing in #2759
• 修复主题端文章列表排序不固定问题。 @guqing in #2742
• Console 端 @halo-dev/components 组件库中的 VEntityField 组件支持设置宽度，防止内容过多导致 UI 异常。 @ruibaby halo-dev/console#700

主要特性

• 主题端支持使用表达式方言获取登录状态和判断权限。 @guqing in #2729
• 提供未分组附件的筛选功能。 @JohnNiang in #2752
• 新增全局异常处理。 @guqing in #2741
• Console 端文章和独立页面的编辑页面支持 returnToView 参数。 @ruibaby halo-dev/console#698
• 完善 Console 端表单的验证规则。 @ruibaby halo-dev/console#701
• Console 端附件管理支持未分组的筛选条件。 @ruibaby halo-dev/console#706

重要变更

• 优化 Console 数据列表的筛选标签样式，以及支持清空所有筛选条件。 @ruibaby halo-dev/console#702
• 优化 Console 端数据列表的加载，添加加载动画，解决加载完成之后界面闪动的问题。 @ruibaby halo-dev/console#703
• 优化 Console 端文章管理的分类/标签/作者的筛选下拉框样式，以及支持搜索。 @ruibaby halo-dev/console#704
• 优化 Console 端创建新文章和自定义页面之后的表现，现在会自动跳转至管理列表。 @ruibaby halo-dev/console#709

破坏性变更

• 修改 Halo 默认工作目录为 .halo2。 @JohnNiang in #2728

依赖变更

• 升级依赖 SpringDoc OpenAPI 至 2.0.0-RC2。@JohnNiang in #2726

其他资源

• 适用于 2.0 的插件和主题可查阅：https://github.com/halo-sigs/awesome-halo

Full Changelog: v2.0.0-beta.2...v2.0.0-rc.1

1.6.1

问题修复

• 修复文章保存内容时，可能发生空指针异常的问题。 @EsolMio #2615
• 修复又拍云附件删除成功仍旧提示错误的问题。 @shiker1996 #2607
• 修复后台文章列表的标签显示空白括号的问题。 @BoWang816 halo-dev/console#650

Full Changelog: v1.6.0...v1.6.1

1.5.6

What's Changed

• 修复文章保存内容时，可能发生空指针异常的问题。 @EsolMio #2615
• 修复又拍云附件删除成功仍旧提示错误的问题。 @shiker1996 #2607

Full Changelog: v1.5.5...v1.5.6