新特性

• 在主题后台“侧边栏设置”中新增“归档页侧栏组件顺序”配置。
• 支持通过拖动调整归档页面侧栏组件的显示顺序。
• 支持排序以下组件：
  • 热力图（文章、瞬间、碎碎念数据）
  • 一言
  • 热门文章
  • 最新评论
  • 标签云

PJAX优化

• 支持首次进入归档页面时初始化。
• 支持 PJAX 切换回归档页面后重新初始化。
• 页面离开时终止尚未完成的文章数据请求。
• 侧栏排序会在日历、评论和标签云初始化之前完成。
• 文章接口使用分页读取，避免只统计当前归档页数据。
• 动态内容使用 DOM 文本节点生成，不解析不可信 HTML。

历史遗留Bug修复

• 分类详情：修复无数据默认展示硬编码数据
• 文章详情：修复上一篇 / 下一篇跳转方向似乎与发布时间顺序相反等问题

一些回滚

• 修复Lenis 全局惯性滚动回滚，修复项目集、朋友们等页面卡片加载问题。

新增

• 项目集新增“项目打开方式”配置
• 支持“项目展示”和“跳转链接”两种模式
• “跳转链接”支持直接打开网站、演示地址或其他项目链接
• GitHub 项目在“跳转链接”模式下不再请求 GitHub API
• 我的项目和收藏项目均支持直接跳转

修复

• 修复导航链接为空时可能导致的模板解析异常

性能优化

• 移除 Lenis 全局惯性滚动，改善 macOS和Safari 下的滚动跟手性。
• 优化页面入场动画的错峰节奏，避免多个组件同时出现造成生硬感。

Bug 修复

• 修复后台“项目展示”配置中的文字乱码。
• 修复 Star 数量字段名称显示异常。
• 修复 Fork 数量字段名称显示异常。

问题修复

• 修复首页“个人简介”无法按照后台输入内容换行的问题。

问题修复

• 修复朋友页面“申请友链”弹窗复制内容错误的问题。

  • 名称和描述不再被错误转换为网址。
  • 地址与头像链接复制功能保持正常。

• 修复首页天气信息受右侧内容挤压而换行的问题。

  • 时间、位置、天气状态和温度保持单行显示。
  • 头像及天气区域不再被右侧个人信息压缩。

2.1.5

新增

• 适配 Links 插件的访客友链申请功能。
• 在友链页面分类栏右侧新增“申请友链”入口。
• 新增友链申请弹窗，支持官方验证码、CSRF 校验和审核流程。
• 在申请弹窗中展示本站名称、地址、头像链接和站点描述，并支持一键复制。

适配

• 适配心愿插件新接口。
• 适配Afdian Plus插件新接口。

移除

• 移除友链页面底部原有的申请组件。

修复Bug

• 修复首页“生活回想”图片浮层描述直接显示瞬间插件富文本标签的问题，避免出现 <p style=""> 等 HTML 片段。

修复

• 修复启用 PJAX 与 Lenis 平滑滚动后，从其他页面返回首页时页面滚动边界未及时刷新，导致页脚下方出现大面积空白并可继续滚动的问题。
• 修复首页 Swiper、图片等异步内容加载后未同步刷新 Lenis 滚动高度的问题。
• 优化 PJAX 内容替换后的滚动复位流程，切页后会同步重置 Lenis 与浏览器原生滚动位置。

版本

• 主题版本更新至 2.1.0。

新特性（新增星图库）

星图库页面

• 新增“星图库”页面模板，可在 Halo 后台创建页面时选择使用。
• 星图库支持插件状态探测，插件未安装、未启用或暂无数据时展示提示状态。
• 星图库支持展示本星系头像、名称、描述、访问入口与星图遥测信息。
• 星图库支持展示本星系关联星系数量。
• 星图库支持展示星系代号、星球代号、联邦签名、星图遥测等信息。
• 星系联盟支持星系头像、名称、描述、影响力、可信度、星球数量展示。
• 星系联盟支持卡片点击打开星系详情弹窗。
• 星系联盟支持三种展示模式：
  • 泡泡模式
  • 一体川流模式
  • 极简模式
