← ClaudeAtlas

memory-managerlisted

Agent记忆健康管理(Memory Manager)。用户说'记忆太乱''整理记忆''检查记忆''记忆清理'时使用。扫描 Hermes 记忆文件(MEMORY.md/USER.md),统计 token 占用、找过期/冗余/超长条目、体检会话库(state.db 体积与索引占比)、并从会话历史挖掘用户纠正与长期要求(提示哪些还没进记忆)。Memory health check for AI agents: token cost per turn, stale/redundant entries, session-DB size diagnosis, and correction mining from chat history.
jiawood2006/hermes-skills · ★ 0 · AI & Automation · score 78
Install: claude install-skill jiawood2006/hermes-skills
# Memory Manager 记忆健康管理 Agent 的记忆会**注入每个会话的 system prompt**——太大 = 每轮浪费 token、挤占上下文、还可能存过期信息误导判断。本技能定期检查记忆健康,保持记忆精简有效。 > 📁 **安装**:`hermes skills install jiawood2006/hermes-skills/skills/memory-manager` 或按 README 方式二复制 → 默认在 `~/.hermes/skills/utilities/memory-manager/`。 ## 触发条件 - "检查记忆""记忆清理""整理记忆" - 发现 Agent 回答变慢 / 上下文被挤占 - 定期记忆健康检查(建议每月一次) ## 使用步骤 ### 1. 记忆健康检查 ```bash python3 ~/.hermes/skills/utilities/memory-manager/scripts/memcheck.py python3 ~/.hermes/skills/utilities/memory-manager/scripts/memcheck.py --full # 完整报告(逐条分析) ``` 输出: - 每条记忆文件的 token 占用/条目数 - 超长条目(>800 字,建议精简) - 含 30 天前日期的条目(可能是过期信息) - state.db 体积(>500MB 建议清理,见第 2 节) - 每轮记忆注入总 tokens(建议 <2000) ### 2. 会话库体检(`--state-db`) 不只是报体积——会**拆到表级**告诉你是"正文大"还是"索引大",给出对症方案: ```bash python3 ~/.hermes/skills/utilities/memory-manager/scripts/memcheck.py --state-db ``` 实测样例(1.2GB 的库): ``` 🗄️ state.db(会话历史): 1.2GB 页: 316858×4096B | 空闲页: 2770 | 可直接回收: 约 10.8MB 体积占比 Top 表: 478.1MB messages_fts_trigram_data 331.8MB messages 162.7MB messages_fts_trigram_content 162.7MB messages_fts_content ⚠️ 其中 FTS 全文索引占 872.6MB(71%)——索引比正文还大,先处理索引,别急着删会话 ``` - **索引占大头**(常见)→ 先 `rebuild` 索引 / 去掉 trigram,再 VACUUM,**不用删历史** - **正文占大头** → 才清理旧会话 - 无 `dbstat` 支持时自动降级(只报体积与行数),不会报错 ### 3. 从纠正中学习(`--corrections`) **重复两次的纠正 = 该进记忆的长期偏好。** 扫描会话历史,把用户的纠正/长期要求挖出来,并标记哪些疑似还没进记忆: ```bash python3 ~/.hermes/skills/utilities/memory-manager/scripts/memcheck.py --corrections python3 ~/.hermes/skills/util