_{HALO 2 博客主题}

Halo-Theme-Ethereal 2.0.1

一款专为 Halo 打造的 Fuwari 风格增强型主题

更新说明

欢迎使用 Ethereal 主题 v2.0.1。本次更新主要完善 Halo 生态兼容性，补齐页脚注入、插件配色与自定义路由支持，并带来通用错误页与 SEO 设置；同时优化首屏加载与卡片悬浮效果，修复分类导航滑块、打赏页深色模式等问题。

请注意，本次更新将「认证」分组更名为「杂项设置」，原「登录界面」设置不会自动迁移，升级后需重新确认，详见 设置项迁移

主题使用中遇到问题或者建议，欢迎在 Issue 中提交，也可前往 主题交流群 进行讨论

插件兼容

• 新增 插件配色支持，插件前台组件可跟随主题明暗切换

• 修复 页脚注入不生效：补齐页脚扩展点，后台「代码注入 → 页脚」与页脚类插件恢复工作

• 修复 插件前台页标题重复输出的问题

页面与路由

• 新增 通用错误页：其他错误状态统一显示状态码、提示与返回首页按钮

• 修复 后台自定义路由前缀下归档 / 分类 / 标签链接失效的问题

SEO 与元信息

• 新增 「杂项设置 → SEO 设置」，可统一开关 canonical 与社交分享标签

• 修复 文章页、独立页面与六个自定义页缺失 canonical 的问题

• 修复 首页描述与系统 SEO 描述重复的问题

• 修复 站点图标重复输出的问题，改由 Halo 统一注入

性能与加载

• 优化 页面内联脚本体积，首页由 135KB 降至 72KB

• 优化 卡片封面加载，按屏幕选择 400 / 800 两档，1x 屏幕约省一半流量

• 优化 备案图标体积，由 19.3KB 降至 1.1KB

• 优化 归档页分类数据查询，减少服务端开销

• 修复 封面图片带查询参数时压缩失效的问题

卡片与打赏

• 优化 卡片悬浮效果：深色模式提亮更柔和，技能 / 日程日历 / 关于页卡片统一底色，过渡统一为 300ms

• 修复 打赏页收款卡在深色模式下的显示问题

分类导航

• 优化 高亮宽度的动画，避免抖动；系统减少动效时直接落位

• 修复 滑块在点击与滚动时左右抽搐的问题

• 修复 自定义路由前缀下分类导航高亮消失的问题

无障碍

• 修复 Banner 纯图标链接缺少无障碍名称的问题

设置项迁移

从 2.0.0 升级到 2.0.1 后，以下设置需重新确认。

杂项设置

• 「认证」分组更名为「杂项设置」；「登录界面」设置不会迁移，需重新选择

其它

• 全仓按 prettier 规范化格式，精简注释与文档；构建链加入类型检查

• 依赖升级：Astro 7.3.8、Svelte 5.57.2、Prettier 3.9.10 等

• 依赖安全：锁定 brace-expansion、source-map-js、postcss-selector-parser 修复版

• 更新 README

• 版本号提升至 v2.0.1

本次更新处理的 Issue 与 PR

Issue

• #91 缺少页脚扩展点 <halo:footer />，页脚注入类插件无法生效（v1.0.0 起遗留）

PR

• #94 依赖升级：npm 分组 6 项更新

Full Changelog: v2.0.0...v2.0.1

---

Generated from v2.0.1

_{HALO 2 博客主题}

Halo-Theme-Ethereal 2.0.0

一款专为 Halo 打造的 Fuwari 风格增强型主题

更新说明

欢迎使用 Ethereal 主题 v2.0.0 正式版。请注意，本次更新会导致部分主题配置失效，需重新配置，详见 设置项迁移

本次更新带来全新「沉浸（Hero）」全屏壁纸布局、可自由编排的侧边栏小组件体系、关于页 / 打赏页页面模板与页脚卡片版式，并为全站页头、卡片与正文元素换上新的视觉语言；同时系统性打磨了换页动画、移动端流畅度与旧版浏览器兼容性。

更新完成后建议前往「主题设置 → 详细」进行 重载主题配置 & 清除模板缓存 两项操作，确保新设置项正常生效

主题文档暂未完善，更新后请自行摸索相关配置，如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交，也可前往 主题交流群 进行讨论

全屏壁纸

沉浸（Hero）布局

• 「全屏布局」新增「沉浸模式」，并支持经典 / 沉浸两种形态，且访客可在前台「显示设置」中切换；可前往「布局设置 → Banner 布局」切换体验

• 沉浸布局下壁纸钉住视口：首页下滑时壁纸由清晰渐变至模糊、标题随滚动上移淡出；非首页固定模糊、内容贴近导航栏；显示设置支持调节背景模糊度、卡片透明度

导航栏与细节

• 全屏模式新增首页导航栏顶部透明，向下滚动平滑过渡为玻璃底

• Banner 署名胶囊在全屏壁纸下隐藏，透明模式移除壁纸压暗滤镜，暗色卡片底改用深灰

流畅度

• 优化移动端壁纸切换与抽屉菜单性能，消除切换卡顿

• 打磨换页动画：首页与内页互切时标题落位后再显现、滚动位置与内容位移锁步同步，消除抖动

首页 Banner

链接图标行

• 标题 / 副标题下方新增一排链接按钮，支持纯图标与 图标 + 名称 胶囊两种形态；可前往「样式设置 → 标题与副标题 → Banner 链接」配置体验

图片加载

• Banner 图片分档加载适配全部图床

• 首屏 Banner 揭示不再等待主脚本，媒体就绪且首帧绘制后即刻显示

• 标题 / 副标题字号改为首帧定档，修复移动端首屏字号闪变

页面头部

仪表条形态

