这一版把几处和 X 官网不一致的界面细节全部对齐了 —— 所有数值都是对 X 官网实测反推出来的，不是拍脑袋调的。

布局
左栏导航行高 46px → 58px

之前导航项上下各 10px 内边距，和 X 比显得紧。X 实测是「图标 26 + 上下 16 ≈ 58px」，现在一致了，导航区更舒展。

宽屏右栏 350px → 400px

X 在宽屏（≥1300px）下用 275 / 600 / 400 的三栏分配（常规宽度才是 350），右栏内容列实际 326px。这一版在 ≥1300px 时整体对齐：右栏 400、内容列 326、容器同步加宽到 1315（仍是居中 + 左右各 20 留白）。1265–1300 之间维持原来的 350 规格，折叠断点行为完全不变。

视觉
右栏卡片改为 X 风格

卡片从「灰底无边框」（旧版 X 的样式）换成 与页面同底 + 1px 细边框 —— 这是 X 现在所有卡片的统一画法，Lights out / Dim / Light 三档配色下都更贴近。

发帖框图标：蓝 → 灰

发帖输入框下那排小图标（图片 / 话题 / 日历）原来常亮蓝色，X 上默认是灰的。现在默认灰、悬停才亮蓝（带淡蓝圆底）。

「更多」图标：三点 → 圆环三点

左栏导航的「更多」图标原来和帖子菜单一样是裸三点，X 的导航「更多」是圆环内含三点。现在换上了新图标（帖子卡片和菜单里的「···」保持原样，和 X 一致）。

交互
顶栏操作区右对齐

首页顶栏的「登录 / 注册」（以及登录后的账号头像）原来紧跟在「主页」标题右边，现在推到顶栏最右侧 —— 和 X 的顶栏布局一致，也顺带修复了详情页顶栏「返回 + 标题 + 账号」挤在一起的问题。

安装
下载 halo-theme-x-1.12.12.zip → Halo 后台 外观 → 主题 → 安装主题。要求 Halo >= 2.26.0。

本主题的绝大部分代码由 WorkBuddy（模型 DeepSeek V4.1 Flash） 生成，人工负责提出需求、审阅与验收。

查看版本详情

新特性

• 新增 AI 使用统计，支持查看调用次数、Token 用量、趋势及调用明细，并按插件、服务商和模型等维度筛选 by @ruibaby in #96
• 服务商支持配置图片响应缓冲上限，可按需调大以处理包含较大 Base64 图片的生成响应 by @Akvicor in #114

功能优化

• 使用统计页面支持自动刷新，可选择刷新间隔并记住设置 by @ruibaby in #118
• 优化调用记录的数据质量提示，明确展示记录不完整或用量数据缺失等原因 by @ruibaby in #119

问题修复

• 修复控制台模型测试调用在使用统计中被识别为未知插件的问题 by @ruibaby in #120

Full Changelog: v1.1.1...v1.2.0

Generated from v1.2.0

查看版本详情

Rackora v0.9.8

修复

• 分类页的“精选内容”卡片和文章页的系列列表恢复显示。此前判断条件引用了同一元素上 th:with 定义的变量，而 Thymeleaf 会先执行 th:if 再执行 th:with，判断时变量尚未定义；变量定义已移到外层元素，构建检查会拦截同类写法。
• “外观 → 强调色”设置恢复生效。此前颜色变量写在 <body> 上，而主题在 <html> 上派生强调色，页面始终显示默认绿色；现在浅色模式直接使用所选颜色，深色模式自动提高亮度。以前改过强调色的站点，升级后会按当时所选的颜色显示。
• 安装包内中英文 README 的截图、Logo 和封面改为固定到对应版本标签的地址，仓库之后调整截图不会再让已发布安装包中的图片失效。

优化

• 主题清单声明 Halo 应用市场应用 ID（store.halo.run/app-id），便于 Console 识别已安装的 Rackora 并提示应用市场中的更新。
• “分析”分组的总开关说明补充数据流向，并指向 README 中的隐私说明。
• 清理重复的 CSS 规则，前台显示不变。

文档

• README 补充隐私说明：区分主题自身行为（不设置 Cookie，只在访客本机保存明暗模式选择）与第三方统计的数据处理，列出 GA4、Microsoft Clarity、百度统计的数据类别、浏览器存储、保存与删除方式和隐私政策链接。
• 代码高亮说明改为实际内置的 16 种语言，其他语言保持纯文本显示，不再使用“按需语言包”的说法。
• README 截图更新为中文默认界面，分为前台页面与后台设置两组，并加入应用市场封面。

安装包：theme-rackora-0.9.8.zip

完整提交对比：v0.9.7...v0.9.8

Generated from v0.9.8

查看版本详情

问题修复

• 修复主题名称包含大写字母时，无法通过 MCP 更新主题设置和读取主题模板的问题 by @ruibaby in #17

Full Changelog: v1.3.0...v1.3.1

Generated from v1.3.1

查看版本详情

软件中心 v1.2.0

