智能媒体管理插件

• 版本：2.0
• 作者：惊鸿博客  
• 官网：https://penx.cn

✨ 核心功能

1. 智能扫描未使用文件

• 全量扫描：扫描整个媒体库，识别所有未使用的媒体文件
• 多维度检测：通过多种方式检测文件引用关系，确保准确性
• 实时统计：显示总文件数、未使用文件数、可释放空间等统计信息
• 分类显示：区分未使用文件、有引用文件、文件丢失（幽灵文件）等状态

2. 全面的引用检测系统

• 检测 `wp-image-{ID}`、`wp-video-{ID}`、`wp-audio-{ID}`、`wp-att-{ID}` 等标签
• 支持图片、视频、音频等多种媒体类型

• 检测完整 URL、相对路径、文件名等多种 URL 格式
• 支持原图和缩略图的关联检测

• 检测 `attachment_id=` 参数形式的引用
• 适用于下载按钮等场景

• 检测 `href` 和 `download` 属性中的文件引用
• 支持单引号和双引号格式

• 检测存储在 `postmeta` 中的文件引用
• 支持 ACF 字段、付费下载插件等场景

• 检测用户头像、封面图片等存储在 `usermeta` 中的引用
• 支持多种头像插件（Simple Local Avatars 等）
• 检测序列化数据中的引用
• 智能排除系统字段，避免误报

3. 特色图片检测

• 自动检测文章特色图片（缩略图）
• 支持删除文章时一并删除特色图片（可配置）
• 智能判断特色图片是否被其他文章使用

4. 自动清理功能

• 删除文章时自动清理：删除文章时，自动检测并清理文章内容中的未使用图片
• 孤立附件清理：自动清理 `post_parent` 指向已删除文章的附件
• 安全保护：如果图片被其他文章引用，仅解除关联，不删除文件

5. 媒体库删除保护

• 在后台媒体库删除图片时，自动检测是否被引用
• 如果图片仍被文章引用，阻止删除并提示用户
• 防止误删正在使用的文件

6. 批量管理功能

• 批量扫描：一键扫描整个媒体库
• 批量删除：支持选择多个文件批量删除
• 全选功能：快速选择所有未使用文件
• 实时预览：显示文件缩略图、大小、上传日期等信息

7. 高级筛选功能

• 扫描模式：可选择扫描未使用文件或显示有引用的文件
• 文件类型筛选：按文件扩展名筛选（未来功能）
• 文件大小筛选：按文件大小范围筛选（未来功能）
• 日期范围筛选：按上传日期筛选（未来功能）

8. 排除关键字保护

• 设置排除关键字列表（逗号分隔）
• 包含关键字的文件永远不会被扫描或删除
• 适用于保护 Logo、Banner 等重要文件

 9. 文章类型配置

• 可选择需要检测引用的文章类型
• 支持所有公开的文章类型（post、page、自定义类型等）
• 未选中的类型中的图片引用将被忽略

10. 日志系统

• 操作日志：记录所有扫描、删除操作
• 调试日志：详细的引用检测过程日志
• 日志查看：在后台实时查看日志内容
• 日志管理：支持复制日志、清空日志
• 可配置：可选择启用或关闭日志功能

11. 用户友好的界面

• 现代化设计：采用 Bootstrap 5 风格的现代化界面
• 响应式布局：完美适配桌面和移动设备
• Tab 导航：设置、扫描、日志分标签页管理
• 实时反馈：操作状态实时显示
• –   **确认对话框**：删除操作前显示确认对话框，防止误操作