• 全站页头升级为「眉题 + 标题 + 统计方片 + 动作槽 + 大图标水印」仪表条形态，页头与内容拆分为独立卡片

筛选与统计

• 分组筛选池改为全新胶囊形态（滑动选中浮块），全部分组页统一接入；页头统计随当前筛选分组实时变化

• 「已筛选」清除钮移至统计片左侧；日程日历页面周导航移至页头，心愿墙页面分组控件移动至页头

侧边栏

小组件吸顶

• 左右侧栏重构为「不吸顶区 + 吸顶区」，每个小组件可单独勾选「吸顶」；可前往「侧边栏 → 小组件设置」配置体验

移动端专用列表

• 新增移动端专用小组件列表（<768px）：留空时沿用「左栏 → 右栏」顺序，配置后只显示指定组件；可前往「侧边栏 → 小组件设置」配置体验

目录位置

• 目录支持挂载在左侧栏或右侧栏（三栏布局），两栏布局继续使用悬浮目录；可前往「文章 → 目录位置」配置体验

• 含目录的文章页仅保留前 2 个吸顶组件，高度差额由目录卡片承担

两栏「右栏模式」

• 新增两栏布局右栏模式：侧栏与正文交换列位置，悬浮目录镜像到左侧空白槽；可前往「布局设置 → 页面布局」配置体验

配置与细节

• 小组件详细配置外提为独立设置分组（站点统计 / 天气 / 一言 / 音乐 / 日程），同类小组件可在多个位置复用

• 侧栏小组件不再随站内换页重建，音乐播放器与天气等组件在换页间保持状态

• 音乐播放器未配置 ID 时显示提示卡；默认小组件列表重新编排

页脚

友情链接卡片墙

• 页脚新增友情链接卡片墙，数据来自友情链接插件、服务端渲染；可前往「页脚 → 页脚友情链接」配置体验

• 支持显示开关、仅在首页显示、申请友链按钮与最多显示条数

卡片版式与星芒分割带

• 新增卡片版式页脚，卡片版式整合站点标题、友情链接（紧凑形态）、社交图标、版权与备案等信息，整块为一张卡片；可前往「页脚 → 页脚样式类型」配置体验

• 新增星芒分割带样式；可前往「页脚 → 分割带样式类型」配置体验

正文与卡片

正文元素适配

• 文章正文元素全面适配：图片 / iframe 圆角、分隔线、列表 marker、嵌套列表、任务列表、折叠块、视频防溢出与表格磨砂卡片

• 折叠面板样式优化：友链页折叠面板指示器移至标题左侧，与正文折叠块统一为圆角三角

列表封面比例

• 文章卡片列表模式新增「列表封面比例」设置：撑满卡片高度（默认）/ 固定 16:9；固定 16:9 在屏幕变窄后自动垂直居中裁切，避免封面越裁越多；可前往「布局设置 → 文章卡片布局 → 列表封面比例」配置体验

• 移动端卡片封面比例统一为 2:1

项目集卡片

• 项目集列表卡片重构，推荐区与全部区共用同一份卡片；悬浮反馈分整卡底色、封面放大与标题箭头三层

• 作品详情页新增「分类区」：平台 / 类型 / 技术栈 / 标签三行展示，移除底部重复区域

卡片样式

• 新增「卡片跟随主题色」：浅色模式下卡片背景跟随主题色相；可前往「样式设置 → 样式开关」中配置体验

• 新增「卡片边框和阴影」：内容卡片、按钮卡、分页页码组与导航栏统一加细边框与浅阴影；可前往「样式设置 → 样式开关」中配置体验

• 两个开关均支持访客在前台「访客样式面板」中覆盖

布局宽度

• 全站宽屏宽度调整，充分利用宽屏空间，显示宽度不足时自动压缩内容区宽度

• 列表页卡片最小宽度统一为 240px（项目集 / 友链 / 日程）

功能页面

关于页面

• 新增「关于页面」模板：身份卡 / 个人简介 / 本人项目 / 最近提交 / 我的技能 / 我的朋友 / 保持联系等共 9 张卡片，后台按卡片顺序分组配置；可前往「扩展页面 → 关于页面」配置体验

• 身份卡与侧栏「在线状态」实时同步，点击即可切换状态

• 「订阅更新」卡片：邮箱订阅直连文章订阅插件公开接口，需安装 文章订阅 插件，缺失或未开启时整卡不渲染

打赏页面

• 新增「打赏页面」模板：用途说明、微信 / 支付宝收款码、打赏者名单；可前往「扩展页面 → 打赏页面」配置体验

• 文章打赏模态框底部新增「打赏页面」跳转按钮，开关与路径可前往「文章 → 打赏设置」配置体验

瞬间

• 瞬间页面动态卡片改为全新独立卡片流：一条瞬间一张卡，头像轨道缩进、标签胶囊、右下角水印与复制链接、点赞 / 评论 / 更多操作栏

• 内容区顶部新增全站瞬间条：服务端直出、无缝跑马灯、悬停与键盘聚焦暂停，仅大屏端（≥768px）显示；可前往「布局设置 → 瞬间预览条」配置体验

友链页即时搜索

• 友链页新增搜索框，输入即时过滤当前分组卡片：组内无命中整组隐藏、全无命中显示空态，支持一键清空与匹配卡片错峰入场；可前往「友情链接 → 显示搜索框」配置体验

朋友圈

• 移除黑名单功能与来源链接行

• 时间轴改为「日期头 + 卡片」整组包裹，移动端浏览体验更佳

归档页面

• 归档时间轴列宽与对齐调整：年份 / 日期定宽右对齐贴轴，消除内容区左侧空档

个性化与交互

樱花特效

• 新增全站樱花特效，访客可在前台「访客样式面板」中覆盖；可前往「样式设置 → 样式开关」配置体验

