Sky Blog Theme

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 /> 支持，可从系统设置注入页脚代码

🐛 修复

🔄 兼容性

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