宏尘极客发布于

1.26.1 版本说明

修复

Halo 升级 Thymeleaf 3.1 后，@font-face 会被误判为 bean 引用，导致页面报错（禁止实例化对象/访问静态类）。现已将字体样式表达式改写，CSS 输出保持不变。受影响的站点升级至本版本即可恢复正常。

Full Changelog: 1.26.0...1.26.1

Generated from 1.26.1

资源下载

theme-dream2-plus-1.26.1.zip

1.26.0

宏尘极客发布于

1.26.0

>=2.26.0

升级日志 · 2026-10-27

⚠️ 配置项变更（需要重新配置）

配置项	变更	你需要做什么
无刷新加载	原「Pjax 加载」开关（true/false）→ 下拉三选一：关闭 / Pjax（旧）/ Swup（推荐）	到后台重新选一次；旧值会让下拉显示为空（站点仍按 Swup 运行）
Service Worker 并发 CDN 源	默认值换成 3 个实测更快的源；新增 `/npm` 路径说明	已保存过配置的站点不自动更新，想用新默认值请手动替换或恢复默认
相关文案	「Pjax 配置」→「无刷新加载配置」等	仅改名，配置内容不受影响

主要变化

无刷新切换新增 Swup：与 pjax 并存，可在后台切换；只替换正文列，导航/侧栏/音乐播放器不重建，前进后退恢复滚动位置。
关闭 Swup 页面缓存：二次进入同一页面会重新取阅读量、点赞、评论等数据。
pjax、Remixicon 改为 npm 依赖：删掉 assets/lib 下约 1.7MB 的静态副本，图标与功能表现不变。
Service Worker：静态资源默认走缓存（不再要求开「并发 CDN」），缓存版本跟随主题版本自动更新。

修复

切页后内容区脚本不执行（链接页报 setSafeSrc is not defined）、页面资源与布局不同步（相册不加载、侧栏不隐藏）。
页面脚本长时间无响应会卡在加载态（已加超时兜底）。
SW：多 CDN 源只生效第一个、CDN 全失败时资源报错、清理缓存误删同域其它应用缓存。

Full Changelog: 1.25.1...1.26.0

Generated from 1.26.0

资源下载

theme-dream2-plus-1.26.0.zip

1.25.1

宏尘极客发布于

1.25.1

>=2.26.0

升级日志

标题栏：移除「固定标题栏」开关，标题栏改为常显固定显示，旧配置无需处理。
Banner：去掉负外边距，改为直接留白；显示或隐藏时不再跳动。
标题层次：列表标题改用 --title 变量，字重 400 → 450。
夜间配色：暗色标题 #e2e2e2 → #d0d0d0，暗底上不再刺眼。
首屏：夜间判定只认 localStorage.night 的 true/false，脏值回退默认主题；背景图加载前用主题底色兜底，不再闪白。

Full Changelog: 1.25.0...1.25.1

Generated from 1.25.1

资源下载

theme-dream2-plus-1.25.1.zip

1.25.0

宏尘极客发布于

1.25.0

>=2.26.0

升级日志

换页体验（本次重点）

pjax 改为只刷新 .column-main：点链接只换正文，导航栏、banner、侧栏、页脚、head 保持首屏节点，音乐播放器、特效、访问统计不再被重建。
容器 class 在「替换完成、绘制前」同步，契约页面侧栏隐藏照常生效且不闪。
页面级资源按差集补齐：外链样式、<script src>、内联 <style>/<script> 都能随页面生效；外链按文档顺序串行执行，内联即时执行。
页面级脚本先 preload，下载与内容替换并行；初始化分级，不依赖脚本的（目录、图片预览、导航高亮）先跑，不让正文等网络。

换页问题修复

公告等内联脚本被重复执行，报 const 重复声明
非 pjax 下进入非 banner 页面会闪一下 banner；pjax 切换时 banner 收起晚一帧
快速连点链接导致重复初始化（Swiper、图片包裹）
海报浮层残留、抽屉展开项不跟随、来回首页累积 Swiper 实例

