• 新增最近使用分类，可在设置中设置显示数量。
• 将会记住上一次打开的分组和浏览到的页码

MiniDocs v1.0.1

一、功能优化

1. 知识库详情页：刷新记忆当前文章与布局

• 打开某篇文章后，当前文档会同步到 URL 参数，刷新页面后自动恢复正在阅读的文章
• 自动展开该文章的所有祖先目录，保持浏览上下文
• 侧边栏宽度、目录展开/折叠状态通过 localStorage 按知识库持久化，刷新后恢复

2. 知识库详情页：默认打开第一篇文章

• 进入知识库时，若未指定文档，自动打开第一篇文章（含目录嵌套时取第一个叶子文章）

3. 知识库详情页：移除文章树状态小圆点

• 移除了文章树每行右侧的发布状态小圆点（蓝色/灰色），界面更简洁

4. 阅读页大纲：默认展开到二级标题

• doc.html（阅读页）与 doc_share.html（分享页） 的右侧大纲统一优化
• 刚打开文章时，大纲默认展示一级 + 二级标题（H1 展开出 H2，H2 及更深折叠）
• 点击 H2 前的箭头可手动展开查看更深层级，滚动定位时仍自动展开活动节点祖先链

5. 知识库导出：文件名规范优化

• 单知识库导出：优先使用别名（slug）命名，如 KB20260828105721916349521.zip
• 别名为空时回退：MiniDocs-{timestamp}.zip
• 批量导出：MiniDocs-{timestamp}.zip

二、Bug 修复

1. 修复知识库批量导出接口异常

• 修复 POST /knowledgebases/export 端点在响应式链中调用 .blockOptional() 阻塞 reactor 事件循环线程导致的请求异常
• 改为全响应式非阻塞过滤，导出功能恢复正常

2. 修复阅读页点赞功能

• 修复 doc.html 模板点赞不生效问题：重构点赞逻辑，确保事件正确绑定、错误可追踪
• 点赞成功后点赞数实时 +1，本地去重防重复点赞

• 支持导入 Lottie 动画时预览
• 支持瞬间插件使用 Lottie 动画

通过 JS 注入 实现，可能有未知 BUG。

新特性

• 支持通过 URL 上传远程附件，并沿用 Halo Console 的附件策略与分组 by @ruibaby in #11
• 支持查询和版本校验更新当前主题设置，以及列出和安全读取主题模板 by @ruibaby in #10

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

Generated from v1.1.0

v1.1.7（2026-09-02）

修复

• 修复深色模式设置页中自定义单选按钮不可见的问题。
• 修复 Vue scoped 样式无法作用于 Halo VEntity 插槽内容的问题，确保主题模式和编辑页策略选项均显示圆形单选控件。

验证

• 在本地 Halo 实例中实测 5 个单选控件均正常渲染。
• pnpm type-check、pnpm lint:check、pnpm test:unit、pnpm build 与 ./gradlew build 通过。

新特性

• 新增瞬间列表页和详情页默认模板 by @ruibaby in #199
• 新增 MCP 工具，支持查询、获取和创建瞬间 by @ruibaby in #200

Full Changelog: v1.17.1...v1.18.0

Generated from v1.18.0

新特性

• 新增 MCP 图片发现能力，安装 MCP Server 1.x 后可搜索 Unsplash、Pexels 和 Pixabay，并支持 Unsplash 下载准备 by @ruibaby in #7

功能优化

• 适配 Halo 2.26，最低支持版本调整为 2.26

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

Generated from v1.4.0

• 增加骨架屏

在动画文件尚未加载完前显示

新特性

• 适配 MCP Server 插件，提供 11 个文档工具，支持发现、读取、搜索、创建、编辑、移动和发布文档

功能优化

• 记住项目编辑页的全屏偏好，切换文档或刷新页面后继续保持
• 减少文档树拖拽排序时不必要的更新请求
• 在应用市场中推荐可选的 MCP Server 配套应用

新特性

• 支持恢复回收站中的文章和独立页面

功能优化

• 附件上传自动沿用 Halo Console 的附件策略与分组，并明确 7 MiB 上传限制
• 支持仅更新文章和独立页面元数据，并避免并发内容更新互相覆盖
• 编辑访问密钥时保留暂不可用的既有工具授权，工具目录加载失败时禁止保存
• 轮换访问密钥时保留原有启停状态，并在概览中及时排除已过期密钥

问题修复

• 修复开发模式下贡献工具可能无法识别，以及仅返回结构化内容时部分客户端无结果的问题 by @ruibaby in #8
• 修复文章、独立页面创建或更新失败时可能遗留未引用资源的问题

开发者相关

• 贡献工具改为声明插件内 snake_case 名称，由 MCP Server 生成全局协议名称
• 收紧贡献工具结构化结果类型，并隔离异常、阻塞或超量的 Provider，避免影响其他工具

Full Changelog: v1.0.0-beta.1…v1.0.0

性能优化

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

一些优化

• 优化生产插件打包配置。

Bug修复

• 修复插件主题集成数据展示问题
• 修复星链资讯左侧列表数据加载动画和数据加载问题

其他

• 一些你可能并不在意的小更新

v2.0.10 (2026-09-01)

• 美化文章页 Markdown 表格
  • 增加清晰可见的表格线、表头、斑马纹、悬停和暗色模式样式
  • 宽表格在移动端支持横向滚动
  • 表格内链接保持紧凑的正文链接样式

v1.1.6（2026-08-31）

新增

• 设置页新增「编辑页 Dark Reader」选项，二选一：
  • 完全使用 Dark Reader：文章 / 页面编辑页也保持深色，适合使用 Markdown 等不受崩溃影响的编辑器
  • 在文章编辑页面禁用 Dark Reader：编辑页强制白天，避免富文本编辑器与 Dark Reader 动态分析互相触发导致的卡死（默认）

调整

• 编辑页是否禁用 Dark Reader 由上述设置决定，不再一刀切全部禁用；策略持久化到 localStorage（halo-dark-mode-editor）并在多标签页间同步

验证

• 前端单元测试通过（新增编辑页策略相关用例）
• ./gradlew build 成功，产物 plugin-dark-mode-1.1.6.jar

Bug修复

• 修复世界频道头像大小、头像装饰、用户称号渲染的问题。

Bug 修复

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

v1.1.5（2026-08-31）

修复

• 解决文章 / 页面编辑页深色模式下卡死的问题：在编辑页彻底禁用 Dark Reader 引擎，切断 contenteditable（如 ByteMD / 富文本）与引擎动态分析之间的相互触发

