v1.0.19

这一版给友链页的「站点信息」补了一行 图标：显示站点图标的完整地址，右侧按钮一键复制，访客申请友链时不用再猜你的 favicon 在哪儿。

_{桌面端实测：图标行位于「网址」下方，显示完整地址（而非缩略图），右侧复制按钮可直接填进友链申请}

新增

• 「站点信息」新增图标行

  访客填友链申请时，图标字段常被留空或填成看图才懂的相对路径。现在「友链页 → 站点信息」多出「图标」一行，显示的就是可直接粘贴的完整地址：

  名称   熹屿 Xiyu
  网址   https://example.com
  图标   https://example.com/upload/logo.png   ← 一键复制
  简介   一座为文字留白的岛。
  RSS    https://example.com/rss.xml
  

• 图标来源可自定义，留空自动跟随站点

  优先级	来源	设置位置
  1	图标地址（外链 / 图床）	友链页 → 站点信息 · 图标地址
  2	上传附件	友链页 → 站点信息 · 图标
  3	Halo 站点图标（favicon）	设置 → 基本设置 → 站点图标
  4	站点 Logo	设置 → 基本设置
  5	主题内置 favicon	兜底，不会出现空白

  一般来说什么都不用配：只要后台设过站点图标，这里就自动显示它，零配置可用。

细节

• 只显示地址，不显示缩略图

  站点图标多是宽幅手写 logo（例如 237 × 54），缩略图要么被压成细条、要么把小方块撑变形，反而不如直接把地址写清楚。因此这一行只输出纯文本地址 + 复制按钮，长度不省略、超长按词换行。

• 相对路径补全为完整链接

  附件库给出的常是 /upload/xxx.svg 这类相对路径，直接复制走会失效。现在会自动补成 http(s)://你的域名/upload/xxx.svg；//cdn.example.com/x.png 这种协议相对地址补成 https://；本来就是完整外链的原样输出。复制按钮复制的也是补全后的地址。

• 行序与视觉保持一致

  图标行固定排在「网址」下方（桌面与手机一致），行高与相邻行对齐，暗色模式下文本对比度足够，桌面 / 390px / 360px 三种视口均无横向溢出。

升级说明

• 控制台「外观 → 主题 → 安装」上传本 ZIP 覆盖升级，现有设置全部保留。
• 升级后无需任何配置：会在「网址」下方自动多出一行图标地址；想换成自己的图标，到「友链页 → 站点信息 · 图标地址 / 图标」填写即可。

兼容性

• Halo 2.26.0 或更高版本（已在 Halo 2.27.2 实测通过）
• 建议启用官方链接插件 plugin-links 2.5.0（友链、友链申请、朋友圈动态）
• 可选的第三方友链申请插件：LinksSubmit（要求 Halo ≥2.20.14）
• 可选插件：plugin-comment-next 1.1.1、plugin-moments 1.19.0、plugin-hitokoto-hub 3.0.0、plugin-equipment 1.1.1、plugin-steam 1.0.0
• 现代浏览器（Chrome / Edge / Safari / Firefox），支持 prefers-reduced-motion 与 prefers-color-scheme；不支持 color-mix() 的旧内核走实色回退

验证

本地 Halo 2.27.2 热升级至 1.0.19 后实测，图标专项 26 项全过：

• 行位置：紧跟「网址」之后（桌面 / 手机均为第 3 行），行序为 名称 → 网址 → 图标 → 简介 → RSS
• 呈现：不渲染缩略图、纯文本可换行、无省略号截断、复制值等于完整地址、复制按钮带无障碍标签
• 回退：图标地址 → 上传附件 → Halo 站点图标 → 站点 Logo → 主题内置 favicon，五级顺序与优先级正确
• 链接补全：站内相对路径补成 http://域名/...、协议相对地址补成 https://...、完整外链原样输出
• 布局：超长地址完整输出且可断词换行，桌面 / 390px / 360px 无横向溢出，图标行与相邻行高度接近，暗色模式文本可读

回归：LinksSubmit 申请分支 23 项、品牌标识 26 项、横幅与随机访问 29 项，均 0 失败。

Full Changelog: https://github.com/YBRC114514/halo-theme-xiyu/compare/v1.0.18...v1.0.19

新特性

• 首页商品列表块支持选择商品分类进行筛选，选择父分类时包含子分类商品；清空分类后恢复展示全部商品，“查看全部”会携带相同分类跳转

问题修复

• 修复页脚社交信息中选择图片类型时未在弹窗中查看图片、而是直接跳转链接的问题；现在点击后可在弹窗中预览图片，并支持通过关闭按钮、遮罩或 Esc 关闭

主题文档
插件相关配置
新版朋友圈配置说明
留言板配置说明

版本说明

修复

• Halo 升级 Thymeleaf 3.1 后，@font-face 会被误判为 bean 引用，导致页面报错（禁止实例化对象/访问静态类）。现已将字体样式表达式改写，CSS 输出保持不变。受影响的站点升级至本版本即可恢复正常。

Full Changelog: 1.26.0...1.26.1

Generated from 1.26.1

v1.0.18

这一版把站点左上角的标识做成了可替换的：可以直接上传图片（含 SVG）当标识，也可以填图片地址或粘贴内联 SVG 代码，还能选择「只显示标识、不显示站名」。

新增

• 左上角标识支持三种来源

  「首屏 → 左上角标识」现在按优先级依次取用：

  优先级	设置项	用法
  1	内联 SVG 代码	把 <svg>…</svg> 源码直接粘进来，不用上传；可用 currentColor 跟随主题色
  2	图片地址	填完整的图片网址，https://…/logo.svg 这类外链也能用
  3	图片附件	点「选择」直接上传 PNG / JPG / SVG

  三者都留空时仍回退到站点 Logo，再没有就用站名首字，原有行为不变。

• 「只显示标识、不显示站名」开关

  标识本身已经是完整字样（宽幅 logo、手写体 lockup）时打开，胶囊里只保留图形并自动收紧内边距，不会出现「图形里写着站名、旁边又重复一遍站名」的情况。

• 关于上传 SVG

  Halo 支持 SVG 附件（image/svg+xml），主题里点「选择」就能直接上传 .svg。唯一的坑是默认存储策略的允许类型只有「图片 / 视频 / 音频」，没勾 SVG 时会返回 415 不支持上传 image/svg+xml 类型的文件；到后台「附件 → 存储策略」编辑当前策略，把 SVG 勾进允许类型后，上传、选择、前台渲染全链路实测正常。不想动存储策略也可以走「图片地址」或「内联 SVG 代码」。

修复

• 宽幅 SVG 标识被压成小方块

  原来所有标识都套在 36 × 36 的圆框里，宽度是高度四倍多的宽幅 logo 会被缩成一条看不清的细线。现在 SVG 标识改为按高度等比缩放：桌面高 32px、宽度上限 168px，手机高 26px、宽度上限 96px，比例不变、不裁切（object-fit: contain）。

• 手机端左右两块胶囊一高一矮

  左侧品牌胶囊（头像 + 站名）原本 50px 高、右侧搜索 / 收藏 / 菜单按钮组 42px，视觉上明显不齐。现在两者统一为 44px 并顶部对齐，标识图片在窄屏收到 32px。宽幅 SVG 标识也一并收窄（≤96px），390px 与 360px 视口都无横向溢出。

• 内联 SVG 的安全过滤

  粘贴的代码必须包含 <svg>，且含 <script>、javascript:、onload=、onerror= 时会被忽略并回退到图片 / 站点 Logo，不会把可执行内容注入页面。

升级说明

• 控制台「外观 → 主题 → 安装」上传本 ZIP 覆盖升级，现有设置全部保留。
• 想用附件方式上传 SVG，请先把 SVG 勾进「附件 → 存储策略」的允许类型；不想改策略就用「图片地址」或「内联 SVG 代码」。
• 标识文件里自带的 CSS / SMIL 动画（比如手写描边动效）在 <img> 与内联两种方式下都会照常播放；若想让它静止显示，删掉 SVG 里的 <style> 块即可。

兼容性

• Halo 2.26.0 或更高版本（已在 Halo 2.27.2 实测通过）
• 建议启用官方链接插件 plugin-links 2.5.0（友链、友链申请、朋友圈动态）
• 可选的第三方友链申请插件：LinksSubmit（要求 Halo ≥2.20.14）
• 可选插件：plugin-comment-next 1.1.1、plugin-moments 1.19.0、plugin-hitokoto-hub 3.0.0、plugin-equipment 1.1.1、plugin-steam 1.0.0
• 现代浏览器（Chrome / Edge / Safari / Firefox），支持 prefers-reduced-motion 与 prefers-color-scheme；不支持 color-mix() 的旧内核走实色回退

验证

本地 Halo 2.27.2 热升级至 1.0.18 后实测：

• 标识专项 26 项：附件 SVG 渲染为 img 且 object-fit: contain、内联 SVG 高度 32px 与 currentColor 生效、含 <script> 的代码被忽略并回退、三项全空回退站点 Logo / 首字、宽幅 SVG（237 × 54 手写 lockup）等比缩放不被压扁、隐藏站名后不输出文字并收紧内边距、手机端收窄、左右胶囊等高对齐且 390 / 360 视口无横向溢出
• 回归：横幅标签化 20 项、抽屉 / 箭头 / 页脚 18 项、两套文章模板渲染、横幅与随机访问动画 29 项、LinksSubmit 申请分支 23 项，均 0 失败

Full Changelog: https://github.com/YBRC114514/halo-theme-xiyu/compare/v1.0.17...v1.0.18

• 外观：新增「背景默认显示」开关，关闭时首次访问只显示主题渐变；开启后首次访问即显示已配置的图片或视频，访客保存过的切换选择优先。
• 外观：新增「导航栏显示分类图标」开关，只为配置了图标的分类展示图标，没有图标时不占位。
• 背景：站点默认显示不再被当作访客偏好写入本地存储，管理员关闭默认显示后老访客会按新设置生效；访客第一次点击背景按钮即可正确关闭背景，不再依赖延迟落盘的存储状态。
• 背景：视频背景改为在模板中预渲染，配合首屏属性在绘制前命中，避免先闪出主题渐变；自动播放失败或源站不可达时回退无背景。
• 页脚：访问统计新增独立的前台显示开关，在备案行上方展示今日浏览、今日访客与累计浏览；关闭记录后仍展示已统计的数据。
• 性能：页脚统计聚合结果缓存 5 秒（与计数落盘周期一致），公开页热路径不再每次渲染都全量读取访问统计；读取异常回退 0，不影响导航页显示。
• 基本设置：ICP 与公安备案支持上传图标、从附件库选择或填写图片地址，留空只显示备案号文字。
• 修复：快捷导航下拉框宽度贴合菜单项文字，长名称省略显示。

新特性

• 新增决策模型支持：内置 TypeSafe 与 AIHubMix 服务商可直接执行决策请求，返回是否概率、选项与有序评分，并提供跨服务商一致的 Java 与 npm 决策客户端 by @ruibaby in #129
• 模型选择器新增服务商筛选栏，可按服务商快速过滤模型列表，搜索与分组行为保持不变 by @ruibaby in #133

功能优化

• 发现的模型能力可由 models.dev 精确补全，仅在服务商、端点与模型 ID 完全匹配时生效，支持后台同步、持久缓存与手动刷新 by @ruibaby in #128
• 服务商类型选择支持搜索，服务商较多时更易定位 by @ruibaby in #127
• 精简插件内置的 SQLite 原生库，仅保留 macOS、Linux、Linux Musl、Windows 的 ARM64 与 AMD64 版本，安装包体积减少约 6.57 MiB；其他系统与架构不再内置 SQLite 原生库 by @ruibaby in #130
• 优化决策问题列表的选中状态显示

问题修复

• 修复模型测试工作台中审批续答沿用旧请求、过期流式快照覆盖新状态、外部工具结果重复提交、刷新后测试模式丢失等问题 by @ruibaby in #132

Full Changelog: v1.3.0...v1.4.0

Generated from v1.4.0

Full Changelog: v1.1.0...v2.0.0

feat: 接入 Swup 实现页面无刷新过渡与分页

Generated from v2.0.0

注意：此版本将最低 Halo 版本要求提升至 2.27.0，升级插件前请先将 Halo 升级到 2.27 或更高版本。

新特性

• 新增多款代码高亮配色方案：Catppuccin（Mocha、Macchiato、Frappe、Latte）、Gruvbox Material（深色与浅色）和 Dracula by @DanielZhangyc in #40

功能优化

• 复制按钮支持印度尼西亚语 by @Manssizz in #46
• github-auto 配色跟随站点的 data-theme 属性切换明暗样式 by @WittF in #41

问题修复

• 修复 github-auto 配色在明暗切换下复制按钮样式错误的问题 by @VoidYun in #38

开发者相关

• 构建工具链升级到 Halo 2.27 平台（Java 21），UI 构建从 Rsbuild 迁移到 Vite 8

Full Changelog: v1.3.2...v1.4.0

Generated from v1.4.0

注意：此版本将最低 Halo 版本要求提升至 2.27.0，升级主题前请先将 Halo 升级到 2.27 或更高版本。

新特性

• 支持 Halo 2.26 页面布局契约，插件前台页面可复用主题的页头、页脚、样式与脚本。

功能优化

