跳转到内容

更新日志

本项目的所有显著变更将记录在本文件中。

该格式基于保持变更日志, 本项目遵循语义版本管理

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" />,根据当前主题样式自动输出并更新浏览器地址栏主题色。

🔧 代码重构

  • scriptsstyles 目录移动到 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 等服务器时,请参考配置文档以启用预压缩文件的自动交付。

🔧 代码重构

  • 调整 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:ifth:unlessth: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

🐛 错误修复

  • 修复启用“标签集合页样式——标签排序方式”时标签颜色无法正常显示的问题。

基于 MIT 许可发布