这是继 v1.0.0 后的正式发布，包含 v1.1.0 阶段新增的可选 Halo MCP Server 集成，以及自动化操作的重试、并发编辑和操作前检查改进。现提供 43 个基础工具 + 2 个默认关闭的敏感工具，覆盖软件、版本、下载源、分类、标签和专题；未安装 MCP Server 时插件仍可独立运行。相对于 v1.1.0 阶段新增 9 个查询工具，已有工具名称和必填参数保持兼容。

三项改进

1. 创建请求持久化，重复调用不会重复创建

六类创建工具均接受可选 requestId（UUID）。同一资源类型下，相同 ID 和相同输入只尝试创建一次；换用不同输入会返回 IDEMPOTENCY_CONFLICT。

• 创建回执保存在 Halo 数据库中，跨插件重载及 Halo 进程重启保留。
• 同一请求并发到达时，只有取得写入资格的调用创建资源，其他调用返回原回执或 OPERATION_IN_PROGRESS。
• 资源已保存但回执未完成时，可以通过资源上的请求标记恢复回执。
• 资源后来被修改或删除，重放旧请求只返回原创建结果，不覆盖或重建。
• 新增 get_create_operation，查询 pending/writing/succeeded/failed/unknown 状态。

回执只保存输入摘要、目标名称和操作状态，不保存输入正文或敏感值。当前不自动清理回执；管理员清理记录或回退数据库会改变防重复保障。无法确认结果的请求保留 unknown，不自动重建。

2. 统计刷新不再必然阻止普通编辑

普通读取增加 editRevision。普通更新及发布时，除 expectedVersion 外传入 expectedEditRevision，即可在业务内容未变的情况下接受统计或元数据造成的版本变化。

实际落库仍发生版本冲突时，最多重新读取并重试两次。每次重试重新检查业务内容和引用，不覆盖其他人的业务修改。

只传 expectedVersion 时继续严格校验。敏感配置更新和删除仍使用严格版本，不能使用该宽容机制。敏感值不参与普通业务摘要；普通更新保留最新敏感配置。editRevision 表示当前内容，不是修改历史序号。

3. 发布前看准备情况，删除前看影响

新增 check_app_publication、check_topic_publication 及六类 check_*_deletion。

• allowed 表示当前领域规则是否允许操作；ready 还要求没有准备度警告。
• 软件发布检查已发布版本、该版本启用的下载源、目标配置及必要 Secret 是否存在；不输出 Secret 名称或值。
• 专题发布检查条目中的软件是否可见。
• 删除检查返回引用数量、最多 20 个名称样本，以及引用是否阻止删除；同时提示保留的专题或关联软件引用。
• 每组下载源或专题条目最多深入检查 200 条，超限会明确提示检查不完整。

预检查是当前快照，不锁定资源，也不改变原有发布规则。它不验证远程文件能否下载或登录、验证码流程能否成功；实际执行仍重新校验。

升级与使用

1. 在 Halo Console 上传 plugin-software-1.2.0.jar。
2. 等待插件恢复 STARTED，客户端重新获取工具目录。
3. 在 MCP 服务中为已有密钥勾选需要的新增查询工具；新增工具不会自动授权。
4. 自动化创建始终携带稳定的 requestId，重试复用同一 ID 和输入；编辑读取最新详情并携带 expectedEditRevision。

新增参数均为可选。旧客户端继续可用，但不会自动获得创建去重或容忍统计变更的能力。重放创建返回的是原回执，后续编辑前需要重新读取资源。

从 v1.0.0 升级前，需先将 Halo 升级至 2.26.0 或更高版本（v1.0.0 的最低要求为 2.25.0）。源码构建使用 Java 21。当前编译使用 MCP API 1.3.0，保留 1.0.0 调用契约，可选插件依赖仍为 MCP Server >=1.0.0 & <2.0.0；不嵌入 MCP API/SDK。基础工具不依赖 AI Foundation；AI Foundation 编译 API 为 1.1.1，可选依赖范围保持 >=1.0.0-SNAPSHOT & <2.0.0。

新增内部 Extension operations.software.jiewen.run/v1alpha1/SoftwareCreateOperation 及两项引用索引，既有六类业务 GVK、Console API 和业务数据结构保持兼容。内部请求记录未向普通软件角色或匿名用户开放原始资源权限。

完整参数、工具目录和失败处理见 MCP 接入文档。1.1.0 设计背景见 原实现方案。

构建与发布维护

• 更新 Gradle、Halo UI 和其他兼容依赖；Console 保持 IIFE 输出及现有 JS/CSS 加载方式。
• 对齐 Node.js 24、TypeScript 5.9 和 Halo 2.26 要求的 Vue Router 5.1，避免依赖升级破坏构建兼容性。
• GitHub Release 发布后自动构建安装包并推送至 Halo 应用市场应用 app-todmqfve；本次不自动同步 README。
• 暂停三个生态的常规 Dependabot 版本更新 PR，改为按需手动维护；仓库安全更新设置保持原样。

验证记录

验证日期：2026-10-16。使用独立 Halo 2.26.0 容器、文件型 H2 数据库、官方 MCP Server 1.0.0，通过 /mcp Streamable HTTP 联调。

真实联调覆盖六类创建/查询/编辑/删除、同一请求重放和不同输入拒绝、四个并发请求只创建一条资源、保存资源后恢复回执、插件重载和整站进程重启后的去重、删除资源后不再重建、不确定结果不重建、业务版本与统计版本冲突、发布准备及引用影响、敏感配置脱敏、密钥白名单、匿名访问拒绝，以及 MCP 停用和恢复。

