2.0.0-beta.2

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

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

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

问题修复

• 修复非超级管理员无法 取消发布 和 删除 文章的问题。 @JohnNiang #2701

主要特性

• 支持在首次启动 Halo 时初始化默认主题。 @JohnNiang #2704
• Console 端的 FormKit Schema 定义支持 Repeater 类型的输入选项。 @ruibaby halo-dev/console#692
• Console 端的附件管理支持排序筛选。 @JohnNiang @ruibaby #2705 halo-dev/console#694
• Console 端的附件管理支持删除分组和存储策略。 @ruibaby halo-dev/console#695
• 主题和插件支持获取外部访问地址配置。 @guqing #2714

重要变更

• Console 端不再使用 uuid 为资源设置 metadata.name，改为使用 generateName。 @ruibaby halo-dev/console#688
• 优化文章和自定义页面的保存内容和发布逻辑。 @guqing @ruibaby #2709 halo-dev/console#696
• 主题端 Finder 改为使用 Reactive API。 @guqing #2695 #2715

破坏性变更

• 简化 Snapshot 模型的职责，去除版本相关属性。 @guqing #2709

其他资源

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

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

2.0.0-beta.1

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

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

自 v2.0.0-alpha.4 发布以来的变更如下：

问题修复

• 修复日志 while 循环导致 CPU 占用高的问题。 @guqing #2663
• 修复主题预览时跳转页面没有携带预览参数的问题。 @guqing #2661

主要特性

• 支持通过配置修改文章列表分页大小。 @guqing #2660
• Console 端重构主题预览弹框，支持选择主题以及针对主题进行设置。 @ruibaby halo-dev/console#683
• Console 端的菜单管理支持设置主菜单。 @guqing @ruibaby #2667 halo-dev/console#684
• 主题端提供 pluginFinder.available() API 以获取具体插件的可用状态。 @guqing #2683
• 提供文章全文搜索功能并支持搜索引擎扩展。 @JohnNiang #2675

重要变更

• 主题端获取默认菜单的 API 由 menuFinder.getDefault() 改为 menuFinder.getPrimary()。 @guqing #2667
• 优化 Console 端获取系统初始化状态的方式，解决切换路由会发生卡顿的问题。 @ruibaby halo-dev/console#686
• 重构 Console 端编辑器的创建方式。 @ruibaby halo-dev/console#670
• 重构 Console 端文章和自定义页面的发布流程。 @ruibaby halo-dev/console#685 halo-dev/console#690
• 移除 Console 端表单中的动画效果。 @ruibaby halo-dev/console#687
• 重构文章发布以解决创建与发布 API 几乎同时调用时无法成功发布文章的问题。 @guqing #2659

依赖变更

• 升级 Spring Boot 至 3.0.0-RC2。 @JohnNiang #2692

其他资源

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

Full Changelog: v2.0.0-alpha.4...v2.0.0-beta.1

2.0.0-alpha.4

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

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

自 v2.0.0-alpha.3 发布以来的变更如下：

问题修复

• 修复 Halo 异常停止时日志服务线程无法中断的问题。 @guqing #2639
• 修复获取菜单和分类列表时会出现空指针异常的问题。 @guqing #2645
• 修复当文章和自定义页面被逻辑删除之后，无法通过 label 筛选的问题。 @guqing #2648

主要特性

• 主题端支持通过文章名称获取上一篇和下一篇文章数据。 @guqing #2636
• 文章/自定义页面/分类支持通过主题配置多套渲染模板。 @guqing @ruibaby #2638 halo-dev/console#671
• 文章/分类/标签的访问路径自动追加外部访问地址。 @guqing #2641
• 更新系统设置的表单定义，提供更便捷的代码和附件选择输入框。 @ruibaby #2646
• Console 端的 FormKit Schema 定义支持 Code 类型的输入框。 @ruibaby halo-dev/console#672
• Console 端的 FormKit Schema 定义支持附件选择类型的输入框。 @ruibaby halo-dev/console#674
• Console 端文章/自定义页面管理支持逻辑删除文章，以及新增回收站管理功能。 @ruibaby halo-dev/console#677

重要变更

• 插件 Logo 支持配置外部 URL 或相对于 resources 的路径。 @guqing @ruibaby #2652 halo-dev/console#678
• 优化 Console 端表单的样式。 @ruibaby halo-dev/console#673
• Console 端文章/自定义页面管理里显示的时间改为发布时间。 @ruibaby halo-dev/console#676
• 优化 Console 端首次上传附件时，创建存储策略的流程。 @ruibaby halo-dev/console#681