• 前台「显示设置」新增「特效」标签页与樱花开关

访客样式面板

• 访客样式切换收敛为标签页级：总开关 + 外观 / 壁纸 / 特效三项，面板 Tab 栏按后台配置项动态生成；可前往「布局设置 → 菜单栏设置 → 访客样式切换」配置体验

按压与细节

• 全站按钮与弹窗统一按压反馈，按下平滑泛主题色、松手回弹，覆盖外链 / 友链申请 / 分享 / 打赏等场景，并补齐友情链接模态框出场动画

• 分区标题新增前置图标盒

• 朋友圈 / 友链 / 标签页眉题图标更新，并移除图标的悬浮放大效果

渐进式入场

• 归档页面条目补齐渐进入场动画

设置项迁移

从 1.2.4 升级到 2.0.0 后，后台部分设置项的位置与形式发生变化，以下设置需到新位置重新确认一遍，不再沿用旧值。

侧边栏

• 小组件详细参数从「小组件列表」条目内移出，改为独立分组：

  • 天气 →「天气小组件」
  • 一言 →「一言小组件」
  • 音乐播放器 →「音乐播放器小组件」
  • 最近日程 →「最近日程小组件」
  • 站点统计 →「站点统计小组件」
    • 站点统计的九个开关合并为「统计项」多选

• 条目精简为「小组件 + 吸顶」，并新增「移动端小组件」列表

• 个人简介 / 公告取消「启用」与「显示位置」：加入小组件列表即显示，位置由所在列表决定

布局

• 「启用分类导航栏」移至「页面布局 → 分类导航栏」分组

• 「列表模式封面位置」移至「文章卡片布局 → 列表设置」

访客样式

• 访客样式切换由分项开关（主题色相 / 文章布局 / 卡片样式 / 壁纸模式 / 壁纸设置 / 透明设置）收敛为「外观 / 壁纸 / 特效」三项

• 卡片悬浮效果不再提供前台「访客样式面板」内开关，改为仅后台控制

扩展页面

• 移除时间轴 / 技能页面的「副标题」设置项

• 移除朋友圈的「屏蔽列表」设置项

修复与其它

问题修复

• 修复非主题页（插件自带前台页等）被换页脚本接管导致整站样式丢失的问题，现已交还浏览器原生跳转

• 修复瞬间页点赞与评论锚点在站内换页后失效的问题

• 修复部分旧版 Chromium 内核浏览器（OPPO / 一加自带浏览器、旧版微信内核等）图标显示不全的问题

• 修复认证页装饰图标规则误伤人机验证插件元素的问题

• 修复移动端浏览器动态地址栏导致的波浪露缝与滑动屏幕壁纸抖动的问题

• 修复分类导航栏「更多」按钮未贴右端的问题

• 修复横幅壁纸与全屏壁纸模式下换页内容区抖动的问题

其它

• 无障碍优化：清理冗余 aria 属性，欢迎弹窗标题层级调整为 h2

• 依赖升级：Astro 7.2.8、sharp 0.35.4、colord 2.10.0，js-yaml 统一至 4.3.2

• 版本号提升至 v2.0.0

• 更新 README

• 太多了，如有遗漏见谅

本次更新处理的 Issue 与 PR

Issue

• #46 文章页中目录在侧边栏中的位置，可以调整就好了

• #47 阅读模式：可隐藏左侧栏、右下角 CSDN 样式目录、正文全宽

• #69 主页增加友链展示（底部或侧边栏）

• #80 优化桌面端列表模式文章封面显示（显示不全 / 大屏留白多）

• #82 SWUP 页面切换 FOUC，手机访问短暂丢失样式

• #83 OPPO 手机浏览器底部图标加载不全（疑似腾讯 X5 内核兼容问题）

• #84 加载人机验证插件无法显示验证码

PR

• #74 页脚新增友情链接卡片墙 by @PanDaDaTech

• #78 新增「关于页面」模板与全站瞬间条 by @lqbby

Full Changelog: v1.2.4...v2.0.0

---

Ethereal，由多位开源贡献者共同打造❤️

---

Generated from v2.0.0

呀呼！欢迎使用 Ethereal 主题 v1.2.4 版本

本次更新带来菜单栏随滚动方向自动显隐、热门文章 / 音乐小组件支持放置右侧边栏、站点统计小组件支持自定义展示项、置顶文章徽章，以及宽屏 / 高分屏下的 Banner 高清适配与外部 CDN 的 webp 图片压缩等

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往 主题交流群 进行讨论

样式改进

• 置顶文章徽章与卡片高亮：置顶文章在元信息左侧显示「置顶」徽章，列表中的置顶文章卡片增加主色描边与光晕，一眼识别置顶内容 by @lqbby

功能优化