行为变化

• 编辑页识别采用「路由 + 编辑区 DOM」双重判断：只要 URL 以 /editor 结尾，或页面出现 .ProseMirror / .editor-content / [contenteditable] / .editor 任一编辑区节点，即执行 disable()，并强制 color-scheme: light
• 编辑页整页转为白天模式：无论全局主题是深色还是浅色，进入编辑页时左侧导航、工具栏、正文均显示为 Halo 默认浅色；退出编辑页后自动恢复全局主题
• 通过劫持 history.pushState / history.replaceState、监听 popstate、MutationObserver 与兜底轮询，在进出编辑页时即时重应用 DR，无需整页刷新

验证

• 前端单元测试通过（含“编辑页 URL 命中强制禁用”“编辑区 DOM 出现强制禁用”“离开编辑页恢复”用例）
• ./gradlew build 成功，产物 plugin-dark-mode-1.1.5.jar

功能

• 重要日期：名称+日期+备注；阳历/农历（含闰月）；每年自动循环；自研日期选择器（阳历日历标注农历）
• 人员管理：姓名/昵称/关系/生日/血型/身高/体重/喜好/备注；日期关联多人、按人筛选
• 到期提醒三处：①控制台仪表盘常驻小组件（无关闭、每分钟刷新，Halo 2.21+）②后台+前台横幅「「…」明天就到啦～」③全站悬浮弹窗（位置可选、倒计时、关闭菜单：本次/3天/10天/永久）
• 隐私：日期/人员各自「前台展示」开关；体重血型等敏感字段永不出现在前台；生日默认脱敏
• 前台页：插件自带默认模板，主题可提供同名模板自定义覆盖（TemplateNameResolver），不写入/不修改主题文件
• 操作日志：新增/编辑/删除及开关切换全记录；导出/导入：JSON 判重跳过
• Finder API：importantDateFinder 供主题自定义

兼容与合规

• Halo 2.20+（基于 2.20 平台 API 编译；2.20.20 与 2.26.0 双版本全流程 36/36 实测通过；2.14–2.19 未验证）
• 数据存于站点数据库；插件无任何联网请求、不采集用户数据；MIT 开源
• 按 2026-09 应用市场审核意见整改：脚本经官方 TemplateHeadProcessor 扩展点输出（不读写系统配置）、不再写入主题文件（零残留）、兼容范围统一 >=2.20.0

安装

上传 jar → 插件 → 安装 → 启用；前台访问 /important-dates 查看插件默认模板页面；升级不丢数据（停用→卸载→装新版）。

添加压缩包文件数量限制
从动画文件中读取宽高设置为默认不启用

开发者相关

• 新增 Halo 2.26 页面布局契约，插件前台页面可复用主题页头、页脚、样式和脚本

新特性

• 支持 Halo 页面布局契约，插件前台页面可复用 Apex 的页头、页脚与响应式布局

• ✨ 优化图片预览组件对浏览器工具栏高度变化时的表现；

v1.1.4（2026-08-30）

调整

• 移除插件对 Halo 官方设计 token（--halo-*）的全局覆盖，后台所有页面（官方页 + 第三方插件页）配色回归官方默认，不再被自定义绿色系主色污染
• README 补充 Dark Reader vendored 依赖溯源：说明 4.9.129 与官方 4.9.128 的差异、构建所需文件清单，以及 SHA256SUMS 的生成与校验命令
• 消除 Gradle 脚本中 group '...' 空格赋值语法的弃用（改用 group = '...'），并记录 run.halo.plugin.devtools 的 generatePluginComponentsIdx 已知弃用限制

清理

• 移除未被引用的前端资产 ui/src/assets/logo.svg（插件图标实际使用 src/main/resources/logo.png）
• 移除 0 字节的空文件 workplace/roleTemplates.yaml
• 移除 useDarkMode 中系统偏好变化时的冗余 DOM 应用逻辑（行为不变）

验证

• pnpm type-check / lint / test:unit（3 份测试文件、17 例）/ build 全绿
• ./gradlew build 成功，产物 plugin-dark-mode-1.1.4.jar 内含更新后的 ui/main.js、ui/style.css 与 logo.png

首个版本发布

halo-theme-cosolar v1.1.6

新增功能

主题接入了「知识库」功能——可以把成套的文档像书一样组织起来给访客阅读；同时优化了页脚在极简模式下的留白，并让部分插件页面自动拥有和站点一致的外观。

✨ 新增 1：知识库功能（列表页 + 三栏阅读页）

配套 MiniDocs 插件后，你的站点可以多出两个页面：

• 知识库列表页 /docs：像书架一样展示你所有的知识库。
• 知识库阅读页 /docs/view/{知识库}：像看电子书一样浏览文档。

列表页能做什么

• 顶部统计看板：知识库总数、文档总数、标签数量、访问量、点赞量。
• 搜索（按 / 键即可聚焦）与标签筛选，支持四种排序：最近更新 / 文档最多 / 名称 A-Z / 最新创建。
• 卡片视图与列表视图一键切换；内容多时自动分页。
• 左侧边栏展示「今日动态」（今日更新数、文档总数、贡献者）、「最近更新」和「标签云」，点标签即可筛选。
• 卡片可直接点赞，访客无需登录（浏览器本地记录，避免重复点赞）。

阅读页能做什么

• 三栏布局：左边文档目录树、中间正文、右边文章大纲。
• 点目录直接换文章，不刷新页面，翻文档时不会被打断阅读节奏；地址栏同步变化，方便复制分享。
• 目录树可搜索、可折叠，当前文档自动高亮并展开所在层级。
• 右侧大纲跟随滚动自动高亮所在章节，支持分组展开 / 收起，点击即平滑跳转。
• 代码块带语言标签和一键复制按钮；mermaid 图表支持「预览 / 源码」切换。
• 两侧栏宽度可拖拽：文档树 200–520px、大纲 170–480px，宽屏窄屏都能调到舒服的比例。
• 底部信息栏显示文档路径、字数、行数、作者与创建 / 更新时间。
• 顶部工具条提供：返回知识库、加入浏览器书签、复制链接、点赞、访问量。
• 完整支持暗色主题与手机浏览。

怎么开启

1. 安装并启用 plugin-minidocs 插件（下载：halo-plugin-minidocs Releases）。
2. 在插件设置中开启「允许未登录用户阅读」（希望游客也能看的话）。
3. 在后台创建至少一个公开知识库，并在其中发布至少一篇文档。
4. 访问 /docs 即可看到效果，无需在主题里额外开关页面。