其他资源

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

Full Changelog: v2.0.0-alpha.3...v2.0.0-alpha.4

2.0.0-alpha.3

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

其次，在 2.0.0-alpha.2 中使用的插件在当前版本中可能无法正常运行。

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

自 v2.0.0-alpha.2 发布以来的变化如下：

问题修复

• 修复主题端菜单查询数据错误问题 by @guqing in #2587
• 修复主题列表数据类型转换问题 by @guqing in #2592
• 修复分类树状数据查询 by @guqing in #2537
• 修复数据一直处于删除中的错误 @JohnNiang in #2612
• 修复删除文章或自定义页面时没有级联删除内容快照和评论的问题 by @guqing in #2601
• 修复插件卸载时没有连同删除插件 JAR 文件的问题 by @guqing in #2613
• 修复文章、自定义页面、评论聚合查询接口排序不固定的问题 by @ruibaby in #2623
• 修复插件首次启动的时候没有设置 Console 端的资源地址问题 by @guqing in #2625
• 修复设置了文章的 htmlMetas 字段但没有在页面的 head 注入标签的问题 by @guqing in #2626
• 修复 halo-dev/console 项目的部分 scripts 无法在 Windows 平台运行的问题。 @Simple-Stark halo-dev/console#642

主要特性

• 新增文章和评论等资源的点赞和点踩 API @guqing in #2566
• 支持设置站点 Favicon by @guqing in #2582
• 为插件提供修改主题模板 head 标签的能力 by @guqing in #2574
• 支持扫描主题目录下未安装的主题 by @guqing in #2586
• 新增 generateName 字段用于自动生成自定义模型名称 by @JohnNiang in #2563
• 提供主题端站点统计信息查询器 by @guqing in #2604
• 提供主题更新功能 @JohnNiang in #2600
• 为主题提供文章归档页 by @guqing in #2598
• @halo-dev/components 添加 Toast 组件。 @ruibaby halo-dev/console#644
• @halo-dev/components 优化 Avatar 组件在图片加载失败的状态。 @ruibaby halo-dev/console#649
• Console 端为登录操作和加载插件资源添加异常提示。 @ruibaby halo-dev/console#645
• Console 端通过扩展 FormKit 的自定义 Input，提供系统常用资源的选择组件。 @ruibaby halo-dev/console#643
• Console 端支持显示和安装未安装的主题，以方便主题开发的时候，创建主题资源。 @ruibaby halo-dev/console#648
• Console 端支持升级主题。 @ruibaby halo-dev/console#653
• Console 端支持升级插件。 @ruibaby halo-dev/console#663
• Console 端的主题管理添加预览主题的支持。 @ruibaby halo-dev/console#660

重要变更

• 重构插件 JsBundle 文件加载方式及路由规则 by @guqing in #2556
• 对反向代理规则注册增加重复注册检查 by @guqing in #2567
• 禁用对 RESTful API 的 CSRF 检查 by @JohnNiang in #2580
• 利用 Radix Tree 优化路由匹配 by @guqing in #2547
• @halo-dev/components 重构 Dialog 组件的 API 调用方式。 @ruibaby halo-dev/console#646
• 重构 Console 端的路由和侧边菜单生成的逻辑。 @ruibaby halo-dev/console#651
• Console 端为部分功能数据列表添加刷新按钮。 @ruibaby halo-dev/console#656
• 优化 Console 端部分数据列表的逻辑，支持在检测出有正在删除的数据时，自动定时刷新列表。 @ruibaby halo-dev/console#661
• 优化 Console 端加载 Logo 的方式，改为以 inline svg 的形式加载，解决因为加载 svg 文件导致的页面抖动问题。 @ruibaby halo-dev/console#664

依赖变更

• 升级 Spring Boot 至 3.0.0-RC1 by @JohnNiang in #2620
• 升级 SpringDoc 至 2.0.0-RC1 by @JohnNiang in #2628
• 升级 jasync-r2dbc-mysql 至 2.1.7 by @JohnNiang in #2631

其他资源

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

Full Changelog: v2.0.0-alpha.2...v2.0.0-alpha.3

2.0.0-alpha.2

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

其次，在 2.0.0-alpha.1 中使用的插件在当前版本中可能无法正常运行。

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

自 v2.0.0-alpha.1 发布以来的变化如下：

问题修复