单元测试另覆盖回执存储失败、取消与超时恢复、业务并发竞争、有限重试、敏感字段不进入摘要、检查数量上限及全部工具输出 Schema。联调修复了 Halo 将存储重名异常转换为 HTTP 400 异常的兼容问题：重试先读取并核验已存在请求，不依赖异常消息文字。

提交前对抗审查修复了两项边界问题：引用校验不再接受已标记删除但尚未清理的软件、分类或 Secret 等资源；专题发布预检查遇到旧数据中的空条目时返回隐藏条目警告，避免 Reactor 拒绝空元素而中断检查。4 项回归用例先复现失败，修复后通过；上述真实 MCP 联调记录来自修补前，本轮修补通过完整本地构建和回归验证，未重复执行整套真实 MCP 联调。

依赖更新后，Gradle 9.8.1 完整构建、193 项 Java 测试、55 项前端测试、lint 和类型检查再次通过。保持新 API 编译结果不变，仅将测试运行时替换为 AI Foundation API 1.0.1 / MCP API 1.0.0 后，193 项 Java 测试再次通过；安装包保留 Console JS/CSS，不包含可选插件 API 或 MCP SDK。此阶段未重复执行真实 Halo 安装、升级、编辑器 UI 和 MCP 联调。

本次未进行 PostgreSQL/MySQL 联调、生产数据压力测试、全部 MCP 1.x 版本测试或特定 AI 客户端的界面验收。跨资源工作流、批量导入和 AI 异步作业仍不在本版本范围内。

正式版本号为 1.2.0，Git 标签为 v1.2.0，安装包为 plugin-software-1.2.0.jar。发布安装包不会自动升级已安装插件的站点；站点升级需在 Halo Console 中执行。

Generated from v1.2.0

查看版本详情

更灵活的 Webhook 接入

• 可选择请求方式、添加自定义请求头，并按接收服务要求编排消息内容，连接更多通知服务。
• 完整展示已保存的 Webhook 地址，地址、请求头和消息模板可直接查看与修改。
• 新增“发送测试”，使用当前编辑内容立即验证接收效果，无需先保存；成功或失败都会弹窗提示，并显示接收端返回状态。

更顺手的配置体验

• 地址与请求方式并排展示，请求头编辑更紧凑，保存与测试按钮集中排列，配置更容易检查。
• 模板参考与编辑区同页展示，宽屏左右并排，点击即可复制占位符或示例，方便边查阅边编写；说明独立滚动，保存与测试按钮位置稳定。
• 改善升级兼容性，继续保留个人配置和历史配置自动迁移能力。

Generated from v1.3.0

查看版本详情

仿 X 开屏加载页（1.12.9）
打开任何页面时，先显示一整屏居中的站点标识（背景跟随当前配色），页面就绪后快速淡出 —— 就是 X App 启动画面那个感觉。

标识不写死：自动跟随「账号信息与标识」里的设置 —— X Logo / 自定义图片 / 文字 + 副标题
脚本正常时：页面就绪 150ms 后主动淡出并移除
脚本不可用时：CSS 动画 3 秒兜底，任何情况下不会把访客堵在开屏页
系统开了「减弱动效」：直接跳过开屏
开屏显示时机可选（1.12.10）
上一版加了仿 X 的开屏加载页，这一版把「什么时候显示」也做成了设置 —— 主题设置 → 布局 → 开屏显示时机：

选项 行为
仅首次访问（默认） 每个浏览器会话只在打开站点时显示一次；站内跳转、刷新都不再出现
每次加载都显示 每打开一个页面都显示（上一版的行为）
「仅首次」在 里就做完了判断（body 里的开屏元素还没解析就已经决定去留），跳过时零闪烁；浏览器存储不可用时静默退化为每次都显示，不影响进入页面。

设置结构重排（1.12.11）
设置页从 6 组整理为 8 组，每组各管一摊，找东西不用再翻长列表：

组 管什么
外观配色 配色、字号、圆角
账号信息与标识 logo、头像、资料、封面与认证
布局 栏位显示、右栏卡片、开屏
内容展示（新） 统计数、封面、时间线形态、阅读时长、加入日期
功能开关 点赞、评论、搜索、趋势、编辑资料
瞬间（新） 投稿入口、站内发布、评论组设置
导航自定义 导航项、菜单、自定义条目
地址与登录入口 登录注册入口与各页面地址
原来的「内容与交互」一坨 15 项（点赞、封面、瞬间、通知全混在一起），现在按职责拆成了三组。

升级注意
设置项的分组名是配置的存储键。这次挪过组的 12 项都做了过渡回退——升级后在你保存设置之前，行为和旧版完全一致，不用急着重新配置。

但在后台保存过一次设置之后，如果你以前改过这 12 项里的某几项（主要是：时间线形态、瞬间投稿相关、首页发帖入口、导航里的瞬间 / 通知开关），建议顺眼核对一下，个别项会以默认值显示。

安装
下载 halo-theme-x-1.12.11.zip → Halo 后台 外观 → 主题 → 安装主题。要求 Halo >= 2.26.0。