• 页脚菜单改用 Halo 2.27 的批量菜单查询，减少重复查询；保留菜单顺序、自动去重并跳过不存在的菜单。
• 优化无障碍与 SEO：补全页面标题层级和站点标题，外链按场景添加 noopener、noreferrer 与 nofollow。
• 轮播图配置改为带条目标签的数组表单，列表直接显示封面和标题。

注意：此版本将最低 Halo 版本要求提升至 2.27.0，升级主题前请先将 Halo 升级到 2.27 或更高版本。

功能优化

• 页脚菜单改用 Halo 2.27 的批量菜单查询，减少重复查询；保留配置顺序，自动去重并跳过不存在的菜单。

开发者相关

• 发布 @halo-dev/shiki-code-element 1.4.4

依赖更新

• 升级 Shiki 至 4.6.0
• 升级前端依赖至最新兼容版本，包括 Vue 3.5.44、Vite 8.3.5、UnoCSS 66.11.0 等 by @ruibaby in #40

Full Changelog: v1.5.1...v1.5.2

Generated from v1.5.2

注意：此版本将最低 Halo 版本要求提升至 2.27.0，升级主题前请先将 Halo 升级到 2.27 或更高版本。

新特性

• 新增 layout.html 页面布局契约，插件前端页面可复用主题的页头、页脚、样式与响应式页面骨架。

功能优化

• 页脚菜单改用 Halo 2.27 的批量菜单查询，减少重复查询；保留配置顺序，自动去重并跳过不存在的菜单。

问题修复

• 移除布局中重复的站点标题标签，页面标题只由各页面自己的 head 内容输出，避免 title 元数据重复或冲突。

功能优化

• 缓存表单跟踪配置，页面渲染时直接复用已生成的跟踪脚本，避免每次请求都重新加载表单和已发布修订。
• 缓存自动表单显示配置，路由匹配和 JSON 拼接不再重复查询数据库；表单、修订、旧版模板或迁移记录变化时自动失效。
• 并发请求共享同一次加载，加载失败会重试；插件停止时释放配置监听。

问题修复

• 重建跟踪与显示配置时排除已软删除的修订和资源，避免删除后的配置仍被注入页面。

首个版本。把 tinytraffic（自托管、不使用 Cookie 的网站统计工具）接入 Halo。

功能

• 统计脚本：在主题每个页面的 head 内注入 tinytraffic 统计脚本，支持站点域名、Hash 路由、出站链接、自定义脚本地址和上报地址，可以选择不统计已登录用户。
• 访问统计页面：在控制台查看访客、访问次数、浏览量、每次访问浏览量、跳出率、访问时长的趋势，以及来源、页面、地区、设备、目标的排行。点击任意一行即可筛选，支持各种时间范围和表格视图。
• 仪表盘小部件：显示过去 24 小时的访客数和当前在线人数。
• RSS 阅读量：安装了 RSS 订阅插件时，把 RSS 阅读器中的文章阅读量上报到 tinytraffic，来源记为 RSS。
• 权限：提供「查看访问统计」权限模板，可以单独授予非管理员角色。

API 密钥保存在 Halo 的密钥（Secret）中，只在服务端使用，不会发送到浏览器。

安装

1. 下载下方的 plugin-tinytraffic-1.0.0.jar。
2. 在 Halo 控制台的「插件」中上传并启用。
3. 按 README 填写 tinytraffic 地址和 API 密钥。

要求

• Halo 2.27.0 或更高版本（在 2.27.2 上验证）
• 一个已经部署好的 tinytraffic

Full Changelog: v1.0.7...v1.0.8

Generated from v1.0.8

Full Changelog: v1.0.6...v1.0.7

Generated from v1.0.7

Full Changelog: v1.0.1...v1.0.2

feat(moment): 重构瞬间卡片布局，实现内容滚动和页脚固定底部

调整卡片为弹性列布局，将文本类样式重命名为 body 以适配图文共用滚动区域，添加滚动条隐藏和行为控制。修改 HTML 结构使文本和媒体内容整合到 body 容器，同时将页脚设置为自动边距以固定在卡片底部，避免等高卡片出现底部留白。

Generated from v1.0.2

feat: 适配 Halo 2.27.0，新增多分类展示与可配置品牌文案

• 新增主题设置：英文标语、首屏背景大字、眉题、页脚标语
• 文章/归档/瞬间等页面支持多分类链接展示
• 深色模式同步 Halo 插件组件的 data-color-scheme 属性
• 新增打包脚本避免 pnpm-lock.yaml 被误打进主题包
• 升级主题版本至 1.0.1，兼容 Halo >=2.27.0

What's Changed

• feat(links): 添加隐藏友链页面评论区配置 by @AR-26710 in #210
• feat(user-auth): 添加带重定向的登录登出链接，支持返回操作前的页面 by @AR-26710 in #211
• style: 调整侧边栏和布局的高度，高度延伸到页面底部 by @AR-26710 in #212

Full Changelog: 1.6.19...1.7.0

Generated from 1.7.0

功能优化

• 单页面工具的创建、更新、查询与列表接口支持摘要字段，可手动设置摘要或控制自动生成，并与文章工具保持一致 by @ruibaby in #21

Full Changelog: v1.3.3...v1.4.0

Generated from v1.4.0

新增与改进

• 新增智能搜索，在 Halo 官方搜索框中提供语义查找和带来源的流式 AI 解答，保留关键词搜索、历史记录与键盘导航；支持随机推荐和热门文章，帮助读者发现站内内容。
• 新增热词注释，结合文章上下文解释生僻词、专业术语与缩写，支持悬停、点击和键盘查看；可在后台生成预览，按文章保存结果并在正文更新后重新生成。
• 新增独立「MCP 工具」管理页，支持连接远程工具服务、发现和选择工具、设置登录要求与执行前确认。前台展示可用工具、调用状态和结果卡片，历史会话可恢复结果并继续追问，后台可查看调用记录与耗时。
• 更新项目介绍和配置文档，补齐智能搜索、热词注释、MCP 服务及前台助手的使用说明。

问题修复

• 修复手机端助手全屏后页头按钮越界、无法关闭的问题；适配窄屏、横竖屏及可见视口变化，支持 Escape 退出，全屏时隐藏悬浮宠物，避免遮挡会话内容。（#45）
• 修复旧浏览器中助手面板、文字和按钮配色异常的问题，改进浅色、深色及跟随系统模式，修正预设配色无法正常切换深色主题的情况。（#44）
• 修复反向代理场景下知识库管理请求可能被错误拒绝的问题。
• 完善 MCP 调用确认、结果恢复及运行时兼容处理，避免工具调用影响后续对话。

使用说明

• 需要 Halo 2.25+，并安装、启用 Halo AI Foundation；已有配置继续保留，功能通过「智阅 AI」工作台管理。
• 智能搜索扩展需要 Halo 官方搜索组件，当前适配 1.7.1；启用前请导入公开文章并完成知识库索引。语义检索和 AI 解答只使用当前公开发布的文章，输入关键词不会触发模型调用。
• MCP 接入支持远程 Streamable HTTP 服务。在「MCP 工具」中选择开放的工具，并按需设置登录与确认要求后启用。
• 灵构自定义摘要仍需 Halo 2.26+、灵构 UI 1.0.3 或更新的兼容版本。

使用文档 · 智能搜索 · 热词注释 · MCP 服务

Generated from 4.1.0

内容安全首个正式版本，适用于 Halo 2.27.0 及以上版本，需安装并启用应用市场集成插件 1.x。

新特性

• 在用户注册、资料修改、评论与回复写入前检测文字与图片，拦截违规内容。
• 支持本地敏感词库、AI 模型、阿里云和腾讯云，可按场景配置检测服务与多服务执行方式。
• 提供提交频率限制、全站并发控制和服务商每日调用额度。
• 支持查询检测记录、资料变更与安全事件，按筛选条件导出 CSV / JSON，并生成合规报表。
• 支持检测故障、额度不足及异常提交等告警，可通过 Halo 通知、Webhook、Bark、钉钉、飞书和企业微信接收。
• 免费版提供本地词库、AI 检测、记录导出和 Halo 通知；云服务、多服务编排、词库文件上传、合规报表及高级告警配置需激活许可证。

开发者相关

• 提供公开 Java API，支持第三方插件贡献检测场景，并在保存业务数据前调用内容检测。

更新内容

1. 新增文章页大纲导航（响应 Issue #14）：由正文二/三级标题自动生成；宽屏（≥1200px）为文章右侧 sticky 玻璃侧栏，窄屏为浮动按钮 + 右侧抽屉。
2. 滚动高亮当前章节并保持其在列表内可见，页面底部兜底末条；点击条目平滑跳转，复用全局 scroll-padding-top，落点不被固定导航遮挡。
3. 渐进增强与无障碍：toc.js 构建并以 html.toc-ready 门控——禁用 JS、正文标题不足两个或开关关闭时整块不渲染且布局保持单栏；抽屉支持 Esc / 遮罩 / 关闭按钮收起，aria-expanded / aria-controls / aria-label 动态切换并管理开合焦点；尊重系统「减少动态」偏好。
4. 主题设置新增「文章页」组「显示文章大纲」开关（默认开启，未配置按开启处理，老站点升级即生效）。
5. 版本号按 minor 规则升至 1.4.0，README 与 CHANGELOG 同步。

真机验证

环境：Halo 2.26.1 本地真机（H2）+ headless Chrome CDP，41/41 断言通过。

1. 升级安装 1.4.0 保留既有设置，主题 READY；toc.js / style.css 正常下发并带 ?v=1.4.0 缓存破坏。
2. 桌面 1440：双栏网格、sticky 侧栏滚动中段仍固定、8 条目（5×h2 + 3×h3，h4 排除）、标题 id 唯一、scrollspy 中段与底部兜底、锚点落点不被导航遮挡。
3. 移动 390 / 320：浮动按钮可见、抽屉开合、焦点首条 / 归还按钮、body 滚动锁定、条目点击收起并跳转，无横向溢出。
4. 少标题文章整块移除且单栏；既有文章复用原生标题 id；禁用 JS 正文完整且单栏；三档视口控制台零报错。
5. 开关关闭变体包不渲染 toc-col / toc-fab，恢复官方包后回归正常。
6. 临时验证文章已清理，站点恢复 7 篇，全路径 200 / 404 符合预期。

升级方式

1. 下载附件 theme-luye.zip。
2. Halo 后台 → 外观 → 主题 → 升级上传（要求 Halo ≥ 2.26.0）。
3. 升级后大纲默认开启；如需关闭：主题设置 → 文章页 → 显示文章大纲。

附件校验

• 文件数：32
• SHA-256：07a2deca4e07f9fb674f10781731038c0161aa694797c8566154ed7afa7c0e98
• 最低 Halo 版本：2.26.0

相关 PR：#16；关闭 Issue #14。完整历史见 CHANGELOG.md。

在 1.3.3 基础上合并落地一轮性能、无障碍与可维护性优化。相关 PR：#15。

更新内容

1. 锚点修复：修复首页「看看我的文章」等锚点跳转落点被固定导航遮挡的问题，scroll-padding-top 按导航高度 + 12px 偏移（实测落点 88px ≥ 导航 76px）。
2. 无障碍：汉堡菜单动态切换 aria-expanded / aria-controls / aria-label，Esc 关闭并归还焦点；返回顶部尊重系统「减少动态」偏好；分页禁用态改为不可聚焦的 <span>（不再进入 Tab 序），可用态补 rel="prev/next"，移除 javascript: 伪链接。
3. 性能：文章封面、作者头像与 hero 图统一 loading="lazy" decoding="async"；天气画布 resize 防抖 150ms、仅宽度变化时重建粒子。
4. 视觉一致性：单色 SVG 图标改用 CSS mask 着色；行内代码、雾面渐变与滚动条（含 Firefox scrollbar-color）全部由强调色 --green 派生，主题设置改强调色后全站同步生效；补 theme-color meta。
5. 可维护性：置顶大卡抽取为 modules/post-featured.html 片段供列表/网格两分支共用（守卫置于外层 th:block，规避 th:replace 优先级陷阱）；visit-badge 片段自门控「显示文章浏览量」开关，调用方不再重复判断；删除四个冗余叶子 SVG。
6. 与 1.3.2 / 1.3.3 调和：沿用「置顶不要求封面、封面独立可选」语义与精选专题全量已发布筛选（外层 th:block 求值）；无 JS 降级统一为 reveal-ready 机制；保留 1.3.3 阅读排版（摘要 16px / 400、容器 1280px、置顶封面 3.4:1 / 移动端 2:1）。

真机验证

环境：Halo 2.26.1 官方 jar + H2 数据库、无头 Chrome（CDP）。

1. 正式 ZIP 升级安装成功，后台识别版本 1.3.5、主题 READY，既有主题设置保留。
2. 首页、归档、分类、标签、文章、独立页、作者页全路径返回 200，不存在路径按预期 404；多页数据下分页第二页正常（rel="prev/next"、禁用态为 span、无 javascript:）。
3. grid / list 双布局：无封面置顶文章仅渲染一次且不输出空封面图，既有置顶不重复；无封面置顶不进入精选专题。
4. CDP 禁用脚本后，首页 / 分类 / 标签页 .reveal 元素全部可见（reveal-ready 降级生效）。
5. 菜单 aria / Esc / 焦点归还、锚点落点、强调色注入联动 mask 图标与滚动条，逐项复核通过。
6. 1440 / 390 / 320px 三档视口均无横向溢出；控制台无主题侧报错。