• 修复主题端内容页访问量统计接口角色规则动词配置错误问题 @guqing #2517
• 修复插件重启引起的异常 @guqing #2518
• 修复系统默认数据无法正常更新的问题 @JohnNiang #2536

主要特性

• 支持 MySQL 和 Maria DB 作为 Halo 的数据库 @JohnNiang #2512
• 支持服务端反向代理 Console @JohnNiang #2535
• 插件卸载支持选择清空数据 @ruibaby
• 菜单项创建支持选择父级菜单项 @ruibaby

重要变更

• 重命名后台管理项目 halo-dev/halo-admin 为 halo-dev/console @ruibaby halo-dev/console#634
• 重构插件反向代理注册方式 @guqing #2522
• 优化系统角色模板配置 @guqing #2524
• 优化系统登录和登出逻辑 @JohnNiang #2528
• 优化用户登录的逻辑，支持提示错误信息 @ruibaby halo-dev/console#636
• 优化 UI 权限控制 @ruibaby

依赖变更

• 升级 Spring Boot 至 3.0.0-M5 @JohnNiang #2511
• 升级 SpringDoc 至 2.0.0-M5 @JohnNiang #2511

其他资源

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

1.6.0

Features

• SMTP 添加 STARTTLS 的设置支持。 #1861 halo-dev/console#552 @ntdgy @wangxiaoerYah
• 为邮件通知模板添加更多的可用参数，email、status、createTime、authorUrl。 #2095 @Yhcrown @iRoZhi
• 后台附件设置中添加 去除图片 EXIF 信息 的选项。 #2168 halo-dev/console#554 @SladeGranger @eziosudo @52lemon6
• 后台文章标签管理支持清理未使用标签。 halo-dev/console#587 @ruibaby
• 重构后台的友情链接管理页面，现在支持拖动排序以及分组管理。 halo-dev/console#574 #2105 @Camsyn @daifiyum @gungnir479

Improvements

• 优化文章编辑时间更新的逻辑，目前更改为仅在修改文章标题或者内容时才更新。 #2195 @wxyShine @ListenV
• 修改后台管理页面为直接渲染而不是重定向，以更好地兼容反向代理。 #2259 @viticis
• 后台在构建时提供 gzip 压缩的资源。 halo-dev/console#547 @2211898719
• 后台主题设置界面顶部提供了保存设置的按钮。 halo-dev/console#549 @Aanko
• 修改后台页面的 lang 属性，由 zh-cmn-Hans 改为 cmn-Han，zh-cmn-Hans 已废弃。 halo-dev/console#576 @wordlesswind
• 优化后台附件库列表以及选择附件弹框的布局。 halo-dev/console#580 @ruibaby
• 修改后台底部的 Power by Halo 为 Powered by Halo。 halo-dev/console#597 @liaocp666
• 优化后台日志管理设置公开/隐藏状态的方式。 halo-dev/console#610 @zjy4fun @manction
• 优化后台在个人资料中设置头像的逻辑，现在无需再提交个人资料表单。 halo-dev/console#619 @wxyShine
• 优化后台图库批量从附件添加时，按照选择顺序倒序排列，即最先选择的图片在最前面。 halo-dev/console#631 @zjy4fun @zyy247796143

Bug Fixes

• 修复文章详情页 meta_description 为空的问题。 #2282 @guqing @ruibaby
• 修复批量删除外部云存储的时候，因为文件不存在导致的删除失败问题。 #2317 @JustinLiang522 @129duckflew
• 修复了七牛云存储附件无法上传非图片文件的问题。 #2331 @AirboZH @hexWars
• 修复未审核评论回复会发送邮件提醒的问题。 #2340 @AirboZH @cetr
• 修复在单个分类所属文章页面页面变量中无法获取子分类中文章的问题。 #2405 @JustinLiang522 @HugeLeaf
• 修复管理员资料表单中邮件地址的字符数限制。 halo-dev/console#571 @Yhcrown
• 修复了无法设置日志、相册、链接页标题和每页显示条数的问题。 halo-dev/console#601 @JustinLiang522 @manction

Dependencies

• Docker 镜像的基础镜像使用 Eclipse Temurin 镜像替代 AdoptOpenJDK。 #2120 @wordlesswind

Full Changelog: v1.5.4...v1.6.0

1.5.5

Improvements

• 完善install路径返回的页面结果。#2225 @cetr
• 修改根据分类查询文章方法，使其同时返回子分类文章。#2405 @JustinLiang522

Bug Fixes