本主题的绝大部分代码由 WorkBuddy（模型 DeepSeek V4.1 Flash） 生成，人工负责提出需求、审阅与验收。

查看版本详情

右栏可以自己加卡片了；顺带修掉两个「会跟着帖子滚走」的栏。

新增：右栏自定义卡片
主题设置 → 布局 → 右栏自定义卡片，卡片式条目，可自由增删、拖动排序，想加几张加几张。显示在右侧栏账号卡片的下方。

每张卡片三样东西：

字段 说明
标题 留空则没有标题行
内容 多行文本，换行按原样显示
链接 可留空；链接文字不填时显示「了解更多」，外链自动新窗口打开
标题、内容、链接全空的条目不会渲染 —— 所以升级之后右栏外观不会有任何变化，想用了随时加。

卡片外壳复用现有的卡片体系，和账号卡片、「正在发生」摆在一起观感一致。

修复：两处「跟着帖子滚」的横栏
① 右栏（桌面端第三栏）会跟着帖子流一起滚走，滚两屏右边就空了。

根因：.x-app 是 align-items: flex-start 的 flex 容器，右栏外壳 .x-rail__inner 只有内容那么高 → 里面 sticky 的包含块跟着变矮 —— 粘了，但一滚就到底。修法是给外壳补 align-self: stretch，让它撑到与主栏等高。

② 作者页「帖子」tab 栏也会跟着滚。主页、瞬间页的 tabs 都长在顶栏内部、跟随整体固定，唯独作者页这条独立在资料区之外，压根没做吸顶。现在它粘在顶栏下沿（与归档页的年份标题同一套路），滚过资料区后就一直可见。

这次怎么验证的
先在线上站点「注入修复样式」做 A/B，滚动到多个位置对比坐标；再用改后的真实 CSS 替换线上样式、逐页滚动核对：右栏恒 0 不动，作者页 tab 栏滚到 54px 后停住，左栏 / 顶栏 / 归档年份栏不受影响。

新增的卡片功能走真实 Thymeleaf 渲染测试（弹层工程在 .probe/tplcheck）：全空条目过滤、链接文字回退、多行换行都验证过，最后把渲染结果注入线上右栏截图确认了视觉。

顺带查清了一个一直没坐实的技术点：Halo 的 theme.config 实际是 JsonNode，但 Halo 给模板求值注册了 JsonPropertyAccessor，所以设置项用 item.field 这种点号写法是官方支持的 —— 自定义导航、账号菜单一直就这么工作的。

安装
下载 halo-theme-x-1.12.8.zip → Halo 后台 外观 → 主题 → 安装主题。要求 Halo >= 2.26.0。

本主题的绝大部分代码由 WorkBuddy（模型 DeepSeek V4.1 Flash） 生成，人工负责提出需求、审阅与验收。

查看版本详情

此版本要求 Halo ≥ 2.27.0。

新特性

• 支持订阅商品，提供套餐与周期选择、试用及套餐切换，并在购物车、结算和支付页面展示订阅信息
• 支持游客下单、支付和查看订单，可通过邮箱重新获取订单访问链接
• 支持手机浏览器中的微信 H5 支付

功能优化

• 批量加载页脚菜单，减少菜单查询次数
• 商品购买数量适配库存和单笔限购，购物车自动排除询价商品参与结算
• 完善结算失败重试、提交状态和支付查询超时提示

问题修复

• 修复移动端商品详情页横向溢出的问题

开发者相关

• 适配 Halo 页面布局接口，插件前台页面可复用主题布局

查看版本详情

v1.0.3

修复（应用市场审核意见）

• 业务代码包名由 run.halo.visiteditor 迁移至开发者自有包名 top.iloved.visiteditor
• 移除对 Halo 2.22+ 引入的 Queries API 的依赖，文章列表读取兼容更低版本
• 最低兼容版本声明调整为 Halo >= 2.22.0，并同步更新插件清单与 README

v1.0.2

修复

• 列表排除回收站中的文章（修复出现「未命名未发布文章」的问题），与 Halo 后台文章列表行为保持一致

v1.0.1

修复与优化

• 修复：搜索框不渲染的问题（组件库中不存在 VInput，改为原生输入框）
• 新增：输入即搜（300ms 防抖）
• 新增：支持按阅读量从高到低 / 从低到高排序，文章多时也方便查找

v1.0.0

首次发布：Halo 文章阅读量可视化管理插件。

• 查看/搜索文章阅读量
• 行内修改阅读量，支持批量保存
• 修改后前台即时生效，与真实统计兼容累加

安装：Halo 后台 → 插件 → 安装 → 上传本 jar。要求 Halo >= 2.20。

查看版本详情

Rackora v0.9.7

本次调整

• 新安装默认使用简体中文，主题界面语言默认为“简体中文”，网站语言默认为 zh-CN。
• 已安装站点保留原有语言设置，不受本次默认值调整影响。
• 主题详情中的描述恢复为英文。

使用说明

• 兼容 Halo 2.20.0 及以上版本。
• 如需英文界面，请在主题“基础”设置中将主题界面语言设为 English，并将网站语言改为 en-US。

前台页面

后台设置

查看版本详情

体验改进