字色对比提升

亮色正文 #424242 → #1f1f1f、标题 #333 → #1a1a1a；辅助文字（#888、#9a9a9a 等）整体加深，白底上不再发虚。
暗色正文 #ccc → #d6d6d6、标题 #d0d0d0 → #e2e2e2；辅助文字整体提亮，暗底阅读不刺眼。
正文默认字重 300 → 400，自定义字体下不再显得细弱。

其他

banner 打字循环在折叠期间不再空转
清理整文档替换时代的兼容代码与死函数

Full Changelog: 1.24.2...1.25.0

Generated from 1.25.0

资源下载

theme-dream2-plus-1.25.0.zip

1.24.2

宏尘极客发布于

1.24.2

>=2.26.0

升级说明

升级前必读

最低支持 Halo 版本提升至 2.26.0（布局契约依赖该版本）

新增

页面布局契约：插件前台页面可复用主题布局（~{layout :: html(head, content)}），自动隐藏左右侧栏、正文占满；移动端侧栏 widget 仍进导航抽屉
正文入场动画：pjax 切换后 .column-main 自上而下揭示并淡入（0.34s）

修复

pjax 多次导航后脚本重复执行（DreamConfig / video 重复声明）导致整页强制重载
导航后点赞、代码块展开/折叠/复制、图片折叠、日志评论与分享全部失效
banner 视频空白、切换时“显示一下再消失”、隐藏后残留高度
侧边栏音乐偶发多个播放器/两份声音，播放器样式偶发丢失
文章内 mew-music 多次进入后播放器样式失效（head 被整块替换后样式缺失）
契约页面（侧栏隐藏）音乐无法关闭——现自动暂停，回到普通页面自动恢复
切换瞬间导航抽屉/遮罩闪一下
页面高度变化引起滚动条出现/消失，导致整页左右位移
3D 标签云在 pjax 换页后不再旋转
鼠标/点击特效在切页后消失（画布未随新 body 迁移）
卜算子统计在pjax切换页后不显示

优化

站点级脚本跨导航判重、document 级监听去重，避免重复绑定与叠加
pjax 后 mermaid 正常渲染，无相关图时零额外开销
pjax 日志统一受「调试模式」控制，正常使用时不刷屏
特效不再占用 window.onresize / onmousemove 等独占属性，避免顶掉第三方回调

Full Changelog: 1.23.4...1.24.2

Generated from 1.24.2

资源下载

theme-dream2-plus-1.24.2.zip

1.24.1

宏尘极客发布于

1.24.1

>=2.26.0

升级说明

升级前必读

最低支持 Halo 版本提升至 2.26.0（布局契约依赖该版本）

新增

页面布局契约：插件前台页面可复用主题布局（~{layout :: html(head, content)}），自动隐藏左右侧栏、正文占满；移动端侧栏 widget 仍进导航抽屉
正文入场动画：pjax 切换后 .column-main 自上而下揭示并淡入（0.34s）

修复

pjax 多次导航后脚本重复执行（DreamConfig / video 重复声明）导致整页强制重载
导航后点赞、代码块展开/折叠/复制、图片折叠、日志评论与分享全部失效
banner 视频空白、切换时“显示一下再消失”、隐藏后残留高度
侧边栏音乐偶发多个播放器/两份声音，播放器样式偶发丢失
文章内 mew-music 多次进入后播放器样式失效（head 被整块替换后样式缺失）
契约页面（侧栏隐藏）音乐无法关闭——现自动暂停，回到普通页面自动恢复
切换瞬间导航抽屉/遮罩闪一下
页面高度变化引起滚动条出现/消失，导致整页左右位移
3D 标签云在 pjax 换页后不再旋转
鼠标/点击特效在切页后消失（画布未随新 body 迁移）

