缓存清理与存储空间不足 — 视频缓存、下载文件、临时数据怎么清理

BiliPai 会占用哪些空间

BiliPai 在手机上产生的存储占用分几类：

查看存储占用

BiliPai 内部查看

路径：设置 → 存储与数据

这个页面会显示：

• 总占用空间
• 各类数据的大致占用（视频缓存多少、笔记多少、临时文件多少）
• 各类数据的清理入口

Android 系统查看

系统设置 → 应用 → BiliPai → 存储 → 可以看到更精确的数字。

清理视频缓存

方式一：BiliPai 内部逐个删

设置 → 存储与数据 → 视频缓存 → 进入缓存列表 → 左滑不需要的视频 → 删除。

方式二：一次性清理

设置 → 存储与数据 → 视频缓存 → 右上角菜单 → 全部清理。

⚠️ 全清后所有缓存视频都没了——请确认手机网络状况（Wi-Fi 下可以重新缓存，移动网络下可能不够流量）。

缓存文件在哪里

BiliPai 的视频缓存默认存在应用私有目录：/data/data/com.android.purebilibili/files/download/

其他 App 无法访问这个目录。想手动清理只能在 BiliPai 内部操作。如果把存储位置改成 SD 卡，文件在 SD 卡的 Android/data/ 目录下。

清除弹幕缓存

弹幕缓存存储了各个视频的弹幕数据，重复打开同一视频时直接读缓存不用重新下载弹幕。

路径：设置 → 存储与数据 → 清除弹幕缓存

清除后不影响观看，只是下次打开视频需要重新拉弹幕。

清除播放历史

路径：设置 → 存储与数据 → 清除历史记录

⚠️ 清除后本地的播放历史记录没了。B 站服务器上的历史记录（可以在官方 App "历史" 里看到的那种）和这个是两回事——B 站服务器的历史是云端同步的，BiliPai 的"清除历史"只清本地 Room 数据库里的记录。

不想清但想精简

播放历史里的视频自动有"还看"标记——如果你只是不想让某些视频出现在历史里，但不想清全部，可以在 B 站官方 App 或网页版手动删除云端历史记录。下次 BiliPai 拉历史列表时就不会有了。

存储空间不足怎么办

如果系统提示"存储空间不足"，按优先级清理：

优先级一：清理视频缓存（通常最大）

去设置 → 存储与数据 → 视频缓存 → 全部清理，或手动删几个大的缓存视频。

优先级二：清除缓存数据

设置 → 存储与数据 → 清除弹幕缓存 + 清除临时文件。

优先级三：系统级清除

系统设置 → 应用 → BiliPai → 存储 → 清除缓存。这会清掉 Android 系统为 BiliPai 保留的所有缓存（包括网络请求缓存、图片缓存等），不会清除你的笔记和播放历史。

优先级四：卸载重装

最后手段。卸载 BiliPai 会清除：

• 所有视频缓存
• 播放历史（本地）
• 视频笔记（本地）
• 插件配置
• 设置（外观、倍速列表等）
• 登录 Cookie

卸载不会清除：

• 你的 B 站服务器数据（收藏夹、追番、评论等，云端存在）
• WebDAV 备份文件（如果已经上传到云端）

建议卸载前先做 WebDAV 备份（如果你之前配置过的话），或手动导出视频笔记。

缓存和清理的小贴士

• 离线缓存 vs 在线播放：缓存下来的视频会占用空间，在线播放不占。通勤场景（地铁）建议提前缓存；Wi-Fi 下直接在线看省空间
• Android 存储自动清理：Android 12+ 有存储空间自动清理功能，在系统设置里可以设置"缓存超过多少自动清理"
• 定期看一下：每月或每季度检查一次 BiliPai 的存储占用，视频缓存累积速度比你想的快
• 笔记要特别小心：笔记存在本地 Room 数据库里，卸载 App 会丢。重要笔记记得导出到 Markdown 文件存起来

存储空间相关常见问题

删了缓存视频但空间没释放

可能是 Android 的 MediaStore 还在索引旧文件：

• 重启手机（会刷新 MediaStore）
• 或在 BiliPai 里删完后等几分钟再看
• 或去 Android 文件管理器里手动确认文件是否真的删除了

下载到 SD 卡的缓存删不掉

• 确认 SD 卡没有只读保护
• 取出 SD 卡再插回去
• 在 BiliPai 里把存储位置切回内部存储（SD 卡可能需要重新授权）

笔记占了几十 MB

不可能——普通文本笔记非常小。你看到的"笔记"占用大可能是视频笔记里包含了图片或 AI 总结产生的额外数据。可以在设置 → 存储与数据 → 视频笔记 → 查看详细占用。

排查与 FAQ 到这里 3 页完结——这是 BiliPai 站点的最后一个分组。

所有 12 个分组 40 页内容已经写完，现在进行渲染自检。