站点瘦身（SiteFitness）

按分类、批量、定时清理站点无用数据，减少数据库与磁盘体积。清理前默认自动备份，降低误删风险。

• 作者：kuakeba.cn
• 版本：1.0.0

功能

• 附件与图片：无引用附件记录、磁盘孤儿文件（同步删除对应本地文件）
• 数据库冗余：无主回复、标签关联、点赞收藏、付费解锁、举报、帖子附件关联，过期软删除帖子/回复
• 日志与缓存：过期后台日志、邮件日志、邮箱验证码、访问明细，过期清理备份
• 附加动作：OPTIMIZE TABLE 整理数据表、清空运行时缓存与临时文件
• 支持后台勾选批量执行，也可通过 Web URL 或 CLI 定时执行
• 清理前备份：数据行写入 runtime/sitefitness/backup/{runId}/rows.jsonl，物理文件移动到同批次 files/ 目录

安装

1. 将 SiteFitness 目录放入站点 plugins/ 下
2. 后台「应用中心 → 插件」找到「站点瘦身」并安装
3. 安装后左侧菜单出现「站点瘦身」，可直接进入管理页

使用

管理页 /admin/sitefitness：

1. 勾选清理项（默认勾选低/中风险项，高风险项需手动勾选）
2. 点击「扫描选中」查看数量与体积
3. 点击「开始清理」，前端按 batch_size 分批调用，页面会显示进度，可随时停止
4. 清理完成后写入执行日志，并可在「清理备份」中查看或删除备份

到「应用中心 → 插件 → 站点瘦身 → 配置」可调整：

• 是否启用、是否清理前备份、是否备份物理文件
• 备份保留天数、孤儿文件安全天数、软删除保留天数、日志保留天数、每批数量
• 定时任务开关、定时密钥、定时清理项

定时任务

CLI（推荐）：

php plugins/SiteFitness/bin/run.php

Web URL：

https://你的站点/sitefitness/cron?key=定时密钥

定时任务使用 runtime/lock/sitefitness.lock 文件锁，同一时间只会执行一个清理任务；仅清理配置中勾选的定时清理项。

安全说明

• 操作前请备份数据库与 public/storage 目录
• 孤儿文件仅清理超过「孤儿文件安全天数」且未被任何内容引用的文件
• 软删除内容仅在超过「软删除保留天数」后才允许彻底删除
• 附件引用判断复用系统 AttachmentReferenceService，避免误删仍在使用的图片/附件
• 高风险项默认不勾选，执行前会二次确认

数据表

• sitefitness_log：执行日志
• sitefitness_backup：清理备份记录

目录结构

SiteFitness/
├── plugin.json
├── install.sql
├── routes.php
├── SiteFitnessPlugin.php
├── bin/run.php
├── controller/
│   ├── Cron.php
│   └── admin/
│       ├── Base.php
│       ├── Manage.php
│       └── Api.php
├── service/
│   ├── CleanService.php
│   ├── BackupService.php
│   ├── TaskService.php
│   └── StatsService.php
└── view/admin/index.html