问题修复

• 修复最后一页数据可能包含上一页部分数据的问题 by @JohnNiang in #8138
• 修复头像附件配置的描述文本，移除不存在的分组选项说明 by @Copilot in #8145
• 修复 Windows 和 Linux 下无法正常访问缩略图的问题 by @JohnNiang in #8153
• 解决编辑器粘贴富文本内单个图片时无法正确上传的问题 by @LIlGG in #8154

文档

https://docs.halo.run

资源

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

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

Full Changelog: v2.22.3...v2.22.4

功能优化

• 支持使用已验证邮箱登录 by @JohnNiang in #8126
• 个人中心文章设置支持元数据表单 by @JohnNiang in #8129

文档

https://docs.halo.run

资源

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

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

Full Changelog: v2.22.2...v2.22.3

功能优化

• 提升文章、页面、分类的标题和别名字符串长度限制，以提供更好的兼容性 by @ruibaby in #8117

问题修复

• 解决使用部分数据库时无法正常启动的问题 by @JohnNiang in #8115
• 修复部分文章路由规则配置失效的问题 by @JohnNiang in #8116

文档

https://docs.halo.run

资源

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

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

Full Changelog: v2.22.1...v2.22.2

功能优化

• 优化 Iconify 表单类型的图标样式，不再固定宽度，以提供更好的兼容性 by @ruibaby in #8111

问题修复

• 修复附件分组下拉选项显示不完整的问题 by @ruibaby in #8109

开发者相关

• 为 FormKit 添加 Swtich 表单类型 by @LIlGG in #8095

文档

https://docs.halo.run

资源

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

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

Full Changelog: v2.22.0...v2.22.1

⚠️ 注意

• 此版本重构了部分插件 API，升级之后可能导致部分插件无法正常使用，升级之前建议先检查你所使用的插件是否已经兼容 Halo 2.22，在升级之后建议及时更新所有能够更新的插件。
• 此版本重构了附件缩略图的生成逻辑，并且与之前版本的存储目录结构不同，所以在升级之后可能需要按需重新��成，在这个阶段可能会导致网站资源占用较高，属于正常现象。

插件和主题的 API 变更可查阅：插件 API 变更日志 / 主题 API 变更日志

新特性

• 为编辑器新增图片集功能 by @LIlGG in #7897
• 用户注册支持设置受保护用户名 by @liuyiwuqing in #7887
• 编辑器的图片、视频、音频支持添加描述文本 by @LIlGG in #7875
• 重构编辑器拖拽功能，并为其增加功能操作菜单 by @LIlGG in #7861
• 编辑器支持使用中文符号、唤起建议菜单 by @LIlGG in #7840
• 支持在文章编辑页面设置封面图 by @ruibaby in #7809
• 支持为附件存储策略设置在上传界面的显示优先级 by @ruibaby in #7805
• 支持在附件上传界面隐藏部分存储策略 by @ruibaby in #7792

功能优化

• 清理通知发送所残留的无用数据 by @JohnNiang in #8007
• 用户密码允许输入 . 和 ? by @xzyone in #8005
• 为阻塞操作添加超时时间以提升系统可靠性 by @JohnNiang in #8004
• 优化编辑器的整体样式和交互逻辑 by @ruibaby in #7982
• 优化 Console 和 UC 的加载速度 by @ruibaby in #7976 #7971 #7941 #7935 #8037
• 提升 Console 端代码输入框的渲染速度 by @ruibaby in #7956 #7932
• 优化个人中心身份认证设置，将三方登录与两步认证合并到一个选项卡 by @ruibaby in #7950
• Console 和 UC 支持异步加载所需语言包，提升首屏加载速度 by @ruibaby in #7931
• 懒加载 Console 和 UC 的部分路由，优化首屏渲染速度 by @ruibaby in #7930
• 文章设置中选择作者时支持显示用户名 by @ruibaby in #7904
• 修复离线环境下，Console 无法请求接口的问题 by @ruibaby in #7848
• 解决生成缩略图时可能出现内存溢出的问题 by @JohnNiang in #7817
• 支持配置缩略图生成启用、禁用和并发量 by @JohnNiang in #7812
• 为编辑器的命令面板添加插入图片的选项 by @ruibaby in #7803
• 重构图片缩略图��能，移除缩略图记录，改为按需生成 by @JohnNiang in #7779
• 新增 Shiki 代码高亮和超链接卡片预设插件 by @ruibaby in #7785
• 优化系统性能 by @JohnNiang in #8045
• 优化文章详情页面加载 by @JohnNiang in #8047
• 优化编辑器搜索界面的样式 by @ruibaby in #8052
• 重构附件选择��窗，与上传界面融合 by @ruibaby in #8058
• 重构附件表单类型，支持预览和直接上传 by @ruibaby in #8061
• 重构附件默认存储策略配置，统一在设置 -> 附件设置中配置 by @JohnNiang in #8092

问题修复