不需要知识库功能？不装插件即可，博客其他部分完全不受影响，只是 /docs 不可访问。

可以设置什么

在 主题设置 → 知识库页设置 中：

✨ 新增 2：插件页面自动沿用站点外观

主题适配了 Halo 2.26 的「页面布局契约」。简单说：部分支持该能力的插件，其前台页面会自动带上你站点的页头、页脚、主题色与暗色模式，不再出现「点进插件页面突然换了套皮肤」的割裂感。

• 无需任何配置，升级主题后自动生效。
• 在 主题管理 中查看主题状态时，布局契约一项会显示为「支持」。

🐛 修复

• 关闭「页脚主区域」后，底部版权条上下不再出现大片空白，分割线也一并隐藏，极简页脚更紧凑。

💄 细节优化

• 知识库卡片上的标签徽标改为青绿主题色，与站点配色统一。

⬆️ 升级指南

1. 确认 Halo 版本 ≥ 2.25.0（后台「关于」或系统信息查看）。低于该版本请先升级 Halo，否则主题会提示版本不满足。
2. 从 Releases 下载 halo-theme-cosolar-1.1.6.zip。
3. 进入 后台 → 主题管理 → 安装主题，上传 ZIP；若提示已存在，可先卸载旧版再安装，或直接覆盖安装。
4. 启用后无需重新配置，原设置项完整保留；新版本只新增了「知识库页设置」分组。
5. 首次使用知识库功能，请先完成上面「怎么开启」的 4 步。

❓ 升级后常见问题

升级提示「Halo 版本不满足」怎么办？

把 Halo 升级到 2.25.0 及以上即可。这是本次唯一一项硬性要求变化。

/docs 打不开或列表是空的？

按顺序检查：① 已安装并启用 plugin-minidocs；② 插件设置已开启「允许未登录用户阅读」；③ 至少有一个公开的知识库；④ 库内至少有一篇状态为已发布的文档。

阅读页点目录没反应 / 提示无权限？

阅读页优先走公开接口；若是私有知识库，需要已登录且有权限的账号才能查看，未登录会提示「无权限查看该文档」。

只想安安静静写博客，可以不用知识库吗？

完全可以。不安装 plugin-minidocs 时，主题所有原有功能不受影响，也不会多出任何入口。

历史版本

更早版本的变更记录见 GitHub Releases。

知识库预览

• ✨ 优化图片预览组件的展示；

✨ 新增功能

内容分组展示：后台“展示内容”现已支持按“大分类”及“二级标题”进行层级分组，前端页面完全同步后台的分类与显示顺序。

自定义拖拽排序：后台新增卡片拖动排序功能。支持在同分组内自由拖拽调整顺序，松手即自动保存；新建卡片或跨组移动时，默认追加至分组末尾。

更新内容

📱 适配 Halo Pocket 移动端

• 插件简介与文档补充 Halo Pocket 适配说明
• 开放 umami/metrics?type=referrer 来源分布维度 API（v1.1.3 起），供 Halo Pocket 统计页展示访客来源构成

Halo Pocket 是 Halo 2.x 博客的管理端移动客户端，现已上架华为应用市场，搜索「Halo Pocket」即可免费下载使用。

升级说明

• Console → 插件 →「文章数据趋势分析」→「升级」，上传新版本 jar 即可，配置与点赞统计数据不会丢失

Generated from v1.1.4

更新内容

📱 适配 Halo Pocket 移动端

• 插件简介与文档补充 Halo Pocket 适配说明
• 聚合的 备份完成 ✅ / 新文章发布 📝 / 文章删除 🗑️ / 登录提醒 🔐 四类通知，可在 Halo Pocket 的通知中心与首页动态流中直接查看，零额外配置

Halo Pocket 是 Halo 2.x 博客的管理端移动客户端，现已上架华为应用市场，搜索「Halo Pocket」即可免费下载使用。

升级说明

• Halo 后台 → 插件 → 上传新 jar 覆盖安装即可，开关配置与订阅状态不会丢失

Generated from v1.0.15

更新内容

📱 适配 Halo Pocket 移动端

• 本插件聚合的 备份完成 ✅ / 新文章发布 📝 / 文章删除 🗑️ / 登录提醒 🔐 四类通知，现已可在 Halo Pocket（Halo 2.x 跨平台移动客户端）的通知中心与首页动态流中直接查看，支持未读角标与已读管理
• 零额外配置：通知走 Halo 标准通知中心 API，升级本插件后 App 侧即可消费

稳定性改进

• 权限重校验增加容错：瞬时故障不再影响插件启动与生命周期，等待下次角色变更/投递前自动重试
• 停用清理范围覆盖全部插件相关订阅（含早期无标签存量订阅）
• 移除旧版本（≤1.0.11）订阅迁移代码

升级说明

• Halo 后台 → 插件 → 上传新 jar 覆盖安装即可，开关配置与订阅状态不会丢失

Generated from v1.0.14

更新内容

📱 适配 Halo Pocket 移动端

• 开放 umami/metrics?type=referrer 来源分布维度 API，供 Halo Pocket（Halo 2.x 跨平台移动客户端）统计页展示访客来源构成（按域名聚合，直接访问单独归类）
• App 首页「最新动态」的每日点赞汇总、统计看板数据均来自本插件 API，升级后移动端体验更完整

升级说明

• Console → 插件 →「文章数据趋势分析」→「升级」，上传新版本 jar 即可，配置与点赞统计数据不会丢失
• 未使用 Halo Pocket 的用户无感知，可正常升级

Generated from v1.1.3

呀呼！欢迎使用 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

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

✨更新内容

• feat(message-board): 重构留言版界面

Full Changelog: 1.22.6...1.22.7

Generated from 1.22.7

问题修复

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

• ✨ 优化页面渲染逻辑，提升用户体验；

MiniDocs 知识库 v1.0.0

MiniDocs 是 Halo 2.x 的轻量知识库插件，用于搭建团队 / 个人知识库：多知识库管理、文档树、Markdown 编辑、分类标签与权限控制，并将知识库内容通过公开接口与 Finder 暴露给第三方主题，方便开发用户侧文档站点。

插件同时提供 Console 管理界面、minidocsFinder Finder API 和匿名公共 REST API，适用于传统 Thymeleaf 主题和前端框架渲染的文档页。

目标平台：Halo >= 2.26.0

