更新内容

发布链路

• 移除 package.json 中的 packageManager 精确声明，避免与官方 theme-cd.yaml@v4 默认 pnpm-version: 10 重复声明导致 Setup pnpm 失败。
• 继续使用 halo-sigs/reusable-workflows/.github/workflows/theme-cd.yaml@v4 和 Node 24，对齐 theme-sky-blog-3 已验证成功的发布链路。

版本与缓存

• 更新主题版本到 2.2.23。
• 同步刷新前端静态资源缓存版本和生成后的 JS chunk 文件名。

验证

• pnpm build
• git diff --check
• 主题包 dist/theme-sky-blog-1-2.2.23.zip 已确认包含 theme.yaml 版本 2.2.23 和 App ID app-squauk4h。

发布说明

本版本只创建 GitHub Release，不手动上传资产。主题包构建、GitHub Release 资产上传和 Halo 应用市场同步由官方 CD 工作流处理。

---

Generated from v2.2.23

v2.2.19

发布时间：2026-05-13

本版本包含 v2.2.18 之后的所有提交，重点是插件适配闭环、Docsme 免费版支持、Photos/PJAX 修复、Douban 页面接入和验证脚本增强。

插件适配

• 修复 PJAX 后 lightgallery 插件脚本重放问题，避免图片灯箱在页面切换后失效。
• 适配 Photos 详情页 PJAX 访问与返回流程，补齐详情页布局和相邻图片探索体验。
• 支持 Docsme 免费版 1.5.0，同时保留专业版 1.6.0 兼容说明。
• 改进 Docsme 目录页脚本链路和 0 篇文档项目禁用态，避免无内容项目生成不可用入口。
• 改进 Links 提交兼容性；当 link-submit 接口不可用时，友链申请弹窗切换到评论留言兜底。
• 补充 Moments POST 媒体渲染契约，避免只支持 PHOTO/VIDEO/AUDIO。
• 新增 Douban 豆瓣记录页面适配，支持海报网格、类型筛选、题材筛选、分页、加载态、空态和错误态。
• Douban 页面按 plugin-douban v1.2.5 公开 API 渲染，避免触发插件路由懒加载变量在空筛选参数下的 NPE。
• 修复 Douban 题材接口返回字符串数组时筛选按钮文本为空的问题。
• 补充 Douban 图片加载失败占位；真实封面代理仍通过 plugin-douban 的 isProxy / proxyHost 配置处理。

验证与文档

• 更新 Photos、Docsme、Search Widget、Alist、Douban 等插件适配说明。
• 记录当前浏览器验收结果，包括 Docsme、Search Widget、Shiki、Comment Widget、lightgallery、暗色切换和移动端基础布局。
• 明确 Alist 存储当前标记为不可用，不作为 Moments 前端发布上传后端。
• 明确 Search Widget 本地旧索引 404 属于搜索插件索引数据问题，不属于主题模板缺口。
• 增强插件深度验证，覆盖 Docsme 目录脚本链路和 Douban 真实题材接口。
• 更新插件适配方案，记录 Douban、Alist、Search Widget、Docsme、Moments 等当前兼容边界。

提交范围

• 4152a1a fix: replay lightgallery plugin scripts after pjax
• 588d69c feat: adapt photos detail for pjax
• 7aadf44 docs: update photos and docsme guidance
• 71c496b fix: adapt docsme free version support
• 9ea5edf fix: improve docsme and link submit compatibility
• 0d6a724 chore: document plugin verification gaps
• e33cd17 docs: record plugin browser verification
• 9a5d90b docs: mark alist storage unsupported
• 6aa231c docs: record search widget verification
• 0152911 feat: adapt douban page
• f39adf9 test: strengthen plugin verification
• ae82d30 chore: release v2.2.19
• 3a2625c docs: expand v2.2.19 release notes
• 8e680cb docs: remove release note file

验证

• pnpm lint
• pnpm build-only
• pnpm verify:plugins
• pnpm verify:plugins:deep

---

Generated from v2.2.19

v2.2.18 更新说明

修复

• 修复 PJAX 切换页面后 lightgallery.js 灯箱插件未重新初始化的问题。
• 支持从任意页面进入引用 lightgallery 插件的页面后自动恢复灯箱绑定。
• 修复 PJAX 下在线统计组件重复请求导致 429 Too Many Requests 的问题。

优化

• 统一通过 PJAX 页面生命周期触发灯箱恢复逻辑。
• 自动解析 lightgallery 插件注入脚本中的图片区域选择器，减少对固定页面的硬编码。
• 更新静态构建产物版本引用到 2.2.18。

---

Generated from v2.2.18

v2.2.17 更新说明

