# 存储管理

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：数据与同步。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/storage_management/

## 它是什么

存储管理用来查看应用各模块的占用空间,并在空间不足时安全清理冗余文件。入口在 **设置 → 数据与同步 → 存储管理**。

## 可查看的占用

占比会按 会话与消息、对话附件、AI 生图、知识库、技能、脚本产物、缓存、数据库、应用本体 等模块分别展示(其中「缓存」已合并临时缓存与模型/服务商图标缓存;「数据库」以单行展示,不再细分主库 / WAL / SHM)。

## 可清理项

- **冗余附件文件(孤儿附件)**:已无任何会话或记录引用的附件文件。
- **临时缓存**:导入导出预览等临时文件,以及模型/服务商图标缓存(清理后按需重新下载)。
- **脚本工作区**:已删除会话留下的脚本产物。
- **未使用字体**:已下载但当前未启用的字体文件。

## 是否安全

可用页面底部的 **清理** 处理选中的冗余项，提交前请核对清单。扫描会检查聊天附件、生成媒体、消息内容和未发送草稿中的文件引用，读取失败时停止扫描，避免用不完整的引用列表判断文件无用。

大量聊天记录会分批读取，以减少界面长时间无响应；扫描失败后应按提示重试，不要把未完成的扫描当成可以清空附件目录的依据。

## 什么时候用

感觉空间占用异常、或收到空间不足提示时,可以来这里查看各模块占用并清理冗余。如果「会话与消息」一行出现「数据库预写日志冗余」的警示,说明预写日志未正常回收(通常体积比主库还大),与真实数据量无关——继续正常使用或重启应用后一般会自行收敛,无需手动删除这些文件。