功能特性

• 知识库管理：支持多知识库创建、编辑、删除，公开 / 私有切换、成员授权与排序。
• 文档管理：支持文档树层级、Markdown 编辑、slug 别名、发布 / 草稿状态、标签与封面。
• 分类标签：知识库与文档均支持标签，便于按主题归类与检索。
• 权限控制：内置「知识库查看」「知识库管理」角色模板；私有知识库可指定成员（可访问者）列表，服务端按「创建者 / 成员 / 管理员」做资源级访问校验；可开关「允许未登录用户阅读公开知识库」控制匿名访问。
• 文档发布：支持单篇文档发布，发布后内容通过公开接口与 Finder 对外可见。
• 文档导入导出：支持批量导入（同名知识库安全覆盖、失败自动回滚保留原数据），以及将文档导出为 Markdown（受导出开关约束）。
• 外链分享：知识库卡片可一键开启外链分享，生成 /docs/share/{token} 对外链接，支持可选访问密码与有效期，分享页与阅读页同布局且无需登录。
• 主题适配：提供 minidocsFinder Finder API 与匿名公共 REST API，便于主题渲染知识库列表、文档树与文档详情。

• 🚀 文章内图片新增支持点击放大查看以及相关手势操作；

详情请参阅更新日志（在 GitHub 上查看）。
Please refer to Changelog (view on GitHub) for details.

howiehz-higan-zh-hans.zip 为简体中文默认安装包，仅包含 .br。
howiehz-higan-zh-hans-tiny.zip 为简体中文轻量安装包，移除默认字体资源，默认 logo 资源将替换为 1x1 占位图，不包含预压缩文件，且不注入 Mermaid / instant.page 运行时。
howiehz-higan-zh-hans-full-precompressed.zip 为简体中文完整预压缩包，包含 .gz / .br / .zst。
howiehz-higan-en.zip is the English default package with .br only.
howiehz-higan-en-tiny.zip is the English tiny package that removes the default font assets, replaces the default logo asset with a 1x1 placeholder image, omits precompressed assets, and excludes Mermaid / instant.page runtime injection.
howiehz-higan-en-full-precompressed.zip is the English full precompressed package with .gz / .br / .zst.

修复内容

• 图库页面隐藏没有照片的空影集分组。
• 首页站点动态中的图库内容改为直接链接到图片资源，修复点击后 404。

更新内容

• 归档页的分类与标签下拉菜单按关联文章数量排序，仅显示前 10 项。
• 瞬间页面的图片统一使用方形缩略图网格，点击可查看原图。
• 图库页面重构为影集列表：每个图库分组使用多图拼贴封面，点击后查看分组作品。
• 未分组图片新增独立影集入口。
• 图库页面新增右侧返回顶部按钮。

问题修复

• 修复 RSS 订阅可能包含私有瞬间的问题 by @ruibaby in #198

Full Changelog: v1.17.0...v1.17.1

Generated from v1.17.1

What's Changed

• 功能（模板）：添加可自定义的左上角标志文本及可点击链接 by @imorisun in #36

Full Changelog: v2.5.0...v2.5.1

Generated from v2.5.1

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

✨更新内容

• refactor(style): 优化section高度，使用css兄弟选择器控制
• refactor(config): 将主题配置脚本提取到独立模板文件并移入body中降低head大小
• fix(security_link): 修复安全连接未能加载主题资源问题

Full Changelog: 1.22.3...1.22.6

Generated from 1.22.6

bug修复

• 统一 AstrahBot 在频道消息、成员资料弹窗中的头像来源，消除弹窗状态污染及失效相对地址造成的头像异常。
• 修复邀请发送成功后，按钮状态被旧列表快照从“邀请中”短暂覆盖为“关注”的问题。
• 邀请、审核、取消与删除关系后，按相关站点和目标地址精确刷新关系投影，避免无关全量重算。
• 插件首页友链数量文案由“星球 N”调整为“关联 N”，准确表达该友链被多少站点关联。

移动端适配

• 完成 AstraHub 插件移动端界面、星际通讯、友链关系状态与共享节点数据交互的阶段性升级。

新增特性

• 新增世界频道星历签到与累计航行称号展示；达到 7、30、90、180、360、730 天时，自动获得头像装饰。
• 机器人情感/温度优化，进一步升级机器人自由度和响应速度。
• 新增世界频道和官方QQ群联动功能，通过世界频道@对应用户，机器人可向QQ群自动提醒对应用户。

其他优化

• 优化世界频道成员资料交互：点击成员后立即打开详情弹窗，并在资料与近期文章并行加载期间展示加载动画；增加请求隔离，避免快速切换成员时发生数据串位。

功能优化

• 优化 Emoji 插件加载性能，并将最低兼容版本调整为 Halo 2.26.0 by @LIlGG in #3

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

Generated from v1.1.0

新特性

• 顶部导航支持最多三级子菜单，适配桌面端、键盘操作与移动端展示

功能优化

• 可视化编辑器区块标题过长时自动截断，避免挤压展开图标

问题修复

• 修复移动端展开导航菜单时页头上移和菜单间距异常

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

✨更新内容

• fix(common): 修复关闭首页横幅时，内容区域高度计算错误问题
• refactor(config): 将主题配置脚本提取到独立模板文件并移入body中降低head大小
• fix(security_link): 修复安全连接未能加载主题资源问题

Full Changelog: 1.22.3...1.22.5

Generated from 1.22.5

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

✨更新内容

• fix(common): 修复关闭首页横幅时，内容区域高度计算错误问题
• refactor(config): 将主题配置脚本提取到独立模板文件并移入body中降低head大小

Full Changelog: 1.22.3...1.22.4

Generated from 1.22.4

问题修复

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

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

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

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

Halo MCP Server 首个 Beta 版本，让 Codex、Claude Code、Cursor、VS Code 等 AI 客户端通过受控的访问密钥管理 Halo 网站。

新特性

• 搜索、读取、创建、更新、发布和回收文章及独立页面
• 查询和管理文章分类、标签、评论、评论回复及附件
• 为不同客户端创建独立访问密钥，并配置可用工具、有效期、启停、轮换和 IP 白名单
• 在 Halo 控制台查看服务概览、工具契约和最近调用记录
• 为常用 MCP 客户端生成连接配置，密钥通过环境变量或安全输入读取
• 自动发现其他 Halo 插件贡献的 MCP 工具

展示架 1.3.7 正式版

主要功能：

