主题文档
插件相关配置
新版朋友圈配置说明
留言板配置说明

升级说明

本次更新以 pjax 稳定性为主，同时新增 Halo 页面布局契约支持。

升级前必读

• 最低支持 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