• 热门文章小组件支持放置右侧边栏：右侧栏小组件列表新增热门文章选项，热门文章现在可与其它小组件一样配置在右侧边栏展示 (#70)

• 音乐小组件支持放置右侧边栏：右侧栏小组件列表新增音乐播放器选项，音乐播放器现在可与其它小组件一样配置在右侧边栏展示

• 站点统计小组件支持自定义展示项：后台新增 9 个统计项开关，可自由组合展示文章数、分类数、标签数等统计，并新增访问量 / 点赞数 / 评论数三项统计；网站上线日期改用日期选择器，设置更直观

• 菜单栏随滚动方向自动显隐：关闭「固定菜单栏」时，向下滚动自动收起菜单栏、向上滚动即浮现，不再需要滚回页面顶部才能看到菜单栏 by @lqbby

• 站点统计加载性能：关闭「总字数」展示后不再逐篇抓取文章正文，降低统计与列表页加载开销

• 首页 Banner 加载：预加载改为与图片实际选中档位保持一致，避免窄屏下提前拉取大图造成重复下载

问题修复

• 侧边栏小组件切换类型时配置值串位 / 丢失的问题

• 宽屏 / 高分屏下首页 Banner 图片模糊的问题，Banner 现在按屏幕自适应加载、自动选用更高清图源 (#71)

• 使用外部 CDN（阿里云 ESA / OSS、腾讯云、七牛云、又拍云等）时 webp 图片不参与尺寸压缩的问题

其它

• 版本号提升至 v1.2.4

• 更新 README

Full Changelog: v1.2.3...v1.2.4

---

Generated from v1.2.4

呀呼！欢迎使用 Ethereal 主题 v1.2.3 版本

本次更新带来菜单栏「显示网站名」开关、项目集详情页外链按钮与文章分类/标签一致的悬浮高亮与按压反馈、瞬间图片朋友圈式布局，以及正文表格适配主题样式等

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往 主题交流群 进行讨论

新增

• 菜单栏「显示网站名」开关：菜单栏 Logo 设置下新增「显示网站名」开关（默认开启），关闭后菜单栏只显示 Logo、不再显示站点名 (#65)

• 正文表格适配主题样式：正文表格改用主题圆角/边框/斑马纹等样式，并暴露相关 CSS 变量，便于自定义表格外观 (#67)

优化

• 项目集详情页外链按钮样式统一：仓库 / 演示 / 文档外链改为与文章页分类 / 标签一致的元信息链接样式——方形图标 + 文字链接，悬浮浮现圆角矩形背景高亮并变主题色，按下有缩放反馈，不再显示外链箭头

• 瞬间图片改朋友圈式布局：瞬间图片列表改为朋友圈式布局，九宫格 / 单图等呈现更紧凑统一

修复

• 瞬间图片非竖图裁切：修复瞬间图片非竖图被错误裁切的问题 (#66)

其它

• 版本号提升至 v1.2.3

Full Changelog: v1.2.2...v1.2.3

---

Generated from v1.2.3

呀呼！欢迎使用 Ethereal 主题 v1.2.2 版本

本次更新带来公告栏支持写入 HTML、照片详情页提示补全等功能，并修复移动端搜索框与搜索结果显示问题；v1.2.1 引入的三栏右侧栏空态收列行为已回退

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往 主题交流群 进行讨论

新增

• 公告栏支持写入 HTML：公告内容支持写入 HTML，可在「主题设置 → 侧边栏 → 公告小组件」写入 HTML，实现链接、图标、富文本等自定义样式；「内容呈现为HTML」开启后按 HTML 渲染，关闭时按纯文本显示 (#55) by @Helio-RC in #61

优化

• 照片详情页无 EXIF 提示：照片无 EXIF 数据时显示「此照片无 EXIF」占位提示，避免 EXIF 面板空白 (#63) by @Helio-RC in #61

修复

• 移动端搜索框聚焦后未占满宽度：修复移动端搜索面板输入框聚焦后缩窄、出现空白的问题 (#58) by @Helio-RC in #61

• 移动端搜索结果标题错位：修复窄窗口下搜索结果显示的标题无法换行而溢出、箭头图标错位的问题 (#64) by @Helio-RC in #61

• 搜索结果摘要显示 HTML 标签文本：修复搜索摘要中正文的 HTML 标签被当作字面文本显示的问题，将其替换为空格，现仅保留搜索高亮标记 (#64) by @Helio-RC in #61

• 照片详情页首尾照片提示：修复图库详情页处于第一张/最后一张照片时，上一张/下一张按钮空白无提示的问题，与文章页提示体验保持一致 (#62) by @Helio-RC in #61

• 三栏布局右侧栏自动收列回退：回退 v1.2.1 引入的「右侧栏无组件时整页按两栏渲染」行为，三栏布局恢复始终保留第三列，布局只跟随「页面布局」设置 (#33) by @Helio-RC in #61

其它

• 版本号提升至 v1.2.2
• 更新 README

变更完整日志: v1.2.1...v1.2.2

---

Generated from v1.2.2

呀呼！欢迎使用 Ethereal 主题 v1.2.1 版本

本次更新带来归档页分类筛选、分类导航栏滚轮/拖拽滚动等体验优化，并修复首页标题、分类导航栏滑块等多处显示问题

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往 主题交流群 进行讨论

新增

• 归档页分类筛选：归档页新增支持按分类筛选文章 (#31) by @Helio-RC in #54

优化

• 装备卡片布局：调整装备卡片为上图下文布局，展示内容更多、页面更美观 (#49) by @Leave-Time in #51

• 圆角统一：统一了导航栏、子菜单、友链页按钮的圆角风格，视觉更协调

• 友情链接/朋友圈页面多语言补全：复制按钮改为点击后仅切换图标，不再显示中文"已复制"；随机钓鱼、随机访问按钮的提示文案补全了三语支持

修复

• 分类导航栏滑块高亮溢出：修复分类标签过多时，高亮滑块颜色溢出到相邻标签的问题 (#52) by @Helio-RC in #53

• 瞬间页面标签展示逻辑：修复瞬间页面标签重复显示的问题 (#48) by @Leave-Time in #50

• 首页标题/副标题显示问题：修复首次进入非首页的页面然后切换回首页标题和副标题不显示的问题，并优化了壁纸标题开关的过渡动画

其它

• 版本号提升至 v1.2.1

变更完整日志: v1.2.0...v1.2.1

---

Generated from v1.2.1

呀呼！欢迎使用 Ethereal 主题 v1.2.0 版本

本次更新带来前台多语言切换、时间轴与技能页面、追番插件页面适配等重大功能更新，后台设置合并「扩展页面」分组，并带来三栏布局空态收列、移动端目录弹窗等体验优化

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往 主题交流群 进行讨论

Tips

• 更新后建议前往「主题设置 → 详细」进行 重载主题配置 & 清除模版缓存 两项操作，确保新设置项正常生效

新增

• 前台语言切换面板：导航栏新增语言切换按钮，访客可实时切换 简体中文 / 繁體中文 / English 三语界面（会同步后台界面语言），并补齐全站 i18n 词条覆盖；可在「主题设置 → 布局设置 → 菜单栏设置 → 语言切换」控制按钮显示，并在「主题设置 → 样式设置 → 主题语言」配置访客未手动切换时的默认语言

• 时间轴与技能页面：新增时间轴与技能两个页面模板，支持条目分组筛选与自定义内容展示（教育经历 / 工作经历 / 项目经历等类型）；可前往「主题设置 → 扩展页面」关联自定义页面并配置 by @Leave-Time in #27

• 追番插件页面适配：新增适配 追番插件 页面，支持类型与状态双维筛选、分页，B 站式竖版封面卡片（渐变覆盖信息、评分角标、追番/播放/弹幕/硬币四项统计），可安装后体验 #28

• 移动端目录悬浮按钮与目录弹窗：当页面无可见目录时，右下角显示目录悬浮按钮，点击呼出 TOC 弹窗，按钮图标随弹窗状态切换；可在「主题设置 → 布局设置 → 浮动导航按钮」开启 #29

• 菜单栏自定义图标与 Logo：菜单项支持在 Halo「菜单管理」中为每个一级菜单配置 Iconify 图标；菜单栏设置新增 Logo 上传项，留空回退主题默认图标

• 分类导航栏组件：新增水平滚动 pill 导航栏（首页 / 归档 / 分类 / 全部分类），液态滑块跟随高亮；可在「主题设置 → 布局设置 → 页面布局 → 分类导航栏」开启

优化

• 三栏布局右侧栏空态收列：三栏布局下右侧栏无组件时，整页自动按两栏模式渲染（收起第三列），避免空栏占位；空态文章页目录改走两栏浮动目录 by @Helio-RC in #33

• 分组页筛选交互统一：抽取分组页页头与筛选标签公共组件，统一友链 / 装备 / 瞬间 / 相册 / 作品集 / 技能 / 时间轴七个分组页的筛选标签尺寸与视觉，「已筛选」徽章全站统一

• 后台设置迁移：「朋友圈」相关设置迁移至「扩展页面」Tab，设置层级更清晰

• 天气 Key 配置说明：腾讯位置服务 Key 的配置提示补充配额分配说明 #30

其它

• 版本号提升至 v1.2.0

• README 优化 by @Helio-RC in #43 #44

• 依赖升级：astro 7.2.1 → 7.2.3 by @dependabot[bot] in #34；npm 依赖组批量更新 by @dependabot[bot] in #41

新贡献者

• @Leave-Time 在 #27 中完成了他们的首次贡献

变更完整日志: v1.1.2...v1.2.0

---

Generated from v1.2.0

呀呼！欢迎使用 Ethereal 主题 v1.1.2 版本

本次更新对后台设置项进行了全面重组，新增「布局设置」页集中管理布局类配置，并完成了 Halo 2.26 页面布局契约模板适配、跨页滚动性能优化与目录体验修复

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往 主题交流群 进行讨论

Tips

• ⚠️⚠️⚠️ 更新必读： 本次为破坏性更新，已保存的大部分主题设置会丢失，升级后需重新配置。受影响的设置项：Banner 布局、Banner 样式、标题与副标题、动画速度、欢迎弹窗、菜单、页面布局、文章卡片布局、菜单栏设置（含菜单样式/固定菜单栏/配色切换/访客样式切换）、浮动导航按钮、配色切换开关

• 更新后建议前往「主题设置 → 详细」进行 重载主题配置 & 清除模版缓存 两项操作，确保新设置项正常生效

新增

• Halo 2.26 页面布局契约模板适配：新增 layout.astro 契约模板，供插件自有前台页面复用主题外壳，含样式顺序对齐、PAGE_WIDTH 常量与动画配置优化

• 后台设置重组：新增「布局设置」设置页，将分散在多个页面的布局类设置集中管理；「基础设置」页删除，Banner 样式/标题与副标题/动画速度迁入「样式设置」页；详细迁移清单见下方 设置项迁移

设置项迁移

⚠️⚠️⚠️ 本次为破坏性更新，以下设置项因组键变更，升级后配置将回落默认值，需用户重新配置。

设置项	原位置	新位置
Banner 布局	基础设置	布局设置
Banner 样式	基础设置	样式设置
标题与副标题	基础设置	样式设置
动画速度	基础设置	样式设置
欢迎弹窗	基础设置	布局设置
菜单	基础设置	布局设置
页面布局	侧边栏	布局设置
文章卡片布局	文章	布局设置
菜单栏设置	样式设置	布局设置
浮动导航按钮	样式设置	布局设置
配色切换开关	样式设置	布局设置
固定导航栏	样式设置	布局设置
基础设置全页	—	已删除，原有设置全部迁出

升级后请前往「主题设置」对照上表逐项检查并重新配置。

优化

• 后台设置项重组：基础设置 / 样式设置 / 侧边栏 / 文章四个设置页精简重构，设置层级更清晰；「样式」tab 更名「样式设置」

  • 布局设置包含：页面布局、Banner 布局、文章卡片布局、菜单栏设置（菜单 / 移动端菜单样式 / 固定菜单栏 / 配色切换 / 访客样式切换）、浮动导航按钮、欢迎弹窗
  • 样式设置包含：Banner 样式、标题与副标题、主题颜色、配色方案、样式开关、动画速度、外部字体
  • 侧边栏保留：小组件设置、个人简介小组件、公告小组件
  • 文章保留：版权声明、内容显示、目录、文章摘要、文章操作栏

• 配色（深浅色）切换：「允许访客切换配色」移入菜单栏设置并改名「配色（深浅色）切换」，控制导航栏明暗切换按钮的显示

• 菜单栏设置：「固定导航栏」更名「固定菜单栏」

• 菜单下拉框：菜单选择由 radio 改为下拉框（menuSelect）

• 跨页切换性能：拆分/重写跨页切换逻辑，改用浏览器原生平滑滚动，减少主线程阻塞 by @Helio-RC in #26

• 悬浮目录：优化二栏样式下的悬浮目录，当页面宽度不足时自动隐藏，避免目录显示异常

修复

• 修复 v1.1.1 修改导致的两栏模式下目录不可见问题 by @Helio-RC in #26

其它

• 版本号提升至 v1.1.2

• README 全面重写：更新项目介绍、功能列表、安装说明，改版徽章

变更完整日志: v1.1.1...v1.1.2

---

Generated from v1.1.2

呀呼！欢迎使用 Ethereal 主题 v1.1.1 版本

本次更新新增了 Banner 全屏与全屏透明模式、访客前台快速切换样式，并带来卡片磨砂、目录高亮重构与一批体验修复

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往 主题交流群 进行讨论

Tips

• 更新后建议前往「主题设置 → 详细」进行 重载主题配置 & 清除模版缓存 两项操作

• 本次更新会导致已保存的 Banner 相关设置丢失，请前往「主题设置 → 基础设置 → Banner 样式」重新配置

新增

• Banner 全屏与全屏透明模式：新增 Banner 显示模式四选开关（关闭/纯色、横幅、全屏、全屏透明）——「全屏」模式下首页 Banner 占满整屏，「全屏透明」模式下无横幅、整屏壁纸作为页面背景，配合「高级材质」使内容与组件卡片呈现磨砂透明效果；全屏透明模式下还可分别调节壁纸透明度、背景模糊度与卡片透明度，后台与前台面板均可设置，需同时开启「高级材质」；可前往「主题设置 → 基础设置 → Banner 布局」配置体验

• 访客前台样式切换面板：导航栏原有的「主题色」切换面板升级为「显示设置」面板（外观 / 壁纸双分区），访客可实时切换主题色相、文章列表/网格布局、卡片样式（悬浮 / 磨砂 / 瀑布流）、壁纸模式，以及横幅波浪、首页壁纸标题等壁纸设置；可在「主题设置 → 样式 → 菜单栏设置 → 访客样式切换」逐项配置

• 文章页隐藏封面图开关：新增文章页正文上方封面图显示开关，列表/卡片封面不受影响；可前往「主题设置 → 文章 → 内容显示 → 显示封面图」配置 #20

• 网格封面高度自适应：网格布局新增封面高度自适应开关，开启后封面自动拉伸填满卡片剩余高度，等高网格下同排封面等高、摘要下方不留白；可前往「主题设置 → 文章 → 文章卡片布局 → 网格设置」配置

优化

• 目录高亮重构：高亮指示器改用主题色并同步动画速度档位，转场更平滑；二栏悬浮目录不再显示「此文章无目录」占位文案

• 后台设置项：Banner 相关设置项拆分为「Banner 布局」和「Banner 样式」两项设置组；原「固定色调」开关移入「访客样式切换」并更名为「主题色相切换」

• 部分卡片样式、固定导航栏与网格细节显示优化

修复

• 修复网格布局文章卡片箭头未与标题对齐的问题 #17

• 修复文章卡片主题色装饰竖线未对齐标题的问题 #19

• 修复文章分享海报点击保存无反应的问题 #22

• 修复公告小组件 PC 端无法关闭的问题 #21

• 修复固定导航栏与文章卡片相关布局问题

• 应该没了吧？忘了

其它

• 版本号提升至 v1.1.1

• 新增 AGENTS.md 开发约定文档，完善 README

• 依赖升级：astro 7.2.0 → 7.2.1（补丁级更新） by @dependabot[bot] in #23

TODO

• 随着功能的逐渐增多，主题将在下个版本对后台设置项进行重新整理，优化设置项分页，提升用户体验

• 如您有更好的改进意见，欢迎在 Issue 中提交

变更完整日志: v1.1.0...v1.1.1

---

Generated from v1.1.1

呀呼！欢迎使用 Ethereal 主题 v1.1.0 版本，本次更新是 Ethereal 主题发布以来第一次大版本更新

本次更新带来 Banner 增强、文章卡片布局、在线状态功能、入场欢迎卡片等重大功能更新，并修复了一批体验问题

如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交。也可前往主题交流群 进行讨论

新增

• Banner 增强：新增视频展示、多图轮播、移动端独立图片来源；可前往「主题设置 → 基本设置 → Banner」配置体验 by @Helio-RC in #15

• 文章卡片布局：新增文章卡片网格布局，支持瀑布流显示以及封面贴边。可前往「主题设置 → 文章 → 文章卡片布局」配置，体验全新的卡片布局

• 在线状态功能：新增个人简介小组件在线状态功能，可显示个人在线状态以及自定义文案，支持管理员账号已登录时前台直接切换，无需后台设置；可前往「主题设置 → 侧边栏 → 在线状态」查看，体验独一的状态功能

• 入场欢迎卡片：新增访客进入网站时弹出欢迎卡片，支持 IP 定位（复用天气小组件腾讯位置服务 Key，无需单独配置）、自定义文案；可前往「主题设置 → 基础设置 → 欢迎弹窗」配置体验

• 动画速度档位：新增动画速度档位（舒缓 / 均衡 / 疾速 / 自定义），动画时长全面变量化；可前往「主题设置 → 基础设置 → 动画速度」配置体验 by @Helio-RC in #12

• 菜单面板：移动端新增抽屉样式，支持手风琴 / 抽屉两种模式切换；PC端新增支持固定导航栏，可前往「主题设置 → 样式 → 菜单栏设置」配置体验

• 心愿便签插件页面适配：新增适配 心愿便签 插件页面，可安装后体验

• 日程日历插件页面适配及小组件：新增适配 日程日历 插件页面，并新增配套最近日程小组件，可安装后体验

优化

• 卡片悬浮效果，移动端自动屏蔽
• 优化PC端以及移动端文章卡片显示样式
• 部分设置项说明优化

修复

• 修复所有小组件主题色装饰线未与标题对齐的问题

• 修复移动端文章卡片封面不铺满卡片的问题

• 修复音乐播放器 401 的问题 #11

• 修复公告移动端不显示的问题 #13

• 修复 CodeQL 安全扫描告警（构建产物 HTML 注释清理健壮性、外链弹窗头像 URL 协议白名单防 XSS）

其它

• 版本号提升至 V1.1.0
• 更新 README
• 新增 GitHub Issue 模板 by @Helio-RC
• 依赖与构建工具链安全告警清零 by @Helio-RC in #10

TODO

• 全屏（透明） Banner 、访客前台快速切换样式等功能将在 v1.1.x 版本陆续实现，如果您有更好的建议欢迎提交反馈

变更完整日志: v1.0.8...v1.1.0

---

Generated from v1.1.0

本次更新带来全新的主题切换动画，并主要围绕页面加载性能与交互稳定性做了系统优化：热门文章与图片加载策略重写，降低请求量与布局抖动；外链安全校验、无障碍体验与稳定性问题一并完善，整体体验更流畅。

本版本大部分功能与优化 by @Helio-RC in #8 #7 #4 贡献，在此表示感谢！

欢迎加入 QQ 交流群：点击加入交流群

tips

• 此次更新主题后建议执行重载主题配置 & 清除模版缓存，确保主题使用正常。

新增

• 主题切换动画：切换深浅色时新增淡入淡出 / 圆形扩散 / 擦除三种过渡动效，可前往「主题设置 → 样式 → 配色切换动画」配置
• 底部波浪：开关升级为三选（关闭 / 开启 / 移动端关闭），可前往「主题设置 → 样式 → 底部波浪效果」配置

优化

• 热门文章：改用服务端按访问量排序，单请求获取榜单，替代原先"先取总数再全量拉取"的两步请求，加载更快、接口压力更小
• 首屏加载：文章正文图片懒加载并预留空间（加载前按比例占位、加载后自动修正），减少首屏请求与页面抖动
• 动画节流：后台标签页自动暂停横幅文字、波浪等动画，回到前台继续，减少资源占用
• 目录高亮：滚动时高亮跟随更平滑，切换页面更跟手
• 页面加载：朋友圈相关脚本改为仅朋友圈页面加载，其他页面不再加载多余脚本
• 缓存更新：静态资源统一追加版本指纹，主题升级后旧缓存自动失效，刷新即可生效
• 认证页同步：登录 / 注册等页面配色与主站明暗设置保持一致
• 无障碍：优化读屏软件兼容、弱对比度文字、键盘操作（音量 / 进度滑块、菜单展开）、搜索框与首页标题等细节

修复

• 安全性：外链跳转与友链 / 装备等用户填写内容加强协议校验，拦截 javascript: 等危险链接，防止恶意脚本执行
• 安全性：新窗口打开的链接补充安全属性，防止新页面反向利用当前页面
• 点赞 / 投票：失败自动回滚（撤销已赞状态与计数）并抖动提示；点赞后 5 秒冷却，防连点刷接口
• 随机访问：随机访问 / 随机钓鱼仅从正常 http(s) 链接中随机，危险链接不进候选
• 天气小组件：接口限流时不再反复重试（避免请求放大），直接显示缓存或错误提示
• 翻页稳定性：修复多次翻页后随机访问可能重复跳转、友链申请可能重复提交的问题

其它

• 清理死代码与冗余逻辑
• 文章正文补充无脚本降级显示
• 开发维护：修复依赖锁定文件与依赖清单不一致，统一包管理工具版本，避免反复出现无谓的文件变动
• 更新 README
• 版本号提升至 v1.0.8

变更完整日志: v1.0.7...v1.0.8

---

Generated from v1.0.8

本次更新主要优化主题的整体体验，包括统计字数准确性、热门文章覆盖范围与页面加载性能，并修复若干细节问题。主题功能逐渐增加完毕以及稳定，后续将拉长发版间隔，避免更新过于频繁。

优化

• SEO 完善：为缺少 meta description 的页面自动添加描述，并补齐三套语言包（中/繁/英）的页面描述文案 by @Helio-RC in #3
• 页面标题与分享信息：18 个页面的 title/OG 标签统一由 Layout 输出，删除重复与空值，避免分享平台读到空链接、重复标题 by @Helio-RC in #3
• 首屏加载：文章封面与相册图片预占空间，避免页面加载时布局抖动；客户端脚本按需加载，减少不必要的请求 by @Helio-RC in #3
• 站点统计字数：总字数优先使用 API 扩展包 插件服务端统计，精确且零请求，未安装插件时自动回退客户端兜底统计 by @Helio-RC in #3 ；两套统计规则现已统一，字数显示更一致、误差更小
• 热门文章：新增会话缓存，切换页面不再重复请求列表接口 by @Helio-RC in #3 ；同时不再受固定 50 篇限制，改为先获取文章总数再拉取全量，按访问量排序取前五，避免老文章因篇数超限无法上榜
• 样式细节：站点统计五组图标统一为圆角风格，归档页副标题图标更新，无封面文章卡片宽度自适应

修复

• 修复 iOS 下页面缩放与横竖屏适配问题 by @Helio-RC in #3
• 修复客户端入口脚本输出位置问题 by @Helio-RC in #3
• 修复部分组合下分类小组件更多按钮失效的问题

其它

• 更新README
• 版本号提升至 v1.0.7

变更完整日志: v1.0.6...v1.0.7

---

Generated from v1.0.7

新增

• 文章打赏：新增文章打赏功能，可在「主题设置 → 文章 → 文章操作栏」中配置打赏文案与收款图片
• 文章操作栏设置：新增文章操作栏设置组（启用/点赞/分享/打赏），可在「主题设置 → 文章 → 文章操作栏」中配置
• 友情链接自助提交：新增友链自助提交功能，访客可在友链页直接填写信息提交申请，需链接管理插件为最新测试版（2.3.0-beta 及以上），可在「主题设置 → 友情链接 → 功能开关」中开启

优化

• 分享海报：海报高度按内容动态计算，避免固定高度留白，摘要超长截断省略号
• 代码精简：精简重复代码，优化图片加载逻辑，提升页面加载速度
• 还有一些你可能并不在意的UI样式优化……

修复

• 安全：修复外链跳转弹窗安全漏洞
• 点赞数量：修复新访客看不到文章点赞数量

其它

• 版本号提升至 v1.0.6
• 更新 README

变更完整日志: v1.0.4...v1.0.6

---

Generated from v1.0.6

重构

• 主题登录认证界面：重构登录认证界面，引入动画角色交互面板，登录交互更生动有趣，前往「主题设置 → 认证」切换体验

新增

• 公告小组件：新增公告小组件，可在「主题设置 → 侧边栏设置页 → 公告小组件」配置公告内容并展示
• 一言 API 可配置：一言小组件支持自定义 API 地址和获取失败文案，可在「主题设置 → 侧边栏设置页 → 小组件设置 → 一言」中配置
• 主题署名开关：新增主题署名开关，可在「主题设置 → 页脚 → 显示主题署名」关闭或开启署名显示
• 随机访问/钓鱼动效：友情链接页面随机访问与朋友圈随机钓鱼跳转新增动效
• 图片处理：图片处理新增 Banner 与头像设置，可在「主题设置 → 速度优化」中配置

优化

• 个人简介设置迁移：个人简介小组件部分设置项迁移，设置项更加明了
• 小组件边距统一：各小组件边距统一调整，视觉更整齐
• 图片处理：优化图片处理默认值，精简重复的模板表达式
• 外部字体：外部字体改为非阻塞加载，JS 打包优化
• 菜单栏二级菜单：补齐点击内凹效果

修复

• SEO 描述：修复 meta description 标签缺少 th: 前缀，导致搜索引擎抓取到字面模板文本的问题 by @Helio-RC in #2
• 个人简介跳转：修复个人简介跳转 /login 一瞬间样式散架问题
• 友情链接随机访问：修复友链随机访问自定义分组失效问题，随机访问改回 DOM 方案实现
• 图片处理：修复图片自定义格式失效、正文图片双重加载与空跑问题
• 分享海报：分享海报摘要改为读取 Halo 后台数据，不再依赖摘要框开关
• 安全：修复潜在安全风险

其它

• 版本号提升至v1.0.4
• 更新README

tips

• 本次更新改动较多，建议更新完成后执行清除模版缓存，如遇页面显示异常可重启 Halo 服务
• 如遇到主题使用问题或意见反馈欢迎前往issues

新贡献者

• @Helio-RC 在 #2 中完成了他们的首次贡献

变更完整日志: v1.0.3...v1.0.4

---

Generated from v1.0.4

重构

• 朋友圈页面UI：改用时间轴布局样式流式加载列表，页面更加美观便捷，同日期同一作者的文章自动归入同一卡片

新增

• 朋友圈黑名单：可在主题设置 → 朋友圈设置页 → 屏蔽列表 进行设置
• 卡片悬浮效果：可在主题设置 → 样式设置页 → 卡片悬浮效果 打开或关闭，打开后部分卡片鼠标悬停时轻微上移并显示主题色阴影
• 文章页支持与分享卡片：可在主题设置 → 文章设置页 → 启用文章操作栏 打开或关闭，打开后文章页面将显示支持与分享卡片，点赞+生成海报分享功能

优化

• 按钮交互：部分按钮图标增加 hover 旋转动效
• 瞬间动态卡片：瞬间页面动态卡片右上角增加引号装饰
• 目录小组件：目录小组件条目增加 hover 位移动效，与其它小组件统一
• 各页面卡片入场动画：各个页面卡片入场动画优化并统一
• 随机访问优化：友情链接页面随机访问功能优化，改用官方链接管理插件API
• 装备卡片点击逻辑优化装备库页面卡片点击跳转逻辑，现在点击卡片即可跳转

修复

• 装备库页面每页数量不跟随插件设置问题
• 加上了部分卡片缺失点击的内凹效果

其它

• 移除了未生效的项目集的分页控件代码，现在项目集页面无分页功能
• 清理冗余依赖及死代码
• 移除了适配和体验并不好的卡片3D倾斜效果，使用用卡片悬浮效果代替
• 更新README
• 版本号提升至1.0.3

tips

• 本次更新改动较多，建议更新完成后执行清除模版缓存，如遇页面显示异常可重启 Halo 服务
• 如遇到主题使用问题或意见反馈欢迎前往issues

新增

• 适配项目集插件
• 支持自定义字体（主题设置-样式-启用外部字体，当前仅支持全局替换）#1

优化

• 统一各页面标题UI与间距样式
• 自定义页面不再始终隐藏评论区，改为跟随 Halo 页面设置 #1

应该是没Bug吧

修复

• 朋友圈部分文章溢出卡片

其它

• 版本号提升至 v1.0.1
• 更新 README

当前版本没有发布说明