优化

站点级脚本跨导航判重、document 级监听去重，避免重复绑定与叠加
pjax 后 mermaid 正常渲染，无相关图时零额外开销
pjax 日志统一受「调试模式」控制，正常使用时不刷屏
特效不再占用 window.onresize / onmousemove 等独占属性，避免顶掉第三方回调

Full Changelog: 1.23.4...1.24.1

Generated from 1.24.1

资源下载

theme-dream2-plus-1.24.1.zip

1.24.0

宏尘极客发布于

1.24.0

>=2.26.0

升级说明

升级前必读

最低支持 Halo 版本提升至 2.26.0（布局契约依赖该版本）

新增

页面布局契约：插件前台页面可复用主题布局（~{layout :: html(head, content)}），自动隐藏左右侧栏、正文占满；移动端侧栏 widget 仍进导航抽屉
正文入场动画：pjax 切换后 .column-main 自上而下揭示并淡入（0.34s）

修复

pjax 多次导航后脚本重复执行（DreamConfig / video 重复声明）导致整页强制重载
导航后点赞、代码块展开/折叠/复制、图片折叠、日志评论与分享全部失效
banner 视频空白、切换时“显示一下再消失”、隐藏后残留高度
侧边栏音乐偶发多个播放器/两份声音，播放器样式偶发丢失
契约页面（侧栏隐藏）音乐无法关闭——现自动暂停，回到普通页面自动恢复
切换瞬间导航抽屉/遮罩闪一下
页面高度变化引起滚动条出现/消失，导致整页左右位移

优化

站点级脚本跨导航判重、document 级监听去重，避免重复绑定与叠加
pjax 后 mermaid 正常渲染，无相关图时零额外开销

Full Changelog: 1.23.4...1.24.0

Generated from 1.24.0

资源下载

theme-dream2-plus-1.24.0.zip

1.23.4

宏尘极客发布于

1.23.4

>=2.24.2

✨更新内容

fix(滚动): 刷新后恢复滚动位置以正确显示按钮组
fix(config): 修复夜间模式初始化依赖未定义问题

Full Changelog: https://github.com/hcjike/halo-theme-dream2.0-plus/commits/1.23.4

Generated from 1.23.4

资源下载

theme-dream2-plus-1.23.4.zip

1.23.3

宏尘极客发布于

1.23.3

>=2.24.2

✨更新内容

perf(common): 优化初始化执行时机与 rAF 循环
feat(common): 添加页面滚动位置记忆功能
fix(css): 补齐 swiper 基础样式避免闪烁
fix(swiper): 避免初始化闪烁并在失败时兜底显示
fix: 修复导航栏过渡与banner打字跳动
fix(banner): 修复描述文案首帧闪烁问题

Full Changelog: 1.23.2...1.23.3

Generated from 1.23.3

资源下载

theme-dream2-plus-1.23.3.zip

1.23.2

宏尘极客发布于

1.23.2

>=2.24.2

✨更新内容

fix(layout): 解决弱网环境下页面长时间白屏问题

Full Changelog: 1.23.1...1.23.2

Generated from 1.23.2

资源下载

theme-dream2-plus-1.23.2.zip

1.23.1

宏尘极客发布于

1.23.1

>=2.24.2

✨更新内容

style(css): 修复编辑器超链接卡片在「瞬间」中意外出现的边距问题

Full Changelog: 1.23.0...1.23.1

Generated from 1.23.1

资源下载

theme-dream2-plus-1.23.1.zip

1.23.0

宏尘极客发布于

1.23.0

>=2.24.2

✨更新内容

refactor(style): 优化页面加载动画样式
refactor(theme): 移除页面切换动画配置并优化弹窗通知配置项设置
style(banner): 添加动画过渡效果并改进隐藏状态样式

Full Changelog: 1.22.10...1.23.0

Generated from 1.23.0

资源下载

theme-dream2-plus-1.23.0.zip

