Halo 存储工具箱

Halo 存储增强插件，支持图片格式转换、水印添加等功能，帮助优化网站图片加载性能。

功能特性

🖼️ 格式转换

• 自动将上传的图片转换为 WebP 或 AVIF 格式
• 可调节输出质量（1-100）
• 可调节压缩等级（WebP 0-6，AVIF 0-10，值越大压缩越慢但文件越小）
• 显著减小图片体积，提升加载速度
• AVIF 格式压缩率更高，适合现代浏览器

💧 水印功能

• 文字水印：自定义文字、字体大小、颜色
• 图片水印：支持上传自定义水印图片，可调节缩放比例
• 位置设置：九宫格位置选择（左上、居中、右下等）
• 透明度：可调节水印透明度（0-100%）
• 边距控制：自定义 X/Y 方向边距百分比

🎯 精准控制

• 指定目标存储策略
• 指定目标分组
• 文件格式过滤（jpeg、png、gif、webp）
• 文件大小过滤（最小/最大限制）
• 支持控制台上传和编辑器上传（Halo 2.22+）

⚡ 性能优化

• 流式处理大图片，降低内存占用
• 支持处理超大尺寸图片

⚡ 批量处理 (New)

• 功能全面：支持对已上传的图片进行批量压缩、添加水印和格式转换
• 灵活策略：支持选择是否保留原文件（保留原图则生成新附件，不保留则覆盖原附件）
• 进度监控：实时显示处理进度、成功/失败数量、跳过数量
• 结果统计：详细展示处理结果、节省空间统计和失败原因

📈 存储分析与优化 (New)

• 存储统计：按类型、策略、分组统计附件数量和大小，提供可视化图表
• 重复文件检测：基于文件 MD5 哈希识别重复文件，显示可节省空间
• 死链检测：扫描文章、页面、评论、瞬间、图库等内容，发现引用的失效附件链接
• 死链白名单：支持配置忽略特定的 URL 模式（支持精确匹配和前缀匹配）
• 未引用检测：识别未被任何内容使用的"孤儿"附件，支持一键清理
• 清理日志：记录所有删除操作详情（删除原因、文件大小、操作者、删除时间等）

📊 处理日志

• 记录每次图片处理的详细信息
• 统计成功/失败/跳过数量
• 显示节省的存储空间
• 支持按文件名、状态、时间、来源筛选
• 自动清理过期日志

安装

1. 从 Releases 下载最新版本的 JAR 文件
2. 在 Halo 后台 → 插件 → 安装 → 本地上传
3. 启用插件

⚠️ 注意：本插件使用了 WebP 和 AVIF native 库进行图片格式转换。由于 JVM 的 native 库加载机制限制，插件更新后需要重启 Halo 才能正常工作。热更新可能导致 native 库冲突或功能异常。

使用说明

基本配置

1. 进入插件设置页面
2. 在「全局设置」中启用图片处理
3. 根据需要选择目标存储策略和分组

格式转换

1. 在「图片处理」→「格式转换」中启用
2. 选择目标格式（WebP 或 AVIF）
3. 调节输出质量（推荐 75-85）

💡 格式选择建议：WebP 兼容性好，推荐大多数场景使用；AVIF 压缩率更高但需要较新浏览器支持（Chrome 85+、Firefox 93+、Safari 16+）

添加水印

1. 在「图片处理」→「水印设置」中启用
2. 选择水印类型（文字/图片）
3. 配置水印内容、位置、透明度等参数

查看日志

1. 进入 Halo 后台 → 工具 → 存储工具箱
2. 在「处理日志」标签查看处理统计和详细记录
3. 可按条件筛选日志

存储分析

1. 进入 Halo 后台 → 工具 → 存储工具箱
2. 在「统计」标签查看存储空间分布
3. 在「分析」标签进行重复检测和引用扫描

开发

环境要求

• Java 21+
• Node.js 20+
• pnpm 9+

本地开发

# 克隆项目
git clone https://github.com/Tim0x0/halo-plugin-storage-toolkit.git
cd halo-plugin-storage-toolkit

# 启动 Halo 开发服务器
./gradlew haloServer

# 开发前端（新终端）
cd ui
pnpm install
pnpm dev

构建

./gradlew build

构建产物位于 build/libs 目录。

技术栈

• 后端：Java 21、Spring WebFlux、Halo Plugin API
• 前端：Vue 3、TypeScript、Halo Console Components
• 图片处理：Java ImageIO、WebP ImageIO、AVIF ImageIO

许可证

GPL-3.0 © Tim0x0

作者

Tim