• 泡泡模式支持星系头像气泡展示。
• 泡泡模式支持鼠标悬停展示星系信息卡片。
• 一体川流模式支持星系卡片横向流动展示。
• 一体川流模式支持鼠标悬停暂停流动。
• 极简模式支持星系卡片网格展示。
• 星图库展示模式可在主题后台配置切换。
• 星系详情弹窗支持展示星系头像、名称、描述、访问星系按钮。
• 星系详情弹窗支持展示影响力、可信度、星球数量。
• 星系详情弹窗支持展示加入时间与活跃时间。
• 星系详情弹窗新增“星系成员”区域。
• 星系成员展示当前星系下的星球成员。
• 新增“星际资讯”模块。
• 星际资讯支持展示文章类动态。
• 星际资讯支持展示星系连接、同步、邀请等动态。
• 星际资讯支持展示动态头像、标题、描述、时间、来源星球。
• 星际资讯文章类动态支持“打开原文”按钮。
• 星际资讯非文章类动态支持“定位星球”按钮。

首页导航标志

• 修复首页菜单图标配置缺失的问题。顶部导航图标配置新增首页菜单标志配置，基本设置->导航图标配置->首页图标，默认fa-solid fa-house。

项目集页面

• 项目集页面新增项目分类配置，支持按自定义分类分组展示，项目展示
  ->GitHub 项目列表。

朋友们页面

• 朋友们页面重构为三种展示模式，友链页面->友链设置：
  • 泡泡模式
  • 一体川流模式
  • 极简画栏模式
• 优化友链筛选逻辑，不同分类下保持交互状态一致。
• 画廊模式按分类分组展示，分类标题展示对应数量。
• 非画廊模式的筛选项样式与分类标题保持一致。

导航

• 修复顶部导航默认图标匹配问题。
• 新增星图库页面默认图标识别。
• 调整星图库默认导航图标为 fa-solid fa-location-arrow。
• 修复首页菜单图标配置缺失的问题。

项目集页面

• 新增项目分类配置。
• 支持 GitHub 项目和自定义项目分别设置分类。
• 前台按分类分组展示项目卡片。
• 保留“我的项目”和“收藏项目”的原有行为。
• 修复 PJAX 进入项目集页面时项目数据需要刷新当前页才加载的问题。

其他…

主题元信息修订

性能优化

• 内联 theme-color-init.js，减少首屏阻塞请求。
• 调整欢迎页加载逻辑，去掉 body visibility:hidden 式的首屏隐藏方案。
• 欢迎遮罩改为在 DOMContentLoaded 后更早结束，不再强依赖 window.load。
• 缩短欢迎页过渡动画时长，减少首屏等待感。
• 首页背景图改为“本地默认图先显示，远程图异步替换”，避免远程接口拖慢 LCP。
• 非关键 CSS 改为异步加载：
  • qweather-icons.css
  • lenis.css
  • aos.css
  • swiper-bundle.min.css
  • welcome.css
• 字体图标改为延迟加载，降低首屏阻塞。
• 若干非关键脚本改为 defer：
  • APlayer.min.js
  • Meting2.min.js
  • cursor-init.js

字体显示优化

• fontawesome.min.css 中的 font-display 从 block 调整为 swap。
• qweather-icons.css 增加 font-display: swap。
• 优化字体加载策略，减少文本不可见时间。

文章页与侧栏修复

• 相关文章无数据时，假链接占位改为普通文本占位。
• 作者信息浮层链接补充可访问描述，避免被识别为“无描述链接”。

装备页面修复

• 重写 equipments.html 的静态中文文案，修复乱码问题。

v2.0.4

新增 PJAX 无刷新切换引擎

站内页面切换时仅替换主体内容，保留全局持久层，解决切换页面时音乐播放组件中断、播放器重新初始化等问题，提升浏览体验。

新增 PJAX 启用/关闭功能

后台主题设置中可自由开启或关闭 PJAX 功能，适配不同站点需求。关闭后恢复传统整页跳转。

优化页面切换样式加载机制

PJAX 切换时会先加载新页面所需 CSS，再替换页面内容，避免出现短暂无样式页面、图标放大、布局闪烁等问题。

优化页面切换过渡

开启 PJAX 后自动使用页面切换遮罩，减少切页过程中的视觉突兀感。

优化全局资源加载

Font Awesome、AOS、Swiper 等关键样式改为稳定加载，降低冷加载和 PJAX 切页时的样式闪烁概率。

优化 PJAX 生命周期管理

增加页面进入与离开钩子，支持页面脚本在 PJAX 切换后重新初始化，并在离开页面时清理定时器、滚动监听、弹窗状态等资源。

优化滚动与动画组件兼容性