1. 支持展示内容的新增、编辑、删除和发布管理。
2. 支持分类、二级标题、封面、标签、简介、观看感受、评分和观看链接。
3. 支持自定义前端主题颜色、背景图片或视频。
4. 支持樱花飘落、繁星点点、鱼群等页面动效。
5. 支持白天/黑夜模式切换。
6. 支持与 Steam 信息展示插件联动。
7. 支持离站跳转确认提示。
8. 支持从 Halo 附件库选择封面图片和 GIF 动图。
9. 支持接入 Halo 评论组件的匿名评论，昵称必填，邮箱和网站可选。
10. 支持邮箱头像显示和访客网站链接跳转。
11. 支持读取并展示 Halo 站点名称、Logo 和 Favicon。
12. 修复插件启动时因 ObjectMapper 依赖导致的加载失败问题。
13. 优化移动端和桌面端布局，以及暗色模式下的显示效果。
14. 修复访客统计关闭后仍可能写入数据的问题。
15. 限制访客标识格式和存储容量，避免客户端标识无限保存。
16. 增加访客统计限频、并发控制和计数器溢出保护。
17. 访客统计数据仅使用展示架自身资源保存，不修改 Halo 全局设置或其他插件配置。

呀呼！欢迎使用 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

新增

• 支持「外部链接」类型的附件作为下载资源：访客（按需完成邮箱验证）并计数后，浏览器 302 跳转到外部地址直接下载，文件不经服务器中转、不占带宽
• 外链地址非法时自动回退为服务端代理抓取

说明

• 外链附件的防直链不适用（真实地址对访客可见），下载统计与邮箱验证仍正常
• 文档已同步更新外链附件说明、防直链边界与 FAQ

构建

• 修复 Gradle 9 与 foojay-resolver-convention 0.8 的兼容问题（升级至 1.0.0）

Generated from v1.3.3

破坏性更新

• API 数据结构有变化

功能优化

• 数据迁移至 SQLite

What's Changed

WARNING

包含破坏性更新. 升级前请备份主题配置, 升级后需要重新检查主题设置.

破坏性更新

• 最低 Halo 版本要求由 2.8.0 提升至 2.22.0
• 重构主题设置分组, 升级后需要重新配置
• 页头功能开关统一调整为数组
• 自定义字体由单字体配置调整为字体数组
• 社交资料由固定平台字段调整为可自定义数组, 原 GitHub, Email, Discord, Telegram 等配置需要重新添加
• 自定义配色调整为结构化配置, 并重构配色 CSS 语义变量
• 自定义配色选择器由 html[theme-color-scheme] 调整为 html[data-theme-color-scheme]
• 布局, 表格和配色等自定义属性统一调整为 data-* 属性
• 首页置顶图标位置值由 pin-left, pin-above 调整为 left, above

新功能

• 支持添加多套自定义配色, 并可分别配置文字, 导航, 控件, 边框, 选中背景, 光标和代码等语义颜色
• 支持配置多套自定义字体 fallback, 并可分别配置字重, Unicode 范围等
• 支持自定义页头功能按钮, 并可添加自定义功能按钮
• 支持添加任意社交资料
• 页头功能按钮支持自由排序和显示控制
• 新增友链申请支持, 包括表单提交, 验证码刷新与过期提示, 提交状态反馈和多语言文本
• 新增联系表单插件样式适配
• 归档页新增分页开关, 以及 全部展开, 全部收起 和 仅展开首项 三种年份展示模式

修复

• 修复菜单项设置的打开方式未生效的问题
• 修复 PJAX 页面切换期间可能重复插入样式的问题
• 修复评论组件缺少 fallback 字体的问题
• 修复分类和标签列表未使用自定义时间格式与元信息分隔符的问题
• 修复部分主题设置默认值, 显示条件与模板行为不一致的问题

样式

• 重构配色语义变量
• 更新页头按钮图标
• 默认外观调整为跟随系统
• 使用标准 list-style-type 控制无序列表标记

杂项

• 按新版 Halo 主题模板规范重构页面布局
• 简化共享页面布局及相关样式覆盖
• 补充外观切换和友链申请的多语言文本
• 移除旧版访客偏好迁移逻辑和字体预加载逻辑

Full Changelog: 2.6.0...3.0.0

Generated from 3.0.0

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

✨更新内容

• feat(sidebar): 添加移动端抽屉式侧边栏功能
  • 默认关闭，开启后侧边栏模块将显示在移动端抽屉式菜单中。“信息模块”和“目录模块”始终不显示。

Full Changelog: 1.22.1...1.22.3

Generated from 1.22.3

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

✨更新内容

• feat(sidebar): 添加移动端抽屉式侧边栏功能
  • 默认关闭，开启后侧边栏模块将显示在移动端抽屉式菜单中。“信息模块”和“目录模块”始终不显示。

Full Changelog: 1.22.1...1.22.2

Generated from 1.22.2

1.3.10

修复

• 修复电脑端窗口较窄时 Halo 导航栏和插件会话栏同时占宽，导致长回复被挤成窄列的问题。
• 在宽度不超过 1200px 的电脑窗口中，会话列表改为顶部按钮打开的抽屉，聊天正文获得完整可用宽度。
• 长回复生成期间，用户主动向上滚动阅读时不再被自动拉回底部。
• 窗口尺寸变化时，如果用户原本停留在消息底部，会继续保持在最新回复末尾。
• 重新打开已有超长会话时，在布局完成后再次定位到最新消息，避免偶发停在会话顶部。

验证

• 使用本地 DeepSeek 模型生成 2187 字、16 次自然换行的真实角色回复。
• 覆盖 1440×1000 和 1024×768 两种电脑端窗口尺寸，并检查横向溢出、气泡边界、输入框位置和滚动状态。

问题修复

• 修复插件启动或重新启用后，对已有完整索引重复执行全量重建的问题。
• 启动时会检查现有索引是否完整且可读，符合条件时直接复用。
• 修复部分固定维度 Embedding 模型不支持 dimensions 参数而导致连接失败的问题。
• 自适应处理 Embedding 向量维度，已验证硅基流动 BAAI/bge-m3 可正常返回 1024 维向量。

升级说明

• 本次升级不涉及数据迁移和索引结构变更。
• Embedding 模型和向量维度不变时，无需重新建立索引。
• 现有插件配置和索引数据不受影响。
• 要求 Halo >=2.25.0。
• 必须安装并启用 Halo AI Foundation。

验证