升级方式

1. 下载本 Release 附件中的 theme-luye.zip。
2. Halo 后台 → 外观 → 主题 →「绿野 Luye」→ 升级 → 上传 ZIP。
3. 原有主题设置保存在 ConfigMap 中，升级不会丢失。

附件校验

• 文件数：31
• SHA-256：7364919a8918d9c8f4bd97ade33006b4600c7ebf30a31f92eccec39e38e37a29
• 最低 Halo 版本：2.26.0

SteamView v1.2.0 更新日志

⚠️ 本版本要求 Halo 2.27.0 及以上

新功能

• 玩家在线状态：资料头部实时显示「正在玩 XXX / 在线 / 离线」，状态约 1 分钟内同步 Steam 实际情况
• 徽章墙：展示 Steam 徽章与游戏徽章（含名称与图标），空间不足时自动横向滚动；Console 设置中可一键开关
• 仪表盘小组件：Console 仪表盘新增 Steam 展柜概览卡（玩家信息 + 总游戏数 / 总时长 / 近两周时长 / 活跃游戏数），手动添加即可使用
• 暗色模式：自动跟随站点主题切换，嵌入 iframe 时与父页面双向同步，编辑器块同步适配

安全

• Steam API Key 迁移至 Halo Secret 加密存储，不再明文保存（旧配置自动兼容迁移）
• 新增出站请求安全校验：强制 HTTPS、拒绝内网地址、限制响应大小

优化

• 游戏中文名持久缓存：已获取的本地化名称不再重复请求商店接口，刷新速度显著提升；受限网络环境每次刷新优先补齐最近游玩的游戏
• 刷新请求超时收敛，避免个别接口无响应时长时间卡顿
• 前台脚本地址携带版本号，插件升级后浏览器与 CDN 缓存自动失效

全能右键 1.0.0-beta3 为阅读场景增加本地工具和可选 AI 助手，并补齐菜单交互与运行时兼容性。

新增

• 摘句 PNG 分享卡、带来源的 Markdown 引用、保存与恢复本地阅读位置。
• 菜单分组、控制台场景预览和可选 AI 模型选择器。
• 基于 AI Foundation 1.1.1 的划词解释、举例与翻译，支持流式输出、停止、重试和复制。

修复与完善

• 复制失败反馈、危险链接协议校验、键盘焦点和导航、长菜单滚动、依赖未就绪时隐藏入口。
• PJAX 切页清除过期文章上下文，菜单项自动生成稳定标识。
• 修正新安装默认菜单初始化、匿名 AI 配置接口权限，以及控制台预览读取表单上下文。
• AI 默认关闭且默认仅登录用户可生成；可配置访客额度、每日总额和并发限制。

兼容与升级

• 基础菜单支持 Halo >= 2.25.0；AI 需 Halo >= 2.26.0 与 AI Foundation >= 1.1.1 且 < 2.0.0。
• 升级保留已有菜单，包括主动清空的列表；新动作需在插件设置中手动添加。
• 本地书签只保存在当前浏览器；AI 额度保存在进程内存，重启会重置。

验证

• 30 项后端测试、23 项前端测试、类型检查、ESLint 和完整 Gradle 构建通过。
• 隔离 Halo 2.25.4 / 2.27.0 验证插件加载、设置、权限与可选依赖行为。
• 真实 Halo 2.27.0 + AI Foundation 1.1.1 使用本地模拟供应商验证流式输出、错误帧、登录/访客策略、限额、并发与取消释放。
• 未调用真实商业模型供应商，未部署生产站点。

Generated from 1.0.0-beta3

• 日记更快：再次进入直接到密码框，超过半小时也不再全量扫描
• 日记更稳：新日记本启用 600k PBKDF2、8 位密码与强度提示
• 日记更顺手：右上角时间锁、解锁页改密、删除确认、备份明文提醒
• 写作页：草稿删除改站内确认，跨标签草稿切换更稳

本次更新主要完善 Halo 应用市场发布信息与主题配置，新增与其他 Next 主题的区分说明，方便用户了解和使用主题。

本次发布不涉及主题功能变更，升级无需额外迁移。

Generated from v1.0.1

• 重做 /pulse 页面视觉：以紫、蓝、琥珀三色区分指标，新增点阵网格背景、信号轨迹装饰、发光仪表环、等宽读数与更清晰的层级排版。
• 优化亮色与暗色主题的对比度、面板质感与状态页配色；错误状态使用琥珀色语义，登录状态沿用品牌色。
• 指标卡与「最近 2 分钟」趋势面板新增悬停反馈：抬升、指标色描边与光晕、图表提亮、图例强调。
• 趋势图改为平滑曲线与虚线网格，增加末端读数标记；压缩组件高度并移除图表内边框。
• 默认刷新间隔调整为 2 秒（可选 1–30 秒）；服务端按 1 秒采样，历史曲线保持 2 分钟窗口。
• 无障碍：实时状态文案仅在变化时更新，避免屏幕阅读器每秒重复播报。
• 性能：轮询数据未变化时跳过图表重绘，减少不必要的 canvas 渲染。

WarmIsland 暖屿 v1.2.7

合规与隐私

• 默认零第三方自动请求：移除 21 个模板对 cdn.jsdelivr.net 的 preconnect / dns-prefetch，脚本、样式、字体、图标、句子库全部随包自托管
• 移除远程运行时：文章页不再自带 PrismJS 1.29.0 / autoloader / qrcode-generator；代码高亮交由应用市场高亮插件或 API 扩展包，主题保留 Warm / Cold 本地配色；微信分享改为复制链接
• 三个可选 API 改为管理员显式配置
  • Hero「描述文案来源」默认「无」，不渲染一言元素、零请求；选「一言」时已预填 https://v1.hitokoto.cn/，留空则回退内置本地句子库
  • IP 定位主 / 备选接口默认留空，候选 https://myip.ipip.net/json、https://r.inews.qq.com/api/ip2city?otype=json
  • 仅填写后才会发起请求；IP 定位会暴露访客 IP，需自行在站点隐私说明中披露
  • 设置项提示精简为功能说明，完整披露统一放在 README「外部资源与隐私」
• README 新增逐项隐私披露与「原创声明」（完全原创、无上游派生）；LXGW WenKai 的 SIL OFL 1.1 全文随包，LightGallery 按 GPLv3 使用并去掉占位 licenseKey
• Logo 由两份 1024×1024 压缩去重为单份 256×256（约 146KB）

安全与稳定性

• 文章页 JSON-LD 不再用 th:utext 把标题 / 摘要 / 作者 / 封面拼进 <script>，改为「转义写入 <meta> → JSON.stringify → textContent」，避免脚本闭合标签注入
• 瞬间正文 content.raw 兜底改 th:text（4 处）；#strings.substring(x, 0, 1) 全部加判空，修复作者为空时页面 500
• 打包前置校验模板 / 资源 / 版本一致性，杜绝「升级后首页 404」的空壳包；compat/assets 保留历史哈希资源，旧缓存 HTML 不再请求到已删除的 CSS
• 新增 pnpm audit:external 与 pnpm smoke（JSON-LD 桩 DOM 验证），拦截远程加载、README 死链、字体许可证缺失；修正上架说明无效链接

功能与文档

• 修复正文引用块文字下方留白过大（外边距叠加），并折叠编辑器生成的空段落
• 「朋友圈」（plugin-friends）已不再提供：feed / RSS 聚合改由官方「链接管理」（PluginLinks）插件的订阅承担；新增订阅配置 / 页面文档，删除旧朋友圈文档；friends.html 与旧分组仅兼容旧站点
• 全文统一 Halo 要求为 2.27.0+，清理与代码不符的描述，补齐欢迎弹窗 / 订阅 / 微信读书三个分组文档（17 组 / 126 项全部有文档覆盖）
• README 精简重排（331 → 237 行），移除自证式合规宣言与回归清单，保留 5.1 披露、许可与原创声明

本次新增按规则配置的定时刷新，可实现「每日一图」「每小时换图」等场景。

新功能

• 每条规则新增「刷新方式」：每次请求随机（默认）、每分钟、每小时、每天、每周、自定义秒数
• 周期内访问同一路径固定返回同一张图片，到达自然周期边界自动换图
  • 每天：服务器本地 0 点
  • 每周：服务器本地周一 0 点
  • 每小时 / 每分钟：本地整点 / 整分钟
• 自定义秒数范围 1–31536000，按 Unix 时间戳对齐
• 无状态时间窗口实现：不需要后台任务或持久化，插件重启、多实例部署结果一致
• 旧配置无需迁移，未设置刷新方式的规则保持每次请求随机

修复与改进

• 分钟 / 小时窗口正确处理 DST 回拨（重复小时获得不同窗口）及 UTC+5:30 等非整点时区
• 跳过 metadata / name 异常附件，避免单条畸形数据导致整池加载失败
• 附件名单按名称哈希排序并预计算哈希，缓存重载不影响周期内图片映射

• 瞬间浮层更稳、更少跳动
• 日记阅读头部、首帧、忘记密码重建、备份按钮
• 日记 owner 数据隔离
• 表格对齐和编辑连续性修复

Rackora v0.10.3

修复

• 移动端打开目录抽屉（body.toc-open）时锁定底层页面滚动，避免滚动穿透；当视口拉宽至桌面端（> 960px）时自动收起抽屉遮罩，并在关闭抽屉时将键盘焦点归还给目录触发按钮。
• 代码块复制按钮补充连续点击定时器清理与失败状态自动恢复，避免快速点击时状态提前重置或复制失败后文案无法复原。
• 独立页面（SinglePage）补齐 rackora_index_policy 索引策略表单与 noindex,follow 输出，并统一归一化普通独立页与关于页 JSON-LD 中的 isPartOf.url。
• 文档模板（post_docs.html）补齐更新时间、核验日期与推广关系披露声明；当同分类仅含当前文档时隐藏冗余同分类列表，并在右侧栏无可见区块时自动折叠为单栏布局。

新增

• 正文图片灯箱支持展示 <figcaption> 或图片 alt 图注，并支持点击放大后的图片直接关闭灯箱。
• 启用搜索组件（PluginSearchWidget）时，支持使用 Ctrl+K / Cmd+K 快捷键唤起搜索框。

优化

• 目录滚动监听（Scroll Spy）缓存顶栏高度与目录链接集合，仅在当前激活章节变更时更新 DOM；返回顶部按钮增加 requestAnimationFrame 节流与状态缓存，显著降低滚动期间的样式计算与 DOM 操作开销。
• 正文图片自动补齐默认 loading="lazy" 与 decoding="async"，且仅在正文存在可放大图片时才向页面挂载灯箱 <dialog> 节点。
• 文章系列循环仅对匹配当前系列的文章读取 rackora_series_order 注解，减少非本系列文章的模板求值开销。

安装包：theme-rackora-0.10.3.zip

完整提交对比：v0.10.2...v0.10.3

Generated from v0.10.3

新增：

• 文章支持记录作者地区、发布时天气与心情。地区可通过定位获取或手动填写，天气自动获取，心情通过下拉选择，随文章一起保存。
• 文章顶部以一句连贯的文字展示写作记录，未填写的部分自动省略；已有天气记录会保留，不会随访客访问改变。

优化与修复：

• 重新设计沉浸式文章头图：清晰封面搭配靠左的标题与摘要，写作记录加入主题色点缀，作者、日期与阅读信息集中到底部横栏，正文卡片自然衔接头图。
• 改善手机端、长标题及无封面文章的展示，经典布局也支持显示写作记录。
• 修复部分访问中页面样式丢失、需要刷新才能恢复的问题。
• 修复首页轮播箭头显示异常和加载时内容溢出的问题，改善键盘操作时的按钮显示。
• 优化首页视频背景加载，减少不必要的图片请求。
• 移除选中文字后的复制、引用评论和分享工具条，避免与 AI 助手入口重叠。

使用提示：升级后请在主题详情中执行「重载主题配置」，并完整刷新管理后台。编辑文章时，可在「扩展设置」中维护作者地区、天气与心情。

Generated from v1.0.4

MiniDocs知识库 v1.0.4

MiniDocs 知识库插件更新。

主要改动

• 阅读页 / 分享页无刷新切换：点击目录树文档通过 AJAX 更新正文与 URL（pushState），目录树展开状态、滚动位置完整保留，并支持浏览器前进 / 后退。
• 兼容 halo-plugin-shiki：切换后派发 pjax:complete，触发 shiki-code Web Component 重新高亮代码块，修复异步加载时代码块停留在模糊占位态的问题。
• 前端资源外置：模板内联样式与脚本抽离为 doc-page.css / doc-page.js，减小页面体积并规避大树渲染截断。
• 公开 API / Finder 增强：文档标识支持 metadata.name 兜底，补齐分享链路与可见性相关处理。

安装

下载 halo-plugin-minidocs-1.0.4.jar，在 Halo 后台「插件 → 上传 / 升级」安装；要求 Halo >= 2.26.0。

halo-theme-cosolar v1.1.11

更新速览

1、知识库阅读页目录模式（src/doc.html · src/js/doc.ts · src/css/doc.css）

适配 MiniDocs 1.0.8 新增的知识库属性 docMode（catalog 目录模式 / hierarchy 父子文档模式，默认 hierarchy）：

