修复 
Floating Particles插件 启用后，前端点击详情卡片，鼠标样式和粒子效果不显示问题
修复 Floating Particles插件 启用后，前端点击详情卡片，鼠标样式和粒子效果不显示问题
/movie 页面切换为 Halo 原生模板渲染，Live2D 等插件资源可正常注入/admin/settings，后台控制台从该接口读取设置/settings 接口，返回数据剔除 tmdbApiKey，防止密钥在公开接口泄露/admin/settings 处理
data-color-scheme，并把评论区配色对齐 BBS（#2）Generated from v1.1.1
Full Changelog: 1.23.2...1.23.3
Generated from 1.23.3
Full Changelog: v2.5.2...v2.5.3
Generated from v2.5.3
VTag 不支持的 theme="success"，改为 primary（否则前端类型检查失败）Full Changelog: v1.0.0...v1.1.0
Generated from v1.1.0
本次发布修复部分站点处理无损 WebP 失败的问题，并优化过期日志清理。
NoClassDefFoundError: VP8LDecoder 的问题。现已固定使用本插件自身的编解码器，不再受其他插件残留实现干扰Generated from v1.2.1
一个 Halo 2.x 插件：记录纪念日、生日与家人朋友，也管好你的座驾（汽车 / 电瓶车 / 自行车）——保险、年检、保养到期自动提醒；支持阳历/农历、多图相册、前台「生活 / 爱车」双视图、隐私脱敏，零系统配置写入、零主题文件写入。
更名说明：原名「重要日期」，1.2.0 起更名「记得」——功能已从"记日期"扩展到"记日子、记人、记爱车"，旧名装不下。插件 ID（
plugin-important-dates）不变，数据、设置、前台地址（/important-dates）与升级路径均不受影响。
English README ｜ Releases ｜ 问题反馈 ｜ 作者：yyliucha
| 截图 | 说明 |
|---|---|
 |
控制台仪表盘小组件：到期提醒常驻仪表盘，每分钟自动刷新 |
 |
后台页签：重要日期 / 人员 / 座驾，提醒横幅 + 卡片列表 + 拖拽排序 |
 |
座驾页签：分类图标、车牌、到期徽章（已过期 / 临近）、车主与驾驶人、前台开关 |
 |
座驾表单：分类（含电瓶车 / 自行车）、能源、证照与里程、多图相册、到期项 |
 |
前台 /important-dates：生活视图——重要日期 + 牵挂的人（生日与纪念日倒计时） |
 |
爱车视图：车辆卡片（脱敏车牌、到期徽章）+ 车主与驾驶人（统一徽章）+ 其他重要的人 |
 |
相册查看：点击封面全屏浏览（只读、Esc 关闭），仅显示后台勾选「展示」的照片 |
 |