• 文档检查通过。
• Gradle 完整测试与构建通过。
• Halo 2.25.4 与 Halo AI Foundation 1.0.1 实机验证通过。
• 插件重启后未触发重复索引，原有索引数据保持正常。
• 硅基流动 BAAI/bge-m3 连接测试通过，向量维度为 1024。
• SHA-256：5a2c95982ccca513366d27d6995b9c42cd2ce643085d02f4fe0eb60ec6fef93e

AI RolePlay 1.3.9

修复

• 修复 UC 桌面端聊天页错误减去 96px 高度，导致长回复换行后消息区过早滚动、可视区域被压缩的问题。
• 桌面端聊天页现在会完整占用可用视口高度，输入框继续固定在聊天区底部。
• 为消息行和消息内容补充 min-width: 0，避免长 URL、连续字符等内容撑开桌面聊天布局。
• 消息列表禁止横向溢出，长内容只在气泡内部换行并纵向滚动。

验证场景

• Chrome 桌面视口：1440 × 1000。
• Chrome 移动视口：390 × 844。
• 使用包含多段换行、长度超过单屏的角色回复进行对照测试。

安装

上传 plugin-ai-roleplay-1.3.9.jar 覆盖升级并重新启用插件。

AI RolePlay 1.3.8

新增

• 管理端仪表盘新增角色互动走势图，支持近 7、30、90 天切换。
• 展示所选周期内互动消息最多的前 5 个角色及每日变化。
• 管理端仪表盘新增用户情感走势图，展示积极、平和与消极倾向。
• 图表支持空数据提示、悬停明细和移动端响应式布局。

修复

• 修复 DashboardAnalyticsService 存在多个未标注构造函数，导致 Halo 插件容器无法创建 Bean、插件启用失败的问题。
• 新增 Spring 容器创建测试，防止相同的构造函数注入问题再次出现。

统计口径

• 角色互动按已持久化的用户消息数统计，最多展示前 5 个角色。
• 用户情感根据消息中的中英文情绪词进行轻量估算，仅用于运营趋势观察，不代表心理诊断。

安装

上传 plugin-ai-roleplay-1.3.8.jar 覆盖升级并重新启用插件。

Full Changelog: v2.1.0...v2.1.1

修复已知问题，然后吃了一顿蘑菇（很好吃(☆▽☆)）

Generated from v2.1.1

更新内容

• 优化分类页面展示，增加中文信息头部。
• 文章详情页支持封面背景标题区域。
• 修复封面文章分类链接颜色显示。
• 归档页分类和标签下拉菜单仅显示前 10 条。

MicroImmersion v1.6.0 发布日志

发布日期：2026-08-24
适配版本：Halo 2.26.0 及以上

本次版本主要完成 Docsme 文档插件的主题布局适配，解决文档页面空白、加载动画不消失、顶部菜单缺失、明暗模式冲突及版本切换 404 等问题。同时适配 plugin-douban 1.2.6+ 的新数据结构，并修复 51LA 统计功能的开关判断。

重点更新

Docsme 文档插件适配

• 文档列表、文档目录和文档详情页面接入主题统一布局。
• 文档页面现在可以正常显示主题顶部菜单、页脚及全局组件。
• 保持 Halo 2.26.0 要求的根目录 templates/layout.html 布局结构。
• 未配置文档模板来源时默认使用主题适配模板。
• 显式选择插件模板时继续使用 Docsme 原生页面，不受主题覆盖影响。

修复文档页面空白和持续加载

• 修复文档布局中 Thymeleaf 片段参数同名导致的递归渲染风险。
• 增加文档页面加载动画禁用标记。
• 文档页面不再等待插件资源的 window.load 事件关闭主题加载动画。
• 解决部署后文档页面持续转圈、内容无法显示的问题。

修复主题菜单与 Docsme 初始化冲突

Docsme 和主题都使用 Alpine.js，原有加载顺序可能导致 Docsme 提前接管主题节点，使顶部菜单一直保留 x-cloak 状态。

本次更新：

• 将 Docsme 主脚本调整为延迟执行。
• 增加 Docsme 就绪事件和主题启动等待机制。
• Docsme 继续负责文档侧栏、目录和版本切换。
• 主题 Alpine 继续负责顶部菜单、明暗切换及主题交互。
• 增加 3 秒超时兜底，避免插件脚本异常时阻塞主题初始化。

文档页面主题颜色适配

当后台选择“由主题提供文档模板”时，文档页面颜色会自动跟随主题设置：

• 主色和品牌色
• 激活状态颜色
• 悬停颜色
• 侧栏选中状态
• 文档目录高亮
• 页面及卡片背景
• 边框和分割线
• 多级文字颜色
• 亮色与暗色模式背景

选择 Docsme 插件原生模板时，不会加载这些主题颜色覆盖。

修复文档页面明暗模式

• 关闭 Docsme 自带的主题模式控制。
• 统一由主题维护 data-color-scheme 和明暗模式状态。
• 修复明暗模式偶尔点击不生效、刷新后才生效的问题。
• 修复 Docsme 覆盖主题“跟随系统”状态的问题。
• 文档页面位于顶部时使用实色菜单背景。
• 首页及带 Banner 的页面继续保留透明菜单效果。
• 统一文档页面、主题宿主和顶部菜单的背景色，修复圆角区域露出相反模式底色的问题。

修复文档版本切换 404

• 不再直接使用字符串替换生成目标版本地址。
• 对当前版本和目标版本 permalink 进行路径规范化。
• 切换版本时保留当前文档的后缀路径。
• 支持绝对地址和相对地址。
• 支持站点部署在子路径下的情况。
• 兼容 permalink 尾斜杠差异。
• 保留当前查询参数和页面锚点。

豆瓣插件适配

适配 plugin-douban 1.2.6+ 返回的 SQLite 扁平化数据结构。

数据结构调整

• 将原来的 spec、faves 嵌套结构调整为扁平字段。
• 新增 DoubanMovieData 类型。
• 更新豆瓣列表、详情和组件字段读取方式。
• 支持可空的名称、封面、类型、状态、评分和日期字段。
• 增加无效日期判断，避免渲染异常。

页面优化

• 更新卡片数据绑定和列表唯一标识。
• 筛选器、内容列表、空状态和分页区域增加 x-cloak。
• 减少 Alpine 初始化完成前的页面闪烁。
• 未改变豆瓣页面原有布局和视觉样式。

51LA 统计修复