适配 Lenis 平滑滚动、AOS 动画、Swiper 轮播等组件在 PJAX 场景下的重新初始化与状态刷新。

Bug 修复

修复心知天气无法显示的问题

v2.0.1

新特性

• 归档页 / 文章页标签云改造为 3D 旋转球：将归档页和文章详情页侧边栏原本平铺的标签云，改造为球面分布、可自动旋转的 3D 标签球，支持拖动旋转、释放后惯性滚动、近大远小的透视缩放。

性能优化

• 页面切换：引入 View Transition，站内跳转由原来的纯色硬切换为整页交叉淡入淡出。
• • 文章详情页长文滚动卡顿：合并并节流滚动监听，目录高亮加缓存仅在变化时刷新；移除文章背景容器、侧边栏组件、封面图上覆盖大面积的实时高斯模糊，消除逐帧模糊开销。
• 移除 PJAX：删除 PJAX 相关脚本，侧边栏改用原生 CSS position: sticky，减少运行时开销与维护成本。

问题修复

• 在线壁纸加载问题：修复文章背景图、首页 API 图与主题视频自动加载问题。

v2.0.1

新特性

• 归档页 / 文章页标签云改造为 3D 旋转球：将归档页和文章详情页侧边栏原本平铺的标签云，改造为球面分布、可自动旋转的 3D 标签球，支持拖动旋转、释放后惯性滚动、近大远小的透视缩放。

性能优化

• 页面切换：引入 View Transition，站内跳转由原来的纯色硬切换为整页交叉淡入淡出。- 文章详情页长文滚动卡顿：合并并节流滚动监听，目录高亮加缓存仅在变化时刷新；移除文章背景容器、侧边栏组件、封面图上覆盖大面积的实时高斯模糊，消除逐帧模糊开销。
• 移除 PJAX：删除 PJAX 相关脚本，侧边栏改用原生 CSS position: sticky，减少运行时开销与维护成本。

问题修复

• 在线壁纸加载问题：修复文章背景图、首页 API 图与主题视频自动加载问题。
• 在线壁纸加载问题：修复标签云/热门标签无限平铺问题。

v2.0.0 更新记录

✨ 新增

1. 亮 / 暗双色主题色配置 —— 后台 主题 → 基本设置 新增 亮色模式主题色、暗色模式主题色 两项独立配置，分别对应亮、暗模式的主色调，模式切换时实时生效（默认湖水蓝 #7DCDE8 / 樱花粉 #E87D98）。
2. 主题切换渐变过渡 —— 亮暗模式切换时背景色相变量平滑插值，过渡更柔和自然，不再突兀（饱和度刻意压低，仅保留极弱主题色相暗示）。
3. ANI 动态指针样式 —— 内置鼠标指针动态化效果，悬停可交互元素自动反馈，全站统一观感。
4. 文章页目录组件自适应高度 —— 侧边栏 TOC 根据视口高度自适应，长目录支持滚动，短目录贴合内容，不再撑爆或留空。

🛠 修复

1. 页脚公安备案图标错乱 —— 原默认图标复用了站点 logo 兜底图导致显示不一致。
2. 留言板「天数记录」常显「-」 —— 与页脚「本站已运行 X 天」共用同一份配置。
3. 搜索弹窗关闭按钮残影 —— .search-modal 透明度与可见性同步淡出，不再出现「面板消失但 X 按钮还在」的拖影。
4. 朋友圈页面 —— 已适配官方链接管理插件，请在插件->链接管理插件详情->rss订阅部分勾选公开 RSS 订阅动态即可

🗑 移除 / 优化

1. 移除前端色相切换面板 —— 导航栏的色相滑块和取色卡片彻底下线，主题色统一由后台双色配置驱动，单一信息源更清爽。
2. 背景主题色染色减弱 —— 登录页 / 网关页背景渐变饱和度从 30% / 12% 降至 8% / 4%，背景接近中性，不再被主题色「染色过重」。
3. 友链提交功能下线 —— 因友链提交插件不再兼容新版 Halo，移除朋友们页面提交按钮、表单弹窗及样式。建议通过 halo 商城安装 AstraHub 星链插件 注册邀请交换友链，或直接联系博主。本站信息卡（一键复制）保留。

Bug修复

修复碎碎念页面遗漏的问题（动态条数限制问题）

---

Generated from v1.5.11

新特性

• 集成 Passkey 通行密钥插件
  • 登录页“快速关联”并入 Passkey 入口