• 目录模式约定：凡有子文档的父文档都视为「目录」而非文档——树中目录节点带主题色文件夹图标、文字灰化；点击目录仅展开 / 折叠当前目录（不影响其他目录）；点击子文档（带文档图标）才打开阅读；右侧正文永不显示目录内容（服务端不渲染父文档内容，等待 JS 打开其下第一个文档时显示加载态）。
• 首次打开知识库：自动展开第一个目录并打开其下第一个可阅读文档（URL 无 docSlug 时生效）；直链访问目录父文档时自动改打开其下第一个文档。
• 父子文档模式行为完全不变（维持圆点标识、父文档可阅读）。

2、知识库列表页加载方式与分页胶囊（src/docs.html · src/js/docs.ts · src/css/docs.css）

• 「知识库页设置」新增列表加载方式（分页模式 / 滚动加载模式）与每页条数（3–50，默认 9）。
• 分页模式：底部改为胶囊式分页（‹ 当前页/总页数 › + N 条/页 徽标），箭头用 SVG 不受手写字体影响，组件锁定中性系统字体。
• 滚动加载模式：释放固定高度视窗，列表随页面自然增长；底部显示「已加载 x / y」与「加载更多」胶囊按钮，点击追加下一页，加载完自动隐藏；卡片网格列宽改 minmax(286px, 1fr) 均摊，两侧对齐。

3、列表页统计卡与阅读页布局美化（src/css/docs.css · src/doc.html · src/css/doc.css）

• 列表页五张统计卡按各自图标色系整体着色（浅色渐变底 + 同色描边 + 右上角装饰圆），明暗双模自适应；排序下拉去掉含混的小图标，改胶囊样式。
• 阅读页顶栏重排：左侧为知识库图标 + 名称（原「返回」位置），右侧依次点赞 / 访问量 / 返回 / 书签 / 分享；知识库开启外链分享时点击分享按钮直接跳转分享页（未开启则复制链接）。
• 阅读页底栏左侧新增「共 N 篇」统计；创建 / 更新时间增加中文标签；左侧文档树移除原知识库信息块，搜索框上移。

4、知识库页设置重排与页脚开关拆分（settings.yaml · src/doc.html · src/docs.html）

• 「知识库页设置」开关排到前部（显示统计栏 / 页脚 / 侧边栏），加载方式与条数随后。
• 「显示页脚」拆分为显示列表页页脚（show_footer_list，控制 /docs）与显示阅读页页脚（show_footer，控制 /docs/view/{kbSlug}），各自独立。
• 文档树默认仅展开第一个父目录，其余折叠；点击折叠态父目录同时展开（父子文档模式）。

5、移动端隐藏看板娘（src/css/main.css）

• 小屏（≤768px）自动隐藏 Live2D 看板娘（live2d-context { display:none }），避免遮挡内容；桌面端不受影响；文章页悬浮工具条不再与模型重叠。

6、修复：模板 BOM 导致的怪异模式（src/index.html）

• 编辑器为 src/index.html 写入 UTF-8 BOM，Vite <include> 拼接时带入产物，<!doctype html> 前出现 BOM 使浏览器进入怪异模式（head 内容被丢进 body、sticky header 被顶下），表现为首页顶部出现约 26px 空隙。已清除 BOM，产物恢复以 <!doctype html> 开头。

问题修复

• 修复 JSON 导入 ZIP 后文章因所有者为空而不可见、导入后发布可能超时的问题。by @ruibaby in #23

Full Changelog: v1.9.0...v1.9.1

Generated from v1.9.1

Rackora v0.10.2

修复

• 文章模型（Post）补充注册 rackora_index_policy（索引策略）元数据表单字段，使文章与文档页的 noindex,follow 策略可在 Halo 后台直接下拉选择。
• 统一文章页、文档模板、普通独立页和关于页的正文图片灯箱开关：全部跟随后台「文章 → 点击放大正文图片」设置，普通独立页不再遗漏灯箱，文档与关于页也不再在关闭设置后继续弹出灯箱。
• 文章系列目录在全站同系列公开文章不足 2 篇（仅含当前文章自身）时自动隐藏，避免底部出现单条仅指向当前页的系列列表。
• 修正「插件 → 显示友情链接入口」的后台说明，明确其控制 /links 页面适配与默认页脚导航中的友链入口。
• 补齐 CHANGELOG.md 底部缺失的历史版本标签链接定义。

安装包：theme-rackora-0.10.2.zip

完整提交对比：v0.10.1...v0.10.2

Generated from v0.10.2

1.3.0

新增

• 私密日记：登录后的独立空间，支持时间线目录、心情记录、居中抽屉阅读与编辑。
• 端到端加密：日记先在浏览器内加密再上传，云端只保存密文；HTTPS / localhost 下启用。
• 支持 Markdown / ZIP 导出、空闲自动锁定；日记不会进入首页或公共列表。

写作页

• 修复草稿同步中的一些小问题：草稿列表分页遗漏、同步时本地草稿被误删、旧内容覆盖本地等。
• 打字机模式的分级渐隐更连续，长段落上下过渡更顺滑。

其他

• 日记右键菜单、新建入口、返回位置和心情展示等细节调整。

说明

• 日记页需要手动创建：标题「日记」、别名 diary、模板「日记（私密）」。
• 通过局域网 IP 的 HTTP 访问时，日记会提示并降级为明文保存；需要加密请使用 HTTPS 或 localhost。

Palette 导航页插件 1.0.1 正式版。

功能

• 独立公开导航页 /nav：分类筛选、多搜索引擎（支持移动端模板）、快捷导航、时钟/日期/问候语/随机一言、背景图片或视频、6 种主题色与夜间模式、响应式布局。
• 控制台管理页 /console/palette-nav：分类、链接、搜索引擎、快捷导航的完整 CRUD，搜索与筛选、分页、批量启停、批量删除、批量移动/复制、拖拽排序（先存草稿后保存）、分类级联删除、未保存修改确认。
• 链接图标：控制台内上传图片/SVG、从附件库选择、填写图片地址或粘贴 SVG 代码；「获取」自动读取目标网页名称与图标，图标转存为 Halo 附件。
• 图标与 URL 安全：前后端同一套白名单，SVG 经安全处理后才输出；「获取」使用防 DNS rebinding、逐跳校验重定向、限制大小与超时的出站客户端。
• 仪表盘：链接数量、今日浏览量、今日独立访客、累计浏览量、近 7 天 PV/UV 走势；访问统计可用加盐哈希按天去重，不保存原始 IP 与 User-Agent，可随时关闭。
• 内置默认导航数据：新实例首次启用时导入一次，之后不会恢复用户删除的内容。
• 设置页签：基本、访问统计、外观、链接图标、搜索五组设置，支持上传/附件库/链接三种媒体来源。

_{HALO 2 博客主题}

Halo-Theme-Ethereal 2.1.0

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

更新说明

欢迎使用 Ethereal 主题 v2.1.0。本次更新带来站点日历小组件，打赏页面改由 打赏插件 提供并支持访客自助提交打赏信息，图片处理统一改用 Halo 官方缩略图接口；同时修复移动端小组件不生效、图片地址导致 Banner 黑屏等问题。

请注意，本次更新移除了「速度优化」与「扩展页面 → 打赏页面」两个分组，打赏文案与收款码改由打赏插件配置，升级后需重新确认，详见 设置项迁移

打赏插件 需配合本版本使用：旧版主题启用该插件后访问 /reward 会白屏，请先升级主题

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

侧边栏小组件

• 新增 站点日历侧栏小组件，提供日 / 月 / 年三种视图，可查看当月与单日发布的文章，支持年度文章热力图，点击格子跳转到对应月份

• 修复 同一小组件同时放在桌面侧栏与移动端列表时，移动端热门文章一直「加载中」、音乐播放器无法播放的问题

打赏页面

• 新增 打赏页面改由 打赏插件 渲染，收款方式与文案在插件设置中统一配置

• 新增 打赏页页头展示累计人次、累计金额与本月人次

• 新增 访客可自助提交打赏信息，支持验证码与选填内容

• 新增 文章打赏弹窗支持爱发电入口

• 优化 赞助者墙支持加载更多，提交后自动刷新

弹窗与滚动

• 修复 打开弹窗（外链跳转、友情链接申请）后页面回到顶部的问题

图片与加载

• 优化 图片处理改用 Halo 官方缩略图接口，Banner、卡片封面与文章封面按屏幕自动分档加载，无需额外配置

• 优化 正文图片响应式属性由 Halo 自动注入，主题不再改写图片地址

• 优化 头像按显示尺寸加载，高分辨率屏不再固定取最大档

• 修复 外部图床与带查询参数的图片地址导致 Banner 黑屏的问题

插件兼容

• 修复 评论表情面板换页后残留且无法关闭的问题，改由评论组件自行兜底，请将评论组件升级至 3.5.1 及以上

设置项迁移

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

扩展页面

• 「打赏页面」分组已移除，/reward 改由打赏插件提供；需在应用商店安装并启用「打赏插件」，并删除原来创建的「打赏页面」自定义页面

文章

• 「操作栏 → 打赏设置」中的打赏文案、微信 / 支付宝收款码与页面路径已移除，改在打赏插件设置中配置；主题仅保留「显示打赏页面按钮」

侧边栏

• 新增「站点日历小组件」分组，可开关年度热力图；需在侧边栏小组件列表中加入「站点日历」才会显示

速度优化

• 分组已移除，原图片处理设置不再生效，图片统一由 Halo 缩略图接口处理

其它

• 依赖升级：Astro 7.4.5、Svelte 5.57.3、Tailwind CSS 4.3.4、@halo-dev/api-client 2.27.0 等

• 依赖安全：锁定 glob、minimatch、serialize-javascript、fast-uri 等安全修复版

• 更新 README

• 版本号提升至 v2.1.0

本次更新处理的 Issue 与 PR

Issue

• #95 [建议] 打赏页面支持爱发电及更多赞助通道

• #100 [Bug] 主题修改了背景链接导致背景黑屏

• #102 [Bug] 评论表情面板无法关闭 / 回复评论时面板位置错位（配合评论组件 Next）

• #105 [Bug] 热门文章同时放在桌面侧栏和移动端小组件时，移动端一直「加载中」

PR

• #90 新增站点日历侧栏小组件，服务端动态注入文章数据

• #104 依赖升级：npm 分组 13 项更新

• #106 修复小组件同 id 多实例只有第一份生效，移动端热门文章与播放器不可用

Full Changelog: v2.0.1...v2.1.0

Generated from v2.1.0

发布第一个版本，已基本完成 Next 的功能适配。

打赏插件 1.0.0

为 Halo 站点提供独立打赏页：访客扫码打赏后提交记录，站长确认后展示「赞助者墙」。可选对接爱发电，订单自动同步入库。

插件不参与资金流转，不接入支付网关，不代收、不结算、不抽成。

主要功能

• 独立页面 /reward，自动套用主题页头页脚（Halo 2.26+ 的 layout 契约）
• 支持微信、支付宝收款码与爱发电入口
• 打赏表单以模态框呈现，支持昵称、金额、留言、交易单号、头像与图形验证码
• 赞助者墙只展示已确认记录，金额显示可单独关闭
• 后台记录管理：搜索、状态筛选、确认 / 拒绝、批量操作、CSV 导出
• 爱发电：Webhook 自动入库、后台手动同步历史订单（最多最近 250 条）、打赏者昵称头像反查
• 权限分两层：打赏记录查看 仅能浏览，打赏记录管理 才能新增、编辑、确认、删除、同步与导出
• 主题集成：覆盖 reward.html、引用提交模态框、或通过 rewardFinder 自建页面

安装

1. 后台「插件 → 安装」，上传 plugin-reward-1.0.0.jar
2. 启用插件，在插件设置中完成基础、收款、记录、爱发电与通知配置
3. 在站点菜单或文章中添加入口，指向 /reward

应用市场上架后，也可在「插件 → 应用商店」搜索「打赏插件」安装。

兼容性

• Halo >= 2.27.0
• 前台页面依赖 Halo 2.26.0 起提供的 layout 页面布局契约

数据与隐私

• 记录保存在站点自身的 Halo 数据库（自定义模型 RewardRecord），插件不额外备份、不外传
• 联系方式与交易单号仅后台可见，任何匿名接口都不返回
• 不采集访客 IP：限流只在内存中按来源 IP 做短时计数，不落库、不写日志
• 不含遥测、访问统计上报、崩溃上报、广告或 AI 数据分析
• 仅在启用爱发电后访问 afdian.com（备用 ifdian.net），传输内容为开发者身份标识、请求签名、分页参数与订单号
• 所有外部请求均有 15 秒超时与重试上限，失败降级，不阻塞站点访问

已知边界

• 静态收款码无法自动确认到账，访客提交的记录默认「待确认」，需站长对照收款通知人工确认
• 爱发电 Webhook 没有签名机制，插件通过反查订单确认真实性；查不到时不会入库，需后台点「同步爱发电」补齐
• 关闭「启用打赏页面」只影响页面、配置读取、验证码与提交入口；赞助者墙与统计接口仍可匿名读取（便于主题在其它页面展示）
• GET /public/stats 的累计金额没有独立关闭开关，「在赞助者墙显示金额」只控制墙面
• 限流与验证码为单实例内存实现，重启后失效；多实例部署时各实例独立计数
• 站点在 CDN / WAF 之后时，需确认代理透传 X-Forwarded-For，否则所有访客会共享同一份限流配额