• 将 51LA 开关默认值调整为 false。
• 使用明确的字符串布尔判断，避免空字符串被识别为已启用。
• 只有开关明确为 true 时才加载统计脚本。
• 只有同时配置监控 ID 时才执行 51LA 初始化。
• 修复控制台统计组件的变量命名和显示条件。

兼容性说明

• 最低 Halo 版本：2.26.0
• 豆瓣页面新数据结构适用于 plugin-douban 1.2.6+
• Docsme 原生模板模式保持不变
• 主题提供的文档模板会启用主题菜单、页脚、明暗模式和主题颜色
• 51LA 统计升级后需要在主题设置中明确启用，并配置有效的监控 ID

绿野 Luye 主题首个发布版本，要求 Halo ≥ 2.26.0。

深绿玻璃拟态风格：雾绿光晕、毛玻璃卡片、衬线大标题，视觉语言移植自 Ron567 个人主页
晴 / 雨 / 雪三种 Canvas 粒子背景特效，导航栏一键切换
完整模板：首页（Hero + 文章列表）、文章页、独立页、「关于我」自定义模板、归档、分类、标签、作者页、404
主题设置：Hero 文案与横幅图、强调色、天气/字体开关、页脚信息
安装：下载下方 theme-luye.zip，在 Halo 后台 → 外观 → 主题 → 安装主题中上传即可。

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

feat: 新增亮色配色支持，优化配置项与模板逻辑

• 新增配色方案配置，支持暗/亮色系一键切换
• 修复模板中配置值类型导致的500问题，重构文章/动态列表查询逻辑
• 重排配置项分组，更新文档与版本号
• 适配亮色主题的CSS变量与样式调整

Generated from v2.1.0

Full Changelog: v1.0.11...v2.0.0

Generated from v2.0.0

问题修复

• 修复评论组件样式文件因构建产物名称变化而无法加载的问题 by @ruibaby in #223

Full Changelog: v3.2.1...v3.2.2

Generated from v3.2.2

功能优化

• 优化评论编辑器和代码块高亮的加载体积，避免加载 Oniguruma WASM 资源 by @ruibaby in #222

Full Changelog: v3.2.0...v3.2.1

Generated from v3.2.1

功能优化

• 优化主题侧代码高亮加载，移除 Oniguruma WebAssembly 运行时，将高亮引擎依赖负载由约 274.5 KB 降至 59.3 KB gzip by @ruibaby in #35

依赖更新

• 升级 Shiki 至 4.4.3 by @ruibaby in #36

Full Changelog: v1.5.0...v1.5.1

Generated from v1.5.1

问题修复

• 修复回复分页条数与同时加载回复条数相同时，首次点击“加载更多”无法加载新回复的问题 by @ruibaby in #221

开发者相关

• 最低支持 Halo 2.26，并将控制台 UI 构建迁移至 Vite by @ruibaby in #220

Full Changelog: v3.1.2...v3.2.0

Generated from v3.2.0

新特性

• 新增访客友链申请，可在友链页面直接递交门牌。
• 新增二级导航，可通过 Halo 菜单的父子关系进行配置。by @LIlGG in #5

功能优化

• 完善主题内部链接与插件路由适配。

Full Changelog: v0.1.0...v0.2.0

Generated from v0.2.0

✨ 新功能

• 图标获取网址模板自定义：后台「外观」设置新增「图标获取网址模板」配置项（默认 https://toolb.cn/favicon/{host}，{host} 会自动替换为目标网址的域名）。toolb.cn 服务不可用时，可一键切换到自建 favicon 服务或其他同类模板，编辑器「直链 / 自定义」填入网址后自动按该模板生成图标。

🐛 问题修复

• 编辑器预览卡片垂直居中：修复预览虚线框内卡片下方间距比上方大、未居中的问题，上下留白现已等高。

兼容性：Halo >= 2.25.0 ｜ 浅色 / 深色主题 ｜ 桌面 / 移动端自适应

新特性

• 首页 Hero 区域新增轮播（Carousel）变体，支持最多 5 张幻灯片及自动播放间隔设置，新安装默认启用轮播变体，已有配置保持不变
• Hero 区域支持配置可选的媒体图片，可展示产品或应用截图，并支持浮动动画与面板宽度调节

功能优化

• 文章详情页 Banner 根据文章主分类展示标题、分类描述与完整面包屑路径，不再使用硬编码文案

新特性

• 友链页面新增「申请友链」入口，访客可以直接在弹窗中填写并提交友链申请（需配合链接管理 2.3.0 及以上版本）。

体积缩小至63 KB

功能优化

• 适配 Halo 2.26，并将最低运行版本调整为 Halo 2.26 by @ruibaby in #196

问题修复

• 修复切换瞬间审核状态后列表未正确刷新的问题 by @imorisun in #193
• 修复 Halo 2.26 下部分编辑器扩展与 Shiki 插件无法识别的问题 by @ruibaby in #197

Full Changelog: v1.16.1...v1.17.0

Generated from v1.17.0

问题修复

• 修复文档富文本编辑器无法加载 ESM 形式编辑器扩展的问题

问题修复

• 修复结构化输出在不同模型供应商中的 strict 适配、结束原因识别和错误诊断问题 by @LIlGG in #97
• 修复混合调用外部工具和服务端工具时，服务端工具可能不会执行的问题 by @LIlGG in #99

Full Changelog: v1.0.0...v1.0.1

Generated from v1.0.1

新特性

• 适配 Halo 2.26，支持询价商品展示“联系销售”，可跳转咨询链接或展示配置的联系方式

新特性

• 付费阅读新增易支付渠道，支持支付宝、微信支付二维码支付及回调校验（Pro）

开发者相关

• 升级插件构建工具链，并将最低兼容版本调整为 Halo 2.26.0

新特性

• 付费阅读新增易支付渠道，支持支付宝、微信支付二维码支付及回调校验（Pro）

开发者相关

• 升级插件构建工具链，并将最低兼容版本调整为 Halo 2.26.0

功能优化

• 统一文档树结构处理，提升复杂目录结构下路由、导航和搜索的稳定性
• 优化文档发布状态变更后的导航刷新，无需重启即可同步前后篇链接
• 优化文档编辑器高度适配，避免内容区域溢出

问题修复

• 修复包含中文或空格的文档永久链接未正确编码的问题

开发者相关

• 适配 Halo 2.26，最低运行版本调整为 2.26.0

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

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

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

Tips

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

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

新增

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

• 后台设置重组：新增「布局设置」设置页，将分散在多个页面的布局类设置集中管理；「基础设置」页删除，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

