本次更新让通知更聪明：设备故障有回音、点击直达对应的管理页、评论爆发不再刷屏。
装包后请强刷浏览器（Ctrl+Shift+R），并完整重启一次 Halo 服务（仅替换 jar 不重启，Halo 会继续用内存里的旧代码）。
这是最后一个功能版本。此后本插件不再新增功能，只维持可用。所以这一版的重点不是"还能做什么"，而是让它在你不管它的情况下也不容易坏、坏了你能自己看出来。
设置里新增「提醒自检」卡片，点一下会沿着提醒链路逐项检查，并用人话告诉你结论：
| 检查项 | 它会告诉你 |
|---|---|
| 提醒接口 | 能不能取到提醒数据、当前有几条进入提醒期 |
| 服务端版本 | 后端实际在跑的版本（排查"换了包没生效"） |
| 插件版本 | 插件版本与服务端版本是否一致 —— 不一致几乎就是换了 jar 没重启 |
| 弹窗脚本 | 当前页面有没有注入弹窗脚本、脚本序号是多少 |
任何一项异常都会直接给出下一步该做什么（强刷浏览器 / 重启 Halo / 检查开关）。这一项是为"以后没人给你排查"准备的：以前这类问题只能靠翻日志和猜，现在用户自己点一下就有答案。
从应用市场安装的用户看不到仓库里的 README，所以把用法直接放进设置页，做成可折叠的「使用说明与常见问题」：
「记得」页的重要日期列表此前只能按人员筛选，排序还是拖拽顺序 —— 条目一多，根本看不出"最近有什么"。
拖拽排序此前把筛选后可见的那几条的顺序整份写回，于是被筛掉的条目顺序被抹平，会在列表里悄悄跳位。现在只移动可见项，其余条目保持原有相对位置。加了临近程度筛选之后这个问题的破坏力会成倍放大，所以一并修掉。
<span> 换成真正的 <button>：可以 Tab 聚焦、回车触发，读屏软件能正确朗读「关闭提醒」。role="alert" 改为 role="status" + aria-live="polite"：这是提醒不是报错，不该打断用户正在听的内容。插件描述从 200 多字的长句改成一句话：
把容易忘的事记下来：纪念日与生日、家人朋友、爱车的保险年检保养到期，到点提醒你，愿意公开的还能展示在博客前台。
深绿玻璃拟态 Halo 主题的首次功能升级：首页从「Hero + 纵向文章流」升级为完整的信息层次体验。
#E8B96E 斜体衬线点缀，访问量可选配置categoryFinder.getAll() 调用不存在的 API 导致的 500（改为 list(1, 1).total）theme-luye.zip
一个 Halo 2.x 插件：记录纪念日、生日与家人朋友，也管好你的座驾（汽车 / 电瓶车 / 自行车）——保险、年检、保养到期自动提醒；支持阳历/农历、多图相册、前台「生活 / 爱车」双视图、隐私脱敏，零系统配置写入、零主题文件写入。
English README ｜ Releases ｜ 问题反馈 ｜ 作者：yyliucha
| 截图 | 说明 |
|---|---|
 |
控制台仪表盘小组件：到期提醒常驻仪表盘，每分钟自动刷新 |
 |
后台页签：重要日期 / 人员 / 座驾，提醒横幅 + 卡片列表 + 拖拽排序 |
 |
座驾页签：分类图标、车牌、到期徽章（已过期 / 临近）、车主与驾驶人、前台开关 |
 |
座驾表单（1.3.0）：五个可折叠分区（基本信息 / 到期提醒默认展开）；字段按车型显示——电瓶车锁定「纯电」、不留发动机号，自行车连车牌与能源都不出现 |
 |
前台 /important-dates：生活视图——重要日期 + 牵挂的人（生日与纪念日倒计时） |
 |
爱车视图：车辆卡片（脱敏车牌、到期徽章）+ 车主与驾驶人（统一徽章）+ 其他重要的人 |
 |
相册查看：点击封面全屏浏览（只读、Esc 关闭），仅显示后台勾选「展示」的照片 |
 |
