缓存任务
Tasks · Cache
让目录秒开：全局缓存 + 定时预热
后台 → 任务管理 → 缓存任务。先开「元数据缓存」，再给高频目录加缓存保持任务。这里预热的是目录列表信息，不是把文件下载到本地。
快速步骤
全局
先打开元数据缓存
- 点页头「缓存设置」齿轮，确认 启用元数据缓存 为开
- 把 全局缓存时间 设成保守值（例如 30–60 分钟）：账号未单独设 TTL 时用它
- 按机器内存设好 缓存条目上限 与 缓存内存上限，避免无限涨
预热
给常用目录加缓存任务
- 点「添加任务」→ 选账号与目录
- 扫描层级：入口目录常用「单层」；需要子目录也快，再选 2–5 层（没有「无限递归」）
- 刷新间隔先 60 分钟；易风控就加大 API 补偿、改夜间时间段
注意
任务上限与互斥
- 最多 6 条缓存任务，优先覆盖最高频入口，不要堆满
- 同账号若 STRM / 目录整理正在跑，缓存任务会排队，占用结束后再跑
- 服务刚启动有约 45 秒 退避；新建任务可能提示「启动退避结束后自动执行」
我该怎么选
| 全局缓存时间 | 你会得到什么 | 代价 | 推荐 |
|---|---|---|---|
| 15–30 分钟 | 更「新」，变动更快看到 | 更常回源 | 目录常变、对新鲜度敏感 |
| 30–60 分钟 | 速度与新鲜度平衡 | 一般 | 家庭日常（推荐） |
| 120–240 分钟 | 更稳、更省请求 | 变动可能滞后 | 大库 / 慢驱动 / 易风控 |
任务里还有哪些常用项
API 额外补偿间隔两次网盘列目录之间多等几毫秒。遇 429 / 风控时加大（例如 200–800ms）。新建默认约 200ms。
刷新间隔任务自己的定时周期（分钟）。新建默认 60。不建议设过短，否则等于持续打盘。
执行时间段全天，或只在设定时段内自动跑（可跨午夜）。适合白天少刷、夜里预热。
选择子目录请选具体子目录，不要选网盘根。大库用多个入口任务 + 合适扫描层级即可。
缓存设置
右上角 / 页头齿轮打开「缓存设置」抽屉。点左侧设置项，右侧看说明。FUSE 读缓存不在这里，而在 文件共享 → 本地挂载。
启用元数据缓存
总开关。关闭后所有目录列表都直连网盘，不走缓存；缓存保持任务也失去意义。
日常应保持开启。
日常应保持开启。
常见问题
缓存保持是不是把文件下载到本地？
不是。它只刷新并维护目录 / 文件元信息缓存，让浏览、列目录更快。真正的文件内容仍从网盘按需拉取。
为什么改了「全局缓存时间」感觉没变化？
优先级是：全局关闭缓存 > 账号配置里的 cache_ttl > 这里的全局默认。账号填 0 表示该账号完全禁用目录缓存，缓存任务也会提示无法生效。只有账号没单独设 TTL 时，全局时间才兜底。
点「清空缓存」会怎样？
清掉当前元数据缓存条目，下一次访问会更多回源，短时间变慢是正常的。一般只在配置大改、缓存异常时用。
为什么立即执行提示「太快了 / 冷却中」？
系统会结合账号 TTL 做冷却，避免刚刷完又强制打盘。等提示的时间后再试，或适当缩短 TTL / 拉长刷新间隔来匹配你的预期。
命中率越高越好吗？
不一定。命中率高说明重复访问快，也可能缓存偏旧。以「打开是否更快、列表是否够新」为准；不够新就降低 TTL，或给重点目录加缓存任务。
WebDAV 专用缓存和通用缓存有何不同？
通用缓存管后台浏览 / 列目录的元数据；「WebDAV 路径与 PROPFIND 缓存」专门加速 WebDAV 客户端列目录。关掉通用缓存后，浏览都会直连网盘。
为什么点了「立即执行」却提示太快 / 无法生效？
- 任务须先启用。
- 若刚跑完，可能提示冷却中，稍后再试。
- 账号若关闭了目录缓存（TTL=0），任务无法生效，需先在账号或全局设置里打开缓存。
删除任务会清掉已缓存的目录吗？
不会。删除只停止后续预热；已经进缓存的元数据仍在，可用页头「清理」清空。