• Webhook 正文现在可以按个人需求编排：在用户中心填写 JSON 模板后，可把通知标题、正文、接收人、主题信息和扩展属性组合成适合自己系统的请求格式。
• 模板支持占位符和类型保留，既能生成简单的标题消息，也能直接传递结构化主题与属性；设置页同时提供可复制的字段示例，降低接入成本。
• Webhook 配置按用户独立保存，用户数量增长不会让单个配置对象持续膨胀；旧版本配置会在插件启动时自动迁移，升级过程无需重新录入地址。
• 用户删除后会自动回收关联的 Webhook 配置，重新注册同名用户也不会继承历史地址或模板。

Generated from v1.2.0

查看版本详情

用户中心可以配置个人 HTTPS Webhook，按 Halo 原生通知偏好接收本插件及系统其他通知类型

Generated from v1.1.0

查看版本详情

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

新特性

• 支持复制评论和回复的固定链接，打开链接可直接查看对应讨论 by @ruibaby in #246
• 支持拥有评论管理权限的用户在前台编辑评论和回复 by @ruibaby in #247
• 支持将回复设为私有 by @ruibaby in #258

功能优化

• 优化 Console 评论图片的尺寸限制，保持图片原始比例 by @ruibaby in #259
• 将评论管理菜单中的“隐藏 / 取消隐藏”统一为“设为私有 / 设为公开” by @ruibaby in #260

开发者相关

• 新增 --halo-cw-primary-contrast-color，支持自定义主色按钮的文字颜色 by @SinonJZH in #257
• 新增 --halo-cw-content-img-max-width，支持限制评论内容中的图片宽度 by @ruibaby in #259

Full Changelog: v3.3.2...v3.4.0

Generated from v3.4.0

查看版本详情

• 修复首页「精选专题」区文章封面不显示的问题。

查看版本详情

Halo2Bark v1.1.0 更新说明

本次更新让通知更聪明：设备故障有回音、点击直达对应的管理页、评论爆发不再刷屏。

新增

• 设备健康有回音：某台设备连续投递失败会收到失败告警；故障恢复后，恢复通知会在手机上原地替换失败告警——每台设备的健康状态在手机上始终只占一条，不用去后台查。多设备站点里，失败告警由其他正常设备代为转达。
• 评论爆发温度计：评论爆发刚起时收到一条「🔥 评论爆发中」，爆发结束的合并摘要会原地替换这条过程通知——无论讨论多热烈，整个过程在手机上只占两条。

改进

• 点击直达对应的管理页：「评论待审核」点进去是 Console 的待审核列表，「文章已删除 / 取消发布」点进去是回收站——每个事件都落到你最可能要去的地方，被删文章不再跳死链。

说明

• 需要 Halo 2.26.0 及以上，升级后无需重新配置。
• 以上能力依赖较新的 Bark 服务端（v2.2.5+，官方服务即为新版）；旧版服务端会自动退化为普通通知，不影响使用。

查看版本详情

2.0.0 正式版说明 · 收官版本

装包后请强刷浏览器（Ctrl+Shift+R），并完整重启一次 Halo 服务（仅替换 jar 不重启，Halo 会继续用内存里的旧代码）。

这是最后一个功能版本。此后本插件不再新增功能，只维持可用。所以这一版的重点不是"还能做什么"，而是让它在你不管它的情况下也不容易坏、坏了你能自己看出来。

一、插件内自检：提醒不弹时，先点这里

设置里新增「提醒自检」卡片，点一下会沿着提醒链路逐项检查，并用人话告诉你结论：

任何一项异常都会直接给出下一步该做什么（强刷浏览器 / 重启 Halo / 检查开关）。这一项是为"以后没人给你排查"准备的：以前这类问题只能靠翻日志和猜，现在用户自己点一下就有答案。

二、使用说明搬进了插件里

从应用市场安装的用户看不到仓库里的 README，所以把用法直接放进设置页，做成可折叠的「使用说明与常见问题」：

• 三步就能用起来（先记日子 → 想管车再加座驾 → 要公开才开前台开关）
• 提醒会在哪三个地方出现
• 弹窗为什么"刷新又出来了"、怎么才能不烦我
• 默认值是给谁看的（哪些内容默认不对访客展示）
• 到期了没办会怎么样（逾期 → 待处理 → 一直保留，可撤销）
• 提醒没出现怎么办（三步排查）
• 数据在哪、怎么搬走

三、条目多了也能一眼看出最近要办什么

「记得」页的重要日期列表此前只能按人员筛选，排序还是拖拽顺序 —— 条目一多，根本看不出"最近有什么"。

• 新增临近程度筛选：全部 / 今天 / 7 天内 / 30 天内 / 30 天以后，每档都带条目数；
• 新增「还有」列：直接显示「明天」「5 天后」「已过 3 天」，临近的用颜色标出来。

四、修掉一个会打乱顺序的问题

拖拽排序此前把筛选后可见的那几条的顺序整份写回，于是被筛掉的条目顺序被抹平，会在列表里悄悄跳位。现在只移动可见项，其余条目保持原有相对位置。加了临近程度筛选之后这个问题的破坏力会成倍放大，所以一并修掉。

五、弹窗的无障碍与小改进