感谢 @xiaocaiye5201314 提交 PR：#28，带来了默认主题跟随系统与 Windows 构建路径兼容相关改进。

新增

• 默认主题支持“跟随系统”选项。
• 主题切换支持浅色、深色、跟随系统三态循环。

修复

• 修复 Windows 环境下路径分隔符导致部分页面 JS 构建异常的问题。
• 修复跟随系统主题在部分浏览器中的监听兼容性问题。
• 优化 PJAX 切页后主题状态保持逻辑。

优化

• 优化导航栏主题按钮、移动端菜单、搜索入口和用户菜单的可访问性细节。
• 保留并刷新 Halo 标准静态构建产物，确保主题资源完整输出。

---

Generated from v2.2.17

v2.2.16 更新说明

修复

• 修复文章页脚本在服务器环境下因旧 chunk 缓存导致的加载异常
• 修复 post.js 与共享分包文件版本不一致时引发的目录、点赞等组件连锁报错

优化

• 共享 chunk 改为使用主题版本号命名
• 发布后入口脚本与分包脚本保持同版本切换，降低浏览器复用旧资源的风险

版本

• 主题版本更新至 2.2.16

---

Generated from v2.2.16

v2.2.15 更新说明

修复

• 修复文章页脚本在服务器环境下偶发加载失败的问题
• 修复 post.js 与 toc-utils.js 等分包文件在发布后可能出现的版本错配问题
• 修复因文章脚本加载失败引发的点赞、目录等 Alpine 组件连锁报错

优化

• 构建产物中的共享 chunk 改为使用版本号命名
• 保持入口脚本继续使用主题版本号控制缓存
• 避免浏览器在发版后复用旧的固定路径 chunk

版本

• 主题版本更新至 2.2.15

---

Generated from v2.2.15

v2.2.14 更新说明

版本

• 主题版本号更新至 2.2.14

调整

• 同步更新 theme.yaml 中的主题版本
• 同步更新 package.json 中的项目版本

发版信息

• Git Commit: 856e721
• Git Tag: v2.2.14

---

Generated from v2.2.14

v2.2.13 更新说明

修复

• 修复文章页在 PJAX 切换后目录、抽屉和页面交互未正确重新初始化的问题
• 修复文档页在 PJAX 切换后目录不显示的问题
• 修复文章页与文档页目录相关事件在多次 PJAX 进入/离开后可能残留、重复绑定的问题

优化

• 将文章页与文档页的页面逻辑统一接入 SkyPjax.onPage / onCleanup
• 收敛文章页与文档页的生命周期管理，页面模块自行负责进入初始化与离开清理
• 完善文档页目录 IntersectionObserver、滚动、抽屉与键盘事件的清理逻辑

版本

• 主题版本更新至 2.2.13

验证

• pnpm build-only 构建通过

---

Generated from v2.2.13

v2.2.12 更新说明

修复

• 修复音乐播放器音量配置在 Thymeleaf 渲染时的类型错误
• 兼容 volume 配置为字符串时的数值换算，避免模板渲染异常

优化

• 版本号更新至 2.2.12

验证

• pnpm build-only 构建通过

---

Generated from v2.2.12

v2.2.11 更新说明

修复

• 修复 PJAX 场景下 halo:footer 全局脚本与页面切换冲突的问题
• 修复评论页、目录页、文章页在 PJAX 后的初始化异常
• 修复文章页摘要打字机在 PJAX 切页后仍继续执行，导致 textContent 报错的问题
• 修复首页瞬间卡片光效在无事件对象时可能报错的问题

优化

• 调整 PJAX 容器结构，新增 swup-page-extras，避免悬浮 Dock、目录抽屉等页面附加区域状态异常
• 保持 halo:footer 注入区域常驻，不再在 PJAX 后重复执行全局页脚脚本
• 增加统一的 SkyPjax.once / onPage / onCleanup 生命周期能力，便于后端注入脚本适配 PJAX
• 收敛主题层 PJAX 逻辑，移除文章页特判，恢复为通用页面脚本初始化机制

版本

• 主题版本更新至 2.2.11

---

Generated from v2.2.11

v2.2.10

✨ 新功能

• 音乐播放器 9 宫格定位：后台新增「位置与显示」配置组，支持 9 个屏幕位置（左/中/右 × 上/中/下）及像素级微调，移除访客拖拽功能

🐛 修复

• 修复 PJAX 导航时事件监听器泄漏问题
• 修复 Vite watch 模式下构建产物触发递归循环的问题

🔧 内部

• 升级全部依赖至最新版本，兼容 Vite 8 / TypeScript 最新构建
• 锁定 pnpm-lock.yaml 依赖版本
• 清理 Vercel 配置、Gradle 构建残留文件
• 完善主题开发文档及音乐播放器使用说明