1.22.10

宏尘极客发布于

1.22.10

>=2.24.2

✨更新内容

refactor(photos): 重构照片画廊布局加载样式
fix(mermaid): 解决mermaid图表渲染和样式问题

Full Changelog: 1.22.7...1.22.10

Generated from 1.22.10

资源下载

theme-dream2-plus-1.22.10.zip

1.22.9

宏尘极客发布于

1.22.9

>=2.24.2

✨更新内容

refactor(photos): 重构照片画廊布局加载样式

Full Changelog: 1.22.7...1.22.9

Generated from 1.22.9

资源下载

theme-dream2-plus-1.22.9.zip

1.22.8

宏尘极客发布于

1.22.8

>=2.24.2

✨更新内容

refactor(photos): 重构照片画廊布局样式 by @mjsoftking in #496

Full Changelog: 1.22.7...1.22.8

Generated from 1.22.8

资源下载

theme-dream2-plus-1.22.8.zip

1.22.7

宏尘极客发布于

1.22.7

>=2.24.2

✨更新内容

feat(message-board): 重构留言版界面

Full Changelog: 1.22.6...1.22.7

Generated from 1.22.7

资源下载

theme-dream2-plus-1.22.7.zip

1.22.6

宏尘极客发布于

1.22.6

>=2.24.2

✨更新内容

refactor(style): 优化section高度，使用css兄弟选择器控制
refactor(config): 将主题配置脚本提取到独立模板文件并移入body中降低head大小
fix(security_link): 修复安全连接未能加载主题资源问题

Full Changelog: 1.22.3...1.22.6

Generated from 1.22.6

资源下载

theme-dream2-plus-1.22.6.zip

1.22.5

宏尘极客发布于

1.22.5

>=2.24.2

✨更新内容

fix(common): 修复关闭首页横幅时，内容区域高度计算错误问题
refactor(config): 将主题配置脚本提取到独立模板文件并移入body中降低head大小
fix(security_link): 修复安全连接未能加载主题资源问题

Full Changelog: 1.22.3...1.22.5

Generated from 1.22.5

资源下载

theme-dream2-plus-1.22.5.zip

1.22.4

宏尘极客发布于

1.22.4

>=2.24.2

✨更新内容

fix(common): 修复关闭首页横幅时，内容区域高度计算错误问题
refactor(config): 将主题配置脚本提取到独立模板文件并移入body中降低head大小

Full Changelog: 1.22.3...1.22.4

Generated from 1.22.4

资源下载

theme-dream2-plus-1.22.4.zip

1.22.3

宏尘极客发布于

1.22.3

>=2.24.2

✨更新内容

feat(sidebar): 添加移动端抽屉式侧边栏功能
- 默认关闭，开启后侧边栏模块将显示在移动端抽屉式菜单中。“信息模块”和“目录模块”始终不显示。

Full Changelog: 1.22.1...1.22.3

Generated from 1.22.3

资源下载

theme-dream2-plus-1.22.3.zip

1.22.2

宏尘极客发布于

1.22.2

>=2.24.2

✨更新内容

feat(sidebar): 添加移动端抽屉式侧边栏功能
- 默认关闭，开启后侧边栏模块将显示在移动端抽屉式菜单中。“信息模块”和“目录模块”始终不显示。

Full Changelog: 1.22.1...1.22.2

Generated from 1.22.2

资源下载

theme-dream2-plus-1.22.2.zip

1.22.1

宏尘极客发布于

1.22.1

>=2.24.2

✨更新内容

feat(links): 添加友链申请功能 by @mjsoftking in #485
- 需要链接管理插件 ≥ 2.3.0，并且插件中开启【友链申请 - 允许访客提交】后生效。
feat(links-captcha): 添加验证码点击获取功能并优化样式，默认不加载验证码。 by @mjsoftking in #487

Full Changelog: 1.21.1...1.22.1

Generated from 1.22.1