• 支持 Esc 关闭：按键盘的习惯动作只收起当前弹窗，不写任何静音记录（不该因为按了下 Esc 就"以后都不提醒"）。
• 关闭按钮从 <span> 换成真正的 <button>：可以 Tab 聚焦、回车触发，读屏软件能正确朗读「关闭提醒」。
• 弹窗语义从 role="alert" 改为 role="status" + aria-live="polite"：这是提醒不是报错，不该打断用户正在听的内容。

六、描述收敛成一句话

插件描述从 200 多字的长句改成一句话：

把容易忘的事记下来：纪念日与生日、家人朋友、爱车的保险年检保养到期，到点提醒你，愿意公开的还能展示在博客前台。

七、关于后续维护

• 升级方式：请在「插件」页面上传新 jar 升级。不要手工替换 plugins 目录里的文件 —— Halo 在数据库里记录插件的加载路径，换了文件名它就不再加载（表现为接口 404、后台菜单消失）。
• 数据安全：纪念日、人员、座驾都存在 Halo 自己的数据里，卸载插件不会替你删除；「记得」页右上角的导出可以把全部内容存成 JSON 留底。
• 遇到问题先点「提醒自检」，它能覆盖绝大多数"提醒不出现"的情况。

查看版本详情

深绿玻璃拟态 Halo 主题的首次功能升级：首页从「Hero + 纵向文章流」升级为完整的信息层次体验。

功能特性

• Hero 数据徽章行：文章 / 分类 / 标签真实统计数字，琥珀色 #E8B96E 斜体衬线点缀，访问量可选配置
• 精选专题区：自动取最近 3 篇带封面文章生成玻璃特色卡
• 文章列表混合布局：置顶文章通栏大卡（左封面右内容）+ 双列网格，可在主题设置切回经典纵向列表
• 首页作者卡片：圆头像徽章 + 简介 + GitHub/Email 联系胶囊
• 导航搜索入口：配置搜索页链接后显示（可选）
• 新增主题设置分组：精选专题 / 文章列表 / 作者卡片 / Hero 徽章，全部带默认值兜底，老站点升级免配置

修复

• 修复首页数据徽章 categoryFinder.getAll() 调用不存在的 API 导致的 500（改为 list(1, 1).total）

安装方式

1. 下载本 Release 附件中的 theme-luye.zip
2. Halo 后台 → 外观 → 主题 → 升级主题（或安装主题）
3. 在「主题设置」中查看新增的配置分组

兼容性

• Halo >= 2.26.0
• 已在 Halo 2.26.0 本地实例完成真机验证（首页 / 文章 / 归档 / 分类 / 标签 / 静态资源全路径 200）

查看版本详情

记得（plugin-important-dates）

一个 Halo 2.x 插件：记录纪念日、生日与家人朋友，也管好你的座驾（汽车 / 电瓶车 / 自行车）——保险、年检、保养到期自动提醒；支持阳历/农历、多图相册、前台「生活 / 爱车」双视图、隐私脱敏，零系统配置写入、零主题文件写入。

English README ｜ Releases ｜ 问题反馈 ｜ 作者：yyliucha

截图

截图	说明
	控制台仪表盘小组件：到期提醒常驻仪表盘，每分钟自动刷新
	后台页签：重要日期 / 人员 / 座驾，提醒横幅 + 卡片列表 + 拖拽排序
	座驾页签：分类图标、车牌、到期徽章（已过期 / 临近）、车主与驾驶人、前台开关
	座驾表单（1.3.0）：五个可折叠分区（基本信息 / 到期提醒默认展开）；字段按车型显示——电瓶车锁定「纯电」、不留发动机号，自行车连车牌与能源都不出现
	前台 /important-dates：生活视图——重要日期 + 牵挂的人（生日与纪念日倒计时）
	爱车视图：车辆卡片（脱敏车牌、到期徽章）+ 车主与驾驶人（统一徽章）+ 其他重要的人
	相册查看：点击封面全屏浏览（只读、Esc 关闭），仅显示后台勾选「展示」的照片
	悬浮提醒：位置自选、倒计时 + 进度条、关闭方式菜单（本次关闭 / 今天不再提示 / N 天内不显示），默认只在「记得」页弹出

功能

📅 重要日期

• 名称 + 日期 + 多行备注；阳历 / 农历（含闰月），农历自动换算当年阳历
• 每年自动循环，列表显示"最近一次"与"还有几天"；支持拖拽排序（前后台一致）
• 自研日期选择器：阳历格内标注农历；农历选年/月（含闰月）/日实时换算；编辑时面板定位到已选日期

👤 人员

• 姓名、昵称、关系（含"本人"）、生日（阳历/农历）、性别、血型、身高、体重、喜好、备注、大头贴（官方附件上传 / 附件库选择）；支持拖拽排序
• 重要日期可关联多人，列表可按人员筛选

🚗 座驾（汽车 / 电瓶车 / 自行车）

