磁盘使用率持续升高、目录占用异常膨胀或首次启动耗时延长，很可能是缓存文件、记忆快照、向量索引及日志数据未受控增长所致；需清理临时缓存、过期会话、冗余数据库记录并优化向量索引与日志策略。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在运行 Hermes Agent 时发现磁盘使用率持续升高、/home 或 ~/.hermes 目录占用空间异常膨胀，或首次启动耗时显著延长，则很可能是由于缓存文件、记忆快照、向量索引及日志数据未受控增长所致。以下是针对性的多种清理与优化路径：
一、清理临时缓存与过期会话文件
Hermes Agent 在运行过程中会生成大量临时缓存（如 tool_output_cache、image_cache、session_state_cache）及会话消息快照，若未设置 TTL 或定期清理，单个会话可能产生数百 MB 的碎片化文件，长期累积可轻易突破 10GB。
1、进入缓存根目录：cd ~/.hermes/cache/
2、删除所有创建时间早于 7 天的缓存子目录：find . -type d -mtime +7 -exec rm -rf {} +
3、清空 session 状态数据库中已关闭会话的冗余记录：sqlite3 ~/.hermes/state.db "DELETE FROM messages WHERE session_id IN (SELECT id FROM sessions WHERE status = 'closed' AND updated_at
4、执行缓存管理器强制清理：python -c "from tools.cache_manager import cache_manager; cache_manager.cleanup_expired()"
二、压缩并迁移记忆文件存储
Hermes Agent 默认将每条记忆以独立 .md 文件形式存于 ~/.hermes/memory/，该目录在高频使用下易积累数千个文件，引发 inode 耗尽与文件系统遍历延迟。启用 SQLite 后端可将全部记忆结构化归档至单个数据库文件，体积压缩率达 65% 以上，且支持索引加速检索。
1、初始化 SQLite 记忆后端：hermes memory init-sqlite
2、执行历史记忆迁移：hermes memory migrate-to-sqlite --batch-size 500
3、验证迁移完整性：hermes memory list --limit 5（应返回非空结果且无 .md 文件加载日志）
4、禁用旧式文件记忆加载：编辑 ~/.hermes/config.yaml，在 memory: 区块下添加 backend: sqlite 并移除 path: 字段
三、精简向量库持久化数据
当 Hermes Agent 启用本地 Qdrant 实例且未配置磁盘后端时，全部向量索引与 payload 将以全精度常驻内存并同步写入 /var/lib/qdrant/storage/collections/ 目录，单个 collection 可达 3–5GB。启用标量量化与 on-disk payload 可使磁盘占用下降约 78%，同时避免内存映射文件拖慢 I/O。
1、检查当前 collection 存储模式：curl http://localhost:6333/collections/hermes_memory
2、若 response 中 config.hnsw.on_disk 为 false，需重建 collection：curl -X POST http://localhost:6333/collections/hermes_memory?wait=true -H 'Content-Type: application/json' -d '{"vectors": {"size": 1024, "distance": "Cosine"}, "on_disk_payload": true, "quantization_config": {"scalar": {"type": "int8", "always_ram": false}}}'
3、触发已有数据量化迁移：curl -X POST http://localhost:6333/collections/hermes_memory/points/quantize?wait=true -H 'Content-Type: application/json' -d '{"quantization": {"scalar": {"type": "int8"}}}'
4、清理原始未量化 segment：rm -rf /var/lib/qdrant/storage/collections/hermes_memory/segments/*/index/*_original
四、裁剪日志与模型缓存体积
默认日志策略保留无限滚动日志，而模型下载缓存（如 transformers 模型权重、LoRA 适配器）常被重复拉取却未清理，二者合计可占据 8GB 以上磁盘空间。通过配置轮转与缓存白名单机制，可将这部分开销稳定控制在 1.2GB 内。
1、配置日志轮转：创建 /etc/logrotate.d/hermes-agent，内容为：/var/log/hermes/*.log { daily rotate 7 compress missingok notifempty }
2、手动清理旧日志：sudo logrotate -f /etc/logrotate.d/hermes-agent && sudo find /var/log/hermes/ -name "*.log.*" -mtime +7 -delete
3、限制 Hugging Face 缓存目录大小：huggingface-cli scan-cache --max-size 2g --delete
4、禁用非核心模型自动缓存：在 ~/.hermes/config.yaml 中添加 model_cache_enabled: false，并在调用 model.load() 时显式传入 cache_dir="/tmp/hermes_model_cache"