校验

• 文件：plugin-reward-1.0.0.jar
• 大小：135 KB
• SHA-256：b603093688da6edc4f1fd043cea649c8332f0f397eebc765c03fdfe343fe832d

开发说明

本版本开发过程中使用了 AI 辅助编码，全部代码经人工审查，并在 Halo 2.27 环境完成安装升级、前台提交、后台确认、爱发电手动同步的人工测试。

爱发电 Webhook 回调因官方测试功能维护中，尚未完成端到端验证；，接入后建议先使用后台「同步爱发电」拉取订单

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

此版本要求 Halo 2.27.0 或更高版本。

功能优化

• 完善评论组件的无障碍支持：为点赞、回复及回复列表切换提供正确的状态与读屏标签，播报评论数量和加载状态，并支持键盘聚焦引用徽标 by @ruibaby in #263
• 评论分页与 URL 中的 comment-page 参数保持同步，支持通过浏览器前进/后退切换分页；评论内容中的图片改为懒加载 by @ruibaby in #263
• 更新西班牙语、简体中文和繁体中文翻译 by @ruibaby in #263

问题修复

• 修复在使用 Swup、Turbo、PJAX 等无刷新导航的站点中，表情面板在切换页面后重新出现且无法关闭的问题 by @ruibaby in #266
• 修复繁体中文环境下表情选择器显示简体中文标签的问题 by @ruibaby in #265
• 修复存在未保存评论草稿时离开页面没有提示，以及分页请求在组件卸载后仍可能改写 URL 的问题 by @ruibaby in #263

Full Changelog: v3.5.0...v3.5.1

Generated from v3.5.1

安全修复
每次授权生成不可预测的一次性 state（32 字节随机数），放在回调地址路径里（/login/mapay/callback/{state}），回调时与当前浏览器会话一次性校验（常数时间比较），校验不通过的 code 不会用于登录或绑定。修复 1.0.1 的 CSRF 漏洞：此前仅校验会话发起过同类型授权，攻击者可用自己的授权 code 诱导已登录用户打开攻击者回调地址，把攻击者的三方身份绑定到受害者账号导致账号接管（Halo 应用市场审核在 2.27.1 实机复现）。
回调地址仅接受 https:// 的站点对外地址配置，防止授权 code 与一次性 state 经明文 HTTP 传输被窃取。
文档
README 按 Halo 2.27.1 实测行为重写：首次登录是 Halo 的选择页（绑定已有账号 / 注册新账号），不是自动创建账号；回调地址说明一次性随机码；安装链接指向 1.0.2 的 JAR。
补充许可证与派生来源说明：GPL-3.0、上游 halo-sigs/plugin-oauth2、与上游的具体差异及维护计划。

功能优化

• 优化 SEO 元数据生成与重定向规则处理，减少页面渲染耗时。
• 微信分享凭据改为后台刷新，分享脚本仅在微信、QQ 浏览器中异步加载，减少对页面加载的影响；插件启动或凭据变更后，需等待后台刷新成功才能启用自定义分享。
• 精简插件安装包，仅保留 Linux（含 Alpine Linux）、macOS 和 Windows 的 ARM64、AMD64 SQLite 原生库，其他平台和架构不再内置。

问题修复

• 修复请求的 Accept 头格式异常时，重定向过滤器可能导致请求失败的问题。

依赖更新

• 更新 SQLite JDBC 至 3.54.1.0。

v2.2.41：Halo 2.27 适配与页面稳定性修复

本版最低要求为 Halo 2.27.0，本地最终验证环境为 Halo 2.27.2；不再声明支持 Halo 2.26。各可选插件仍须满足其自身的版本要求。

主要变化

• 页面切换与代码高亮：修复慢资源加载、快速切页和迟到回调引起的错误刷新、遗漏初始化及错页更新。Shiki 延迟启动完成后能恢复当前正文高亮；配置改变、离开适用范围或执行结果尚不确定时，保留整页导航恢复。
• 图库：修复分页追加和灯箱关闭后的滚动跳动，按已知图片尺寸预留空间；补齐小分页继续加载、重复分页保护、坏图重试、键盘入口和离页清理，保留原有瀑布流与图片比例。
• 分类与标签：完善分类层级、当前项折叠及空列表呈现；修复长标题、摘要和标签撑宽手机页面的问题。极简列表的长标签可自然换行，阅读数和“阅读更多”保持正常横排；无标签时保留原有对齐。
• Docsme：对齐官方文档字段、正文和评论主体，统一版本/语言选择入口；切换时保留当前正文路径，修复抽屉断点、空目录锁滚动、目录定位及公式在 PJAX 返回后的重复处理。
• 导航与认证：完善手机菜单的焦点、Tab 约束、Escape/遮罩关闭和跨断点清理，保留站内链接的主题预览身份。适配 Halo 2.27 验证码与核心认证脚本，修复密码显隐、保持登录状态、失败反馈及短屏布局。
• 友链与瞬间：完善友链识别、详情、分页历史、权限降级和失败重试，避免旧请求覆盖新输入。瞬间发布遵循官方 UC 权限、审核状态、上传响应和附件数量限制，补齐取消、超时与草稿保护；历史多媒体内容保留完整入口。
• 组件与其他页面：按插件已有能力处理联系表单、AI 摘要、受限阅读等宿主的按需加载、明暗状态和离页清理。修复 Steam/豆瓣分页与异步状态、装备长规格和窄屏布局、独立页面封面、关于页地图降级，以及复制/分享失败反馈。

本版保持原有字体、配色、图标和各页主要布局；减少重复说明，补充必要的状态反馈与可访问性。插件没有提供的主题接口不补造功能。

构建依赖与安全

• Vite 更新至 8.3.6，source-map-js 更新至 1.2.2；glob/minimatch 采用已修复并通过 pnpm 发布冷却期的 14.0.3 / 11.0.4。
• 2026-11-06 查询到的 glob 14.0.4、minimatch 11.0.5 及其依赖组合会触发冷却期豁免，本版未降低供应链策略。此处不表示所有依赖均为当日最新版本。
• 本地全量依赖审计由 9 条开发依赖告警降至 0，生产依赖审计也为 0。保留冻结安装、完整 audit 和质量门禁；限定消费者版本的 override 已做实际匹配及打包行为对比，不作为任意旧 API 的兼容承诺。

本地验证

验证使用 Node 24.21.0、pnpm 12.6.0 和 Halo 2.27.2，记录的范围如下：

• 冻结安装、完整构建、lint、格式及差异检查通过；构建回归 577/577，0 跳过。
• 44 个路由/视图在桌面与手机完成 88 组巡检；最后调整无标签阅读区对齐后，在最终代码上追加 18 组相关路由复验。两批代码身份分别记录，不将此前 88 组改写为最终版本的全量重跑。
• 四种实际 Thymeleaf 列表，覆盖正常内容、长标题、长摘要、长标签及空标签，结合两种视口与侧栏开关，完成 80 组隔离布局验证。手机标签页由 501px 溢出恢复到 390px；长标签阅读入口保持单行。
• 服务端 54/54 份 CSS/JS 与本地构建产物一致；本地候选 ZIP 的 240 份文件与磁盘逐字节一致。

详细环境、修复依据、分批代码身份及证据见发布阻断补修记录；Shiki 与迟到组件场景见专项验证记录。实际发布选集另经独立目录构建验证，运行文件与此前安装包内容一致。本节列出本地结果，远端 CI 与发布状态以对应标签的 GitHub Actions 和 Release 为准。

适配与验证边界

本版按插件官方已有能力适配，不宣称所有插件、配置和业务均已通过。Contact Form、AI Summary、Restricted Reading 仍缺少部分真实正文宿主样本；官方组件的隔离验证不能替代实际正文注入、模型生成、提交与持久化回读、支付解锁、外部 SSO 或完整 WebAuthn 验证。用户此前手测 AI/Passkey 的结果保留其来源，不改写为本次自动化测试结果。

AList 不在本次修复与验收范围；无主题接入点的后台、编辑器和调度能力不列为主题缺陷。逐插件范围与历史证据见当前适配结果。

远端发布验证

发布提交 3243170 的主线 Quality Gate与标签 Quality Gate均已通过，包括冻结安装、lint、格式、完整依赖审计、构建及生成文件一致性检查。安装包由本次 Release 触发的 CD 自动上传。

Generated from v2.2.41

1.2.13

本次改善新版 Halo 与已集成插件的兼容性，修复评论固定链接及主题预览跳转。

• 修复重复打开同一评论或回复链接时定位不准确的问题，保留已挂载评论组件与输入状态。
• 搜索结果和主题命令的同源跳转保留预览主题，避免意外切换到当前启用主题。
• 改善评论按钮文字对比度，修复超链接卡片被插件默认暗色样式覆盖的问题。
• 对齐 Halo 认证布局与动态登录片段契约，更新认证资源版本参数，修复第三方登录的“记住我”同步。
• 更新 Vite 及受影响的构建、打包和检查依赖，修复依赖审计发现，并补充文件匹配兼容性回归测试。

兼容范围变更：主题最低要求由 Halo 2.26.0 提高到 Halo 2.27.0。 1.2.13 以本轮最新版已适配插件组合为支持基线，其中 Comment 3.5 自身要求 Halo 2.27.0。使用 Halo 2.26 的站点需先升级 Halo，再升级至本主题版本；即使未启用评论插件，主题最低要求也统一为 2.27.0。本次实际验证环境为 Halo 2.27.2、Comment 3.5.0、Search 1.8.0。

搜索预览参数保留依赖浏览器 Navigation API，不支持时沿用插件原始跳转；不影响普通站点搜索。

本次覆盖主题已有集成，不扩展为全部已安装插件的完整功能适配。

Generated from v1.2.13

macOS 桌面与搜索

• 修复窗口最小化时快速点击 Dock 无法恢复的问题，改善菜单、通知、搜索与分享面板的键盘操作和关闭回焦。
• 修复桌面首次加载后滚动条管理仍保留已移除容器的问题。
• 优化官方搜索组件的输入、结果、选中态与键盘焦点；搜索运行模块按需加载，支持取消、失败回退和减少动态效果。

阅读与商城交互

• 修复阅读器窄窗目录的空白布局，扩大手机目录拖柄的触摸区域，改善目录导航与浮动表单的衔接。
• Docsme 按应用窗口宽度调整目录布局，完善抽屉键盘操作并改善正文可读性。
• 分离商城规格选择与图片预览，为地址加载、购物车加载和删除失败补充反馈与恢复，避免重复操作。

图库转场与操作

• 修复列表进入详情时照片和文件名溢出窗口的转场残影，保持图片比例。
• 图片预加载使用与正式显示一致的响应式候选，取消或超时时撤销未完成的加载。
• 改善方向键切图、Tab 唤醒缩略条，以及信息／评论面板的 Escape 和关闭回焦；避免评论输入、外部菜单和长按触发误切图。

要求 Halo >=2.26.0；可选插件遵循各自的最低版本要求。本版未新增前端运行依赖。

Generated from v0.9.51

Rackora v0.10.1

修复

• 文章页与文档页的 JSON-LD 内联表达式补上 ${}，并把标签关键词从 #strings.arrayJoin 改为 #strings.listJoin。Halo 2.27 会把原先缺少 ${} 的表达式当成模板错误，文章页因此返回 500。

安装包：theme-rackora-0.10.1.zip

完整提交对比：v0.10.0...v0.10.1

Generated from v0.10.1

本次为性能与稳定性更新，行为与 1.0.0 保持一致。

变更

• 随机选图改用索引采样：每次请求最多抽取 3 个互不重复的候选下标，不再复制整张附件名单，降低高并发下的内存分配
• 附件名单以只读视图缓存，供并发请求共享，避免就地修改
• 新增测试覆盖重试候选不重复、重试次数不超过名单数量、缓存名单不被消费
• 修正文档：no-store 等缓存头仅作用于 302 响应，目标图片的缓存策略由存储服务与 CDN 决定

新增

• 新增主题设置「首页布局 → 站点主菜单」：使用菜单选择器从站内已有菜单中挑选，左侧导航改由该设置决定，不再固定读取系统主菜单
  • 未选择菜单时导航区块不渲染，模板内也不再保留硬编码的默认菜单
  • 菜单项的「打开方式」会原样输出到 target，可直接用于新窗口打开外部页面
  • ⚠️ 删除已选中的菜单会导致导航渲染失败，删除后需回设置重新选择

性能优化

• 开启 CSS 压缩（esbuild minifier）：main.css 332KB → 273KB，gzip 传输 53.5KB → 46.8KB，样式零回归（像素级对比验证）
• 消除 <head> 阻塞脚本：dayjs/relativeTime/zh-cn 三合一为 dayjs-bundle.min.js，与 main.js 一并改为 defer 加载，head 同步脚本从 4 个降为 0 个
• normalize.css 并入主样式表构建，再省一个渲染阻塞请求；首页主题 CSS/JS 请求从 9 个减至 7 个
• 瞬间页 36KB 交互脚本由内联改为外置 moments.js（gzip 6.1KB，minify 后体积近乎减半），HTML 输出从 173KB 降至 135KB（-22%），且可跨页面缓存
• 图标字体新增 woff2 格式（68.7KB → 28.4KB，-59%），移除浏览器从不下载的 eot/ttf/svg 冗余格式与 iconfont 设计源文件