• 修复七牛云做附件存储时附件无法上传非图片文件的问题。#2331 @AirboZH
• 修复了当云存储中文件被删除时，在 Halo 同时删除多个附件会失败的问题。#2317 @JustinLiang522
• 修复文章详情页 meta_description 为空的问题。#2282 @guqing
• 修复了无法设置日志、相册、链接页标题和每页显示条数的问题。halo-dev/console#601 @JustinLiang522

Full Changelog: v1.5.4...v1.5.5

2.0.0-alpha.1

⚠️ 注意

此版本为 Halo 2.0 的首个 Alpha 测试版本，无法从 1.5 直接升级到当前版本，也不建议在生产环境使用。当前版本仅用于测试，我们欢迎大家在测试过程中反馈任何问题。另外，在 Halo 2.0 正式发布的时候，我们会提供完整的升级指南。

主要特性

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

重要变更

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

文档

https://docs.halo.run/2.0.0-SNAPSHOT

资源

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

1.5.4

Improvements

• 默认评论组件的地址由 jsDelivr 更改为 unpkg.com。 #2098 @Yhcrown @ruibaby
• 限制 Markdown 导入文件的格式和大小。 #2104 #2187 @ETLAN666 @XM2510136957 @eziosudo
• 又拍云附件上传文件命名规则改为保持原文件名。 #2185 @okayhu

Bug Fixes

• 修复后台新建分类中父级分类选择列表过长导致的 UI 问题。 halo-dev/console#577 @SladeGranger @Alickx
• 修复附件名包含特殊字符无法访问的问题。 #1874 halo-dev/console#568 @FanZeros @Lwenguang
• 修复导入文章时 Front Matter 解析错误的问题。 #2137 @Simple-Stark @MarmaladeCat
• 修复在 Windows 平台下，导出 Markdown 文档因为文件名包含特殊字符导致无法导出的问题。 #2143 @eziosudo @szgacsaftop
• 修复静态存储文件重命名时文件名造成的目录逃逸问题。 #2207 @JohnNiang
• 修复上传附件到华为云时提示 NoSuchMethodError，okhttp3.RequestBody.create 的问题。 #2209 @JohnNiang @toolv94

Dependencies

• 更新后台 @halo-dev/editor 版本。 halo-dev/console#584 @ruibaby
  • 优化预览/编辑按钮的提示文案。 halo-dev/editor#4 @manction
  • 修复编辑器的滚动条会与添加链接面板有重叠的问题。 halo-dev/editor#5 @wxyShine @zyy247796143

Upgrade guide

https://docs.halo.run/install/upgrade

---

v1.5.3...v1.5.4

1.5.3

Improvements

• 优化邮件发送异常信息处理。 #1860 @ntdgy @superdgy
• 优化静态存储的资源映射处理逻辑，支持手动操作 .halo/static 目录后，在后台通过刷新按钮更新资源映射。 #1907 @Yhcrown @muyunil
• 优化文章字数统计的算法。将中文和其他字符分开统计，中文按照字数计数，其他的语言默认按照标点分割来计数。 #1865 @Yhcrown @Tanhex
• 优化后台部分弹窗中表单在移动端的布局。 halo-dev/console#564 @ruibaby

Bug Fixes

• 修复在 Windows 平台下，因为 H2 Database 文件被占用导致无法全站备份的问题。 #1867 @anshangPro
• 修复在 1.5.x 版本中，文章搜索没有关联查询内容（contents）的问题。 #1873 @Yhcrown @guqing
• 修复本地上传附件过程中如果发生异常，没有完整打印异常信息栈的问题。 #1913 @JohnNiang
• 修复在系统初始化之后，仍然可以通过 /install 跳转到登录页面的问题。 #1908 @Ljfanny @littlesleep
• 修复评论通知无法正常发送邮件的问题。 #1916 @JohnNiang @hapke24
• 修复后台仪表盘中最近文章的标题过长导致样式异常的问题。 halo-dev/console#545 @Aanko @hotspring-zwb
• 修复后台带有分页的数据列表中，删除最后一页的所有数据后导致分页页码异常的问题。 halo-dev/console#550 @QuentinHsu @luohongqu
• 修复后台修复因为缓存数据，重新安装会出现循环进入 install 路由的问题。 halo-dev/console#558 @ruibaby @Ljfanny

Dependencies

• 更新后台 @halo-dev/editor 版本。 halo-dev/console#562 @ruibaby
  • 修复在改变编辑器布局后导致重复初始化编辑器的问题。

---

v1.5.2...v1.5.3