后台-缓存管理

Cache

命中率与「缓存保持」的平衡

缓存管理用于控制 LitePan 的全局缓存行为，并为重点目录建立定时刷新的缓存保持任务。合理配置后，前台浏览、WebDAV 挂载、STRM 扫描都会更顺畅。

功能概述

全局缓存设置开关、默认 TTL、持久化与快照间隔。

统计查看缓存条目、缓存大小与命中率。

缓存保持任务为常用目录建立定时刷新任务。

手动维护刷新统计、清空缓存、立即执行任务。

页面结构

缓存管理页分成两个视图：全局缓存设置 与 缓存保持任务。

全局缓存设置

1. 统计卡片

页面顶部会显示：

• 缓存条目
• 缓存大小
• 命中率

并提供两个快捷操作：

• 刷新统计
• 清空缓存

2. 全局缓存配置

可配置的核心项包括：

• 启用缓存
• 默认缓存过期时间（分钟）
• 启用缓存持久化
• 缓存持久化快照间隔（分钟）

3. TTL 优先级

缓存 TTL 的优先级是：

• 账号 TTL = 0：完全禁用该账号缓存
• 账号 TTL > 0：使用该账号自己的 TTL
• 账号 TTL 留空：使用这里设置的全局默认 TTL

提示

缓存持久化只负责把未过期缓存保存到磁盘，避免程序重启后完全从零开始；它不会让缓存“永久有效”。

缓存保持任务

缓存保持任务适合给经常访问、媒体端经常扫描、或你特别希望保持较新状态的目录使用。

1. 顶部统计

会显示：

• 配置目录
• 运行中
• 已暂停

2. 任务列表

每条任务会显示：

• 目录路径
• 当前状态
• 最后刷新情况
• 操作按钮

支持的操作包括：

• 启用 / 禁用
• 立即执行
• 修改
• 删除

页面右上角还提供 全部执行。

3. 新建或修改任务时可配置

• 选择账号
• 选择目录
• 递归模式：单层缓存 / 无限递归
• API 额外补偿间隔（毫秒）
• 刷新间隔（分钟）

4. 数量限制

缓存保持任务最多可创建 6 条。
如果你需要覆盖更多目录，建议优先选择上级目录并搭配 无限递归。

什么时候适合用缓存保持

常用浏览目录前台经常打开的目录适合加入缓存保持，减少每次重新拉取的等待时间。

媒体库目录STRM 源目录、WebDAV 常挂载目录或媒体库根目录都适合建立缓存保持任务。

易风控驱动如果某驱动更容易触发风控，可以通过增加 API 补偿间隔让刷新更温和。

使用建议

家庭日常使用保持全局缓存开启，默认 TTL 建议设为 30-120 分钟，只给高频目录配置少量缓存保持任务。

媒体访问使用给影视目录配置缓存保持任务；目录层级很多时，再考虑开启无限递归。

注意

缓存保持并不是把目录内容完整下载到本地，而是维持目录与文件元信息缓存。
它的主要作用是让目录访问更快、刷新更平滑，而不是做离线镜像。