• 17 类分类（轿车 / SUV / MPV / 跑车 / 越野车 / 皮卡 / 旅行车 / 两厢车 / 跨界车 / 微面 / 房车 / 货车 / 客车 / 摩托车 / 电瓶车 / 自行车 / 其他）、能源类型（燃油 / 纯电 / 插混 / 油电混动 / 人力）、品牌型号、颜色、VIN、发动机号、注册与购买日期、里程、状态（在用车 / 已出售 / 已报废）
• 按车型只显示用得上的字段（1.3.0）：以「有没有发动机、有没有牌照」分档——自行车不显示车牌 / 能源类型 / 车架号 / 里程 / 购买价格；电瓶车保留车牌与车架号（称「整车编号 / 车架号」），能源类型锁定为纯电，不显示发动机号与首次登记日期；保险公司与保险 / 年检 / 车船税只对汽车、摩托车等机动车出现。编辑弹窗相应精简为五个可折叠分区（基本信息、到期提醒默认展开，相册 / 关联人员 / 更多资料收起并显示摘要），每条到期项压成一行、细节收进「设置」
• 改车型不丢数据：把汽车改成自行车时，已有的保险 / 年检项保留在库里但不再展示、也不再提醒（表单里看不到、卡片与前台都不出现），改回汽车后原样恢复，到期日一字不改
• 多图相册：上传或附件库多选、拖拽排序、设封面；每张可单独勾选「展示」（未勾选仅后台可见，适合行驶证、保单等证件照）
• 附件库来源范围：可在「设置 → 照片设置」为人员大头贴与座驾相册分别指定「分类（分组）」与「存储策略」；命中不到时自动放宽范围并在弹窗中说明当前生效范围与命中数（不会出现空白列表），也可一键「显示全部图片」
• 图片失效自动降级：附件被删除（或被其它插件的全局规则拦截）导致图片打不开时，前台封面回退车型图标、大头贴回退首字、相册显示占位说明——访客永远看不到破图；后台车辆/人员卡片会标出「含失效图片 N」「大头贴已失效」，可一键「移除失效图片」或逐张「重新选择」
• 省流量的图片处理：列表 / 相册网格 / 前台卡片使用 ?width= 缩略图（默认 480px，可配，0＝原图），点开查看仍是原图；上传超过 1.5MB 的图片会先在浏览器压缩（默认压到 1920px，可关）
• 提醒状态机（1.2.6）：到期日过了没办就是逾期（不再自动滚到下一期）——逾期期间逐日提醒，之后转「待处理」但一直保留在清单里；只有点「已办」才顺延：循环项顺延一期、保养项记为「刚做完保养」（自动更新上次保养日期并按间隔推算下次）、一次性项标记完成；支持一键撤销办理（含上次保养日期一起还原）
• 节点式提醒节奏：提醒期每 7 天一个节点、最后 15 天加密为 15/7/3/1/0 天、逾期 1/2/3 天，每个节点给出对应的贴心文案—— 这条管的是后台/前台横幅与仪表盘的主动提醒节奏；悬浮弹窗按下面的规则每次打开都提示
• 弹窗内动作原地生效：在座驾编辑弹窗点「已办 / 撤销办理」立即写库、只刷新本行、不关闭弹窗（不必再"记得点保存"）
• 提醒可逐条忽略：前台横幅与仪表盘小组件每条右侧的 ✕ 表示"本次到期周期内不再提示"（存在浏览器里，到期日变化后自动恢复），可一键「恢复显示」，也可在设置里关闭
• 年检规则可配置：「座驾设置 → 年检节点（默认 2,4,6,10）」「从第几年起每年上线检验（默认 11）」可按当地车管所规则调整，表单预览与提醒同步
• 到期提醒：交强险 / 商业险 / 年检 / 保养（按上次保养 + 间隔月数推算）/ 车船税 / 自定义项；每项可设启用、提前天数与循环间隔（每年 / 每两年 / 每三年 / 不循环 / 自定义月数）；已出售 / 报废不再提醒（「驾照换证」自 1.3.0 起不再挂在座驾上——它属于"人"而非"车"，同一个人开两辆车不会重复提醒）
• 保险公司填一次就够：车辆级「保险公司」全车共用（含常用公司快捷提示），个别险种可「使用其他保险公司」单独覆盖；老数据启动时自动迁移（幂等）
• 年检自动推算：按「首次登记日期 + 车型规则」推算下一次年检（第 2/4 年免检申领 → 第 6/10 年上线检验 → 第 11 年起每年），提示阶段与依据，可「手动指定日期」覆盖；默认提前 30 天提醒
• 年检 / 车船税默认与保险同期：日期跟随交强险到期日（可取消后独立填写），保存时写入相同日期
• 同车同日合并提醒：交强险 / 商业险 / 车船税 / 年检同日到期时合并为一条（如「小白 · 交强险 / 商业险 / 年检」），后台列表仍逐项显示
• 规则切换一次性提示：车辆进入上线检验期（第 6 年起）或改为每年一次（第 11 年起）时后台提示一次，点「知道了」不再重复
• 关联人员：车主 + 常用驾驶人（可选），车辆卡片与人员卡片使用统一徽章（男生「酷」/ 女生「可爱」/ 未关联中性）

🔔 到期提醒（三处，任你挑）

