更新日志
本项目的所有显著变更将记录在本文件中。
Unreleased
💥 破坏性变更
- 社交资料设置(
console/theme/settings/sns)中,index_sns数组重命名为sns_list,同时type字段由对象类型改为字符串类型。已有配置需重新设置社交资料列表。 - 分享按钮设置(
console/theme/settings/share)中,button_config数组拆分为share_list(预设按钮列表)和custom_share(自定义按钮)。已有配置需重新设置分享按钮列表。
🚀 新功能
- 分享按钮预设新增 Reddit、WhatsApp、Tumblr、LINE、Hacker News、Blogger、Gmail、Yahoo Mail 和 Skype。
🐛 错误修复
- 修复社交资料设置(
console/theme/settings/sns)保存后无法显示已选类型的问题。 - 修复未安装 RSS 插件时,社交资料中设置的 RSS 链接无法输出
<link>标签的问题。
1.58.2 - 2026-03-18
💥 破坏性变更
- 最低 Halo 版本要求提升至 2.23.1。
🔧 代码重构
- 优化无障碍文本。
- 将主要页面内容用
<main>标签包裹以优化无障碍。
🗑️ 移除
- 移除标签详情页的
<meta name="description">标签,以适配 Halo 2.23.1 内置的 SEO 描述输出。
🛠️ 杂项维护
- 更新开发依赖。
1.58.1 - 2026-03-15
🚀 新功能
- 支持
<meta name="theme-color" />,根据当前主题样式自动输出并更新浏览器地址栏主题色。
🔧 代码重构
- 将
scripts和styles目录移动到templates下,并同步更新相关资源引用路径。
🗑️ 移除
- 移除模板中的
<meta http-equiv="X-UA-Compatible">标签。
📄 文档
- 新增“响应式断点”参考文档,统一手机、平板、桌面断点区间定义,并补充现代写法与兼容写法示例。
- 更新贡献指南,补充 nightly 测试版发布的提交统计规则(时间窗口、正式版 Tag 边界与自动提交排除项)。
🛠️ 杂项维护
- 调整 nightly 预发布触发检查:仅统计前一个自然日(Asia/Shanghai)且位于上一个正式版 Tag 之后的提交,并排除以
docs:开头的自动提交。 - 将页面体积审计结果 PR 的提交前缀由
chore:改为docs:。 - 新增更新日志末尾版本对比链接(
[Unreleased]与各版本号)的自动重建与 CI 校验。
1.58.0 - 2026-03-13
🚀 新功能
- 为所有含有
<link rel="canonical">标签的页面(首页、文章页、归档页、分类集合页、分类详情页、标签集合页、标签详情页、作者详情页、自定义页面、链接页、图库页、瞬间页、朋友圈页面)添加 canonical 标签输出开关控制,默认开启。
🔧 代码重构
- 重构标题边距与段落边距样式,统一边距声明并补充段落控制项,以减小页面渲染体积。
📄 文档
- 修订贡献指南。
1.57.6 - 2026-03-13
📄 文档
- 更改更新日志和贡献指南位置。
- 创建发布流程文档。
🛠️ 杂项维护
- 重构发布流程。
- 为正式版与每日预发布流程接入 artifact attestation(Sigstore provenance),对发布 zip 产物生成可验证来源证明。
1.57.5 - 2026-03-12
🐛 错误修复
- 参考 nonzzz/vite-plugin-compression#93,为符合 RFC 9659 规范,以防止在 Chrome(v123+)和 Firefox(v126+)中报错,调整
*.zst预压缩文件的 zstandard 算法压缩等级至 19。
1.57.4 - 2026-03-12
🚀 新功能
- 为页面添加
<link rel="canonical">标签,优化 SEO 表现。
🔧 代码重构
- 调整
*.zst预压缩文件的 zstandard 算法压缩等级至 22。
🐛 错误修复
- 优化亮色主题配色,提升部分配色与背景的对比度。
- 修复首页和朋友圈页标题颜色渲染错误的问题。
- 修复首页多元列表中文章项二级标题样式显示错误的问题。
- 修复文章内链接标题样式渲染错误的问题。
🛠️ 杂项维护
- 更新开发依赖。
1.57.3 - 2026-02-28
🔧 代码重构
- 重构组件实现。
🛠️ 杂项维护
- 更新开发依赖。
- 优化构建流程。
1.57.2 - 2026-02-13
🔧 代码重构
- 优化主题 SEO,部分页面的顶部站点名不再是一级标题。
1.57.1 - 2026-02-10
🚀 新功能
- 为主题资源添加 SRI 信息以提高安全性。
- 主题的静态资源已提供预压缩版本:
- 文件类型:
.js:.js.gz、.js.br、.js.zst.css:.css.gz、.css.br、.css.zst
- 对应算法与压缩等级:
*.gz— gzip(压缩等级 9,最高)*.br— brotli(压缩等级 11,最高)*.zst— zstandard(压缩等级 21,已使用最大值减 1,以避免构建时内存不足)
- 自动提供与服务器配置:
- 直接使用 Halo CMS 时,服务器会自动提供
.br文件。 - 使用 nginx/Apache 等服务器时,请参考配置文档以启用预压缩文件的自动交付。
- 直接使用 Halo CMS 时,服务器会自动提供
- 文件类型:
🔧 代码重构
- 调整 instant.page 脚本注入位置,优化加载速度。
📄 文档
- 修订安全防护文档。
🛠️ 杂项维护
- 更新开发依赖。
1.57.0 - 2026-02-05
🚀 新功能
- 图库页瀑布流布局支持显示分组标题。
- 图库页新增支持在启用瀑布流布局时显示分组标题,每个分组将拥有独立的瀑布流实例。
图库页样式 -> 显示分组标题配置项现在在启用瀑布流布局时也可用。
1.56.2- 2026-02-04
🐛 错误修复
- 修复启用“全局 -> 多语言功能前缀匹配模式”且根菜单存在非自定义链接类型时会触发内部错误的问题。
1.56.1 - 2026-02-04
🐛 错误修复
- 修复模板中未闭合的引号。
1.56.0 - 2026-02-04
🚀 新功能
- 新增首页朋友圈列表布局功能。
- 在
首页样式 -> 主页列表布局中新增"朋友圈列表"选项,允许在首页显示朋友圈插件的订阅文章(需朋友圈插件启用)。 - 新增
朋友圈列表显示条数配置项,允许设置朋友圈列表在首页显示的文章条数(默认为 10)。 - 新增
朋友圈列表显示发布日期配置项,允许控制是否在朋友圈列表中显示文章发布日期(默认为开启)。 - 新增
朋友圈列表显示作者信息配置项,允许控制是否在朋友圈列表中显示作者信息(默认为开启)。 - 新增
朋友圈列表显示作者头像配置项,允许控制是否在朋友圈列表中显示作者头像(默认为开启)。 - 新增
朋友圈列表显示作者名称配置项,允许控制是否在朋友圈列表中显示作者名称(默认为开启)。 - 新增
朋友圈列表显示文章描述配置项,允许控制是否在朋友圈列表中显示文章描述(默认为开启)。 - 新增
朋友圈列表文章描述行数上限配置项,允许设置朋友圈列表中文章描述显示的最大行数(默认为 3 行,范围 1-5)。 - 新增
朋友圈列表显示跳转链接提示文字配置项,允许控制是否在朋友圈列表文章项中显示跳转链接的提示文字(默认为开启)。
- 在
- 新增归档页文章列表发布日期显示控制功能。
- 新增
文章列表显示文章发布时间配置项,允许控制是否在归档页的文章列表中显示文章发布日期(默认为开启)。
- 新增
- 新增标签详情页文章列表发布日期显示控制功能。
- 新增
文章列表显示文章发布时间配置项,允许控制是否在标签详情页的文章列表中显示文章发布日期(默认为开启)。
- 新增
- 新增分类详情页文章列表发布日期显示控制功能。
- 新增
文章列表显示文章发布时间配置项,允许控制是否在分类详情页的文章列表中显示文章发布日期(默认为开启)。
- 新增
- 新增瞬间页面帖文发布时间显示控制功能。
- 新增
帖文发布时间配置项,允许控制是否在瞬间页面的帖文列表中显示帖文发布时间(默认为开启)。
- 新增
- 新增首页瞬间列表条目发布时间显示控制功能。
- 新增
瞬间列表显示条目发布时间配置项,允许控制是否在首页瞬间列表中显示条目发布时间(默认为开启)。
- 新增
- 新增首页瞬间列表单独配置功能。
- 新增
瞬间列表显示条目预计阅读时间配置项,允许单独控制首页瞬间列表中的预计阅读时间显示(默认为关闭)。 - 新增
瞬间列表显示条目字数统计配置项,允许单独控制首页瞬间列表中的字数统计显示(默认为关闭)。 - 新增
瞬间列表启用点赞按钮配置项,允许单独控制首页瞬间列表中的点赞按钮(默认为开启)。 - 新增
瞬间列表启用评论区配置项,允许单独控制首页瞬间列表中的评论区(默认为开启)。
- 新增
- 新增作者详情页文章列表发布日期显示控制功能。
- 新增
文章列表显示文章发布时间配置项,允许控制是否在作者详情页的文章列表中显示文章发布日期(默认为开启)。
- 新增
🐛 错误修复
- 修复
首页样式 -> 主页列表布局选择“瞬间列表”且“瞬间”插件未启动时,页面出现服务内部错误的问题。 - 修复启用
全局 -> 多语言菜单支持且禁用全局 -> 多语言功能前缀匹配模式时,无法正确匹配菜单的问题。 - 修复错误页在主错误标题可用时仍展示备用标题的问题。
- 修复内置主题
浅色 - 灰粉文件名拼写错误的问题。
🛠️ 杂项维护
- 更新开发依赖。
- 手动格式化模板内
th:if、th:unless、th:with的字符串值。
1.55.1 - 2026-02-03
🐛 错误修复
- 修复瞬间页(
/moments)翻页组件链接不正确的问题。 - 修复启用
全局 -> 仅允许使用指定域名访问且域名白名单列表为空时,页面会无限跳转的问题。
1.55.0- 2026-02-03
🚀 新功能
- 适配朋友圈(应用市场页面)插件。
- 介绍文档:朋友圈插件介绍
- 新增相关配置项:朋友圈页面样式配置项
- 新增首页文章列表发布日期显示控制功能。
- 简洁文章列表:新增
简洁列表显示发布日期配置项,允许控制是否显示文章发布日期(默认为开启)。 - 多元文章列表:新增
多元列表显示发布日期配置项,允许控制是否显示文章发布日期(默认为开启)。
- 简洁文章列表:新增
🐛 错误修复
- 修复
首页样式 -> 主页列表布局选择“瞬间列表”时,在页数大于 1 时无法加载页面的问题。
🔧 代码重构
- 优化英文文档翻译质量。
1.54.0- 2026-01-28
💥 破坏性变更
- 更新后需重新设定
总体样式 -> 自定义字体文件,以修复无法显示已选选项的问题。
🚀 新功能
- 重构自定义字体相关配置,允许进行更详细的设定。
🔧 代码重构
- 默认 Meslo 字体补充相关声明:添加粗体版本、斜体版本、粗斜体版本。
- 优化自定义字体相关渲染逻辑。
🛠️ 杂项维护
- 更新开发依赖。
1.53.1- 2026-01-28
🐛 错误修复
- 修复在 WebKit 内核的浏览器上,页脚内容和文章页顶部菜单出现异常换行的问题。
🔧 代码重构
- 优化自定义鼠标指针声明。
- 更新 Meslo 字体版本从 1.2 到 1.2.1,并且重新压缩各格式,以优化字体体积。
- 优化后备字体声明。
- 移除无用的
vite-ignore声明,优化构建产物体积。
🛠️ 杂项维护
- 更新开发依赖。
1.53.0 - 2026-01-17
🚀 新功能
- 支持自定义鼠标指针。
1.52.1 - 2026-01-16
🚀 新功能
- 支持显示二级菜单。
- 文章页平板模式下(平板样式为页面宽度大于等于 768px 且小于 1024px),可以显示目录了。
- 右上角菜单的回到页面顶端按钮更换为目录按钮。
- 页面不在顶端时,右下角不仅显示回到页面顶端按钮,也显示目录按钮。
🐛 错误修复
- 修复“链接页样式 - 链接描述行数上限”和“首页样式 - 多元列表文章摘要行数上限”默认值无法正常生效的问题。
📄 文档
- 补充多语言文档。
🛠️ 杂项维护
- 更新开发依赖。
1.52.0 - 2026-01-15
💥 破坏性变更
- Halo CMS 最低要求版本从 2.22.0 变更为 2.22.1
🚀 新功能
- 新增“链接页样式 - 头像优先样式”布局选项,支持三列网格展示,强调头像显示。
- 新增子配置“链接页样式 - 链接描述行数上限”
🐛 错误修复
- 修复链接页下,链接描述文本较长且无法自动换行,最终导致溢出屏幕的问题。
- 修复“首页样式 - 多元列表文章摘要行数上限”无法正常工作的问题。
🔧 代码重构
- 将需要插件支持的相关配置项分页移到最后,并在开头加上提示信息。
- 将配置项出现的 checkbox 控件更新为 switch 控件。(勾选框变开关样式)
🛠️ 杂项维护
- 更新开发依赖。
1.51.1 - 2026-01-04
🐛 错误修复
- 修复首页文章列表置顶图标使用颜色错误的问题。
1.51.0 - 2026-01-03
💥 破坏性变更
- 更新后需重新设定
总体样式 -> 配色方案,以修复无法显示已选选项的问题。 - 更新后需重新设定
总体样式 -> 自定义配色方案,以适配新的主题变量设定。
🚀 新功能
- 支持使用 Halo CMS 2.22 新引入的控件来自定义主题配色。
- 即使你没有任何前端知识,现在也能简单地自定义主题配色了!
- 详情请阅读:教程:自定义配色方案
🐛 错误修复
- 修复
总体样式 -> 配色方案保存后无法显示已选选项的问题。 - 修复链接页图片描述意外居中的问题。
- 修复文档预览样式错误的问题。
- 修复瞬间详情页评论区展开/收起按钮点击无反应的问题。
🔧 代码重构
- 移除评论组件 v2 支持,减小包体积。
- 简化主题 CSS 变量数。
- 按需加载字号声明,减小资源体积。
- 按需加载自定义样式,减小页面体积。
- 配置文件尽量不使用
if: "$get(xxx).value === 'xxx'",减小配置页错乱的概率。 - 组件化评论组件样式支持,按需加载,减少页面体积。
- 组件化页面
color-scheme设定,按需加载,减少页面体积。 - 优化瞬间页标签样式。
1.50.2 - 2026-01-01
🚀 新功能
- 支持 Vditor 编辑器插件的
[toc]内联目录。
1.50.1 - 2025-12-28
🔧 代码重构
- 优化包体积。
📄 文档
- 优化文档,新增浏览器兼容性页面。
🛠️ 杂项维护
- 更新开发依赖。
1.50.0 - 2025-12-24
💥 破坏性变更
- Halo CMS 版本要求变为
2.22+。 - 自定义图标设置框将适配 Halo CMS 在 2.22 引入的
iconify类型,您需要重新设置。
🚀 新功能
- 添加配置项“标签集合页样式 -> 页面描述”。
- 添加配置项“分类集合页样式 -> 页面描述”。
- 添加配置项“作者详情页样式 -> 页面描述”。
- 添加配置项“归档页样式 -> 页面描述”。
- 支持
figcaption(图片、视频、音频描述文本)样式。
🔧 代码重构
- 将原本的重复设置项(可重复一组输入。可增加组,移除组,交换任意组顺序),更新为 Halo CMS 2.22 最新样式。
🐛 错误修复
- 修复错误页无法正常显示的问题。
🛠️ 杂项维护
- 更新开发依赖。
- 将 PostCSS 替换成 Lightning CSS,构建速度提高了一倍。
- 将基础样式加入
@layer base层级,避免覆盖 Tailwind CSS 样式。(之前 Tailwind CSS 添加的样式有:not(#\#),Lightning CSS 最小化时删去了:not(#\#)凸显了这个问题)
- 将基础样式加入
1.49.2 - 2025-12-13
🐛 错误修复
- 修复
强制页脚、页码在页面底部配置项失效的问题。
🛠️ 杂项维护
- 更新开发依赖。
1.49.1 - 2025-12-06
🐛 错误修复
- 修复当文章页开启点赞按钮,关闭评论区时,页脚内容会与点赞按钮重叠的问题。
- 修复当无文章发布,随机文章功能会使页面崩溃的问题。
- 移除意外被设置的边框颜色
🔧 代码重构
- 优化图标显示样式
🛠️ 杂项维护
- 重构构建流程。
- 组件化部分模板。
- 更新开发依赖。
1.49.0 - 2025-11-29
💥 破坏性变更
- 你需要使用新流程自定义图标,相关文档请见教程:自定义图标。如果你先前自定义了图标,需按照教程进行迁移。
- “自定义分享按钮”下的配置项将会被重置,先前的配置不会被覆盖,你可通过在主题信息“导出主题配置”获取。
🐛 错误修复
- 修复在“自定义分享按钮 -> 分享按钮设置”中部分默认值空缺导致无法保存的问题。
- “自定义分享按钮 -> 分享按钮设置”中名称为
Native项,链接应为@URL,如您之前安装过本主题,可使用此默认值填充。
- “自定义分享按钮 -> 分享按钮设置”中名称为
- 修复桌面端文章页分享菜单有概率无法唤出的问题。
- 修复英文版配置项主题包中文章元数据“Show in Post List”的类型错误。
- 修复 SVG 图标未成功内联到 CSS 的问题,运行时无需再从 iconify 服务器拉取图标信息。
🔧 代码重构
- 增强在"自定义分享按钮 -> 分享按钮设置"中名称为"Native"(浏览器原生分享)的链接设置功能。
- 优化部分代码,不再挂载到 window 全局变量上,优化页面体积。
- 升级 Tailwind CSS 从 v3 至 v4
- 迁移图标系统从
vite-plugin-purge-icons至@iconify/tailwind4
1.48.3 - 2025-11-26
🐛 错误修复
- 修复在瞬间页中,作者名的悬停样式未按预期渲染的问题。
🔧 代码重构
- 进一步分包优化,移除冗余样式。
🛠️ 杂项维护
- 重构构建流程。
- 组件化部分模板。
- 更新开发依赖。
1.48.2 - 2025-11-25
🐛 错误修复
- 修复使用简洁文章列表的页面,无法按预期渲染的问题。
- 修复在瞬间页中,瞬间列表出现多余样式的问题。
- 修复在瞬间页中,交互栏按钮的悬停样式未按预期渲染的问题。
🔧 代码重构
- 进一步分包优化,移除冗余样式。
- 经过上述优化:
- 主题资源:
- 1.48.1 平均体积:66.808 KiB (gzipped) / 135.609 KiB (原始)
- 1.48.2 平均体积:66.867 KiB (gzipped) / 132.980 KiB (原始)
- 📉 Gzipped 下降:-0.060 KiB (-0.09%)
- 📉 原始大小下降:2.629 KiB (1.94%)
- 页面全部资源:
- 1.48.1 平均体积:341.412 KiB (gzipped) / 999.784 KiB (原始)
- 1.48.2 平均体积:341.500 KiB (gzipped) / 997.325 KiB (原始)
- 📉 Gzipped 下降:-0.088 KiB (-0.03%)
- 📉 原始大小下降:2.460 KiB (0.25%)
- 主题资源:
🛠️ 杂项维护
- 更新开发依赖
1.48.1 - 2025-11-23
🚀 新功能
- 新文档:性能参考
- 展示了主题从 v1.0.0 到最新版的资源体积变化。
🔧 代码重构
- 为默认 LOGO 添加 Avif/WebP 格式,原本的 PNG 格式作为回退。
- 使用 KonghaYao/cn-font-split 对默认字体进行分割。
- 修订构建流程,移除模板中的
// <!--/* 到 */-->注释、<!--/* 到 */-->注释、空行。优化分发体积和输出体积。 - 经过上述优化:
- 主题资源:
- 1.48.0 平均体积:368.038 KiB (gzipped) / 428.557 KiB (原始)
- 1.48.1 平均体积:66.808 KiB (gzipped) / 135.609 KiB (原始)
- 📉 Gzipped 下降:301.230 KiB (81.85%)
- 📉 原始大小下降:292.948 KiB (68.36%)
- 页面全部资源:
- 1.48.0 平均体积:642.663 KiB (gzipped) / 1292.573 KiB (原始)
- 1.48.1 平均体积:341.412 KiB (gzipped) / 999.784 KiB (原始)
- 📉 Gzipped 下降:301.251 KiB (46.88%)
- 📉 原始大小下降:292.789 KiB (22.65%)
- 主题资源:
🛠️ 杂项维护
- 更新开发依赖
1.48.0 - 2025-11-22
🚀 新功能
- 添加“页面元数据 -> 自定义模板 -> 文章页样式”
- 替代原有的“自定义页面样式 -> 启用类文章页样式”
🔧 代码重构
- 优化自定义页面样式体积。脚本和样式表均 -15% 的体积。
🛠️ 杂项维护
- 更新开发依赖
1.47.0 - 2025-11-20
🚀 新功能
- 添加“总体样式 -> 额外菜单项”
- 替代原有的“总体样式 -> 菜单中随机文章项”、“总体样式 -> 菜单中用户账号项”。
- 类型为“重复器”,支持自定义排序,允许自由添加或删除条目。
- 其中新增
用户账号类型:- 未登录时,菜单显示
登录,点击后跳转/login页面。 - 已登录时,菜单显示用户名,点击后跳转
/uc页面。
- 未登录时,菜单显示
🛠️ 杂项维护
- 更新开发依赖
1.46.0 - 2025-11-17
🚀 新功能
🔧 代码重构
- 将部分样式从公用包分离,减小页面体积。
- 优化主题配置项说明。
🛠️ 杂项维护
- 更新开发依赖,移除无用依赖
1.45.4 - 2025-11-07
🐛 错误修复
- 修复启用“标签集合页样式——标签排序方式”时标签颜色无法正常显示的问题。