主题包瘦身

发布包（zip）从 1.4MB 降至约 0.63MB，主要来自清理未使用资源与压缩默认素材：

• 删除从未被引用的 assets/images/logo.png（2048×2048，304KB）与 cover.png（3724×1854，196KB）
• 作者卡默认头像由 500×500 PNG（168KB）改为 200×200 WebP（7.5KB），默认封面由 2388×1668 JPEG（72KB）压缩为 1000px 宽（43KB）
• 移除模板中「保留备用」但实际从未调用的 markdown-it.min.js（124KB），文章页同时少一个阻塞脚本
• 图标字体只保留 woff2，去掉 woff 回退（现代浏览器覆盖率已足够）
• 打包流程统一清理 .DS_Store 与 *.map，避免系统杂项进入发布包

修复

• 认证页（登录/注册/退出）移动端闪烁与偶发白屏问题专项修复：
  • 移除 gateway_fragments/layout.html 中初始化不存在元素 #blue-ripple 的死代码，此前每个认证页都会抛出 2 次 JS TypeError
  • 登录页不再加载未使用的 meteors（流星）样式与脚本
  • 移动端（≤768px）与「减弱动态效果」系统偏好下自动关闭背景涟漪与流光边框动画：毛玻璃卡片叠加大面积无限动画会持续触发移动端重绘，是闪烁的主要诱因，桌面端效果不变

移除

• 移除足迹插件适配：删除 footprint.html，/footprints 页面回归插件原生模板（全屏沉浸、自带导航坞），不再套用主题 header 与 footer
  • 顶部/侧边导航被外壳包裹后与插件全屏 3D 布局观感割裂，取消包裹更自然
  • 如需在站内入口进入足迹页，在 Halo 后台「菜单」中添加 /footprints 链接并把「打开方式」设为「新窗口」即可
• 同步删除 main.css 中足迹页专用的「回到顶部」隐藏规则

Generated from v1.1.2

修复

• 收到 HTML 而非 JSON 问题

升级说明

1. 升级插件至 1.0.5 后，建议硬刷新前台页面，如遇异常请重启docker

修复