悬浮提醒：位置自选、倒计时 + 进度条、关闭方式菜单（本次关闭 / 今天不再提示 / N 天内不显示），默认只在「记得」页弹出 |
📅 重要日期
👤 人员
🚗 座驾（汽车 / 电瓶车 / 自行车）
?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.3.3）。
版本说明：最新正式版
1.3.3（弹窗学会"少抛决定"：一辆车只占一行并注明共几项到期、被折叠的汇总成「还有 N 项」、底部一行可点文字直达「记得」页；关闭方式菜单只保留有期限的选项，去掉「永久不再提示」并自动清掉老访客浏览器里的永久静音标记；「提示频率」可限制弹窗次数，另加「今天不再提示」菜单项；修好座驾自定义到期项从不提醒的老问题）。装包后请强刷浏览器并完整重启 Halo 服务。更早：
1.3.1修复悬浮提醒不出现的一串问题（纪念日被过滤、渲染时提前记账、上报接口 403、全站作用域取不到数据），弹窗改为每次打开页面都提示，点 × 不再被静默静音；1.3.0座驾按车型分档、改车型保留数据、编辑弹窗折叠分区、移除座驾上的「驾照换证」；1.2.6提醒状态机与1.2.5写操作加固、图片失效降级。
Full Changelog: v3.0.5...v3.0.6
Generated from v3.0.6
本版本统一呼号示例来源，并改进线上换卡的状态反馈与提交成功提示。
JAR 附件由 CD 自动构建并上传，Halo 应用市场版本由同一流程提交。
Generated from v2.3.33
在 Halo Console → 主题 → 春野 → 设置 → 谷歌广告 管理：
data-ad-client，以 ca-pub- 开头。data-ad-slot）、格式（自动 / 横幅 / 矩形）、移动端开关。| 位置 | 出现范围 |
|---|---|
| 首页列表上方 | 首页及分页首页，技术分类导航之后 |
| 首页侧栏 | 首页及分页首页，社区介绍卡片之后 |
| 文章正文上方 | 文章阅读区，正文之前 |
| 文章目录下方 | 文章目录之后；移动端开启时位于目录与正文之间 |
| 文章末尾 | 文章结束与标签之后，相邻文章和评论之前 |
建议为各位置创建对应广告单元，便于在 AdSense 中分别查看效果。主题不内置广告账号，参数缺失或格式错误时不输出该位置。所有广告保持文档流，按容器适配，不向窄侧栏外扩展。网站已有 AdSense 脚本时会复用；原有自动广告继续由 AdSense 管理。
此前目录广告开发配置兼容：ads.enabled、client_id、slot_id、show_mobile、preview 的键保持稳定。slot_id 和 show_mobile 继续用于目录下方位置，新增的 sidebar_enabled 控制该位置独立开关，缺省为开启。新增的另外四个位置默认关闭，升级不会自动增加广告。
有侧栏广告时目录随页面滚动，避免与广告重叠；广告未填充或脚本失败时收起对应位置。无广告时仍保留原有固定目录。未请求的移动端隐藏单元不会匹配 Google 的广告选择器。
新增足迹地图支持。
Full Changelog: v3.0.4...v3.0.5
Generated from v3.0.5
本次更新对后台配置体系进行了重构，部分功能配置已迁移至具体功能列表中，升级后原有配置位置会发生变化，请重新检查各功能配置项。
插件端与 App 端需配套升级，旧版本【移动端】影响范围不大，仅部分页面的标题适配；
升级后请检查自定义角色的功能权限。
【插件端/移动端】新增绘画作品功能：支持用户登录后在画布创作并发布绘画（含审核流程），浏览他人作品；并支持画谜模式——发布时可设置谜底，其他用户猜谜互动，猜对积分 +1，支持画谜排行榜、手动/自动揭晓、出题人管理与审核端画谜信息查看。
【移动端】新增【装备管理】插件支持：支持装备分组与装备展示管理，App 端新增装备列表页（分类吸顶 + 详情弹窗）。
【插件端】优化恋爱日记、相册管理的表单 UI 与列表 UI；
【移动端】优化部分列表页面顶部吸顶区域样式。
Full Changelog: v3.0.3...v3.0.4
Generated from v3.0.4
run.halo.visiteditor 迁移至开发者自有包名 top.iloved.visiteditorQueries API 的依赖，文章列表读取兼容更低版本首次发布：Halo 文章阅读量可视化管理插件。
安装：Halo 后台 → 插件 → 安装 → 上传本 jar。要求 Halo >= 2.20。
一个 Halo 2.x 插件：记录纪念日、生日与家人朋友，也管好你的座驾（汽车 / 电瓶车 / 自行车）——保险、年检、保养到期自动提醒；支持阳历/农历、多图相册、前台「生活 / 爱车」双视图、隐私脱敏，零系统配置写入、零主题文件写入。
更名说明：原名「重要日期」，1.2.0 起更名「记得」——功能已从"记日期"扩展到"记日子、记人、记爱车"，旧名装不下。插件 ID（
plugin-important-dates）不变，数据、设置、前台地址（/important-dates）与升级路径均不受影响。
English README ｜ Releases ｜ 问题反馈 ｜ 作者：yyliucha
| 截图 | 说明 |
|---|---|
|
控制台仪表盘小组件：到期提醒常驻仪表盘，每分钟自动刷新 |
|
后台页签：重要日期 / 人员 / 座驾，提醒横幅 + 卡片列表 + 拖拽排序 |
|
座驾页签：分类图标、车牌、到期徽章（已过期 / 临近）、车主与驾驶人、前台开关 |
|
座驾表单（1.3.0）：五个可折叠分区（基本信息 / 到期提醒默认展开）；字段按车型显示——电瓶车锁定「纯电」、不留发动机号，自行车连车牌与能源都不出现 |
|
前台 /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.3.1）。
版本说明：最新正式版
1.3.1（修复悬浮提醒不出现的一串问题——纪念日/生日被过滤、渲染时提前记账、上报接口 403、全站作用域取不到数据；弹窗改为每次打开页面都提示；点 × 不再被静默静音；并补上接口的版本标记便于排查）。装包后请强刷浏览器并完整重启 Halo 服务。更早：
1.3.0座驾按车型分档（电瓶车锁定纯电、自行车不留车牌与能源）、改车型保留数据、编辑弹窗折叠分区、移除座驾上的「驾照换证」，并修复后台座驾卡片到期项标签整块消失的缺陷。更早：
1.2.6提醒状态机（已办才滚动、逾期逐日提醒、节点式提醒、保养项「已办」= 刚做完保养、一键撤销）与1.2.5写操作加固与图片失效降级、1.2.4拖拽 503 修复、1.2.3卡片样式修复、1.2.2附件库范围修复。
本次更新修复了多设备推送的一个边界问题，并进一步提升稳定性。
需安装 MCP Server 1.3.0 或更高的 1.x 版本，并为访问密钥启用相应工具。
Full Changelog: v2.4.0...v2.5.0
Generated from v2.5.0
为 Halo 提供 OpenID Connect 身份提供方能力，使用现有 Halo 账户登录第三方应用。管理员注册应用、按 Halo 角色控制应用访问，用户在授权前确认权限，并可以在个人中心撤销授权。
针对应用市场审核意见的修复版本，并修正了自动建号与站点注册策略的若干行为。
修复控制台「BlogsClub 应用配置」表单不显示、无法配置 AppID / AppKey 的问题
审核延伸发现：插件此前未在 plugin.yaml 声明 settingName 与 configMapName，Halo 据此跳过了 Setting 与 ConfigMap 扩展的初始化（日志提示「the plugin configMapName is blank」），导致控制台根本不渲染配置表单，只能通过 json-config 接口手工写入，且接口还会报 configMapName is blank。
现已补全 settingName: blogsclub-oauth2-setting 与 configMapName: oauth2-blogsclub-config。升级后控制台「用户 → 认证方式 → BlogsClub → 设置」会正常出现配置表单，AppID / AppKey 可在界面维护。
修复首次登录自动建号时写入空密码导致 500 的问题
此前自动创建的账号密码字段为空，部分 Halo 版本在建号流程中会因此抛出 500。现已改为写入一段随机生成的 64 位加密密码（userService.encryptPassword(RandomStringUtils.secure().nextAlphanumeric(64))），账号可正常落地，密码对登录无影响（用户始终通过 BlogsClub 授权登录）。
修复自动建号未遵循站点「注册时必须验证邮箱」设置的问题
此前只要站点开放注册就会无条件自动建号，忽略了后台「注册时必须验证邮箱（mustVerifyEmailOnRegistration）」开关，可能创建出未验证邮箱的账号。
现已严格遵循该设置：
/login?oauth2_select），避免产生未验证邮箱的账号；emailVerified=true），用户无需再走邮箱验证步骤；settingName / configMapName），升级后请到控制台「用户 → 认证方式 → BlogsClub → 设置」确认 AppID / AppKey 已正确填写；此前若通过 json-config 手工写入，升级后可改由控制台表单统一维护。Full Changelog: https://github.com/YBRC114514/plugin-BlogsClub-OAuth/compare/v1.4.2...v1.4.4
本次更新让推送更可靠、更省心，并新增了运行状态查看入口。
Generated from v2.0.0
McpToolDefinition.Builder.category(String) 为插件工具设置自定义分类，在工具目录和访问密钥选择器中按插件和分类展示；需使用 run.halo.mcpserver:api:1.3.0 及 MCP Server 1.3.0 或更高版本 by @ruibaby in #15Full Changelog: v1.2.0...v1.3.0
Generated from v1.3.0
修复登录上下文脚本未在 Halo 登录页加载的问题。
从 OIDC 授权跳转到登录页后，切换通行密钥登录会保留 redirect_uri 等查询参数，以及嵌套授权地址的编码。
密码登录与通行密钥登录之间切换时，保持“保持登录会话”的当前勾选状态，包括取消勾选后的状态。
调整登录页脚本加载方式，兼容 Halo 2.26 的认证页面与 Thymeleaf 分块输出。
兼容要求： Halo 2.26.0 及以上。
Generated from v1.0.6
版本日期：2026-10-10。要求 Halo >=2.26.0；发布状态以 GitHub v0.9.49 为准。
templates/assets/images/shop-demo/**。开发素材继续保留，商城运行代码、模板及功能不删减。pnpm run package / build 在补齐第三方声明后自动校验 ZIP；出现演示素材、版本不一致或必要文件缺失时阻止打包成功。本地候选构建 0.9.49 / 0bd3870d2398 的完整检查、13 路由重载、活动资源一致性与自动制品校验通过。候选 ZIP 约 955 KB，对比上一正式包仅移除三张 DEMO PNG，运行文件集合保持完整；注入演示图的隔离测试包会被拒绝。
本版执行范围及未验收项见版本准备记录。未重跑全站页面冒烟或真实交易；本地候选包不等于正式 CD 制品，正式发布结果另行登记。
Generated from v0.9.49
运行洞察 1.2.0 增加单插件诊断和可回看的故障证据，并减少持续监控的重复工作。
下载附件 plugin-insight-1.2.0.jar，在 Halo Console → 插件中上传安装或升级。
需要 Halo 2.26+、Java 21。SQLite 沿用 v5；升级前建议停用插件并备份 insight 数据目录。
53 个后端测试、70 个前端测试及类型检查、代码检查和构建通过。
尚未在运行中的 Halo 实例验证本次新接口的实际角色权限或安装前后性能变化。
CPU 和分配量为有限采样与归属线程的估算；压力评分和基线对比不能单独证明卡顿、泄漏或升级因果。
Generated from v1.2.0
此版本需要 Halo 2.26.0 及以上；免费与授权功能需要应用市场 1.19.0 及以上。
旧版表单可通过「旧版表单升级」创建新版副本并迁移历史提交，检查后确认切换，也支持回退。历史提交会复制到新版收件箱，旧版原始数据仍保留；回退不会将新版提交反向迁移。
版本日期：2026-10-09。要求 Halo >=2.26.0；本次核验环境为 Halo 商城版 2.26.1。发布状态以 GitHub v0.9.48 为准。
v5，README 自动同步保持关闭；实际发布结果另行登记。本次版本的构建标识、检查、重载及本地 ZIP 结果统一记录在项目进度，适用命令见验证矩阵。详细配置与编号截图见商城指南。旧 0.9.47 截图与日期报告保留原构建身份，不改记为本版本的运行验收。
当前构建 0.9.48 / e10979704e65 的完整检查、13 路由重载、商城 SSR／隔离专项及本地 ZIP 校验通过。全站冒烟 24 路由中 22 项失败，均含同一外部图标 ERR_BLOCKED_BY_ORB；该项来自朋友圈外部图标，本次按用户决定接受此边界，未修改测试规则。
Generated from v0.9.48
draftAction（update / create）：记录本次同步实际执行的动作并落库。501）时整次同步失败 → 自动改为新建，同步可正常完成。wechat_sync_submit：移除 draftAction（只是提交时的预判，执行阶段可能回退），说明改为「预计…」并指向状态查询。wechat_sync_status：按 draftAction 回报实际动作，描述 / 字段说明 / 结果文本都要求 AI 照字段作答。Full Changelog: 1.9.0...1.9.1
Generated from 1.9.1
Full Changelog: v2.6.1...v2.6.2
本次提交主要改动：
Generated from v2.6.2
升级提示：本版本最低支持 Halo 2.26.0，请先升级 Halo 再安装此版本插件。
Full Changelog: v1.7.1...v1.8.0
Generated from v1.8.0
draftAction：本次是更新（update）还是新建（create），提交时实查微信确认，AI 照它回答即可。<style> 块），客户端清洗或 AI 转述时不再散架；并明确要求「原样输出，不要改写」。/cgi-bin/draft/get、/cgi-bin/draft/update（共 7 个路径，见 README）。不放行也不会失败，只是退化为每次都新建草稿，草稿箱会攒下重复草稿。Full Changelog: 1.8.2...1.9.0
Generated from 1.9.0
Full Changelog: v2.6.0...v2.6.1
Generated from v2.6.1
Full Changelog: v3.0.2...v3.0.3
Generated from v3.0.3
Full Changelog: v2.5.3...v2.6.0
Generated from v2.6.0
发布日期：2026-10-03
主题包：dist/theme-mdocs-1.2.0.zip
适用 Halo：>= 2.25.0
小版本更新：参考语雀（Yuque）公共页面的版式，为 Docsme、MiniDocs 两个插件页面补齐页面级自定义能力，并修复首页模板编译产物被截断的问题。
参考语雀公共页面的头部区，为两个插件页面各新增一组英雄块设置：
新增 启用英雄块 开关，默认关闭；开启后在页面顶部渲染英雄块，并展开下方 5 项子设置，关闭时不输出任何结构。
子设置项：
| 子设置项 | 默认值 | 说明 |
|---|---|---|
| 英雄块背景图 | 空 | 通栏铺满页面顶部，自动叠加半透明遮罩保证文字可读 |
| 英雄块标题 | 空 | 与 Logo 同一行显示；留空时回退为当前页面标题 |
| 英雄块 Logo | 空 | 与标题同一行，显示在标题左侧 |
| 英雄块描述 | 空 | 标题下方的说明文字 |
| 搜索框占位文字 | 请输入 | 回车跳转 /search?keyword=，需安装 PluginSearchWidget 搜索插件 |
未安装 PluginSearchWidget 时不渲染搜索框，英雄块其余部分正常显示。
接着英雄块下方，为两个插件页面各新增一组描述设置：
array 组件限制 最多 3 条（max: 3），支持拖拽排序、增删；每条包含 标题 与 文本内容 两个字段。#minidocs-viewer-host 已移出该判断条件，?kb= 直达阅读不受影响。src/partials/home-modules.html（编译内联到各模板），首页与插件页面共用同一份模块实现。$get(字段 id).value 形式的联动表达式，开关切换后子设置项即时显隐，无需先保存。descriptions 数组的 3 条占位文案），重载主题配置后即可直接使用。templates/index.html 编译产物缺失闭合标签、只剩首行的问题（.homepage-container 未闭合导致后续内容被丢弃）。HALO 2 博客主题
一款专为 Halo 打造的 Fuwari 风格增强型主题
欢迎使用 Ethereal 主题 v2.0.0 正式版。请注意，本次更新会导致部分主题配置失效，需重新配置，详见 设置项迁移
本次更新带来全新「沉浸（Hero）」全屏壁纸布局、可自由编排的侧边栏小组件体系、关于页 / 打赏页页面模板与页脚卡片版式，并为全站页头、卡片与正文元素换上新的视觉语言；同时系统性打磨了换页动画、移动端流畅度与旧版浏览器兼容性。
更新完成后建议前往「主题设置 → 详细」进行 重载主题配置 & 清除模板缓存 两项操作，确保新设置项正常生效
主题文档暂未完善，更新后请自行摸索相关配置，如在主题使用中遇到问题或者建议，欢迎在 Issue 中提交，也可前往 主题交流群 进行讨论
「全屏布局」新增「沉浸模式」，并支持经典 / 沉浸两种形态，且访客可在前台「显示设置」中切换；可前往「布局设置 → Banner 布局」切换体验
沉浸布局下壁纸钉住视口：首页下滑时壁纸由清晰渐变至模糊、标题随滚动上移淡出；非首页固定模糊、内容贴近导航栏；显示设置支持调节背景模糊度、卡片透明度
全屏模式新增首页导航栏顶部透明，向下滚动平滑过渡为玻璃底
Banner 署名胶囊在全屏壁纸下隐藏，透明模式移除壁纸压暗滤镜，暗色卡片底改用深灰
优化移动端壁纸切换与抽屉菜单性能，消除切换卡顿
打磨换页动画：首页与内页互切时标题落位后再显现、滚动位置与内容位移锁步同步，消除抖动
Banner 图片分档加载适配全部图床
首屏 Banner 揭示不再等待主脚本，媒体就绪且首帧绘制后即刻显示
标题 / 副标题字号改为首帧定档，修复移动端首屏字号闪变
分组筛选池改为全新胶囊形态（滑动选中浮块），全部分组页统一接入；页头统计随当前筛选分组实时变化
「已筛选」清除钮移至统计片左侧；日程日历页面周导航移至页头，心愿墙页面分组控件移动至页头
目录支持挂载在左侧栏或右侧栏（三栏布局），两栏布局继续使用悬浮目录；可前往「文章 → 目录位置」配置体验
含目录的文章页仅保留前 2 个吸顶组件，高度差额由目录卡片承担
小组件详细配置外提为独立设置分组（站点统计 / 天气 / 一言 / 音乐 / 日程），同类小组件可在多个位置复用
侧栏小组件不再随站内换页重建，音乐播放器与天气等组件在换页间保持状态
音乐播放器未配置 ID 时显示提示卡；默认小组件列表重新编排
页脚新增友情链接卡片墙，数据来自友情链接插件、服务端渲染；可前往「页脚 → 页脚友情链接」配置体验
支持显示开关、仅在首页显示、申请友链按钮与最多显示条数
新增卡片版式页脚，卡片版式整合站点标题、友情链接（紧凑形态）、社交图标、版权与备案等信息，整块为一张卡片；可前往「页脚 → 页脚样式类型」配置体验
新增星芒分割带样式；可前往「页脚 → 分割带样式类型」配置体验
文章正文元素全面适配：图片 / iframe 圆角、分隔线、列表 marker、嵌套列表、任务列表、折叠块、视频防溢出与表格磨砂卡片
折叠面板样式优化：友链页折叠面板指示器移至标题左侧，与正文折叠块统一为圆角三角
文章卡片列表模式新增「列表封面比例」设置：撑满卡片高度（默认）/ 固定 16:9；固定 16:9 在屏幕变窄后自动垂直居中裁切，避免封面越裁越多；可前往「布局设置 → 文章卡片布局 → 列表封面比例」配置体验
移动端卡片封面比例统一为 2:1
项目集列表卡片重构，推荐区与全部区共用同一份卡片；悬浮反馈分整卡底色、封面放大与标题箭头三层
作品详情页新增「分类区」：平台 / 类型 / 技术栈 / 标签三行展示，移除底部重复区域
新增「卡片跟随主题色」：浅色模式下卡片背景跟随主题色相；可前往「样式设置 → 样式开关」中配置体验
新增「卡片边框和阴影」：内容卡片、按钮卡、分页页码组与导航栏统一加细边框与浅阴影；可前往「样式设置 → 样式开关」中配置体验
两个开关均支持访客在前台「访客样式面板」中覆盖
全站宽屏宽度调整，充分利用宽屏空间，显示宽度不足时自动压缩内容区宽度
列表页卡片最小宽度统一为 240px（项目集 / 友链 / 日程）
新增「关于页面」模板：身份卡 / 个人简介 / 本人项目 / 最近提交 / 我的技能 / 我的朋友 / 保持联系等共 9 张卡片，后台按卡片顺序分组配置；可前往「扩展页面 → 关于页面」配置体验
身份卡与侧栏「在线状态」实时同步，点击即可切换状态
「订阅更新」卡片：邮箱订阅直连文章订阅插件公开接口，需安装 文章订阅 插件，缺失或未开启时整卡不渲染
新增「打赏页面」模板：用途说明、微信 / 支付宝收款码、打赏者名单；可前往「扩展页面 → 打赏页面」配置体验
文章打赏模态框底部新增「打赏页面」跳转按钮，开关与路径可前往「文章 → 打赏设置」配置体验
瞬间页面动态卡片改为全新独立卡片流：一条瞬间一张卡，头像轨道缩进、标签胶囊、右下角水印与复制链接、点赞 / 评论 / 更多操作栏
内容区顶部新增全站瞬间条：服务端直出、无缝跑马灯、悬停与键盘聚焦暂停，仅大屏端（≥768px）显示；可前往「布局设置 → 瞬间预览条」配置体验
移除黑名单功能与来源链接行
时间轴改为「日期头 + 卡片」整组包裹，移动端浏览体验更佳
新增全站樱花特效，访客可在前台「访客样式面板」中覆盖；可前往「样式设置 → 样式开关」配置体验
前台「显示设置」新增「特效」标签页与樱花开关
全站按钮与弹窗统一按压反馈，按下平滑泛主题色、松手回弹，覆盖外链 / 友链申请 / 分享 / 打赏等场景，并补齐友情链接模态框出场动画
分区标题新增前置图标盒
朋友圈 / 友链 / 标签页眉题图标更新，并移除图标的悬浮放大效果
从 1.2.4 升级到 2.0.0 后，后台部分设置项的位置与形式发生变化，以下设置需到新位置重新确认一遍，不再沿用旧值。
小组件详细参数从「小组件列表」条目内移出，改为独立分组：
条目精简为「小组件 + 吸顶」，并新增「移动端小组件」列表
个人简介 / 公告取消「启用」与「显示位置」：加入小组件列表即显示，位置由所在列表决定
「启用分类导航栏」移至「页面布局 → 分类导航栏」分组
「列表模式封面位置」移至「文章卡片布局 → 列表设置」
访客样式切换由分项开关（主题色相 / 文章布局 / 卡片样式 / 壁纸模式 / 壁纸设置 / 透明设置）收敛为「外观 / 壁纸 / 特效」三项
卡片悬浮效果不再提供前台「访客样式面板」内开关，改为仅后台控制
移除时间轴 / 技能页面的「副标题」设置项
移除朋友圈的「屏蔽列表」设置项
修复非主题页（插件自带前台页等）被换页脚本接管导致整站样式丢失的问题，现已交还浏览器原生跳转
修复瞬间页点赞与评论锚点在站内换页后失效的问题
修复部分旧版 Chromium 内核浏览器（OPPO / 一加自带浏览器、旧版微信内核等）图标显示不全的问题
修复认证页装饰图标规则误伤人机验证插件元素的问题
修复移动端浏览器动态地址栏导致的波浪露缝与滑动屏幕壁纸抖动的问题
修复分类导航栏「更多」按钮未贴右端的问题
修复横幅壁纸与全屏壁纸模式下换页内容区抖动的问题
无障碍优化：清理冗余 aria 属性，欢迎弹窗标题层级调整为 h2
依赖升级：Astro 7.2.8、sharp 0.35.4、colord 2.10.0，js-yaml 统一至 4.3.2
版本号提升至 v2.0.0
更新 README
太多了，如有遗漏见谅
#46 文章页中目录在侧边栏中的位置，可以调整就好了
#47 阅读模式：可隐藏左侧栏、右下角 CSDN 样式目录、正文全宽
#69 主页增加友链展示（底部或侧边栏）
#80 优化桌面端列表模式文章封面显示（显示不全 / 大屏留白多）
#82 SWUP 页面切换 FOUC，手机访问短暂丢失样式
#83 OPPO 手机浏览器底部图标加载不全（疑似腾讯 X5 内核兼容问题）
#84 加载人机验证插件无法显示验证码
#74 页脚新增友情链接卡片墙 by @PanDaDaTech
Full Changelog: v1.2.4...v2.0.0
Ethereal，由多位开源贡献者共同打造❤️
Generated from v2.0.0
Full Changelog: v3.0.1...v3.0.2
Generated from v3.0.2
运行洞察 1.0.0 首次发布，为安装插件的 Halo 站点提供运行监控、性能诊断和告警通知。
安装：下载本页附件 plugin-insight-1.0.0.jar，在 Halo Console 的“插件”页面上传安装并启用，然后打开侧边栏“运行洞察”。
环境要求：Halo 2.26.0 或更高版本，Java 21。插件在 Halo 进程内运行，无需 Python 或独立站外探针。
插件 CPU 与内存指标来自线程归因采样，属于估算；“分配内存”表示新分配字节量，不是插件当前保留的堆内存。
功能说明与截图见 README。
发布时间：2026-09-30。
**对比基线：**正式 v0.9.46 至本次 v0.9.47（提交 cf504f15），共 28 个提交，见完整差异。
>=2.25.0 提高至 >=2.26.0；新增插件页面 html(head, content) 布局，整理 24 个主题相关插件的 51 个功能范围、版本标记和生命周期边界。各范围实际采用及测试的插件版本见插件适配契约。>=24.21.0 <25、pnpm 12.5.1，更新 Alpine、Vite、Tailwind CSS、Playwright 等依赖及第三方声明；继续使用冻结安装与最小发布时间策略。persistence-conflict.js，构建后检查静态及动态资源引用，避免误删分块和运行时缺失。2.26.0 或更高版本；升级前保留主题配置及上一稳定 ZIP。0.9.47 / 79c9ed2a8831，完整 pnpm run check、构建、资源预算和构建 smoke 通过；两份版本声明、生成资源和源码指纹一致。Shell 静态 JS gzip 为 143580 B，CSS 为 65515 B，均满足原有预算。cf504f15d15a3365df759ffbfb51e04b8d35e23f 的 CI 检查通过；线上 Playwright Smoke 因未配置 SMOKE_BASE_URL 被跳过。0.9.46 / f4cc217c2418 的设置专项及 6 组隔离浏览器检查保留其原始范围，真实配置写入为 0。4cd9e2e00aa6 的完整检查、13 路由 Reload 与 24 场景 smoke 是该构建的历史证据，不能作为新版本候选包的通过记录。0.9.47；生成资源及本地验证结果见项目进度。真实账号配置持久化、认证提交、插件业务写入和真机触摸的剩余范围见项目进度及发布与回滚。Generated from v0.9.47
aiModelSelector 的 requiredFeatures 从强制筛选改为非阻断提示；依赖强制筛选的插件请改用 requiredCapabilities 或在运行时校验，后端 model-options API 的筛选语义不变 by @ruibaby in #113Full Changelog: v1.1.0...v1.1.1
Generated from v1.1.1
此版本需要 Halo 2.26.0 及以上；免费与授权功能需要应用市场 1.19.0 及以上。
旧版表单可通过「旧版表单升级」创建新版副本，检查并发布后再切换，也支持回退。历史提交仍在旧版入口查看，切换后的新提交进入新版收件箱。
一个 Halo 2.x 插件：记录纪念日、生日与家人朋友，也管好你的座驾（汽车 / 电瓶车 / 自行车）——保险、年检、保养到期自动提醒；支持阳历/农历、多图相册、前台「生活 / 爱车」双视图、隐私脱敏，零系统配置写入、零主题文件写入。
更名说明：原名「重要日期」，1.2.0 起更名「记得」——功能已从"记日期"扩展到"记日子、记人、记爱车"，旧名装不下。插件 ID（
plugin-important-dates）不变，数据、设置、前台地址（/important-dates）与升级路径均不受影响。
English README ｜ Releases ｜ 问题反馈 ｜ 作者：yyliucha
| 截图 | 说明 |
|---|---|
|
控制台仪表盘小组件：到期提醒常驻仪表盘，每分钟自动刷新 |
|
后台页签：重要日期 / 人员 / 座驾，提醒横幅 + 卡片列表 + 拖拽排序 |
|
座驾页签：分类图标、车牌、到期徽章（已过期 / 临近）、车主与驾驶人、前台开关 |
|
座驾表单（1.3.0）：五个可折叠分区（基本信息 / 到期提醒默认展开）；字段按车型显示——电瓶车锁定「纯电」、不留发动机号，自行车连车牌与能源都不出现 |
|
前台 /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.3.0）。
版本说明：最新正式版
1.3.0（座驾按车型分档只显示用得上的字段——电瓶车锁定纯电、自行车不留车牌与能源；改车型保留数据不再提醒、改回即恢复；编辑弹窗改为可折叠分区；不再把「驾照换证」挂在座驾上；并修复1.2.6起后台座驾卡片的到期项标签会整块消失的缺陷）。装包后请强刷一次浏览器（Ctrl+Shift+R）。更早：
1.2.6提醒状态机（已办才滚动、逾期逐日提醒、节点式提醒、保养项「已办」= 刚做完保养、一键撤销）与1.2.5写操作加固与图片失效降级、1.2.4拖拽 503 修复、1.2.3卡片样式修复、1.2.2附件库范围修复。
为 SpringForAll 社区制作的独立 Halo 主题，版本 1.0.4。
采用 Spring 绿、石墨色和暖白底色，使用编辑型首页、轻量文章列表与独立阅读布局。历史文章没有封面时自动显示与分类匹配的视觉占位。源码为 Thymeleaf + CSS + 原生 JavaScript，无需 Node 构建、在线字体或前端框架。
Full Changelog: https://github.com/uni-halo/uni-halo-plugin/commits/v3.0.1
Generated from v3.0.1
Full Changelog: https://github.com/liuyiwuqing/halo-plugin-domain-theme-router/commits/v1.1.0
Generated from v1.1.0
Full Changelog: 1.8.1...1.8.2
Generated from 1.8.2
一个 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.6）。
版本说明：最新正式版
1.2.6（提醒状态机：已办才滚动、逾期逐日提醒后转待处理、节点式提醒、保养项「已办」= 刚做完保养、一键撤销、前台只显示未逾期的待办项、弹窗内动作原地生效、提示语人性化；并含1.2.5写操作加固与图片失效降级、1.2.4拖拽 503 修复、1.2.3卡片样式修复、1.2.2附件库范围修复）。装包后请强刷一次浏览器（Ctrl+Shift+R）。
可在 1.10.1中使用该插件。
2.26.0，沿用官方 layout.html 布局契约；Halo 2.25 及更早版本不能安装本版。2.2.40 版本化资源，避免页面缓存继续引用旧版脚本和样式。Node 版本文件和 CI 固定为 24.21.0，包管理器为 pnpm 12.6.0。24.21.0 / pnpm 12.6.0：无例外冻结安装、lint、格式、依赖审计及完整构建通过；27 项静态插件契约和 33 项插件读取检查通过，审计报告 0 个已知漏洞。2.26.1 临时激活本主题并刷新页面缓存：114 个 URL 为 113 个 200、已移除入口的 /terms 为预期 404。真实浏览器验证首页→文章 PJAX、404 回退后返回文章、独立日历整页导航，以及 390px 友链页；测试后恢复原激活主题。3.1.0、Restricted Reading 1.9.1、Schedule Calendar 3.5.0 的主题相关读取和展示表面已定向复测；自动摘要注入、匿名受限组件完整交互及插件后台业务不在通过范围。环境、源码指纹及测试边界见依赖适配记录。Generated from v2.2.40
templates/layout.html，避免友链页因 EL1008E 返回 500。pre code 保留代码块原有空白与换行，修复多行代码挤成一行。/links?view=friends。旧菜单中的 /friends 项会指向新入口。/categories 首屏和滚动后均为 6 篇，第二页是另外 6 篇；/links 正常显示；含 26 个代码块的文章中，抽样多行代码的计算样式为 white-space: pre。精确环境与结果本次验证覆盖上述主题页面和读取链路。插件后台写入、第三方 RSS 可达性，以及此前偶发的 Bilibili 上游超时和装备插件分页告警，不包含在这三项主题修复的通过结论中。
Generated from v2.2.39
本版已在全新 Halo 2.26 实例完成回归：保养项语义 4/4、已办才滚动/节奏 B/原地生效 4/4、提醒状态机 7/7、提示与撤销 7/7、图片失效降级 7/7、浏览器端到端 13/13、附件库范围 5/5、拖拽排序 6/6。长期运行、多主题兼容、极端数据量等场景未覆盖。
升级后请强刷一次浏览器（Ctrl+Shift+R）：控制台会缓存插件的控制台包与提示脚本，不强刷可能看不到新界面或仍跑旧提示。
升级后你会看到的变化：以前"到期日过了就自动当作进入下一期"的行为已取消——现在只有你点「已办」才会顺延。所以现有数据里凡是"到期日已过、但你一直没确认办过"的循环项，会统一以「已逾期」出现在后台（红色 / 待处理），点一次「已办」即可把它顺延到下一期。
进入提醒期后按节点提醒，每个节点只弹一次并写库（关浏览器、换设备都不会重置）：窗口内每 7 天一个节点（提前 60 天 → 60、53、46、39、32、25、18 天）；最后 15 天加密为 15 / 7 / 3 / 1 / 0 天；逾期 1 / 2 / 3 天。
后台「自检」入口与「操作日志」入口（并停止写入日志数据）；列表下方"数据存储于…"与仪表盘小组件底部"来自「记得」插件…"说明；设置里的「关于」与「日志设置」分组（设置页由 9 个页签精简为 6 个）。
开启「全站悬浮提醒」会导致「记得」页面内容整块消失（注入脚本用了自闭合 <script />）；在座驾编辑弹窗保存会清空提醒状态；编辑弹窗提醒行整块不渲染（缺少 import 导致渲染报错）。
Halo 2.26 及以上；由 1.2.0 – 1.2.5 升级：停用 → 卸载 → 安装本版 → 启用，数据不会丢失（新增字段缺失时按"待办"处理，无需迁移脚本）。若主题目录存在 templates/important-dates.html 覆盖文件，请用仓库 docs/theme-override/ 下最新版替换。
详情请参阅更新日志（在 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.
Full Changelog: https://github.com/hcjike/halo-theme-dream2.0-plus/commits/1.23.4
Generated from 1.23.4
本次更新以微信素材缓存体系为主线：新增素材上传缓存，避免同一张图反复上传挤占微信素材库；配套补齐了缓存库的自动备份、每日清理、失效自愈与凭据脱敏；同时新增「一级标题对齐方式」配置项，并在同步任务记录中留存文章标题。
media_id / 图片地址material/get_material 查询素材本身material/get_material 接口的代理规则。<插件数据目录>/backups| 工具（本地名） | 类型 | 参数 | 说明 |
|---|---|---|---|
wechat_sync_preview |
只读 | postName |
获取预览信息：按与同步一致的规则美化正文，返回美化后的正文 HTML、上传后实际使用的标题（64 字上限）、摘要（120 字）、作者（8 字）、原文链接（阅读原文）与留言设置，以及因超过微信长度上限被截断的字段名；不调用微信接口、不写任何数据，可反复调用 |
wechat_sync_submit |
写操作 | postName |
提交同步到微信：先做提交前预检（微信配置、封面图、文章是否正在同步中），通过后创建后台同步任务并立即返回；同步时封面与正文图片会自动转存到微信素材库、正文按公众号排版美化，完成后可在公众号草稿箱看到草稿 |
wechat_sync_status |
只读 | postName |
查询同步状态：返回该文章最近一次同步的状态与说明——PENDING（已提交、正在后台执行）/ SUCCESS（已写入公众号草稿箱）/ FAILED（失败，message 为微信返回的失败原因）/ NONE（尚未同步过）；只读取任务记录，不调用微信接口、不写任何数据，提交同步后可用它轮询结果 |
wechat_cache_cleanup |
写操作 | 无 | 清理素材缓存：立即执行一次素材缓存清理（与每天 0 点的计划任务同一套规则），返回本次删除条数与生效的保留策略——deletedRecords（删除条数）、remainingRecords（剩余记录数）、retentionDays（生效的保留策略：保留天数，如 "30"；「全部保留」时为 never）、cutoff（判定时间）；只删除「超过保留期且最近未被使用」的记录，仍被复用的缓存不会误删，也不影响每天 0 点的自动清理 |
h1Align）text-align 或 align 属性），保持原样，本项不生效（SUCCESS / FAILED）后，输入快照会被清空以释放正文 HTML 占用的数据库空间spec.postTitle 上，快照清空后仍能在任务列表里认出「这条任务是哪篇文章」access_token、secret、appsecret、authorization、sign、password 等键的值统一替换为 ***；接口名与参数名保留，不影响排查。appid 为公开标识，不做脱敏material/get_material：未放行时永久素材校验会「无法判定」，插件将保守地重新上传封面——功能不受影响，但会增加素材库占用与上传耗时Full Changelog: 1.7.0...1.8.0
Generated from 1.8.0
Full Changelog: v0.2.0...v0.2.1
Generated from v0.2.1
FAILED 的问题。原因是 AI 基座被声明为可选依赖 ai-foundation?，而 PF4J 不会把可选依赖放进依赖图，没有任何启动顺序保证：本插件可能先于 AI 基座启动，此时看不到 run.halo.aifoundation.* 的类，Spring 装配时抛 NoClassDefFoundError: run/halo/aifoundation/tool/ToolDefinition。现已声明为必选依赖，并给仅剩的两个引用 AI 基座类型的组件补上条件装配。(#42)Important
从此版本开始，AI 基座 是必选依赖。如果尚未安装，请先安装并启用 AI 基座并配置可用模型，否则插件不会启动。
这不是能力收紧：在此之前，没有 AI 基座的环境同样无法启动，只是报错是一段难以理解的堆栈；现在会直接提示依赖缺失。
感谢 kajhg（#42，提供了完整堆栈和非常到位的排查）、SwaggyMacro（#39 #40 #41）的反馈。
Generated from 4.0.6
设置服务会把同一主机的签名凭证归并成「单个元素、内嵌换行」的形态（host: access: X + 换行 + host: secret: Y），而签名解析把列表元素当作一行处理——归一化形态的值因包含换行被防注入检查整条拒绝。自 1.6.4 引入 SigV4 支持以来，通过设置页配置的签名凭证从未真正生效过，私有桶请求全部以未签名发出，R2 回 400 InvalidArgument / Authorization。
此前的测试直接注入逐行形态的凭证，恰好绕过了归一化这一环，因此一直未能发现。
parseSigningRules 先把每个元素按行拆开再解析：设置页保存的「一行一条」与设置服务归一化后的「内嵌换行」两种形态均支持；防注入检查保留（拆行后的值不再包含换行）。Authorization 头存在；并对真实 R2 私有桶验证同一链路可正常流式取回。升级到 1.7.4 后无需重新配置，已保存的签名凭证即刻生效。
Generated from v1.7.4
生产环境出现 上游拒绝：400 InvalidArgument - Authorization：这是 R2 对完全未携带签名的请求的回应（签名错误会是 403 SignatureDoesNotMatch）。说明媒体代理的签名凭证规则没有生效——可能是未配置，也可能是配置的行被静默丢弃（主机与允许清单不一致、access/secret 未成对等）。
InvalidArgument/Authorization 且本次请求未携带签名时，报错追加指引——去「文档设置 → 媒体同域代理 → 签名凭证」为该主机配置成对的 access 与 secret（已签名的请求不追加，避免误导）。***）：格式错误的行、主机不在允许清单内的规则、access/secret 未成对的组，都能在 Halo 日志里直接看到被忽略的原因。Generated from v1.7.3
视频播放：媒体代理此前把上游响应体整段缓冲（≤8 MiB 进内存、更大落临时文件）后才回给浏览器，导致：
本版改为流式转发：上游响应头一到即回给浏览器，响应体边收边转；Range 请求原样透传，拖动进度条只取所需片段；浏览器断开时取消信号传回上游。服务端不再整段缓冲、不再落临时文件。
X-Amz-Signature 等预签名参数时不再叠加 SigV4 签名头，避免双重鉴权被 S3 拒绝。Generated from v1.7.2
v1.7.1：上游错误文档不再误报 415
修复
/，报成 502 并带上错误码与说明。
- 日志同时打印上游状态码与错误文档片段。
保留
- 类型闸门不变：非 XML 的 text/html、image/svg+xml 等仍按 415 拒绝。
测试
- 新增 4 条用例（R2 的 InvalidArgument/Authorization、AccessDenied、无 Code 标签、非 XML 仍 415）。
- Java 用例 139 → 143。
Generated from v1.7.1
v1.7.0：文档设置页改版
改进
修复
测试
Generated from v1.7.0
v1.6.4：媒体代理支持 S3 SigV4 签名凭证，私有桶可用
修复
新增
提示
Generated from v1.6.4
v1.6.3：修复匿名访客访问媒体代理被重定向到登录页
修复
测试
同时包含 v1.6.2 的内容：媒体代理放行 application/octet-stream 对象并按 URL 扩展名
推断类型（对象存储里没带 Content-Type 的视频此前会被 415 挡掉）。
Generated from v1.6.3
v1.6.2：媒体代理放行 octet-stream 对象并按扩展名推断类型
修复
测试
Generated from v1.6.2
v1.6.1：文档设置页补齐媒体代理与阅读增强设置项
修复
说明
Generated from v1.6.1
v1.6.0：媒体同域代理与前台明暗切换
新功能
修复
升级提示
Generated from v1.6.0
mp4 / webm / ogv / ogg / m4v / mov / m3u8 文件时渲染为内嵌播放器（DPlayer），m3u8 通过 hls.js 支持，加载失败自动回退原生播放器；#md-width / #md-align 等图片参数继续有效，普通链接保持链接语义。--mdocs-accent）为主色自动生成，并修复图表容器无高度不可见的问题。Generated from v1.5.0
Full Changelog: 1.6.2...1.7.0
Generated from 1.7.0
本次更新新增垃圾内容检测、AI 群机器人和聊天图片定期清理，完善协议签署流程，并优化聊天界面、消息处理及访问权限校验。
accessKeyId、accessKeySecret；腾讯云 Secret 需包含 secretId、secretKey。表单仍保存 Secret 资源名称，原有名称配置可继续使用；更新后请确认对应资源存在且字段完整。vision 的模型。AI 是否在本地运行取决于 AI Foundation 接入的模型服务。内置推广词命中分数为 0.70，默认阻断阈值为 0.80，命中内置词不代表一定拦截；需要直接拦截的词语可加入自定义词条。