全站悬浮提醒：位置自选、倒计时 + 进度条、关闭方式菜单（本次 / 3 天 / 10 天 / 永久） |
📅 重要日期
👤 人员
🚗 座驾（汽车 / 电瓶车 / 自行车）
?width= 缩略图（默认 480px，可配，0＝原图），点开查看仍是原图；上传超过 1.5MB 的图片会先在浏览器压缩（默认压到 1920px，可关）🔔 到期提醒（三处，任你挑）
👁 隐私
粤B·****5）；VIN、发动机号、保单号、购买价格不输出；生日默认脱敏🏠 前台页面（插件默认模板，主题可选覆盖）
?view=car）：生活视图＝重要日期 + 牵挂的人；爱车视图＝车辆卡片 + 车主与驾驶人 + 其他重要的人importantDateFinder：listAll() / listAllPeople() / listAllCars() / listUpcoming(days) / listUpcomingCarEvents(days)📊 其他
importantdates.halo.run/v1alpha1），底层即站点数据库（H2 / MySQL / PostgreSQL），与站点同库同备份TemplateHeadProcessor 输出）、零主题文件写入plugin-important-dates-*.jar；https://你的域名/important-dates。升级：停用 → 卸载旧版 → 安装新 jar → 启用（数据不丢失）。若使用页面静态化 / 缓存插件，升级后清理一次页面缓存。
TemplateHeadProcessor 输出脚本，关闭即不输出，停用 / 卸载随插件消失{title}、{whenText}、{daysUntil}、{dateText}、{nextSolarDate}历史升级提示：1.0.21 及以前使用「代码注入」方式，1.0.30–1.1.1 曾自动维护注入片段；自 1.1.2 起改为官方扩展点。若站点仍留有
id-toast:start/end片段，请到「系统设置 → 代码注入」删除一次。
插件不写入主题文件。想完全自定义时，在主题放置 templates/important-dates.html（TemplateNameResolver 优先使用；删除即回退插件默认模板）。
可用数据：
title、dates、people、reminders、showImportantTag、showAvatarcars（含 plateMasked、coverUrl、photos、skin、events）、carEvents、carPeople、otherPeople、personCars、showCarSection、carSkinEnabled、view需 JDK 17+（已在 JDK 23 验证）与 Node.js 18+：
cd plugin-important-dates
./gradlew build
构建结果位于 build/libs/plugin-important-dates-<版本>.jar（当前版本：1.2.5）。
版本说明：最新正式版
1.2.5（14 项完善：写操作统一为「只改变化字段 + 串行 + 退避重试」、导入节流与失败明细、中文可操作报错、上传后自检、图片失效自动降级与一键修复、缩略图与上传压缩、到期项「已办顺延一期」、提醒逐条忽略、年检规则可配置、爱车排序筛选、后台自检面板、设置「关于」分组；并含1.2.2附件库范围修复、1.2.3卡片样式修复、1.2.4拖拽 503 修复）。更早的正式版为1.2.0（更名「记得」，新增座驾模块）。装包后请强刷一次浏览器（Ctrl+Shift+R）。
WechatSyncTask 自定义模型替代 ConfigMap 存储同步状态Full Changelog: 1.5.6...1.6.0
Generated from 1.6.0
Full Changelog: 1.5.4...1.5.6
Generated from 1.5.6
Full Changelog: 1.5.4...1.5.5
Generated from 1.5.5
知识库图标（logo）自定义
在知识库编辑弹窗「封面」下方新增「图标（logo）」设置，支持上传本地图片或直接粘贴图片链接，带实时预览与一键移除。未设置时继续显示默认书本图标。数据存储于 spec.logo（原有字段），卡片即时生效。
未保存内容提醒 + 本地草稿自动保存/恢复
详情请参阅更新日志（在 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.zipis the English default package with.bronly.
howiehz-higan-en-tiny.zipis 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.zipis the English full precompressed package with.gz/.br/.zst.
本次更新聚焦三件事：把文档页的目录（TOC）体验整体重做，适配Halo2.26.0的布局模版 layout.html。以及修复开启两步验证后无法访问的问题。同时补上了网页语言的动态适配。
如果你用 Docsme 插件发布文档，这一版会有非常直观的变化。原先主题自带的是一个「简易目录」小脚本，现在已替换为成熟的 tocbot 方案，并与 Docsme 插件官方对接。
在 tempaltes 目录下新增 layout.html，适配新的布局契约。
h2、h3 两级，扩展到 h1 ~ h4 四级，结构复杂的文档也能完整呈现。问题描述：当站点启用了两步验证（2FA / TOTP）时，用户完成账号密码登录后会被引导到验证码页面，但该页面被主题的访问控制拦截，导致无法输入验证码、进不了站点。
现在：已把两步验证页面加入公开访问白名单，2FA 用户可以正常走完验证流程。
如果你的站点开启了身份认证且启用了两步验证，建议尽快升级到本版本。
页面 <html lang> 属性不再固定写死为 zh-CN，而是根据当前访问语言自动输出。这对多语言站点、浏览器翻译提示、以及屏幕阅读器等场景都更友好。同时在部分没有标题的页面上，也避免输出空标签。
本版已在全新 Halo 2.26 实例完成:自动化回归 50/50 PASS、浏览器端到端 13/13 PASS、附件库来源范围专项 5/5 PASS、拖拽排序专项 6/6 PASS(写入最大并发 = 1、全部 JSON Patch、无逐条 GET、无 5xx、顺序落库正确)。长期运行、多主题兼容、极端数据量等场景未覆盖。
升级后请强刷一次浏览器（Ctrl+Shift+R / Cmd+Shift+R）：Halo 控制台会缓存插件的控制台包，不强刷时看不到新界面（如侧边栏没有「记得」、仪表盘小组件消失）。
现象：拖拽人员 / 日期 / 座驾卡片调序时提示「保存排序失败：Request failed with status code 503」，弹窗里是反向代理返回的 503 Service Temporarily Unavailable，而 Halo 日志里没有任何记录。
根因：
Promise.all 并发提交；每次提交还要「先 GET 最新版本 → 再 PUT」两步；limit_req（请求速率）与 limit_conn（并发连接数）默认以 503 自行拒绝，请求到不了 Halo——这正是"服务端查不到报错"的原因。修复：① 只写真正发生位移的连续区间（非 1…n 稠密数据回退整表重排，保证正确）；② 改用 JSON Patch 只改 spec.sortOrder 一个字段，去掉 GET，请求数减半；③ 串行提交（间隔 40ms），最大并发降到 1；④ 对 429/5xx 退避重试 3 次；⑤ 报错文案点明「站点反向代理暂时不可用」而不是只抛状态码。
实测对比：
| 修复前 | 修复后 | |
|---|---|---|
| 写请求 | 6 个 PUT（+6 个 GET） | 5 个 PATCH（0 个 GET） |
| 最大并发 | 6 | 1 |
| 结果 | 突发、易被代理 503 | 全部 2xx，顺序正确落库 |
提示：若站点反向代理限流设置非常严格（例如
limit_conn只允许极少并发），仍建议检查一次limit_req/limit_conn；本插件已不再产生突发请求。
halo-smoke.mjs 50/50 PASS；浏览器端到端 browser-121-e2e.mjs 13/13 PASS；附件库来源范围 verify-album-scope.mjs 5/5 PASS；verify-sort-save.mjs 6/6 PASS：断言写入最大并发 = 1、无逐条 GET、全部 PATCH、无 5xx、排序结果正确落库；Scheme not found，属 Halo 插件生命周期）被误判为失败。templates/important-dates.html，请用仓库 docs/theme-override/ 下最新版替换（或删除该文件使用插件默认模板）；优化标准页面布局契约
兼容标准页面布局契约
feat(core): 新增表格宽度模式配置项
fix(core): 修复表格同步至微信公众号后二次编辑导致样式异常的问题
Full Changelog: 1.5.3...1.5.4
Generated from 1.5.4
本版已在全新 Halo 2.26 实例完成:自动化回归 50/50 PASS、浏览器端到端 13/13 PASS、附件库来源范围专项 5/5 PASS,并针对本版修复项做了尺寸复现验证(1920×1080 封面 → 卡片 395×191 / 封面 84×62)。长期运行、多主题兼容、极端数据量等场景未覆盖。
升级后请强刷一次浏览器（Ctrl+Shift+R / Cmd+Shift+R）：Halo 控制台会缓存插件的控制台包，不强刷时看不到新界面（如侧边栏没有「记得」、仪表盘小组件消失）。
console/src/views/ImportantDatesView.vue 的样式块被提前闭合——约 3KB 的 CSS（.cars-grid / .car-card / .car-cover / .car-events / .rule-notice / .person-avatar-char 等）落在 </style> 之后，构建时被整体丢弃，这些规则从未生效。没有照片时卡片看起来"还行"，加了照片立刻暴露。object-fit: cover 裁切，原图多大都不影响）；座驾列表恢复多列网格，到期徽章（已过期 / N 天后）、车主与驾驶人、编辑 / 前台展示 / 删除按钮恢复设计中的紧凑样式。.rule-notice）与人员首字头像（.person-avatar-char）的样式，现在也恢复正常外观。halo-smoke.mjs 50/50 PASS；浏览器端到端 browser-121-e2e.mjs 13/13 PASS；附件库来源范围专项 verify-album-scope.mjs 5/5 PASS；repro-car-card.mjs：上传 1920×1080 封面后，卡片与封面尺寸符合设计值（395×191 / 84×62）。templates/important-dates.html，请用仓库 docs/theme-override/ 下最新版替换（或删除该文件使用插件默认模板）；说明：本版的实际测试范围是「全新 Halo 2.26 实例自动化回归 50/50 PASS + 浏览器端到端 13/13 PASS + 附件库来源范围专项 5/5 PASS」，尚未覆盖长期运行、多主题兼容、极端数据量等场景；开发版（
1.2.2-SNAPSHOT）已先行发布供体验，本次为正式版1.2.2，功能与开发版一致，后续会持续修复与完善，欢迎反馈问题。升级后请强刷一次浏览器（Ctrl+Shift+R / Cmd+Shift+R）：Halo 控制台会缓存插件的控制台包，不强刷时可能看不到新界面（如侧边栏没有「记得」、仪表盘小组件消失）。
设置中「分类 + 策略」没有同时命中的图片，已放宽为仅按分类显示 12 张（分类「文章插图」命中 12 张 · 策略「大头贴」命中 0 张）__ungrouped__ 当成真实分组）。halo-smoke.mjs 50/50 PASS；浏览器端到端 browser-121-e2e.mjs 13/13 PASS；verify-album-scope.mjs）：分类命中 + 策略不命中 → 放宽为仅分类并给出命中数（座驾 / 人员两条路径都验）；「未分组」正确过滤；未配置时显示全部；控制台零脚本错误。templates/important-dates.html，请用仓库 docs/theme-override/ 下最新版替换（或删除该文件使用插件默认模板）。Full Changelog: 1.5.2...1.5.3
Generated from 1.5.3
本版本功能测试尚不完整，可能存在导致数据异常甚至数据丢失的严重问题（毁灭性 Bug）。
请务必先完整备份站点数据（数据库 + 附件），并谨慎升级；建议先在测试站点验证无误后再用于生产环境。说明：本版的实际测试范围是「全新 Halo 2.26 实例自动化回归 50/50 PASS + 浏览器端到端 13/13 PASS + 老数据迁移幂等验证」，尚未覆盖长期运行、多主题兼容、极端数据量等场景；开发版（
1.2.1-SNAPSHOT）已先行发布供体验，本次为正式版1.2.1，功能与开发版一致，后续会持续修复与完善，欢迎反馈问题。版本号说明：
1.2.1号段此前未发布过 Release（当时最新正式版为1.2.0），故本次直接以 1.2.1 发布，不跳号。
templates/important-dates.html，请用仓库 docs/theme-override/ 下最新版替换（或删除该文件使用插件默认模板）Full Changelog: v3.2.2...v3.3.0
Generated from v3.3.0
toggle() 行为，不维护第二份主题偏好。VSwitch 开关：开启时编辑页跟随 Dark Reader，关闭时编辑工作区使用浅色纸面；原有 halo-dark-mode-editor 配置值保持兼容。.sidebar__profile，处理 Halo 侧栏延迟渲染和重建，并在关闭设置时卸载组件、容器和观察器。本文档记录 源蝶文档（theme-mdocs） 的版本变更。
主版本.次版本.修订号。theme.yaml 中 spec.version 为准，本文档按同一版本号记录。YYYY-MM-DD。首个正式版本，可稳定用于技术文档、知识库与产品手册站点。
主题包：dist/theme-mdocs-1.0.0.zip
适用 Halo：>= 2.25.0
h2 / h3 生成目录，使用 IntersectionObserver 高亮当前阅读位置。docs.html）、项目目录页（doc-catalog.html）、文档详情页（doc.html）。minidocs-docs.html）与页内嵌阅读视图（minidocs-reader.html）。?kb=xx&docSlug=xx）直达。401 / 403 时提示登录）。localStorage: mdocs-theme）。--mdocs-width-content（1080px）与 --mdocs-width-page（1400px）两个 CSS 变量统一控制。PluginSearchWidget，支持 ⌘K）、自定义图标按钮组（最多 6 个）、明暗切换、用户菜单（登录 / 用户中心 / 控制台 / 退出）。| 模块 | 类型值 | 说明 |
|---|---|---|
| 主视觉 | hero-carousel |
标题 / 副标题 / 主次按钮 / 安装方式标签 / 轮播图（自动播放、拖拽切换、导航点） |
| 快速开始 | quick-start |
主推大卡 + 侧边卡片，支持背景图与色彩遮罩 |
| 卡片模块 | cards |
type1 背景图样式 / type3 图标简洁样式 |
| 文章分类 | ocean-categories |
按分类生成卡片，支持主色、封面与自定义底部代码 |
| 菜单模块 | ocean-menu |
展示指定菜单的前 4 个一级菜单项 |
| 推荐文章 | ocean-posts |
按标签或分类取前 6 篇 |
| Docsme 文档项目 | plugin-docsme-module |
可自动读取插件归档卡片或手动添加 |
| MiniDocs 知识库 | plugin-minidocs-module |
可自动读取插件归档卡片或手动添加 |
| 模板名 | 文件 | 适用位置 |
|---|---|---|
| 文档 | post_documentation.html |
文章 → 新建 |
| docsme-docs | docsme-docs.html |
页面 → 新建 |
| minidocs-docs | minidocs-docs.html |
页面 → 新建 |
aria-* 属性，兼顾无障碍与 SEO 基础。| 依赖 | 版本 / 说明 |
|---|---|
| Halo | >= 2.25.0 |
| Node.js | ^20.19.0 或 >= 22.12.0（仅本地构建需要） |
| pnpm | 10.x（package.json 已声明 packageManager: pnpm@10.33.0） |
可选插件（未安装时对应入口自动隐藏，不影响主题其它功能）：
| 插件 | 标识 | 作用 |
|---|---|---|
| Docsme | plugin-docsme |
文档中心 / 项目目录 / 文档详情适配 |
| MiniDocs | halo-plugin-minidocs |
知识库归档与内嵌阅读 |
| 搜索组件 | PluginSearchWidget |
页眉搜索入口与 ⌘K 快捷键 |
src/ 下的模板与资源后执行 pnpm build，不要直接编辑 templates/ 下的生成文件。theme.yaml 后，需点击「重载主题配置」才会生效。theme-mdocs，需与 theme.yaml 的 metadata.name 保持一致。localStorage 记忆明暗主题偏好（键名 mdocs-theme）。LICENSE，主题元信息见 theme.yaml 的 spec.license。新版本发布时，在本文件顶部按同样格式追加一节，并同步更新 theme.yaml 的 spec.version 与 README.md 中的版本徽章与兼容性表格。
| 类型 | 内容 |
|---|---|
| ✨ 新功能 | 侧边栏新增「广告位」模块，可填写任意 HTML 展示自定义广告 |
| 🎨 样式 | doc 阅读页顶部「返回」按钮美化：渐变底、悬停浮起投影与箭头滑动动效 |
| 🎨 样式 | 广告位标题图标更换为内置 SVG，跟随主题色 |
src/partials/sidebar.html · settings.yaml · src/css/main.css）在首页 / 列表页侧边栏新增可配置的「广告位」模块，用于展示自定义广告：
max-width:100% 自适应圆角、链接取主题色、代码块内部滚动，明暗主题均兼容。fill=currentColor，自动跟随标题栏主题色。src/css/doc.css）Full Changelog: v2.5.1...v2.5.2
Generated from v2.5.2
本版本功能测试尚不完整，可能存在导致数据异常甚至数据丢失的严重问题（毁灭性 Bug）。
请务必先完整备份站点数据（数据库 + 附件），并谨慎升级；建议先在测试站点验证无误后再用于生产环境。说明：本版实际测试范围是「全新 Halo 2.26 实例的自动化回归 44/44 + 浏览器交互验证」，尚未覆盖长期运行、历史数据迁移、多主题兼容、极端数据量等场景；开发版（1.2.0-SNAPSHOT）已先行发布供体验，本次为正式版 1.2.0，功能与开发版一致，后续会持续修复与完善，欢迎反馈问题。
原名「重要日期」→ 现名「记得」。原因：本次新增完整的座驾（爱车）模块并扩展为前台「生活 / 爱车」双视图，功能已从"记日期"变成"记日子、记人、记爱车"，旧名字无法覆盖。插件 ID（plugin-important-dates）不变，更名不影响数据、设置、前台地址（/important-dates）与升级路径。
?view=car）：生活视图＝重要日期 + 牵挂的人；爱车视图＝车辆卡片 + 车主与驾驶人 + 其他重要的人粤B·****5）；VIN / 发动机号 / 保单号 / 购买价格不输出到前台；未勾选「展示」的照片不出现在前台templates/important-dates.html，请用仓库 docs/theme-override/ 下最新版替换（或删除该文件使用插件默认模板），否则前台看不到「爱车」视图⚠️ 本版本为开发版本（1.2.0-SNAPSHOT），用于提前体验新功能；后续将发布正式版 1.2.0，正式版会在此基础上继续完善，欢迎反馈问题。
应用已由「重要日期」更名为「记得」：功能从"记日期"扩展到"记日子、记人、记爱车"。插件标识、数据、设置与前台地址（
/important-dates）均不受影响，升级即可。
?view=car）：生活视图＝重要日期 + 牵挂的人；爱车视图＝车辆卡片 + 车主与驾驶人 + 其他重要的人粤B·****5）；VIN / 发动机号 / 保单号 / 购买价格不输出到前台；未勾选「展示」的照片不出现在前台templates/important-dates.html，请用仓库 docs/theme-override/ 下最新版替换（或删除该文件使用插件默认模板），否则前台看不到「爱车」视图feat(sync): 支持同步文章摘要至公众号草稿
feat(sync): 新增同步前预检，提前拦截已知异常
Full Changelog: 1.5.0...1.5.2
Generated from 1.5.2
feat(sync): 支持同步文章摘要至公众号草稿
feat(sync): 新增同步前预检，提前拦截已知异常
Full Changelog: 1.5.0...1.5.1
Generated from 1.5.1
[文字](Page-Name.md)）在导入时同样按页面名大小写不敏感解析并转换为站内同库短链接，修复 GitHub 端链接大小写与文件名不一致导致的跳转失败。Generated from v1.4.0
Full Changelog: 1.4.0...1.5.0
Generated from 1.5.0
my-docs 为 Halo 提供独立的文档 / 知识库系统，支持文档库、树形目录、Markdown 编辑、前台文档站点、搜索与 SEO 集成。
本版本为 v1.3.1，适用于 Halo >= 2.25.0。
v1.3.0 的产物因 fat jar 中残留 JGit 签名文件无法加载，已撤回；请使用本版本。
owner/repo 或完整 GitHub 地址由服务器浅克隆 .wiki.git 拉取（私有 Wiki 支持 PAT 令牌）；服务器无法直连 GitHub 时可上传 clone 后打包的 zip[[Page]]、[[Page|文字]]、[[Page#锚点]] 转换为站内同库短链接；找不到对应页面时降级为纯文本并在导入报告中提示Home 排最前；_Sidebar / _Header / _Footer 自动跳过；可选导入到已有文档库（别名冲突自动追加序号）或新建文档库；可指定导入后立即发布或保持草稿plugin-my-docs-1.3.1.jar。my-docs。Generated from v1.3.1
my-docs 为 Halo 提供独立的文档 / 知识库系统，支持文档库、树形目录、Markdown 编辑、前台文档站点、搜索与 SEO 集成。
本版本为 v1.3.0，适用于 Halo >= 2.25.0。
owner/repo 或完整 GitHub 地址由服务器浅克隆 .wiki.git 拉取（私有 Wiki 支持 PAT 令牌）；服务器无法直连 GitHub 时可上传 clone 后打包的 zip[[Page]]、[[Page|文字]]、[[Page#锚点]] 转换为站内同库短链接；找不到对应页面时降级为纯文本并在导入报告中提示Home 排最前；_Sidebar / _Header / _Footer 自动跳过；可选导入到已有文档库（别名冲突自动追加序号）或新建文档库；可指定导入后立即发布或保持草稿plugin-my-docs-1.3.0.jar。my-docs。Generated from v1.3.0
Full Changelog: 1.1.0...1.4.0
Generated from 1.4.0
呀呼！欢迎使用 Ethereal 主题 v1.2.4 版本
本次更新带来菜单栏随滚动方向自动显隐、热门文章 / 音乐小组件支持放置右侧边栏、站点统计小组件支持自定义展示项、置顶文章徽章，以及宽屏 / 高分屏下的 Banner 高清适配与外部 CDN 的 webp 图片压缩等
热门文章小组件支持放置右侧边栏：右侧栏小组件列表新增热门文章选项，热门文章现在可与其它小组件一样配置在右侧边栏展示 (#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
Full Changelog: 1.0.8...1.0.9
Generated from 1.0.9
Full Changelog: 1.1.0...1.3.1
Generated from 1.3.1
Full Changelog: 1.1.0...1.3.0
Generated from 1.3.0
Full Changelog: 1.1.0...1.2.0
Generated from 1.2.0
适配 Halo 2.26.0 及以上版本，升级前端 Halo UI 依赖，优化微信读书书架、阅读进度和读书笔记展示能力，提升插件在新版 Halo 环境下的稳定性与兼容性。
二次元少女风格的 Halo 2.x 博客主题。本次为功能新增与问题修复。
templates/layout.html），修复主题详情页提示"页面布局缺失"的问题；插件页面如果使用该契约渲染，现在会正确套用主题的整体外观，而不是退回 Halo 通用的兜底布局。Halo 2.14.0 及以上版本；友链自助申请功能需要「链接管理」插件 2.3.0 及以上版本。
完整说明见仓库 README。
Generated from v1.1.9
本版修复 Markmap 显示为 CSS 和节点文字的问题，并正式接入 Halo 应用市场自动发布。适用于 Halo 2.26.0 及以上版本。
data-manual，阻止这次自动扫描，保留 Markmap 图形和 Shiki 标记。从 2.5.0 更新可获得 Vditor 亮暗适配、Shiki 全部 242 种语言按需加载、统一纯文本代码框、本地 OpenCC 简繁转换，以及绘图提前启动与独立更新。代码块亮色背景和版权图标修复继续保留。
下载 theme-hanlo-2.7.2.zip 更新主题；.zip.sha256 用于校验。刷新原文章即可，无需修改 Vditor 源码或重新设置代码配色。不要使用 GitHub 自动生成的 Source code 压缩包安装。
Markmap 和其它绘图仍依赖插件配置的可用资源地址；PlantUML 在线 SVG 的返回速度取决于远程服务。完整语法和测试文章见仓库 docs/vditor-writing.md、docs/examples/vditor-render-demo.md。
app-pin7ah2e。GitHub 正式 Release 经过校验和构建后，自动上传 ZIP/校验文件并通过官方发布 Action 同步市场。HALO_PAT Environment 中的同名 Secret；不在仓库保存令牌。Generated from 2.7.2
本版修复代码块浅色背景和版权装饰缺字，并改进 Markmap 节点跟踪。适用于 Halo 2.26.0 及以上版本。
下载 theme-hanlo-2.7.1.zip 更新，.zip.sha256 可用于校验。无需调整已经设置好的代码配色。
这是历史版本补发。代码背景与版权图标修复已通过用户实机确认，但此版仍受 Markmap 脚本内捆绑 Prism 自动扫描的影响：图形可能被替换为样式和节点文字。请优先安装已修复此问题的 2.7.2。
209 项单元测试、17 项设置测试、类型与样式检查通过；519 个模板和资源与 ZIP 一致，实际 WOFF2 的 U+E668 对应版权图标。
此 Release 使用当时保存的原始安装包，未以新版代码重建。中间源码当时未独立提交，标签保留安装包内的运行文件快照；完整可维护源码见 2.7.2。补发重新校验 ZIP、manifest、SHA-256 和标签快照内容。
Generated from 2.7.1
本版用 OpenCC 词组词典替换旧式逐字简繁转换，并提前启动 Vditor 绘图，改善图表切换与加载。适用于 Halo 2.26.0 及以上版本。
cn → tw / tw → cn，不启用台湾词汇替换模式。translate="no"、.notranslate、.ignore-opencc 区域。下载 theme-hanlo-2.7.0.zip 更新，校验文件为 .zip.sha256。无需改写文章源码。实际加速幅度取决于网络和图形复杂度。
这是历史版本补发，建议安装 2.7.2。本版 Markmap 因插件替换节点而无法可靠同步简繁；代码亮色背景、版权缺字问题仍存在。后续 2.7.1 修复样式与节点跟踪，2.7.2 进一步修复 Markmap 捆绑 Prism 的自动扫描冲突。
201 项单元测试、17 项设置测试、类型与样式检查通过；按需词典和 519 个打包模板/资源完成核验。
本 Release 保留开发时的原始安装包。中间源码当时未独立提交，标签保存安装包内运行文件快照；完整可维护源码见 2.7.2。补发重新校验 ZIP、manifest、SHA-256 和标签快照内容。
Generated from 2.7.0
本版修复纯文本代码框缺失，以及代码末尾多显示一个空行的问题。适用于 Halo 2.26.0 及以上版本。
text、txt、plain、plaintext、无语言标识和未知语言代码块，现在共用亮暗代码框；复制、行号和折叠遵循主题设置。下载 theme-hanlo-2.6.1.zip 更新主题，刷新原文章即可，无需修改代码源码。.zip.sha256 用于校验。
这是历史版本补发，建议安装 2.7.2。本版尚未修复完整的简繁图表同步、代码背景的遗留样式覆盖以及版权装饰字体问题；这些问题在后续版本处理。
15 项新增代码框回归测试和 12 项相关既有测试通过，类型、格式、CSS 检查与构建通过，516 个模板和资源与打包内容一致。
使用开发时保存的原始安装包，未以新版本源码重新构建。中间源码当时没有独立提交，标签保存该包内的运行文件快照；完整可维护源码见 2.7.2。补发重新校验 ZIP、manifest、SHA-256 和标签快照内容。
Generated from 2.6.1
本版增加 Vditor 文章的亮暗模式适配，并将 Shiki 扩展为全部内置语言按需加载。适用于 Halo 2.26.0 及以上版本。
下载 theme-hanlo-2.6.0.zip 安装，.zip.sha256 用于校验。安装包约 45.01 MiB，增加的语言文件不会在每篇文章中全部下载。
这是历史版本补发，建议日常使用更新的 2.7.2。本版仍有纯文本围栏缺少代码框、代码末尾额外空行、部分简繁图表不同步，以及遗留样式覆盖代码亮色背景的问题；后续版本分别修复。Vditor 渲染资源与插件方法包应使用匹配版本，PlantUML 仍依赖在线服务。
当时的类型、格式、CSS 检查，176 项单元测试、17 项设置测试及构建通过；全部 242 种 Shiki 语法完成加载与高亮测试。
此 Release 使用开发时保存的原始安装包，未以新版本源码重新构建。由于当时未单独提交中间源码，Git 标签保存安装包内的运行文件快照；完整可维护源码见 2.7.2。补发时重新核验 ZIP、manifest、SHA-256 和标签快照内容。
Generated from 2.6.0
支持 Halo 2.24.0 及以上版本。安装或升级后，请确认插件已启用。
感谢 @Anyuer9837 的贡献。
Full Changelog: 1.22.10...1.23.0
Generated from 1.23.0
在后台记录自己的重要日期与家人朋友（结婚纪念日、孩子出生日期等）：阳历/农历（含闰月）每年自动循环、人员档案与大头贴、拖拽排序、到期提醒、隐私脱敏、操作日志与导出导入。完全按 Halo 2.26 官方文档与扩展点实现，零系统配置写入、零主题文件写入。
上传 jar → 插件 → 安装 → 启用；前台访问 /important-dates 查看页面；升级不丢数据（停用→卸载→装新版）；若启用页面缓存/静态化插件，升级后清理一次页面缓存。
Full Changelog: 1.22.7...1.22.10
Generated from 1.22.10
Full Changelog: 1.22.7...1.22.8
Generated from 1.22.8
在后台记录自己的重要日期与家人朋友（结婚纪念日、孩子出生日期等）：阳历/农历（含闰月）每年自动循环、人员档案与大头贴、拖拽排序、到期提醒、隐私脱敏、操作日志与导出导入。完全按 Halo 2.26 官方文档与扩展点实现，零系统配置写入、零主题文件写入。
上传 jar → 插件 → 安装 → 启用；前台访问 /important-dates 查看页面；升级不丢数据（停用→卸载→装新版）；若启用页面缓存/静态化插件，升级后清理一次页面缓存。
| 类型 | 内容 |
|---|---|
| ✨ 新功能 | 阅读页侧边栏知识库图标替换为内置书本 SVG（主题色、无背景框） |
| ✨ 新功能 | 知识库名称 / 描述截断时悬停气泡展示完整内容 |
| ✨ 新功能 | 右栏文档大纲默认展开一级标题的子级 |
| 🎨 样式 | 友链导航图标重构：去除原背景，统一青绿主题镂空图标与选中高亮 |
| 🎨 样式 | 分类导航图标等页头复用样式细化，视觉统一 |
| 🐛 修复 | 引入 KaTeX 样式表，修复含公式文档的渲染排版 |
| 🔧 调整 | Halo 最低版本由 2.25 上调至 2.26 |
Full Changelog: 1.0.0...1.1.0
Generated from 1.1.0
本版本聚焦知识库管理控制台的界面优化与交互体验升级，包括统计栏增强、移动端适配完善、列表交互重构，以及多项视觉细节打磨。
本版新增「瓶中沧海」3D 关于页，支持与原文字关于页切换；同时修复评论昵称、头像和 HTML 标签显示，改进页面加载与入场动画。适用于 Halo 2.26.0 及以上版本。
stonewu 文本。theme-hanlo-2.5.0.zip 更新主题，.zip.sha256 用于校验。GitHub 自动生成的 Source code 压缩包不是主题安装包。pnpm check、pnpm test、pnpm build 通过，共 184 项测试。完整操作与内容映射见仓库中的 瓶中沧海说明。
com.monster.lovepage 业务包名。呀呼！欢迎使用 Ethereal 主题 v1.2.3 版本
本次更新带来菜单栏「显示网站名」开关、项目集详情页外链按钮与文章分类/标签一致的悬浮高亮与按压反馈、瞬间图片朋友圈式布局，以及正文表格适配主题样式等
菜单栏「显示网站名」开关：菜单栏 Logo 设置下新增「显示网站名」开关（默认开启），关闭后菜单栏只显示 Logo、不再显示站点名 (#65)
正文表格适配主题样式：正文表格改用主题圆角/边框/斑马纹等样式，并暴露相关 CSS 变量，便于自定义表格外观 (#67)
项目集详情页外链按钮样式统一：仓库 / 演示 / 文档外链改为与文章页分类 / 标签一致的元信息链接样式——方形图标 + 文字链接，悬浮浮现圆角矩形背景高亮并变主题色，按下有缩放反馈，不再显示外链箭头
瞬间图片改朋友圈式布局：瞬间图片列表改为朋友圈式布局，九宫格 / 单图等呈现更紧凑统一
Full Changelog: v1.2.2...v1.2.3
Generated from v1.2.3
This postings format may not be used for writing, use the current postings format 的问题，改为使用运行环境当前可写的编码格式，并保留最高 4096 维向量支持。toolName 的情况：已有明确工具名时，按 toolCallId 补全。>= 2.25.0，AI 功能需安装并启用 AI 基座插件。10.5.0 和 10.3.2 的索引回归测试，以及 Agent 流式事件兼容与错误详情测试。Full Changelog: 4.0.4...4.0.5
Generated from 4.0.5
呀呼！欢迎使用 Ethereal 主题 v1.2.2 版本
本次更新带来公告栏支持写入 HTML、照片详情页提示补全等功能，并修复移动端搜索框与搜索结果显示问题；v1.2.1 引入的三栏右侧栏空态收列行为已回退
移动端搜索框聚焦后未占满宽度：修复移动端搜索面板输入框聚焦后缩窄、出现空白的问题 (#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.1...v1.2.2
Generated from v1.2.2
本次发布集中修复水印处理链路的可靠性问题（批量导入场景异常与中文方格），文字水印字体改为服务器字体下拉选择；引用扫描新增对互动增强插件的支持，附件清理更安心。
Generated from v1.2.0
为 Halo 提供社区论坛功能：讨论 + 问答 + 公告 + 两级分类，适合博客站旁的隔离社区。
在线演示：blog.timxs.com/bbs（同时是互动增强的演示插件——帖子列表 / 详情已接入装扮与用户卡）
bbs-moderate）+ 分区版主（一级分类指定角色，只管辖自己分类树）${bbs}）+ 匿名公开 REST API，可覆盖 bbs.html / bbs_post.html 模板下载 plugin-bbs-1.0.0.jar，在 Halo 后台 → 插件 → 安装 → 上传并启用。
/bbs 验证反馈：BBS 社区
为 Halo 提供用户装饰、身份标识与前台展示能力的社区互动增强插件。站长管理勋章 / 头像框 / 称号 / 名片背景 / 昵称样式并授予用户，用户在个人中心佩戴，主题与其他插件可在前台展示。
在线演示：作者页（用户卡 + 装扮墙）
hip-* Web Component + Finder API + 公开 HTTP API，供主题或插件前台页在评论区 / 作者行 / 装饰墙展示（不自动注入页面）DecorationGrantApi）/ 身份查询（PublicIdentityQueryApi）/ 统计贡献扩展点（UserStatContributor），可选依赖、缺席自动降级下载 plugin-interaction-plus-1.0.0.jar，在 Halo 后台 → 插件 → 安装 → 上传并启用。启用后左侧出现「互动」分组。
hip-* 标签，评论区 / 作者行才会出现装扮hip-* 标签反馈：BBS · 互动增强
/console/posts/editor 与 /console/single-pages/editor，避免链接编辑弹窗、代码注入页面和普通可编辑控件误触发编辑页策略。color-scheme: light，保证工作区内原生按钮、下拉控件和滚动条采用浅色控件。pnpm type-check、pnpm lint:check、pnpm test:unit、pnpm build 与 ./gradlew clean build 通过。详情请参阅更新日志（在 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.zipis the English default package with.bronly.
howiehz-higan-en-tiny.zipis 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.zipis the English full precompressed package with.gz/.br/.zst.
详情请参阅更新日志（在 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.zipis the English default package with.bronly.
howiehz-higan-en-tiny.zipis 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.zipis the English full precompressed package with.gz/.br/.zst.
上传 jar → 插件 → 安装 → 启用；前台访问 /important-dates 查看页面；升级不丢数据（停用→卸载→装新版）。
Full Changelog: v1.0.1...v1.1.0
Generated from v1.1.0
Ctrl / Command 按键切换多选模式KB20260828105721916349521.zipMiniDocs-{timestamp}.zipMiniDocs-{timestamp}.zipPOST /knowledgebases/export 端点在响应式链中调用 .blockOptional() 阻塞 reactor 事件循环线程导致的请求异常通过 JS 注入 实现，可能有未知 BUG。
Full Changelog: v1.0.0...v1.1.0
Generated from v1.1.0
scoped 样式无法作用于 Halo VEntity 插槽内容的问题，确保主题模式和编辑页策略选项均显示圆形单选控件。pnpm type-check、pnpm lint:check、pnpm test:unit、pnpm build 与 ./gradlew build 通过。在动画文件尚未加载完前显示