升级至 3.0.0 后，原有模型配置将完全不可用，且不会自动迁移。当前版本的模型能力已全部迁移至 AI Foundation，请确认 Halo 已升级至 2.26.0 或更高版本，并按照以下步骤重新配置模型：

升级步骤：

1. 安装并启用 AI Foundation。
2. 在 AI Foundation 中配置所需模型。
3. 检查 AI 助手插件设置，为已启用的 AI 功能重新选择模型。

新特性

• 新增编辑器 Agent，支持文章问答、内容修改审批、联网研究、附件检索和图片生成等能力

功能优化

• 编辑器 Agent 可根据当前编辑器的组件元数据生成和修改内容，并展示当前选中的上下文
• RAG 知识库表单新增常用 Embedding 维度预设，并支持搜索选择和自定义输入
• AI Foundation 改为可选运行时依赖，未安装或未启用时不再阻止插件启动
• 优化 AI 文章设置生成，仅生成所选字段，并结合当前文章内容校验和规范化结果

问题修复

• 修复 Halo 与插件 Lucene 版本冲突导致 RAG 索引无法初始化的问题
• 修复高维向量批量索引可能触发响应缓冲区溢出，以及空元数据可能进入引用信息的问题
• 修复待创建的 AI 分类和标签无法逐项移除，保存时仍会创建已拒绝项目的问题
• 修复 AI 文章属性字段名、推理选项及中文别名处理异常的问题
• 修复部分运行环境未注册 JsonMapper Bean 时编辑器 AI 与 RAG 组件无法初始化的问题

初版上架。

halo-theme-cosolar v1.1.5

1. 页脚 legal 链接开关修复

恢复此前被误 git checkout 还原的修复。将 legal 链接（隐私、条款、友链、关于）的开关判断从错误的 Elvis 写法 ?: true ? 改为正确的 ? 条件判断，确保开关关闭时不显示对应链接。

2. 移动端抽屉导航顶栏固定

修复打开抽屉（汉堡菜单）后顶部导航栏消失/被卷走的问题。在 @media (max-width: 768px) 内新增：抽屉打开时强制 .site-header 固定在最上层。

层叠关系：.site-header (z-index 101) > .header-nav 抽屉 (z-index 100) > .nav-backdrop (z-index 99)。

3. 移动端抽屉左侧灰色边框修复

DevTools 显示抽屉左侧存在 8px 灰色间隙，根因为桌面端 .header-nav { margin-left: 8px } 在移动端未被重置。在移动端 media query 内的 .header-nav 增加 margin-left: 0，消除左侧留白。

4. 友链简洁模式名称溢出省略

友链简洁模式下名称过长时改为省略号截断，避免溢出。

功能优化

• 按需加载 CodeMirror，减少编辑器初始化资源开销 by @ruibaby in #39

问题修复

• 修复在 Halo 2.26 中加载插件时可能出现的 ESM 导出错误 by @ruibaby in #39

开发者相关

• 迁移 UI 构建工具至 Vite，并将最低 Halo 版本调整为 2.26.0 by @ruibaby in #38

Full Changelog: v1.6.1...v1.7.0

Generated from v1.7.0

功能优化

• 优化 Console 编辑器中的 Shiki 初始化，无代码块时不再加载高亮器，并将编辑器初始化负载降低约 77% by @ruibaby in #33

开发者相关

• 适配 Halo 2.26，并将插件最低 Halo 版本要求调整为 >=2.26.0 by @ruibaby in #34

Full Changelog: v1.4.2…v1.5.0

详情请参阅更新日志（在 GitHub 上查看）。
Please refer to Changelog (view on GitHub) for details.

howiehz-higan-zh-hans.zip 为简体中文默认安装包，仅包含 .br。
howiehz-higan-zh-hans-tiny.zip 为简体中文轻量安装包，移除默认字体资源，默认 logo 资源将替换为 1x1 占位图，不包含预压缩文件，且不注入 Mermaid / instant.page 运行时。
howiehz-higan-zh-hans-full-precompressed.zip 为简体中文完整预压缩包，包含 .gz / .br / .zst。
howiehz-higan-en.zip is the English default package with .br only.
howiehz-higan-en-tiny.zip is the English tiny package that removes the default font assets, replaces the default logo asset with a 1x1 placeholder image, omits precompressed assets, and excludes Mermaid / instant.page runtime injection.
howiehz-higan-en-full-precompressed.zip is the English full precompressed package with .gz / .br / .zst.

详情请参阅 CHANGELOG.md。

相关信息

• 版本说明/全量版和轻量版的区别、全量版使用须知、分发文件说明/我该下哪个文件？
• 插件讨论群（QQ）：694413711

详情请参阅 CHANGELOG.md。

相关信息

• 插件讨论群（QQ）：694413711

Generated from v1.0.7

呀呼！欢迎使用 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

v1.0.13 审核整改（对照本次审核意见）

1. 权限约束覆盖全部订阅（对应意见 1「权限与访问控制」）：

   • 权限撤销重校验不再只针对带管理标签的订阅：所有本插件当前类型的订阅（含无标签存量、用户自建）都必须通过当前角色权限校验，失权立即停用；
   • 新增投递前权限闸门：每次投递前重新校验该类型全部订阅，任一订阅应停用而停用失败时跳过本次投递，确保失权用户不会继续收到文章、备份及登录 IP 等信息；
   • 停用失败回滚内存状态，由下次投递/角色变更 reconcile 自动重试；
   • 补充测试：撤权停用、既有无标签订阅停用、停用失败跳过投递并重试、权限恢复自动启用等。

2. 审计写入失败保留重试（对应意见 2「准确的上架信息」）：

   • 审计持久化成功后才清空待写记录；写入失败时保留记录并输出错误日志，由下次整理/停止/设置变更时重试，与"每次整理写入审计日志"的说明一致；
   • 待写计数的累加与冲刷使用同一把锁，并发更新不会清掉刚入账的记录；
   • 去掉阈值冲刷，watch 即时处理后即写审计，低流量场景不丢记录；
   • 补充测试：写入失败保留待写、下次成功补写。

其余同 1.0.12：ReasonType 命名空间 notify-hub-* 与资源所有权标签、原生通知可逆标记已读、性能整改（增量设备索引 / 备份轮询 300s / 无周期扫描）。

What's Changed

• feat: 添加待审核提交上限、可配置清理任务与相关优化 by @imorisun in #34

Full Changelog: v2.4.3...v2.5.0

Generated from v2.5.0