• 解决无法在编辑器中插入视频的问题 by @LIlGG in #7986
• 修复可能无法初始化主题配置的问题 by @JohnNiang in #7923
• 修复潜在的内存泄漏问题 by @JohnNiang in #7914
• 优化重置密码时因邮箱可输入大小写导致的问题 by @JohnNiang in #7901
• 解决切换代码块语言时编辑器页面不正常跳动的问题 by @LIlGG in #7839
• 修复可能无法正常获取附件链接的问题 by @JohnNiang in #7788

依赖更新

• 升级 Spring Boot 至 3.5.7 by @JohnNiang in #7871
• 升级 Spring Boot 至 3.5.9 by @JohnNiang in #8069
• 升级 Tiptap 至 3.x by @LIlGG in #7811

开发者相关

• 修复 @halo-dev/components 的 Dropdown 组件类型问题 by @ruibaby in #7974
• 将 @halo-dev/console-shared 重命名为 @halo-dev/ui-shared by @ruibaby in #7926
• @halo-dev/console-shared 包提供 utils.id.uuid() 方法，用于生成 uuid by @ruibaby in #7898
• 在 @halo-dev/console-shared 包中提供 stores 对象，包含 currentUser 和 globalInfo by @ruibaby in #7858
• 支持在插件的 UI 中使用 Pinia 定义全局 Store by @ruibaby in #7858
• 在 @halo-dev/console-shared 包中提供 UI 权限检查工具 by @ruibaby in #7853
• 在 @halo-dev/console-shared 包中提供统一的 date 和 attachment 工具 by @ruibaby in #7847
• 优化索引引擎以提升索引和查询性能 by @JohnNiang in #7822
• 优化 FormKit 的 color 输入类型，支持透明度 by @ruibaby in #8003
• 为 FormKit 添加 Iconify 选择组件 by @ruibaby in #8000
• 重构 @halo-dev/components 中的 Dropdown 组件，改为完全使用 floating-vue 的原始组件 by @ruibaby in #7978
• 改进 @halo-dev/api-client 包的配置，在外部使用的时候支持 tree shaking by @ruibaby in #7966
• FormKit Color 支持 hsl 格式，并支持手动编辑色值 by @ruibaby in #8039
• 为文章、页面等元数据表单注入当前表单的数据，以便在元数据定义中判断是否需要显示表单项 by @ruibaby in #8040

文档

https://docs.halo.run

资源

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

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

Full Changelog: v2.21.9...v2.22.0

⚠️ 提示

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

• 2.22.0-alpha.4
• 2.22.0-alpha.3
• 2.22.0-alpha.2
• 2.22.0-alpha.1

依赖更新

• 升级 Spring Boot 至 3.5.9 by @JohnNiang in #8069

开发者相关

• Array 表单类型的列表支持显示颜色值 by @Copilot in #8067

Full Changelog: v2.22.0-alpha.4...v2.22.0-rc.1

⚠️ 提示

此版本为 2.22.0 的测试版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

插件和主题的 API 变更可查阅：插件 API 变更日志 / 主题 API 变更日志

• 2.22.0-alpha.3
• 2.22.0-alpha.2
• 2.22.0-alpha.1

功能优化

• 重构附件选择弹窗，与上传界面融合 by @ruibaby in #8058
• 重构附件表单类型，支持预览和直接上传 by @ruibaby in #8061

问题修复

• 修复异步加载 Console 语言包异常的问题 by @ruibaby in #8062
• 修复 Array 表单类型中 Iconify 表单项可能无法预览的问题 by @ruibaby in #8065

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

⚠️ 提示

此版本为 2.22.0 的测试版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

插件和主题的 API 变更可查阅：插件 API 变更日志 / 主题 API 变更日志

• 2.22.0-alpha.2
• 2.22.0-alpha.1

功能优化

• 优化 Console 和 UC 的加载速度 by @ruibaby in #8037
• 优化系统性能 by @JohnNiang in #8045
• 优化文章详情页面加载 by @JohnNiang in #8047
• 优化编辑器搜索界面的样式 by @ruibaby in #8052

开发者相关

• FormKit Color 支持 hsl 格式，并支持手动编辑色值 by @ruibaby in #8039
• 为文章、页面等元数据表单注入当前表单的数据，以便在元数据定义中判断是否需要显示表单项 by @ruibaby in #8040
• 修改 FormKit Iconify 表单类型的数据结构，默认以对象形式存储 by @ruibaby in #8042 #8055

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

⚠️ 提示

此版本为 2.22.0 的早期版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

插件和主题的 API 变更可查阅：插件 API 变更日志 / 主题 API 变更日志

• 2.22.0-alpha.1

功能优化

• 降低文章编辑器中封面的高度，并支持展开图片 by @ruibaby in #8027
• 优化编辑器中图片的大小设置，默认不为其设置 height by @LIlGG in #8031
• FormKit Iconify 支持手动编辑图标信息 by @ruibaby in #8033

问题修复

• 解决编辑器搜索与替换框位置不正确的情况 by @LIlGG in #8029

开发者相关

