空间清理
空间清理用于查看 Nekro Agent 的磁盘占用，并清理运行过程中产生的缓存、日志或临时文件。它适合磁盘空间不足、日志过大、沙盒任务残留较多时使用。
清理前请确认范围
空间清理会删除文件。执行前请仔细查看页面提示和清理项目说明，不要把重要数据当作缓存清掉。
什么时候需要清理
| 现象 | 建议操作 |
|---|---|
| 服务器磁盘空间不足 | 先扫描占用，再按项目清理 |
| 日志文件过大 | 清理旧日志或调低日志等级 |
| 临时文件长期累积 | 清理缓存和临时目录 |
| 沙盒任务异常中断 | 检查是否有残留工作目录 |
| 上传/知识库处理失败 | 确认磁盘是否有足够空间 |
基本流程
- 进入 WebUI 的空间清理页面
- 执行磁盘扫描，查看各类文件占用
- 展开具体项目，确认清理范围
- 只选择确定不再需要的项目
- 执行清理后重新扫描确认结果
如果不确定某项是否可以删除，建议先保留，或只清理明确标记为缓存、临时文件、旧日志的内容。
常见可清理内容
| 类型 | 说明 |
|---|---|
| 旧日志 | 历史运行日志，通常用于排查问题 |
| 临时文件 | 上传、转换、处理任务中产生的临时内容 |
| 缓存文件 | 可重新生成的中间数据 |
| 沙盒残留 | 异常退出后未自动清理的工作目录或任务文件 |
页面实际可清理项会根据部署方式和版本不同而变化，请以 WebUI 显示为准。
不建议随意清理的内容
以下内容通常不应通过空间清理页面随意删除：
- 数据库文件
- 用户上传且仍在使用的资源
- 知识库原始文档
- 工作区项目文件
- 插件数据和配置
.env、密钥、证书等部署配置
如果磁盘压力很大，也建议先备份再处理这些长期数据。
清理日志前的注意事项
日志是排查问题的重要依据。清理前建议确认：
- 最近是否还有未解决的问题
- 是否需要先下载日志用于反馈
- 是否开启了过高的日志等级
如果日志增长过快，可以在「系统配置」中检查 APP_LOG_LEVEL，排查结束后不要长期保持 DEBUG。
和系统命令清理的区别
空间清理页面只面向 Nekro Agent 运行相关内容，适合日常维护。它不会替代系统级维护，例如：
- Docker 镜像和容器清理
- 系统日志清理
- 数据库备份和压缩
- 服务器磁盘扩容
如果使用 Docker 部署，镜像、容器、卷的占用仍需要在宿主机上单独检查。