目录定时清理
2025/11/19大约 3 分钟修仙秘籍
🧹 目录定时清理
定时扫描和清理指定目录中的无用文件，支持黑白名单、文件体积过滤、BT 广告清理、递归子目录等功能，适用于媒体库日常维护。
⚙️ 功能特点
- 支持黑名单后缀和文件名模式匹配清理
- 支持白名单保护重要文件
- 支持按文件体积清理小于指定大小的媒体文件
- 支持递归清理子目录，可配置递归深度
- 支持保留刮削文件（nfo、poster 等）和字幕文件
- 支持清除孤立的刮削/字幕文件（无对应媒体文件）
- 支持一键清理 BT 广告文件
- 支持云存储节流防风控
- 支持多实例，可为不同目录创建独立配置
🚀 配置指南
| 参数 | 必填 | 说明 |
|---|---|---|
| 消息推送 | 否 | 开启后推送清理情况和文件列表 |
| 定时扫描 | 否 | Cron 表达式，例如 0 2 * * *（每天凌晨2点） |
| 清理目录 | 是 | 指定要清理的目录路径 |
| 跳过首次 | 否 | 首次运行时不执行清理，仅记录文件 |
| 清理空文件夹 | 否 | 清理目录下的空文件夹（含嵌套） |
| 递归清理子目录 | 否 | 启用后递归清理所有子目录 |
| 递归深度(层) | 否 | 最大递归深度，默认 3 层，0 表示无限制 |
| 保留刮削文件和字幕 | 否 | 保护 fanart、poster、nfo、srt、ass 等文件 |
| 清除孤立刮削和字幕文件 | 否 | 删除无对应媒体文件的元数据/字幕（慎重） |
| 最小文件体积(MB) | 否 | 清理小于此体积的媒体文件，不填则不清理 |
| 黑名单后缀 | 否 | 这些后缀的文件会被清理，逗号分隔，如 txt,jpg,log |
| 黑名单文件模式 | 否 | 通配符匹配，每行一个，如 *.ad.*、*广告* |
| 白名单后缀 | 否 | 这些后缀的文件不会被清理，优先级高于黑名单 |
| 白名单文件模式 | 否 | 通配符匹配，每行一个，优先级高于黑名单 |
| 清理BT广告文件 | 否 | 自动清理常见 BT 广告特征文件 |
| 云存储节流 | 否 | 对云存储路径启用节流，防止触发风控 |
| 删除延迟(ms) | 否 | 删除文件间的延迟，默认 500ms |
| 扫描延迟(ms) | 否 | 扫描文件间的延迟，默认 100ms |
| 每秒最多删除个数 | 否 | 限制每秒删除数量，0 表示不限制 |
🔧 工具栏操作
- 运行一次：立即执行一次清理
📖 使用说明
- 选择需要清理的目录；
- 根据需求配置黑白名单规则；
- 首次使用建议开启「跳过首次」，先观察哪些文件会被匹配；
- 确认规则无误后关闭「跳过首次」并设置定时任务。
文件处理优先级（从高到低）
- 白名单规则（后缀 + 文件模式）
- 黑名单规则（后缀 + 文件模式）
- 刮削/字幕文件保护
- 文件体积检查
云存储节流建议
| 存储类型 | 删除延迟 | 每秒最多删除 |
|---|---|---|
| 本地/SMB/NFS | 无需启用 | - |
| 115 网盘 | ≥500ms | ≤5 个 |
| 阿里网盘 | ≥300ms | - |
⚠️ 注意事项
- 「清除孤立刮削和字幕文件」可能存在误删风险，请慎重开启；
- 递归深度设为 0（无限制）时可能导致清理时间过长；
- 首次清理前请仔细检查配置，避免误删重要文件；
- 支持的媒体文件格式：mp4、mkv、ts、iso、rmvb、avi、mov、mpeg、mpg、wmv、3gp、asf、m4v、flv、m2ts、strm、tp、f4v；
- 支持的字幕文件格式：srt、ass、ssa、vtt、sub、sbv、lrc、sup、pgs、psb。