v1.0.14

熹屿 Xiyu 的首个公开发布版本。这一版把主题标识统一为 theme-xiyu，并集中修复了浮动按钮语义、长内容溢出与可访问性问题。
如果你此前安装过旧标识 theme-azure-isle，请先看下方「升级说明」——两者在 Halo 里是两个不同的主题身份，需要卸载重装。

新增

首页「返回文章列表」浮动按钮

后台「浮动按钮行为」新增该选项：首页点击按钮会平滑滑到文章列表、跳过首屏 Banner，不跳转、不刷新、不改地址；文章页、归档页、分类页等其他页面仍然是回到顶部。滚动落点已扣除吸顶页眉高度，实测误差 0。
页脚 Powered by 署名

版权行末尾新增 Powered by Halo · XiYu，Halo 与主题名分别链到 halo.run 和主题仓库。新增两个设置项：footer.show_powered（开关）与 footer.theme_repo_url（换仓库时可改）。桌面端为右下角浮动按钮预留 54px 空间，移动端同步留白，二者不再重叠。
主题图标与站点图标

提供线条版图标（海平线 + 从水面升起的岛弧）：logo.svg 用 currentColor 跟随文字颜色，favicon.svg 为深墨绿圆底配米白线条。站点未设置 favicon 时自动作为兜底，Console 主题卡片使用同一枚图标。
首屏与作者页的可配置项

首屏高度、Banner 模糊度、标题类型（文字 / 图片）均可配置；作者页提供可开关的 MBTI 卡片，含类型、中英别名与四条维度占比。

修复首页浮动按钮选「返回文章列表」后仍然只是回到顶部

按钮此前在所有页面都执行回顶，选项形同虚设。现在按页面语义分流：仅在首页滚动到 #post-list，其他页面回到顶部；图标、title 与 aria-label 也随之切换。
修复长标题、长 URL 撑破页面布局

文章标题、归档列表、正文链接与侧栏卡片补充 overflow-wrap:anywhere；侧栏网格列改为 minmax(0,1fr)，避免长词把整列撑宽、导致首页出现横向溢出。
修复页脚署名被浮动按钮遮挡

页脚在有按钮时自动让出右侧空间，XiYu 不再被按钮压住；移动端取消强制不换行，窄屏可完整折行显示。
修复分享卡片显示「站点标题」占位

模板中的静态占位文本统一改为品牌名「熹屿 Xiyu」。此前若被链接预览抓取器读到模板源码，卡片标题会显示成「站点标题」。
修复亮色模式次要文字对比度不足

--l-text-muted 由 #8a9490 调深至 #636e68，对比度从 2.83:1 提升到 4.81:1，同时保留「正文 → 次要 → 弱化」的层级梯度。
修复无摘要内容输出空分享描述

og:description 与 twitter:description 在内容没有摘要时不再输出空标签。
修复错误页缺少 noindex、友链验证码空图请求

错误页补充 noindex；友链申请表单的验证码图片默认隐藏，未取到图时不发起空请求。

主题标识由 theme-azure-isle 改为 theme-xiyu

metadata.name、settingName、configMapName 与打包产物名同步变更；模板内的静态资源路径由构建期读取 theme.yaml 自动生成，无需手改。
Console 主题图标改为包内资源

spec.logo 指向主题包内的 /themes/theme-xiyu/assets/icon-256.png，与 Halo 自身的 status.screenshot 引用方式一致，不依赖外部 CDN。

从旧标识 theme-azure-isle 迁移：Halo 以 metadata.name 作为主题身份，旧主题无法直接升级到本版本。请先卸载旧主题，再安装本 ZIP，然后重新设置一遍——旧配置存于 theme-azure-isle-configmap，不会自动迁移到 theme-xiyu-configmap。
从 1.0.13 及更早版本升级：控制台「外观 → 主题 → 安装」上传新 ZIP 即可覆盖升级，现有设置保留。
若此前调整过浮动按钮行为，升级后请确认选项符合预期——「返回文章列表」只在首页滚动到列表，其他页面回顶。
建议升级后在手机端检查一次：抽屉菜单、目录展开、列表视图切换。

Halo 2.26.0 或更高版本（已在 Halo 2.27.2 实测通过）
建议启用官方链接插件 plugin-links 2.5.0（友链、友链申请、朋友圈动态）；未安装时对应页面显示空态，不影响其他页面渲染
可选插件：plugin-equipment 1.1.1、plugin-steam 1.0.0
现代浏览器（Chrome / Edge / Safari / Firefox），支持 prefers-reduced-motion 与 prefers-color-scheme

Full Changelog: https://github.com/YBRC114514/halo-theme-xiyu/commits/main