---

Generated from v2.2.10

v2.2.9 更新说明

新增与优化

• 优化 PJAX 切页动画等待范围，避免首页装饰性动画阻塞页面跳转。
• 修复从首页进入其他页面时，PJAX 需要等待 3 到 5 秒才完成切换的问题。
• 音乐播放器主题色改为自动跟随当前主题主色，无需再单独配置播放器颜色。

配置调整

• 精简音乐播放器后台配置，删除未被前端实际使用的无效字段。
• 保留仍在使用的音量、播放顺序、APlayer JS 地址和 Meting API 代理配置。

构建产物

• 同步更新前端构建产物与 chunk 输出。
• 发布版本号提升至 2.2.9。

---

Generated from v2.2.9

v2.2.8

新增

• 悬浮音乐播放器（黑胶唱片/胶囊切换，暗亮色适配）
• PJAX 无刷新页面切换（后台可开关）
• 在线统计侧边栏组件（适配 plugin-online）

优化

• PJAX 切页稳定性修复
• 代码清理与模块化重构

---

Generated from v2.2.8

v2.2.7

🐛 Bug Fixes

• 登录页 500 错误：修复开源版 Halo 因缺少 captchaProvider 属性导致登录页报 500 的问题，使用 toString() 检测实现 Pro/开源版自动兼容 (#23)

✨ Features

• 首页瞬间标签显示：首页"瞬间说说" Tab 的两列/单列布局均支持显示 #标签 徽章，点击可跳转瞬间标签筛选页
• 隐藏内容内联标签：瞬间内容区域自动隐藏插件渲染的裸标签链接（[&_a.tag]:hidden），避免标签重复显示
• Header 瞬间标签：首页 Header 瞬间卡片同步支持标签展示

---

Generated from v2.2.7

Release v2.2.6

🍎 适配与修复:

• 适配 Halo >= 2.23.0 版本的本地加密登录与验证码组件（支持 jsencrypt 与 altcha 无版本号路径）。
• 修复因 Halo 模板引擎升级导致的自带登录界面失效问题。

✨ 功能增强 (#21):

• 重构页脚配置项，底部导航改用 Halo 菜单选择器接管。
• 增强备案信息（ICP、公安），支持自定义图标与自定义跳转链接。
• 版权文字左侧增加可选的前缀图标。
• 托管与服务提供商列表增加独立的可选图标支持。
  \

---

Generated from v2.2.6

Sky Blog Theme v2.2.5 Changelog

这是一个特性补充与文档完善的更新版本，旨在进一步丰富主题在归档、瞬间及各类侧边栏小工具上的浏览体验，并补齐近期新功能的配置说明文档。

✨ 新特性 (Features)

• 🧭 全局归档探索 (Global Archive Explorer)

  • 扁平化树状视图：归档侧边栏小工具全面升级，移除了原有的卡片包裹与线条，带来了纯净的扁平化无框排版体验。
  • 全局视图路由：采用了独立的全站 postFinder 接口代替分页拉取，现在可在未翻页的情况下浏览博客全部历史记录，点击任意月份将直接跳转专属原生过滤页面 (/archives/YYYY/MM)。
  • 优雅数字排印：对 /archives 归档主页顶部的字体进行了字距加宽及 font-serif 衬线化重塑，且现在会直接显示“全局发文总年份统计”而非单页统计。

• 🌤️ 天气组件智能降级 (Weather Fallback)

  • 为全局欢迎卡片小工具引入了全新的防卡死配置项：“默认地区（降级容灾）”。
  • 当客户端网络定位失败，或访客身处代理环境导致解析出异常节点（如“未知”、“美国”等）时，天气组件将自动降级拦截并拉取您后台设定的默认地区天气，确保博客稳定丝滑加载。

---

Generated from v2.2.5

Theme Sky Blog 1 - v2.2.4 更新日志
本次更新（v2.2.3 -> v2.2.4）主要侧重于图文排版质感的全面提升、动画视觉优化的对齐及部分组件布局的修复，同时完善了使用文档和配置项。

✨ 特性与优化 (Features & Enhancements)
首页体验优化：首页的“瞬间”模块已全面对齐独立瞬间页，实现了基于 Masonry/Columns 的多图自适应排版与高级光亮质感。
文章列表（杂志风格）升级：重构了杂志风格列表的图片遮罩（Mask）、悬浮放大动效（Zoom）与文字浮现（Reveal）时间轴，完美移植并复刻了图库级（Gallery）的细腻视觉体验。现在卡片呼吸感更平滑，起步动画不再突兀。
作者页与瞬间页图片动效：优化了作者主页及独立瞬间页的图片排版，同步更新并统一了全局的 hover 动画效果及弹性贝塞尔曲线。
配置项回归：恢复了菜单、分类、标签图标的 AnnotationSetting 配置支持，现在可以更方便地在后台自定义这些图标。
🐛 修复 (Bug Fixes)
Live2D 看板娘定位问题：修复了在 Steam 页面上由于 body 标签带有 Alpine 动画导致的 transform 上下文冲突，从而避免 Live2D 从固定侧边栏错位到错误位置的问题。
文档页面目录体验：修复了文档页面的侧边目录宽度不足，以及在页面滚动时活跃的高亮条目不自动跟随的问题。
📝 文档 (Documentation)
配置指南全面升级：全面升级了主题的配置文档与 README，增加了 v2.2 版本近期的多项特性说明及使用指引。

---

Generated from v2.2.4

v2.2.3

🔧 重构

• 图库：JS Masonry 物理分列算法替代 CSS columns 瀑布流，解决新图追加位置错位问题
• 图库：传统分页改为 IntersectionObserver 无限滚动

✨ 新增

• 图库：图片悬浮遮罩层、骨架屏 shimmer 占位、入场动画（错列延迟）
• 图库：悬浮下载按钮（独立后台开关，与图片信息解耦）
• 图库后台「布局外观」配置组：
  • 页面布局：居中 / 全铺
  • 最大列数：2 ~ 6 列
  • 图片圆角：0 ~ 24px
  • 图片间距：0 ~ 32px

🔌 适配

• 全站 15 个页面 <title> 适配 Halo 官方 site.subtitle 副标题字段

🐛 修复

• 修复首页浅色 / 深色主题蒙版配置读取路径错误（overlay_settings → background_settings）
• 修正瞬间页 title 分隔符缺少空格的排版问题

---

Generated from v2.2.3

1、新增动画登录界面
2、修复认证后端错误

---

Generated from v2.2.2

v2.2.1

✨ 特性与重构 (Features & Refactoring)

• 首页模块自由排版 (Free Layout)：重构了首页内容区的渲染逻辑。现在默认支持在主题设置中自由开关、拖拽排序首页的各个挂载模块（热力图、分类聚合、图库、友链、文档中心），彻底告别固定流。
• 全新组件 - 文档中心 (Docsme Integration)：首页新增“文档中心”展区模块，深度适配 plugin-docsme。卡片沿用并优化了极简高级灰配色，且可与首页其他模块自由排布。
• 友链强化筛选 (Links Group Filter)：首页友情链接模块现在支持从主题设置中精准指定仅显示特定的“分组”，并包含前端数量截断展示支持。

💎 样式与优化 (Style & Optimizations)

• 移动端侧边栏全面翻新：重新设计了移动端抽屉栏。包括全新的顶部居中头像与 Logo、统计数据行、装饰性分割线、全图标菜单结构，以及展开时背部的磨砂玻璃模糊效果，整体加倍精致。
• 排版细节一致性统一：清理了所有部件挂载抽离时硬编码的过大边距（Margin），交由全新的弹性布局网格（Flex Gap）接管控制，避免了组件积压或塌陷；将所有扩展组件角落的汉字“全部”统一规范为英文“View All”标识保持前卫语感。
• 顶部导航栏优化：更新了默认态与滚动吸顶态下导航栏组件的样式细节和结构层次。

---

Generated from v2.2.1

🎉 v2.2.0 更新说明
✨ 新增

个人主页新增「瞬间」Tab，适配瞬间公开 API，展示作者最新动态
🛠️ 修复

修复瞬间卡片中标签 (tag) 重复渲染的显示问题
♻️ 重构

天气查询与 IP 定位方案全面换用免费公开 API，通过 Cloudflare 反向代理接入 Open-Meteo（注：受限于免费方案，稳定性可能略有波动）

---

Generated from v2.2.0

v2.1.21 更新日志

🎨 样式重构与优化 (Style & UI)

1. 🔍 搜索组件重构 (Search Widget)

• 极简列表风格：彻底移除了原有的卡片式背景和阴影，转为现代化的透明列表设计。
• 视觉通透感：默认背景全透明，仅在交互时显示微妙的反馈，大幅减少视觉噪点。
• UI 细节打磨：优化了圆角半径（8px）和分隔线样式，使其观感更接近原生操作系统的 Command Palette。

2. 🔐 认证页面表单优化 (Auth Forms)

• 深色主题统一：全面统一了登录、注册、找回密码等页面的深色模式配色，确保视觉体验一致。
• 多登录方式适配：
  • Passkey (通行密钥)：修复了按钮和布局的错位问题，使其完美融入表单。
  • Altcha 验证码：优化了验证码组件在深色模式下的显示效果。
  • 手机号登录：修正了输入框组的样式冲突。

---

🐛 问题修复 (Bug Fixes)

1. ✨ 认证页面特效修复 (Auth Effects)

• 3D 倾斜效果：修复了 perspective 属性缺失导致 "假 3D"（无纵深感）的问题；修正了脚本执行顺序，确保动画生效。
• 聚光灯效果 (Spotlight)：修复了鼠标追踪脚本在 DOM 加载前执行导致失效的问题，现在的光晕效果能流畅跟随鼠标移动。
• 配置兼容性：移除了无效的 None 选项，并自动兼容了数据库中残留的旧配置，强制回退到 3D 效果，防止页面出现"无特效"的死状态。

2. 🛠️ 装备分组图标 (Equipment Icons)

• 配置项升级：将装备页面的分组图标配置项升级为 Iconify 选择器，支持直接预览和选择图标。

---

Generated from v2.1.21

修复首页默认报错

---

Generated from v2.1.20

修复装备页设置逻辑：
修复了“3D卡片”与“优雅卡片”风格切换时参数错乱的问题。
重构了后台配置项，将 Tab 切换样式 优化为 Toggle 开关。
修正了配置字段的依赖关系 (id / name / key)，确保条件显示正常工作。

---

Generated from v2.1.19

🏷️ v2.1.18 更新摘要 (简要版)
核心修复

✅ Pro 版兼容：修复开源版访问 Pro 属性导致的报错。
✅ 评论区修复：修复图库/归档页评论显示“未知”及跳转错误。
新功能

✨ 装备页面：新增独立的装备展示页。
✨ 首页增强：支持音频播放、Tab 排序、文章列表开关。
优化

🔨 配置重构：优化全站配置结构，改进封面替代交互。

---

Generated from v2.1.18

v2.1.16 更新摘要
✨ 交互重构：友链申请改为“本站信息”与“立即申请”分离的双按钮模式，操作更清晰。
🎨 界面升级：新增左对齐布局的“本站信息”弹窗，支持联系邮箱展示；全线适配 Primary 主题色与统一蒙版样式。
🐛 修复：修复了登录界面全局信息 (globalInfo) 可能导致的空指针报错。
📝 文档：更新友链设置文档，补充本站信息配置说明。

---

Generated from v2.1.16

🎉 新增功能

瞬间组件

• 前端媒体上传：支持图片、视频、音频上传
  • 通过 UC 附件 API 上传文件
  • 单图大图展示 + 多图网格布局（2/4张=2列，其他=3列）
  • 后台可配置开关（独立控制图片/视频/音频）
  • 基本安全验证（禁止可执行文件、危险协议）

文章页面

• 摘要显示开关：可关闭文章摘要显示
  • 适用场景：安装 AI 摘要插件后避免重复显示
  • 后台配置：文章 → 内容显示设置 → 显示文章摘要

---

Generated from v2.1.15

📋 Sky Theme v2.1.14 发版说明

从 v2.1.11 升级的完整更新日志

---

✨ 新功能

🌤️ 天气联动系统重构

• 雨天/雷暴场景升级：采用扁平几何风格设计，降低雨滴密度，视觉更清爽
• 回退机制完善：页面加载先显示默认/缓存天气，后台获取真实位置后自动切换
• 事件驱动同步：通过 sky-weather-updated 自定义事件实现天气卡片与背景特效的协同
• 使用提示：设置界面增加提示「天气联动需在侧边栏启用天气小组件」

📺 追番轮播卡片

• 新增 Bangumi 追番轮播组件，支持侧边栏展示

🎮 Steam 功能优化

• Steam 页面异步加载优化，字段兼容性增强
• 适配 Steam 插件 v0.2.0-beta.2 API 变更

📝 页脚代码注入

• 新增 <halo:footer /> 支持，可从系统设置注入页脚代码

---

🐛 修复

问题	修复内容
标题装饰效果丢失	恢复 TitleEffectsManager（粒子/星光/霓虹边缘等特效）
Steam 卡片重复声明错误	使用 IIFE 包裹防止变量冲突
天气特效不生效	修复 loadWeatherData 中变量未定义的 bug
侧边栏配置读取	修复定制配置读取逻辑，优化追番卡片显示

---

🔄 兼容性

Steam 插件 v0.2.0-beta.2

API 域名变更：api.steam.halo.run → api.steam.timxs.com

---

🔧 重构 & 清理

• 优化首页头部区域配置结构
• 移除天气/Steam 调试日志
• 移除天气测试组件

---

📦 环境要求

• Halo: ≥2.22.9

---

Generated from v2.1.14

fix(sidebar): 修复首页定制侧边栏配置不生效问题

• 将首页侧边栏配置从嵌套 group 改为扁平结构，与分类页面保持一致
• 修复 sidebar_settings 嵌套导致配置读取失败的问题
• 更新首页模板直接使用 indexCfg 读取侧边栏配置

perf(steam-card): 优化 Steam 卡片加载性能

• 改用 REST API + Alpine.js 异步加载，不阻塞页面渲染
• 添加骨架屏加载状态，提升用户体验
• 修复字段名大小写兼容问题 (gameid/gameId, personaname/personaName)
• DOMContentLoaded 时间从 16s 降至 1s

chore: bump version to 2.1.11

---

Generated from v2.1.11

feat(bangumi): 新增 Bilibili 追番页面模板

• 适配 plugin-bilibili-bangumi 插件，提供 /bangumis 路由
• 支持追番/追剧类型切换和状态筛选（全部/想看/在看/已看）
• 动态背景：鼠标悬停卡片时切换对应番剧封面
• 响应式网格布局（2-4列自适应）
• 后端可配置页面标题和描述
• 高清封面图片（自动去除 B 站缩略图参数）

fix(auth): jsencrypt 同时引入 3.5.4 和 3.3.2 版本兼容 Halo 2.22.10/2.22.11

---

Generated from v2.1.10

feat(weather): 优化 IP 定位策略，支持 pconline 与 ipapi 并行请求

• 新增 Cloudflare Worker 代理 pconline 接口解决跨域问题
• 实现双 API 并行请求机制，优先响应快的结果
• pconline 具有最高优先级，延迟返回时自动覆盖更新
• 移除天气模块和 Steam 页面的调试日志

---

Generated from v2.1.9

fix: 适配 Halo 2.22.11 jsencrypt 版本升级，修复 steam 懒加载问题
遇到无法登录情况，
参考#10
方式修复

---

Generated from v2.1.8

v2.1.7 认证系统优化与 Steam 页面增强

• 新增简洁默认布局 (default)，居中卡片式设计

• 集成 Altcha 验证码支持 (Halo Pro)

• 移除极客终端主题

• 修复 feature icon 配置类型

• 适配 Steam 插件，重构热力图与 UI 布局

• 热力图颜色优化、亮色主题适配

• 分页图标化、头像游玩状态发光效果

• 优化侧边栏配置结构

• 添加投票组件 CSS 变量适配

refactor(author): 移除作者页面瞬间功能

由于 Halo CMS 瞬间插件 API 限制，非登录用户无法获取瞬间数据，
导致作者页面的瞬间功能无法正常工作，故暂时移除该功能。

变更内容：

• 移除作者页面瞬间 Tab 切换功能
• 移除瞬间列表展示区域
• 移除瞬间数量统计显示
• 简化 author.js，移除点赞、图片预览等瞬间相关逻辑
• 移除 settings.yaml 中作者页面的瞬间配置项：
  • show_moments（显示瞬间开关）
  • moments_count（瞬间显示数量）
  • default_tab（默认标签选项）

技术原因：

• /apis/moment.halo.run/v1alpha1/moments 返回 403
• /apis/uc.api.moment.halo.run/v1alpha1/moments 需要登录
• momentFinder 仅提供 listAll() 和 list()，无法按作者筛选
• Thymeleaf SpEL 不支持在集合过滤中访问外部变量

---

Generated from v2.1.6

修复SEO页面标题格式为 页面标题 - 站点名称

---

Generated from v2.1.5

优化移动端导航栏边距和文章页横向溢出问题

---

Generated from v2.1.4

新增首页蒙版渐变设置，支持明暗主题独立配置

---

Generated from v2.1.3

feat: 完善可访问性支持并修复导航栏图标 Bug

• 为所有图片添加 alt 属性，提升屏幕阅读器支持
• 为图标链接添加 aria-label 属性
• 修复有子菜单的导航项不显示图标的 Bug
• 修复 Thymeleaf 表达式语法错误（th:alt 字面量格式）
• 版本更新至 2.1.2

---

Generated from v2.1.2

新增功能

• 🎭 Iconify 图标选择器：支持菜单项、分类、标签自定义图标
  • annotation-setting.yaml 定义元数据表单
  • 使用 value-only 模式直接返回 SVG 字符串

前端适配

• 标签小工具显示自定义图标（widgets/tags.html）
• 文章头部分类/标签显示自定义图标（post/header.html）
• 分类小工具已有图标支持

UI 优化

• 导航栏间距优化，更紧凑合理
  • Logo 区域 gap-2 → gap-2.5
  • 菜单项 px-4 → px-3.5，gap 统一为 1.5
  • 整体容器增加移动端 px-4 内边距

版本更新

• 版本号更新至 2.1.1
• README 新增 Iconify 图标功能说明
• 修复 README 重复标题问题

---

Generated from v2.1.1

• 登录页面 (login.html, login_local.html)
• 注册页面 (signup.html)
• 登出页面 (logout.html)
• 密码重置页面 (password-reset/)

1. Centered - 简约居中卡片
2. Split - 左右分屏，动态 3D 特性展示
3. Terminal - 极客终端风格，绿色命令行美学

• 文章详情页头部作者可点击跳转

• 瞬间列表/详情页作者可点击跳转

• 首页瞬间 Tab 作者可点击跳转

• 文档详情页作者区域可点击跳转

• Vite 配置新增认证主题入口点

• 认证页面 CSS/JS 独立打包优化

• 修复 SpringEL 路由表达式错误

• README 功能特性补充

• 插件适配表格完善

---

Generated from v2.1.0

feat: 升级天气卡片缓存版本并优化 IP 定位逻辑，移除浏览器地理定位。

---

Generated from v2.0.10

优化天气卡片定位逻辑

---

Generated from v2.0.9

🎉 v2.0.8 更新内容

✨ 天气卡片增强

• 高德 IP 定位：改用国内服务器，响应更快
• 中文城市名：自动显示中文地名（如：苏州、北京）
• 无权限打扰：移除 GPS 定位请求，不弹窗
• 智能降级：失败时显示北京默认天气

🎨 图库加载优化

• Shimmer 占位符：优雅的闪烁加载动画
• 旋转 Spinner：中心加载指示器
• 防抖动：图片加载时布局稳定
• 淡入效果：图片加载完成平滑显示

系统要求

• Halo 2.22.9+
• 现代浏览器（支持 ES Module）

相关链接

• 在线演示
• 主题文档
• 问题反馈

---

Generated from v2.0.8

🎉 v2.0.7 更新内容

🐛 问题修复

• 修复升级失败问题：修复 settings.yaml 缩进错误导致的 500 错误
• 修复表格样式：圆角、响应式滚动

✨ 新增功能

• 天气卡片精确定位：优先使用浏览器 GPS 定位
• GPL-3.0 许可证：新增完整的开源许可证文件
• Admonition 提示框：文档页 5 种语义化提示框

🔧 代码优化

• 统一文章内容样式系统（4 个页面共享）
• 提取 TOC 公共组件（样式 + 函数）
• 消除重复代码 2400+ 行 (-53%)
• 智能构建：自动代码分割

系统要求：Halo 2.22.9+

---

Generated from v2.0.7

🐛 修复

• 修复首页瞬间数量配置无法生效的问题（使用 momentFinder.list() API）
• 修复 Thymeleaf 类型转换错误（Integer vs String）
• 修复首页定制侧边栏配置不显示

♻️ 重构

• 重构首页侧边栏配置结构（独立 sidebar_settings 组）
• 统一瞬间/友链页面配置命名（enable_sidebar → show_sidebar）
• 移除评论抽屉功能
• 统一"悬浮控制栏"命名

---

Generated from v2.0.3

v2.0.2 更新日志

🚀 新功能

• 关于页面重构 - 全新 Squareform 风格设计
• 瞬间说说 - 首页新增瞬间 Tab，支持单列/双列显示
• 作者页面 - 独立作者主页模板，文章/瞬间列表
• 欢迎卡片 - 天气信息、问候语组件
• 全局背景 - 支持 Base 色阶、网格背景效果
• DaisyUI 主题预览 - 35 个主题可视化选择，浅色/深色分类
• 首页头部开关 - 支持隐藏整个头部区域

🎨 UI 优化

• 归档页 - Apple 简约风格重设计
• 友链页 - 发光效果、Apple 风格优化
• 朋友圈 - 卡片样式与布局优化
• 图库页 - 全新设计
• 分页组件 - 全站统一简约风格
• 侧边栏 - 小工具副标题统一英文风格
• 导航栏 - 按钮 hover 效果简化
• 页脚 - 结构与样式优化

🔧 功能改进

• 分享功能 - 重构实现
• 文档目录 - 导航体验优化
• 首页模块 - 配置系统重构
• 热力图 - GitHub/文章热力图功能增强

📝 文档

• README 更新，增加模板适配说明

---

Generated from v2.0.2

修复:

• 修正 theme.yaml requires 版本格式为 >=2.22.0
• 同步更新版本号"

---

Generated from v1.1.5

✨ 新功能

瞬间分享功能

• 详情页新增分享按钮，支持一键分享到微信、微博、X、Telegram、Facebook、QQ、QQ空间、豆瓣等平台
• 后台可配置启用的分享平台，支持拖拽排序
• 支持自定义分享标题模板（变量：`{author}`、`{site}`、`{date}`）
• 微信分享自动生成二维码页面
• 响应式设计：PC 端居中弹窗，移动端底部弹出

瞬间列表优化

• 列表页新增详情入口图标，点击可跳转到独立详情页
• 媒体区域添加 `moment-media` 类，便于灯箱插件识别，避免头像被误放大

---

🎨 样式优化

文章内容 details 折叠组件

• 修复点击展开时的闪烁线条问题
• 优化发光效果，宽度调整为 `calc(100% - 40px)` 居中显示
• 降低阴影强度，提升视觉层级
• 移除默认 marker 标记，展开状态用背景色替代下边框

---

🔧 后台设置优化

表单控件升级

• 将约 90 个布尔值设置从 radio 单选（启用/禁用）改为 switch 开关组件
• 涵盖：加载动画、悬浮控制栏、返回顶部、Logo 显示、主题切换、搜索按钮、社交链接、法律链接等
• 简化配置界面，提升用户体验"

---

Generated from v1.1.4

v1.1.3 更新日志

🗑️ 功能移除与优化

• 移除加载屏幕图标支持：
  移除了加载屏幕中 Iconify 和 SVG 动画的相关配置。鉴于动态图标的加载渲染耗时较长，甚至超过了加载屏幕本身的显示时长，导致“屏幕已关图标未现”的冗余体验，故彻底移除此功能以提升轻量化体验。

⚡️ 适配 Halo 2.22.0 新特性

• 表单适配：
  • 跟进 Iconify 图标选择器，为图标配置提供更直观的通用选择组件。
  • 适配新增的 Array 表单类型，优化数据组定义结构（逐步替代 repeater）。
  • 适配重构后的 Attachment 表单，支持直接预览与上传文件（旧版 attachmentInput 已兼容处理）。
• API 适配：
  • 适配文章 Finder API cursor(postName) 的结构变更：移除 current 字段，更新 previous / next 返回类型为 ListedPostVo，并遵循基于发布时间的上下篇逻辑。

---

Generated from 1.1.3

性能优化：优化动画和过渡效果以提升性能

• 移除全局过渡时间函数，避免对所有元素进行不必要的计算
• 缩短平板电脑和桌面设备上的动画持续时间（0.3 秒至 0.5 秒）
• 简化关键帧动画，移除中间步骤和复杂的变换
• 将 transition: all 替换为特定属性的过渡（例如 transform、box-shadow 等）
• 使用 @media (hover: hover) 查询将悬停效果限制在支持悬停的设备上
• 将浮动停靠栏背景模糊效果从 20 像素优化为 16 像素，并降低阴影复杂度
• 添加 -webkit-tap-highlight-color: transparent 以改善触摸设备的体验
• 缩短停靠栏按钮和分享平台按钮的过渡持续时间（0.15 秒至 0.2 秒）
• 分离动画图层，避免变换叠加，提高渲染效率
• 更新导航菜单过渡效果，使用特定属性而不是 all 简写
  这些更改通过减少绘制/合成操作，确保所有设备类型都能流畅播放动画，同时保持视觉质量，从而提升性能。

---

Generated from 1.1.2

字体：托管至阿里免费cdn
侧边栏：更改样式
升级依赖解决安卓卡顿的问题

---

Generated from 1.1.1

更新开发依赖至最新版本

升级@iconify/json、@types/node、@typescript-eslint系列、daisyui、prettier、prettier-plugin-tailwindcss、typescript-eslint和vite至最新版本。同步更新相关依赖包括browserslist、caniuse-lite和baseline-browser-mapping。

---

Generated from 1.0.10

1、重构CSS文件结构，优化性能并统一样式规范

将内联样式提取至公共CSS文件，移除冗余的will-change和transform属性以提升渲染性能。统一使用data-color-scheme判断暗色模式，替换prefers-color-scheme媒体查询。提取公共fadeInUp和slideInLeft动画至base.css供多页面复用。配置DaisyUI排除未使用组件以减小CSS体积。修复模态框滚动条处理逻辑，移除overflow强制覆盖。删除空的doc.css和doc.js文件。统一颜色变
2、重写doc模版，新增版本切换，优化ui

---

Generated from 1.0.9

优化友链提交模态框性能和用户菜单交互体验，更新版本号至1.0.8

禁用友链提交模态框的DaisyUI默认过渡动画以提升性能，为输入框添加主题色发光聚焦效果和毛玻璃背景遮蔽。在用户下拉菜单中添加before伪元素创建桥接区域，改善鼠标悬停交互体验。

---

Generated from 1.0.8

修复加载模版

---

Generated from 1.0.7

1、优化nav二级菜单显示
2、优化cd 工作流
3、新增dock样式和后端切换功能
更新版本号至1.0.6

---

Generated from 1.0.6

新增文档中心模版
适配文档中心后端控制组件

修复手机版 首页显示

---

Generate from 1.0.4