• FormKit Iconify 支持显示 iconify 数据 by @LIlGG in #8014
• 修复表单中同时存在多个 Array 输入类型时，界面显示异常的问题 by @LIlGG in #8024
• FormKit Iconify 输入框支持配置展开位置 by @ruibaby in #8026

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

⚠️ 提示

此版本为 2.22.0 的早期版本，不适用于生产环境。这个版本部分功能的内部实现做了较大变更，同时包含了部分插件 API 的变动，发布此版本的主要目的是为了可以让社区的插件和主题开发者提前适配。

插件和主题的 API 变更可查阅：插件 API 变更日志 / 主题 API 变更日志

由于 UI 的依赖库还未发布到 npm，暂时可以使用在 pkg.pr.new 中构建的版本。

新特性

• 为编辑器新增画廊（图片集）功能 by @LIlGG in #7897
• 用户注册支持设置受保护用户名 by @liuyiwuqing in #7887
• 编辑器的图片、视频、音频支持添加描述文本 by @LIlGG in #7875
• 重构编辑器拖拽功能，并为其增加功能操作菜单 by @LIlGG in #7861
• 编辑器支持使用中文符号、唤起建议菜单 by @LIlGG in #7840
• 支持在文章编辑页面设置封面图 by @ruibaby in #7809
• 支持为附件存储策略设置在上传界面的显示优先级 by @ruibaby in #7805
• 支持在附件上传界面隐藏部分存储策略 by @ruibaby in #7792

功能优化

• 清理通���发送所残留的无用数据 by @JohnNiang in #8007
• 当首页没有使用文章列表变量时，不再查询数据库，以提升性能 by @JohnNiang in #8006
• 用户密码允许输入 . 和 ? by @xzyone in #8005
• 为阻塞操作添加超时时间以提升系统可靠性 by @JohnNiang in #8004
• 优化编辑器的整体样式和交互逻辑 by @ruibaby in #7982
• 优化 Console 和 UC 的加载速度 by @ruibaby in #7976 #7971 #7941 #7935
• 提升 Console 端代码输入框的渲染速度 by @ruibaby in #7956 #7932
• 优化个人中心身份认证设置，将三方登录与两步认证合并到一个选项卡 by @ruibaby in #7950
• Console 和 UC 支持异步加载所需语言包，提升首屏加载速度 by @ruibaby in #7931
• 懒加载 Console 和 UC 的部分路由，优化首屏渲染速度 by @ruibaby in #7930
• 文章设置中选择作者时支持显示用户名 by @ruibaby in #7904
• 修复离线环境下，Console 无法请求接口的问题 by @ruibaby in #7848
• 解决生成缩略图时可能出现内存溢出的问题 by @JohnNiang in #7817
• 支持配置缩略图生成启用、禁用和并发量 by @JohnNiang in #7812
• 为编辑器的命令面板添加插入图片的选项 by @ruibaby in #7803
• 重构图片缩略图功能，移除缩略图记录，改为按需生成 by @JohnNiang in #7779
• 新增 Shiki 代码高亮和超链接卡片预设插件 by @ruibaby in #7785

问题修复

• 解决无法在编辑器中插入视频的问题 by @LIlGG in #7986
• 修复可能无法初始化主题配置的问题 by @JohnNiang in #7923
• 修复潜在的内存泄漏问题 by @JohnNiang in #7914
• 优化重置密码时因邮箱可输入大小写导致的问题 by @JohnNiang in #7901
• 解决切换代码块语言时编辑器页面不正常跳动的问题 by @LIlGG in #7839
• 修复可能无法正常获取附件链接的问题 by @JohnNiang in #7788

依赖更新

• 升级 Spring Boot 至 3.5.7 by @JohnNiang in #7871
• 升级 Tiptap 至 3.x by @LIlGG in #7811

开发者相关

• 修复 @halo-dev/components 的 Dropdown 组件类型问题 by @ruibaby in #7974
• 将 @halo-dev/console-shared 重命名为 @halo-dev/ui-shared by @ruibaby in #7926
• @halo-dev/console-shared 包提供 utils.id.uuid() 方法，用于生成 uuid by @ruibaby in #7898
• 在 @halo-dev/console-shared 包中提供 stores 对象，包含 currentUser 和 globalInfo by @ruibaby in #7858
• 支持在插件的 UI 中使用 Pinia 定义全局 Store by @ruibaby in #7858
• 在 @halo-dev/console-shared 包中提供 UI 权限检查工具 by @ruibaby in #7853
• 在 @halo-dev/console-shared 包中提供统一的 date 和 attachment 工具 by @ruibaby in #7847
• 优化索引引擎以提升索引和查询性能 by @JohnNiang in #7822
• 优化 FormKit 的 color 输入类型，支持透明度 by @ruibaby in #8003
• 为 FormKit 添加 Iconify 选择组件 by @ruibaby in #8000
• 重构 @halo-dev/components 中的 Dropdown 组件，改为完全使用 floating-vue 的原始组件 by @ruibaby in #7978
• 改进 @halo-dev/api-client 包的配置，在外部使用的时候支持 tree shaking by @ruibaby in #7966

Full Changelog: v2.21.9...v2.22.0-alpha.1