• 集成Halo Plugin Online在线显示插件
  • 页脚在线展示websocket状态、在线人数与活跃页面数
• 登录/注册/忘记密码等网关页新增独立壁纸开关
  • 在 基本设置 -> 登录设置 新增“启用登录页壁纸”，默认关闭
  • 开启后网关页复用首页壁纸配置；关闭后这些页面不再跟随首页壁纸显示
• 公安备案 Logo 自定义
  • 支持为公安备案单独选择 Logo 附件，留空时使用默认图标
  • 支持自定义公安备案 Logo 显示大小（16-40px，默认 20px）
• 朋友们页面跳转验证交互改造（Ordinary / Hue）
• 移除旧滑块验证结构与样式残留，改为主题色 CTA 按钮确认跳转
• 朋友们页面头像兜底逻辑重构
  • 友链未填写头像或头像加载失败时，不再回退字母
  • 统一改为主题跟随的 SVG 占位图标，亮暗模式下自动使用对应主题色

Bug修复

• 修复页脚 ICP / 公安备案显示开关未生效的问题。

---

Generated from v1.5.10

##移除一些无法避免的代码残留

---

Generated from v1.5.9

新特性

• 关于页面：新增联系我组件隐藏/显示功能
• 页脚：新增AstraHub 状态栏适配AstraHub 星链节点

功能与修复

• 修复首页「随想碎片 / 生活回想」在弱网或图片慢加载场景下的布局退化问题，避免内容塌成单列。
• 修复「随想碎片」模块副标题文案显示异常。

---

Generated from v1.5.8

UI优化

文章详情页顶部作者等元数据可见度

朋友圈站点跳转滑块效果优化

---

Generated from v1.5.7

新特性

新增「基本设置 -> 全站文字样式」配置

首页背景壁纸支持亮色与暗色分别配置（可选附件）

性能优化

PJAX性能优化

UI优化

移动端文章封面与元信息样式优化

Bug修复

登录/注册页面输入框线条与图标焦点状态修复，输入框有值时保持高亮，不再在失焦后立即消失。

搜索弹窗样式，亮色模式下搜索面板文字为灰色。移除搜索弹窗整过渡，避免出现短暂的透明。

优化评论区滚动手感，移除对评论组件的整块滚动拦截，解决在评论区附近上滑/下滑时的“阻滞感”与边界发涩问题。

---

Generated from v1.5.6

新特性

• 可配置页面过渡加载动画（基础配置），仅支持gif格式，未设置默认kirara.gif
• OAuth2 社交登录支持
  • 登录页集成 Halo OAuth2 插件的第三方登录（GitHub / Gitee / GitLab 等）

Bug 修复

• 修复友链页面滑块可超出轨道右边界

---

Generated from v1.5.5

新特性

• 自定义页面导航图标
• 重构登录、注册、忘记密码、退出登录页面
  
  
  
  

UI优化

• 优化朋友们跳转滑动块样式

其他优化

• 移除主题中未引用的静态资源

其他不起眼的一些优化

---

Generated from v1.5.4

Bug修复

• 修复分类详情页面顶部的默认标志（和分类卡片一致）

UI优化

• 优化项目集、标签墙空状态提示

其他

• 默认设置进一步调整
• 其他一些没人注意的小细节...

---

Generated from v1.5.3

默认设置调整

• 首页仅保留壁纸，关闭其他组件默认值
• 关于页面所有组件默认关闭

UI 统一优化：空状态提示样式全站统一

将所有非首页页面的"无数据"“无插件”空状态提示统一，保持视觉一致。

---

Generated from v1.5.2

Bug 修复（更新此版本，务必提前备份主题配置）

⚠️ 此版本修复了一个影响范围极大的问题。

重要修复：settings.yaml 数据结构变更导致的全站渲染崩溃

UI 优化

• 解决爱发电组件没适配主题模式切换的问题
• 优化主题项目集我的项目详情弹窗md语法渲染的问题

---

Generated from v1.5.1

新特性

• 新增装备管理页面（模板），适配装备管理插件（来源：blog.zyx-2012.cn，并在此基础上进行适配和优化。）
• 新增页面标题和副标题自定义配置
• 新增文章页标题装饰图标开关以及封面内容布局（适配移动端）

Bug 修复

• 修复登录页主题模式不跟随用户切换的问题
• 修复标签页环形数据统计错误、标签颜色显示错误（历史遗留）问题

其他

• 其他小问题

---

Generated from v1.4.6