• 仪表盘小组件（Halo 2.21+）：常驻仪表盘、每分钟刷新、小分页（默认每页 5 条，可调或关闭），显示完整提醒列表（仪表盘 → 编辑 → 添加部件 → 小部件中心 → 分组「记得」）
• 后台 + 前台横幅：“「结婚纪念日」明天就到啦～” / “「小白」的交强险还有 7 天到期，记得安排一下呀～”
• 悬浮弹窗（可选）：默认只在「记得」页面弹出（访客看不到站主提醒），可切回"全站"；位置 / 文案 / 倒计时可配；每次打开页面都会提示（设置里可关闭菜单，改成静音需访客主动选择时长）
• 重要日期与座驾到期统一排序（谁近谁靠前）；同一辆车同一天到期的多项自动合并为一条

👁 隐私

• 日期、人员、车辆各有「前台展示」开关（车辆默认关闭）
• 前台永不输出：体重、血型、身高、喜好、备注；车牌号永远脱敏（粤B·****5）；VIN、发动机号、保单号、购买价格不输出；生日默认脱敏
• 未勾选「展示」的照片不出现在前台相册

🏠 前台页面（插件默认模板，主题可选覆盖）

• 单页 「生活 / 爱车」 双视图切换（地址栏记忆 ?view=car）：生活视图＝重要日期 + 牵挂的人；爱车视图＝车辆卡片 + 车主与驾驶人 + 其他重要的人
• 相册：点击车辆封面全屏滚动查看（只读）
• 通过官方页面布局契约复用主题外壳（主题不支持时用 Halo fallback 布局）；主题可放置同名模板覆盖；插件不写入、不修改任何主题文件（停用 / 卸载零残留）
• 提供 importantDateFinder：listAll() / listAllPeople() / listAllCars() / listUpcoming(days) / listUpcomingCarEvents(days)

📊 其他

• 导出 / 导入：JSON（v3，含人员与座驾），判重跳过、不覆盖，兼容旧版导出文件

数据与合规

• 数据存于 Halo 扩展存储（importantdates.halo.run/v1alpha1），底层即站点数据库（H2 / MySQL / PostgreSQL），与站点同库同备份
• 零系统配置写入（不使用「代码注入」，脚本经官方 TemplateHeadProcessor 输出）、零主题文件写入
• 无任何联网请求，不采集、不上传任何用户数据

兼容性

• Halo 2.26 及以上（按官方 2.26 文档与扩展点实现；Java 17 字节码；1.3.0 在真实 2.26 实例上以既有数据（含 10 辆历史车辆）完成功能自测 18/18 与前台回归 5/5，覆盖卡片到期项、车型联动、切车型不丢数据、折叠分区与老数据纠偏）
• 管理员安装后默认拥有全部权限，无需手动配置角色权限

安装与升级

1. 从 Releases 下载 plugin-important-dates-*.jar；
2. Halo 后台 → 插件 → 安装 → 本地安装 → 上传 jar → 启用（左侧菜单 内容 → 记得）；
3. 前台访问 https://你的域名/important-dates。

升级：停用 → 卸载旧版 → 安装新 jar → 启用（数据不丢失）。若使用页面静态化 / 缓存插件，升级后清理一次页面缓存。

使用（后台）

• 新增日期：名称、日期类型、日期（阳历点选 / 农历选年月日）、关联人员（可多选）、备注；可设「重要」与「前台展示」
• 人员页签：维护人员信息与「前台展示」；可拖拽排序
• 座驾页签：维护车辆档案、相册（含逐张「展示」勾选）、到期项；可拖拽排序；卡片上可直接切换「前台展示」
• 导出 / 导入：页面右上角
• 提醒与隐私配置：插件 → 记得 → 设置（提醒设置、全站悬浮提醒、展示设置、隐私设置、照片设置、座驾设置）

全站悬浮提醒（可选，设置驱动）

• 启用：经官方 TemplateHeadProcessor 输出脚本，关闭即不输出，停用 / 卸载随插件消失
• 位置：右下角 / 左下角 / 右上角 / 左上角 / 底部居中 / 屏幕中间（默认右下角）
• 文案占位符：{title}、{whenText}、{daysUntil}、{dateText}、{nextSolarDate}
• 行为：每次打开页面都会提示（1.3.1 起；此前是同一浏览器只弹一次）；自动关闭（默认 8 秒，含倒计时 + 进度条）；点 × 可选本次关闭 / 今天不再提示 / N 天内不显示
• 只提醒、不堆清单（1.3.3 起）：一辆车只占一行（显示最近到期的那项，并注明「这辆车共 N 项到期」）；被折叠或超出「每类最多 N 条」的汇总成「还有 N 项」，底部一行可点文字直达「记得」页看全部。完整日期在前台横幅、仪表盘小组件与「记得」页始终逐条可见
• 关闭方式菜单（默认开）：点 × 弹出上面这些选项；若关掉菜单，点 × 只收起当前弹窗，不会静默静音
  • 时长可在设置里勾选（默认 3 / 5 / 7 / 30 天）
  • 没有「永久不再提示」：所有静音都有期限，到期自动恢复，不会有人手一滑就再也收不到提醒
  • ⚠️ 菜单开启时有 5 秒超时：未选择则执行「× 关闭默认行为」，建议保持「本次关闭」或「今天不再提示」

历史升级提示：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、showAvatar
• 爱车视图：cars（含 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 写操作加固、图片失效降级。

License

MIT

查看版本详情