• 点菜提交失败提示「响应不是合法 JSON」
  前台默认改为请求 /apis/plugins/dishes/public，避开 Halo 对 /plugins/** 的 CSRF 校验；兼容旧 /plugins 路径时会自动刷新 CSRF 并重试。错误提示也会区分 CSRF / 403 / 网关问题，便于排查。

• 企业微信通知卡片跳转到服务器私网地址
  通知链接优先使用设置中的「公网访问地址」，其次使用浏览器 Origin、X-Forwarded-*，并尽量跳过 127.0.0.1 / 内网 IP。默认 Logo 资源路径同步修正。

新增

• 通知设置新增 公网访问地址（如 https://你的域名），用于企微卡片跳转与封面图；反代 / Docker 场景建议填写。

安全

• 未配置域名白名单时，拒绝跨站写请求（Origin 与 Host 不一致），降低走 /apis 后的跨站提交风险。

升级说明

1. 升级插件至 1.0.4 后，建议硬刷新前台页面。
2. 若使用企业微信通知，请到 家庭私厨 → 插件设置 → 通知设置 填写公网访问地址。
3. 前台独立域名部署时，请配置域名白名单，并确保反代可访问 /apis/plugins/dishes/public。

功能优化

• 创建页面并启动生成后直接进入工作台，便于查看进度和继续对话 by @ruibaby in #59
• 改进画布元素悬停提示、方向键选择和焦点管理，优化移动端预览与触控操作
• 清晰展示草稿、发布、主题布局和运行模型状态，并按页面记忆模型选择
• 改进加载失败提示与重试入口，优化辅助文字对比度和历史版本时间显示

问题修复

• 修复公开 API 较多时，预览响应头过大导致反向代理返回 502 的问题 by @ruibaby in #60

Full Changelog: v1.2.0...v1.2.1

Generated from v1.2.1

🐛 体验修复版：折叠不再挡代码，打印不再裁长行

• 折叠按钮不再遮挡末行代码：折叠态底部增加留白，按钮落在代码区下方；主题自带的代码块容器也统一按代码区裁剪
• 恢复折叠态渐隐遮罩：代码块与长图折叠时，底部渐隐提示下方还有内容。遮罩与留白的颜色按代码区真实背景合成，切换暗色 / 浅色主题后自动重算，不再出现异色横条
• 展开 / 收起动画双向生效：此前收起是瞬间跳变，现在两个方向都有平滑过渡
• 打印 / 导出 PDF 长代码行自动折行：长行不再被横向裁掉，按钮与装饰层自动隐藏
• 长图折叠更完整：页面加载完成后重新评估尺寸尚未撑高的长图；已加载的长图照常折叠，同时不会提前加载全页图片
• 收起后阅读位置稳定：长代码块收起时自动补偿滚动，读者不会被顶到别处
• 主题样式还原更彻底：移除插件容器时，被临时调整的主题滚动样式会正确还原

升级无需任何配置，刷新页面即生效。

1.2.5 更新：底层重构与草稿同步加固

本次更新以稳定性为主，底层代码做了一次较大规模的重构，重点加固草稿系统，并完善了移动端兼容与自动化门禁。

✍️ 草稿同步更可靠

• 切换不再丢内容：修复了编辑器状态延迟可能导致的吞稿问题，切换或离开前会强制抓取最新内容并上云。
• 冲突提示更准确：多窗口或跨设备编辑时，系统会先比对云端内容——内容一致则静默保存；仅当内容确实不同时才提示，避免误报。
• 跨设备自动同步：回到页面会自动拉取云端最新草稿，并补传本地尚未上云的草稿。
• 草稿列表更稳定：列表不再因后台同步而乱跳重排，新建空草稿时也不会被悄悄切换。

📱 移动端兼容

针对部分手机浏览器（如华为、夸克）开启“请求桌面版”的场景，为触屏设备加入纯色遮罩兜底，避免背景漏出与文字横向溢出；桌面端仍保留毛玻璃质感。

🛡️ 防呆与防连点

• 图片上传期间禁止发布，避免发出缺少图片的内容。
• 发布等操作加入防连点处理，避免重复提交。

🏎️ 性能优化

全站脚本改为 ES Module 模块化，并配合 requestAnimationFrame 渲染合并，列表重绘与打字机响应更顺滑。

本次更新附带较完整的自动化测试门禁，覆盖既有功能回归。

新增功能

• 支持独立使用评论框，通过 show-comments="false" 隐藏内置评论列表，方便主题和其他插件自行实现评论展示。
• 支持通过 replyTarget、replyTo() 和 cancelReply() 从外部设置或取消回复目标，兼容回复主评论及回复另一条回复，并保留已有草稿。
• 新增评论框 created 事件，提交成功后返回内容归属、回复目标和审核状态，便于自定义列表刷新。
• 读者榜公开接口新增 website、emailHash 和 repliesCount，可用于读者墙外链、邮箱哈希关联及主评论和回复的分别统计；保留原有总数和排序规则。
• 新增“评论邮箱”设置，支持禁止指定匿名邮箱、拦截示例邮箱，并防止匿名冒用超级管理员及已配置额外管理员的邮箱。主评论和回复均在提交前校验，管理员本人登录后可正常评论。

优化与修复

• 统一评论、读者榜与头像的邮箱哈希计算，规范大小写和首尾空白处理。
• 修复普通评论框的聚焦与重置操作，以及切换评论列表时头像加载回调的问题。
• 补充开发者适配和公开 API 文档，提供独立评论框、Vue 接入、回复控制、读者榜统计及邮箱限制说明。

使用文档：开发者适配 · 公开 API · 评论邮箱限制

Generated from 1.1.1

Halo2Bark v1.2.0 更新说明

一次体验打磨：通知内容更有料，合并策略可自选，排查状态有据可查。

新增与改进

• 文章发布通知带摘要：发布通知的正文不再空白，显示文章摘要（自动生成或自定义均可）；封面仍作为展开大图。
• 新设备登录通知带账号头像：与评论、注册通知一致，一眼看出是哪个账号的登录。
• 评论 / 回复正文更聚焦：首行只显示谁发的，不再重复写通知自带的时间，把字数留给正文内容。
• 合并窗口可关闭：新增「关闭（逐条实时送达）」选项。想让每条立刻到达时选它，不再出现合并摘要与「评论爆发中」过程通知；每分钟 20 条的限流和免打扰时段照常生效。默认仍是 2 分钟，不改变现有行为。

文档与排查

• README 新增「运行状态」章节：一条命令即可查询配置是否生效、队列深度、各类累计丢弃与失败事件数，反馈问题时不必只靠翻日志。
• README 补充「测试该设备」说明：测试消息按全局配置下发，提示音、图标、分组、角标与事件级别都会生效，可当作一次效果预览（测试消息不归档）。

验证与发布

• clean build 通过，445 个自动化测试全部成功。
• Halo 2.27.1 实例真机验证：关闭合并后逐条实时送达、文章发布通知携带摘要、恢复 2 分钟窗口后的爆发温度计与单条补发；状态端点全程零丢弃、零失败事件。

使用说明

• 需要 Halo 2.26.0 及以上，升级后沿用已有配置，无需重填设备 Key。
• 「合并窗口」保持默认 2 分钟即可；只有确实想逐条接收时才改为「关闭」。

What's Changed

• feat: add Cloudflare Turnstile and Google reCAPTCHA captcha providers by @Furry-yebai in #35

Full Changelog: 1.0.14...1.1.0

Generated from 1.1.0

What's Changed

• feat: 首页新增文章排序切换（最新发布/最近更新） by @AR-26710 in #209

Full Changelog: 1.6.18...1.6.19

Generated from 1.6.19

What's Changed

• feat: 完善旅途集并新增未来足迹规划 by @yunDuan-G in #15

New Contributors

• @yunDuan-G made their first contribution in #15

Full Changelog: v2.0.0...2.0.1

Generated from 2.0.1

功能优化

• 优化阅读口令编辑，支持回显和显示切换，口令描述改为选填。

问题修复

• 修复首页或其他页面引用受限文章、自定义页面内容时可能出现白屏的问题。
• 修复了已知安全问题。
• 修复具有阅读限制管理和内容编辑权限的用户无法配置阅读口令的问题。

功能优化

• 优化阅读口令编辑，支持回显和显示切换，口令描述改为选填。

问题修复

• 修复首页或其他页面引用受限文章、自定义页面内容时可能出现白屏的问题。
• 修复了已知安全问题。
• 修复具有阅读限制管理和内容编辑权限的用户无法配置阅读口令的问题。

首个公开发布版本。

• 按配置的 API 路径随机返回附件图片，并以 302 跳转到公开访问地址
• 支持多条规则，可按存储策略和附件分组过滤
• 自动排除隐藏分组（如头像）以及 SVG、XML、HTML 等非安全图片类型
• 附件名单短时缓存并合并并发查询，修改配置后即时生效
• 兼容本地存储、S3、OSS 等所有 Halo 存储策略

新增

• 适配足迹插件（Halo 应用市场 app-XCtAQ）：新增独立模板 footprint.html，只保留主题 header 与 footer，插件内容本身不做改造
  • 兼容插件 2.0 的 3D 地球、3D 书架与高德 2D 视图，插件样式与脚本由插件自动注入
  • 记忆书架、城市墙、城市详情、门票墙、留言簿等全屏浮层统一从 header 下方开始，不再遮挡主题导航
  • 首屏内容区与 header 占满一屏，页脚需下拉查看；页面滚动时底部导航坞、状态条与浮动按钮联动上移，不压页脚
• 全站新增「回到顶部」按钮：滚动超过 200px 后从视口右侧淡入，点击平滑回到顶部并自动淡出；适配瞬间页的内部滚动容器，深浅色主题各自配色，足迹插件页自动隐藏

优化

• 瞬间发布框图片改为朋友圈式托盘排版：图片统一排列在内容下方，三图及多图未展开前按 1:1 比例显示，不再在内容区上下穿插
• 插入链接改为「文字 + 链接」双输入面板，一次填完直接生成可点击的超链接，无需再次点击已插入文字补填链接
• 瞬间行内编辑改为所见即所得，保存时同时写入 html 与 raw，避免编辑已有内容时把 Markdown 链接破坏成纯文本
• 正文超链接样式统一：站内链接恢复主题色与下划线配色，深色模式单独适配，修正此前被全局链接样式覆盖为灰色的表现

修复

• 修复链接输入面板被发布框裁切遮挡的问题，改为随内容流下移
• 404 页面移除卡片边框、圆角、阴影与裁剪，与页面整体内容自然融合

说明

• 足迹插件 2.0 起高德 Key 改为插件后台的 Secret 配置，升级插件后需在插件设置中重新填写 Web 端 Key，否则 2D 视图不可用

Generated from v1.1.1

新功能

• 自然增长追踪：手动修改阅读量时自动记录基线（修改值 + 时间），列表新增「自然增长」列，展示自上次手动修改后的自然增长量 +N

说明

• 基线记录在文章 Counter 扩展的注解中，随文章删除自动清理，不影响 Halo 核心数据

本次改动较多，版本号从 1.0.8 直接升至 1.1.0，跳过 1.0.9。

新增

• 新增笔记（瞬间）详情页 /moments/{name}，独立标题、描述与 og 社交卡片信息
• 抽出瞬间卡片公共组件 includes/widgets/momentCard.html，首页与列表页共用同一套渲染逻辑
• 登录用户可在首页直接发布笔记，发布框新增公开 / 私密切换
• 灯箱、视频弹窗、点赞、评论等交互脚本独立为 includes/scripts/ 公共片段，列表页与详情页复用
• 新增豆瓣页面模板，适配豆瓣插件（未安装插件时给出友好提示）
• 适配链接管理插件：朋友圈页面改用链接管理订阅数据，友链页面移除原友链自助提交插件支持
• 引入 emoji-mart 资源
• 发表框在所有带 Tab 的列表页（首页 / /moments / 文章列表）统一展示，登录后切换 Tab 不再丢失发布入口
• 适配 Docsme 文档插件：新增文档详情 / 列表 / 目录页模板，深浅色跟随主题配色方案

优化

• 首页与 /moments 列表改为服务端渲染，对 SEO 更友好；首屏 20 条，超出部分引导至完整列表
• 瞬间标签改由插件接口下发真实计数，点击标签跳转 /moments?tag= 由服务端筛选，移除前端 AJAX 重渲染
• 评论区改为惰性挂载，首屏不再为每条笔记创建评论实例，长列表性能明显改善
• 列表恢复插件分页（page / prevUrl / nextUrl），结尾提供「查看全部 N 条笔记」入口
• 将内联编辑框样式统一收敛到主样式表，修复 /moments 与详情页编辑框样式错乱
• 首页顶部栏、移动端与深色模式显示细节优化
• 内容 Tab 收敛为公共片段：链接与高亮统一生成，文章缺失时降级到归档页；Tab 永远指向各类内容的唯一权威入口
• 为首页 / 列表页补全 canonical：重复内容页面归一到权威地址，筛选页声明自身
• 笔记详情页发布时间移到卡片头部左侧，与列表一致的相对时间格式；顶栏右侧只保留管理操作
• 文章首页模式下，/moments 与文章列表页对重复内容给出定位提示条

修复

• 修复瞬间标签重复渲染的问题
• 修复瞬间标签链接在子目录部署下失效、含空格标签无法正确编码的问题
• 修复未安装瞬间插件时首页笔记区域的空白与报错
• 修复未安装瞬间插件时首页仍显示发表框的问题
• 修复发表框底部两角背景从圆角处溢出的问题
• 修复注册页 Favicon 图标不显示
• 修复通行密钥（Passkey）登录按钮显示逻辑
• 修复豆瓣页面显示细节问题

工程

• .gitignore 中 scripts/ 规则收窄为仅忽略仓库根目录，避免误伤 templates/includes/scripts/
• 全部提交信息规范化为 Conventional Commits

Generated from v1.1.0

• 新增 Halo 控制台仪表盘部件：在 /console/dashboard 点击右上角「设置」→「添加部件」→「小部件中心」，选择「服务器」分组即可添加，直接查看 CPU、内存、磁盘和运行时间。
• 部件复用现有只读指标接口与访问策略，支持 401 / 403 / 503 / 网络错误 / 数据延迟 / 降级状态提示。
• 部件支持配置标题、运行时间和硬件信息显示；预览模式使用示例数据，不发起请求。
• 部件按容器宽高自动切换环形仪表、紧凑条形、纵向列表和趋势图布局，宽而短、窄而高及超大尺寸下都能合理利用空间。
• 新增 ui/ 控制台前端子工程；构建需要 Node.js 22+ 与 pnpm 10，Gradle 会自动执行前端构建与类型检查。

新增：

• 新增「关于我」页面模板，提供全屏影像作者页和彩色卡片布局，可展示个人介绍、资料分组、常用工具、近况、作品、生活兴趣及最近文章。
• 影像作者页支持背景照片、透明人物前景、滚动景深，以及「个人资料／站内动态」切换；导航首屏透明，下滑隐藏、上滑显示。
• 关于页模块可调整顺序、标题、宽度、配色和显示开关，主、副按钮支持自定义文字与链接；关于页不展示评论模块。
• 常用工具支持逐项编辑名称、Iconify 图标与颜色，分组图标和生活兴趣图标也可自行选择。

优化与修复：

• 改善关于页姓名文字的清晰度，修复滚动后照片过暗、主副按钮未显示及跨面板锚点跳转的问题。
• 搜索弹窗与评论组件统一跟随主题色及深浅色模式，补齐选中项、表情面板、弹层和瞬间评论区的配色。
• 修复部分主题设置通过可选配置读取时，默认开关和模块内容未正确生效的问题。

使用提示：升级后请在主题详情中执行「重载主题配置」。使用关于页时，新建或编辑独立页面，将模板设为「关于我」，再到「关于我」和「关于页设计」中维护内容与布局。

Generated from v1.0.3

新增：

• 页面扩展设置新增隐藏标题、隐藏作者与日期、正文宽度和透明背景选项，并支持单独关闭侧边栏，适用于默认页面、留言板、友链和朋友圈模板。
• 文章支持收藏与稍后阅读，可在控制中心「我的足迹」中查看和取消收藏；收藏保存在当前浏览器中，多个标签页同步状态。
• 侧边栏「最新回复」新增评论者资料卡，与首页文章列表共用，支持鼠标悬停、手机点击和键盘操作，展示昵称、网站与评论摘要。
• 文章扩展设置支持单独关闭侧边栏、打赏和版权声明。

修复：

• 修复侧边栏和留言板中邮箱访客头像无法正确获取的问题。
• 修复开启「减少动态效果」后评论者资料卡定位异常的问题。
• 隐藏页面标题后，阅读记录仍保留正确的页面名称。

使用提示：升级后请重载主题，以加载新增的页面和文章扩展设置。

Generated from v1.0.2

版本中心首个正式版本。

支持 GitHub、Gitee、GitLab、CNB 多仓库版本同步，提供仓库账号管理、仓库查询与批量导入。
在 Halo 默认编辑器中直接插入「版本中心」组件，可选择全部或指定项目、时间线或表格、默认版本范围和概览展示。
提供版本详情、附件下载、搜索、分页及正式版/预发布筛选，支持主副配色、深色模式、移动端与主题布局适配。
后台提供页面发布指引，通过「新建页面 → 插入版本中心 → 配置 → 发布」创建版本页面，邮件与 Feed 链接使用已发布页面地址。
支持 RSS、Atom、邮箱验证订阅、安全退订和签名 Webhook，邮件复用 Halo 内置通知器。
自动识别 Halo 插件与主题配置中的实际名称，支持 GitHub API 代理。
提供 Svelte 管理界面，支持同步日志、订阅管理、发送记录和通知重试。

绘画空间现在统一通过 Halo 默认编辑器组件展示，页面名称和地址由站长自行设置。

• 移除插件默认的 /drawing、画板、画谜和作品详情等前台路由，避免覆盖自定义页面。
• 后台加入「新建展示页面」入口及三步创建指引，插件设置中也说明了组件的使用方式。
• 组件内浏览、绘画、猜题、分享和登录返回保留当前文章或页面地址，刷新可恢复位置。
• 后台作品管理与举报处理改用弹窗预览，清理指向默认路由的入口。
• 更新 README 和编辑器截图，删除验收文档。

从 1.0.0 升级：先进入「页面 → 自定义页面」新建页面，在默认编辑器中通过「插入内容 → 绘画空间」或 /绘画空间 插入组件，发布后将站点菜单改为该页面地址。已有作品、草稿、谜底和积分会保留；旧的固定作品链接请从新页面重新分享。

要求 Halo 2.27.0+。下载 plugin-drawing-board-1.0.1.jar，在插件管理中升级。

使用说明 · 演示站：林间拾语 · QQ 群：766203360

Generated from v1.0.1

• 新增「指定用户访问」模式：可在插件设置中选择允许查看监控的 Halo 用户；未选中的登录用户返回 403。
• 页面访问标识支持「指定用户」模式。
• 指标数值、圆环与进度条改为同步补间动画，并遵循 prefers-reduced-motion。
• 首屏提前应用访客主题，避免暗色模式下出现亮色闪烁。
• 优化登录提示文案：登录后仍无权限时提示联系站点管理员。

Rackora v0.10.0

修复

• 顶部导航搜索按钮增加 SearchWidget 运行时防御，避免第三方搜索插件脚本尚未加载就绪时抛出未捕获错误。
• 分享栏链接生成增加协议前缀判断防御，避免文章永久链接已包含完整域名时重复拼接导致双重域名。
• 系列文章与相关文章增加空状态自愈清理，当分类下无其他文章或系列列表为空时不再残留多余的标题与空白区块。

新增

• 文章页与文档页的 Open Graph 元数据补齐 article:author、article:section 以及 article:tag 标签，提升社交平台分享卡片信息完整度。
• 文章页与文档页的 Schema.org 结构化数据（BlogPosting 与 TechArticle）补充 keywords（标签关键词）与 articleSection（主分类）语义字段。
• 文章与文档页支持文章级 rackora_index_policy 索引策略，设置为 noindex 时输出对应的 noindex,follow 标签。
• 首页 WebSite JSON-LD 结构化数据增加标准 SearchAction 声明，助力搜索引擎生成站内搜索框。

优化

• 启用 GA4、Microsoft Clarity 或百度统计时，在 <head> 中动态注入对应的 preconnect 与 dns-prefetch，减少第三方分析服务握手延迟。
• 作者页与关于页的图片补充 decoding="async"，避免首屏解码阻塞页面主线程渲染。

安装包：theme-rackora-0.10.0.zip

完整提交对比：v0.9.9...v0.10.0

Generated from v0.10.0

修复：

• 修复打开或关闭搜索弹窗时页面横向跳动的问题。
• 修复输入评论时误触发主题快捷键的问题，兼容评论组件内部输入框和输入法；输入时不再误触发 ⌘K / Ctrl K 搜索。

Generated from v1.0.1

内容级多语言 v1.0.78 更新说明

界面修复

• 角色详情页「翻译配额」表单的三个数字输入框增加清晰边框、圆角、内边距与底色；聚焦时蓝色高亮，深色模式适配。
• 插件设置页仍只保留全局默认限额；按角色配额仍在「用户 → 角色 → 翻译配额」。

权限与安全整改（延续 v1.0.75）

• 译文读写按当前有效编辑权限与资源归属判定，撤权立即生效，不再使用历史 contributors。
• 翻译接口需管理员显式授予「使用翻译服务」，访客与普通账户默认 403。
• 超限 429 / 413，被拒请求不触达模型。

兼容性

• Halo >= 2.27.0；升级自动迁移旧限额配置，清理旧聚合标签与 v1.0.70 残留角色模板。

新增

• 增强按钮：支持配色、圆角和图标配置，默认采用纯色与小圆角。
• 增强提示框：支持 Markdown、内容折叠、自定义配色与图标。
• 外链卡片：支持常用网站预设，自动读取网站标题、说明、图标和预览图。
• 哔哩哔哩视频组件：可在文章中嵌入 B 站视频。
• 组件收藏：可快速找到常用组件。
• MCP 支持：可查询组件目录并生成可嵌入文章的 HTML，需安装并启用 MCP Server 1.2.0 或更新版本。

优化与修复

• 组件按需加载，减少文章首次加载的资源。
• 统一组件选择器、编辑面板和新增组件的默认样式，改善明暗主题显示。
• 优化组件配置、图标选择和附件选择交互。
• 修复聊天消息不显示换行的问题，普通消息、自己的消息和系统消息均支持换行与空行。

Generated from 1.0.3

1.2.2 修复：瞬间图片在 HTTPS/域名访问时消失

这次是媒体地址兼容性修复。

问题原因 瞬间图片保存的是完整的 http:// 站点地址，而文章图片和头像使用站内相对地址。通过 HTTPS、域名或其他入口访问站点时，瞬间图片会被浏览器当作混合内容拦截，所以只有瞬间看起来没有图片。

修复内容 - 将 Halo /upload/ 媒体地址统一转换为同源相对地址 - 同时覆盖图片、视频、音频、source 和视频封面 - 兼容后台动态插入的瞬间图片 - 本地 HTTP、HTTPS 和域名访问都使用当前站点的协议

本次不改文章详情页、首页布局、写作页或 README。

• 独立 /pulse 服务器监控页面
• CPU、内存、磁盘、运行时间与硬件信息
• 最近约 2 分钟的历史曲线
• 亮色、暗色、跟随系统主题
• 默认仅登录用户可见，可切换公开访问

为 Halo 2.27.0+ 提供在线绘画、作品画廊与异步你画我猜，可嵌入文章、自定义页面或主题模板。

• 在线画板：画笔、橡皮擦、调色、粗细、撤销重做、缩放、全屏与 PNG 导出。
• 草稿与发布：浏览器自动保存、账号草稿、继续编辑与管理员审核。
• 作品画廊：最新/热门排序、作者筛选、点赞、分享、举报与 Halo 评论。
• 异步画谜：提示、服务端判题、尝试次数、积分榜、作者统计与手动揭晓。
• 页面适配：手机布局、主题深色模式与独立样式隔离。
• 外观设置：站长可分别配置浅色与深色的强调色、按钮、背景和正文颜色。

使用说明与截图 · 演示站：林间拾语 · QQ 交流群：766203360

基于 Astro 和 TypeScript 构建，支持页面无刷新切换、深浅色模式、浮岛式导航和手机端适配。

问题修复

• 引导 AI 客户端默认创建 HTML 格式的内容，避免使用内置富文本编辑器时出现无法预览或编辑的问题 by @ruibaby in #20

Full Changelog: v1.3.2...v1.3.3

Generated from v1.3.3

1.2.1 更新：更稳的长文写作与云端同步

本次更新集中在写作页的压力、弱网和并发稳定性。

11 万字长文压力测试

使用真实长文做了编辑、打字机模式、滚动、草稿保存与刷新恢复测试。编辑器ready约1.2秒，滚动p95约16.8毫秒，长文可以正常编辑和保存。

弱网启动

写文章页不再加载主题侧的评论、搜索、瞬间、发布器、文章抽屉、资料卡等脚本，只保留写作所需的核心脚本。没有本地草稿时显示轻量的“正在从云端取稿…”提示，取稿失败时会说明本地内容不受影响。Slow 3G 下不承诺秒开，但不再无反馈等待。

并发防覆盖

同浏览器标签使用 BroadcastChannel 即时提示，跨设备通过服务端保存令牌检测冲突。草稿在其他窗口更新后显示“草稿已在其他窗口更新”，可选择“载入云端版本”或“保留当前内容”；冲突未处理时不会自动覆盖云端。

修复

• 写作页会按草稿记住上次光标位置，重新进入时恢复，不再总是跳到文末。
• 修复 Chrome 打字机模式下鼠标滚轮无法向上滚动、一直被自动居中拉回的问题。
• 修复页面初始化时误触发自动保存，避免启动阶段产生幽灵冲突提示。

本次不改文章详情页和首页，README 保持原样。

• 修复页面组件初始化异常导致 Swup 切页后抽屉、装备详情等交互失效的问题，改善旧浏览器兼容性。
• 修复无右侧栏页面在部分浏览器中仍预留大面积空白的问题。
• 优化移动端评论输入框字号，避免 iOS Safari 聚焦时自动放大页面。
• 恢复首页和归档页的分类下拉入口，支持多级分类导航。
• 恢复页脚 Halo 和 Clarity 版权署名，固定展示。
• 修复移动端搜索弹窗被侧边栏遮挡的问题。
• 修复音乐播放器在视口变化后越界，以及歌词滚动不同步的问题。

Generated from 1.6.18

1.2 更新：让时间、文字与光影，在纸上自然呼吸

1.2 是一次集中在读写体验上的更新。没有增加更多入口，而是把写作启动、长文排版、提及跳转和细节稳定性重新梳理了一遍。

写作页

光阴（纸的呼吸）

入口：写作页右下角的字数胶囊。

效果：纸面底色会随一天的时间缓慢变化，早晨偏青白，傍晚转暖，深夜更沉静。

作用：它不是装饰性换肤，而是让长时间写作多一点时间感，像一盏安静的台灯。功能默认关闭，会按用户选择记忆；打字机模式下纸色继续生效，字数按钮暂时禁用。

纸边标题索引

入口：写作页滚动或悬停右侧边缘。

效果：H1/H2 显示墨点，H3 显示更小的刻度；点击后跳到对应章节，目标标题短暂显示下划线。

作用：长文写作不必离开正文去找标题；不新增侧栏，也不替换原生滚动条。

启动与草稿恢复

入口：直接打开写作页。

效果：Vditor 预加载，当前本地草稿先上屏，远程草稿在后台并行读取。

作用：进入写作页不再等待全部历史草稿；同步完成时会显示提示。用户开始输入后，后台同步不会覆盖当前内容。

阅读与上下文

@瞬间与 @文章

效果：文章正文中的 @瞬间 在当前页打开单条浮层，@文章 打开文章抽屉。

作用：不离开当前阅读位置，减少来回跳转。

嵌套返回栈

效果：在抽屉里继续打开另一篇文章时，会保留上一层的阅读位置；按 Esc 逐层返回。

作用：顺着引用链阅读时不再迷路。

未登录选中文字

效果：隐藏片段评论提示，只保留原生复制。

作用：匿名阅读更干净，不弹出无法使用的评论入口。

时间与纸面

相对时间

效果：瞬间时间使用“刚刚”“今天早上”“昨天下午”“昨夜”“前天晚上”等本地表达，三天以上显示精确日期。

作用：让瞬间更像生活记录；评论仍保留 HH:mm，完整时间放在悬停提示里。时间文案切换时预留稳定空间，不会推动旁边的信息和按钮。

排版

严格的 CJK 换行

效果：正文和写作页启用更严格的中文避头尾和安全断词。

作用：减少标点出现在行首、长网址或中英混排造成的尴尬断行。

中西文混排

效果：在浏览器支持时渐进启用中西文自动间距、标点挤压和标点悬挂。

作用：中文、英文、数字放在一起时更接近纸面排版；代码块和表格保持原样，不受影响。

性能与稳定性

更快的写作启动

效果：焦点层级合并计算，字数统计、草稿保存和纸边索引加入防抖。

作用：减少输入和滚动时的重复计算，长文写作更稳定。

全站图片加载

效果：长文图片在首图之后使用异步解码和懒加载。

作用：减少滚动时的白屏和卡顿。

这轮还修复了：系统暗色搭配主题亮色时评论区部分文字发亮或看不清；写作页明暗切换后纸面仍然泛亮；嵌套抽屉切换后历史丢失；后台草稿同步可能覆盖正在输入的内容；首页瞬间信息错位、选中文字体验、全局 Toast 和跨标签页明暗同步等多项细节。

兼容性

支持 Halo 2.27+；Chrome、Edge、Firefox。Safari 和 macOS 暂未实机承诺。排版增强会按浏览器能力渐进启用，不支持时自动回退。

此版本要求 Halo 2.27.0 或更高版本。

新特性

• 支持显示评论和回复的 IP 属地，中国大陆显示省份，其他地区显示国家或地区；开启后会自动补充历史评论的属地信息 by @ruibaby in #262
• 支持在评论和回复表单中选择是否接收后续回复通知，并可在插件设置中控制是否允许用户自行设置（默认关闭） by @ruibaby in #190

Full Changelog: v3.4.0...v3.5.0

Generated from v3.5.0

整体换了一套界面，导航移到底部，2D 地图的弹窗统一，主题色全站生效，新增留言板。
要求 Halo 2.27.0 及以上。

升级前请看

• 要求 Halo 2.27.0 及以上，低版本的 Halo 装不上。
• 2D 地图的图片墙去掉了。点任何足迹都弹同一张信息卡：封面（没有封面用图片墙第一张）、地址、城市、类型、日期，
  有关联文章时带「查看文章」。后台的「图片墙样式」「图片墙单页展示数量」两项一并删除。
  足迹里的「图片墙图片」照常保存，3D 的照片环与城市相册仍然用它。
• 「hsl颜色值」换成取色组件「主题色」，旧值升级时自动换算。以前它只管 2D 地图上去过的城市，
  现在按钮、城市圆点、省份高亮、明信片、票根、书架都跟着它变。存过别的颜色的站点，升级后整个前台会换成那个颜色；
  想要默认的淡紫，在「基本设置 → 主题色」里选回 #7c7bc0。

界面

• 换成「柔光玻璃」风格：浅灰底、半透明白玻璃面板、大圆角柔阴影、圆形照片标记、一种强调色；
  标题统一用插件自带的快看世界体。3D 地球、城记、票根册、世界这本书、2D 地图全部换过。
• 顶部导航改成底部导航坞（2D 地图、城记、这本书、票根册、留言板，以及地球开关），
  不会再和主题自己的顶部导航重复；窄屏时开关收进「工具」。
• 3D 首页左侧的标题卡去掉白底，字直接写在星空上；足迹数、城市数改成两个大数字。
• 2D 地图左上角标题去掉面板，卫星图下自动换白字。
• 底部坞里开着的开关从实心紫块改成淡紫底；左下角说明只写「地图数据 © 高德、天地图」，
  底图名、坐标系这些只在地址加 ?debug 时显示。
• 书架木架改成灰白的白蜡木。

新功能

• 留言板：3D 底部坞和 2D 控制栏都有「留言板」，点开从右侧滑出一个整页的 Halo 评论区（手机上从底部升起）。
  需要装评论组件插件并在站点设置里开评论，否则按钮不显示。后台评论列表里显示为「足迹 · 足迹留言板」。
• 城市圆点合并：整球视野下，屏幕上挨得太近的城市合成一个点，数字是这几座城的足迹数之和；
  悬停显示「厦门等 12 座城，24 条足迹」，点它飞近后自动分开。
• 主题色：见上文。主题色很浅时，按钮上的字自动从白换成深墨。
• 设置效果图：标记点样式、悬停高亮方案、地名标注等选项改用 Halo 2.27 的 toggle 组件，每个选项一张效果图。

修复

• 「地球地名标注」选「关闭」不生效（配置里的 off 被当成了布尔值）。
• 窄窗口下 2D 底部控制栏伸出屏幕左边。
• 从全国视野点标记时，弹窗刚出来就被收掉。
• 外链没写 https://（如 www.xxx.com）时，「查看文章」被当成站内路径。
• 足迹超过 1000 条时，多出来的不显示。
• 拖动地球时掉帧：悬停判定改为屏幕空间计算；关掉地面大气，缩远看地球时帧率接近翻倍；
  第一次放大到城市不再顿一下。
• 票根页提示「滚动鼠标」改为「拖动或用滚轮切换票根」。

后台

• 「足迹」管理页改为和 Halo 2.27 官方插件一致的工作台样式。
• 插件作者改为 Handsome & 云端；描述按新版重写。

开发

• 前台代码拆成 ES 模块，由 esbuild 打包；构建时检查模块注入契约与视觉规范，前台纯函数补了单测。
• 依赖升级到 Halo 2.27，去掉国内镜像源。

Generated from v2.0.0

修复

• 修复部分环境保存插件设置时并发配置监听出现类型转换异常，导致新的全局并发上限可能未及时生效的问题。
• PNG 256 色压缩在输出文件没有变小时保留原图，避免小图或颜色简单的图片压缩后反而变大。

Generated from v0.4.3

修复配置页面显示错误

Generated from v0.4.2

修改插件功能描述

Generated from v0.4.1

新增

• JPEG 压缩：可独立开启质量压缩，质量范围 1–100，默认 80；保持 JPEG 格式和尺寸。
• WebP 压缩：可独立开启质量压缩，质量范围 1–100，默认 80；保持 WebP 格式、尺寸和透明度。
• 附件后缀统一：JPEG/JPG 统一为 .jpg，PNG 统一为小写 .png，WebP 统一为小写 .webp。
• Jpg、PnG、WebP 等混合大小写也会在上传时规范，文件名主体保持不变。

Generated from v0.4.0

新增与优化

• 读者排行新增排除名单，可在插件设置的“读者排行”中选择不参与排行的 Halo 用户或邮箱，例如排除博主。对所有统计周期及页面、侧边栏组件生效，并自动补齐后续读者。#33
• 页面读者榜称号与评论区等级徽章同步，使用相同的名称、图标、颜色和提示。等级按累计评论数计算，不随名次或统计周期变化；未获得等级徽章时不显示称号。#33

问题修复

• 修复部分较旧浏览器中排行榜溢出、头像尺寸异常和背景、边框显示不完整的问题，改善手机端与窄侧栏的显示。#32

完整更新日志：1.0.13...1.0.14

Generated from 1.0.14

• 调用AI失败后增加重试

Generated from v0.3.1

此版本要求 Halo >= 2.27.0。

新特性

• 支持 JSON 与树形双模式编辑、模型校验及编辑模式切换时保留草稿 by @ruibaby in #7
• 新建数据时根据模型定义自动生成包含必填字段和默认值的资源模板 by @ruibaby in #7

功能优化

• 重构数据工作区，优化模型分组选择、记录摘要、批量操作和小屏布局 by @ruibaby in #7
• 完善保存状态、未保存更改提醒、资源标识校验和导入错误提示 by @ruibaby in #7

Full Changelog: v1.0.0-alpha.9...v1.0.0

Generated from v1.0.0

新增功能

• 新增图片压缩与 WebP 转换，支持调整图片质量、限制最大宽度，并保留透明背景。
• 新增自定义随机图接口，支持图片直出、302 跳转、纯文本图片地址和 JSON。
• 支持自动识别 JSON 图片字段，也可通过 data.url、data[0].url 等路径指定图片地址；选中图片数组时随机取一项。
• 支持设置默认随机图来源，用于生成面板和发布时自动补齐封面。
• 新增「测试接口」按钮，无需保存即可验证是否能获取有效图片，支持成功状态和具体失败原因提示。

Generated from v1.3.0

新增功能

新增「PNG 压缩方式」设置，提供三种模式：

• 不处理：保持原图，默认选项。
• 256 色压缩（白底合成）：将透明区域与白色背景合成后压缩。
• 256 色压缩（去透明）：移除透明通道，保留像素原始颜色后压缩。

压缩适用于编辑器、文章列表和发布后自动生成，在预览及上传前统一处理，保持图片宽高尺寸。

使用说明

• 升级后默认不处理图片，可在插件设置中开启。
• 设置作用于后续生成的静态 PNG，已有封面和附件保持原样。
• 256 色量化属于有损压缩，实际体积和画质取决于图片内容。
• 图片处理在服务端完成，无需安装额外程序。

Generated from v0.3.0