Memory Health Score — 记忆健康度评分
概述
一个总分让用户快速判断 Agent 记忆系统健康状况。
评分维度 (总分 100)
1. 完整性 (30分)
- MEMORY.md 存在且有内容 (10分)
- memory/INDEX.md 存在 (5分)
- 近 7 天有日志文件 (10分)
- P0 标记使用率 (5分) — 至少 3 个 P0 项
2. 新鲜度 (25分)
- 今日日志已创建 (10分)
- MEMORY.md 最近 7 天内更新 (10分)
- INDEX.md 最近 3 天内更新 (5分)
3. 结构化 (20分)
- 任务系统 (.issues/) 存在 (10分)
- 至少 3 个 open issue (5分)
- 心跳配置正确 (5分)
4. 密度 (15分)
- MEMORY.md 行数 50-500 (10分) — 太少=信息不足，太多=需压缩
- 日志文件平均长度 20-200 行 (5分)
5. 一致性 (10分)
- INDEX.md 与 MEMORY.md 项目一致 (5分)
- issue 文件与 INDEX.md 一致 (5分)
健康等级
| 分数 | 等级 | 状态 | 建议 |
|---|---|---|---|
| 90-100 | 🟢 优秀 | 记忆系统运转良好 | 保持当前节奏 |
| 70-89 | 🟡 良好 | 基本健康，有改进空间 | 检查低分项 |
| 50-69 | 🟠 警告 | 存在明显问题 | 立即优化 |
| 0-49 | 🔴 危险 | 记忆系统失效 | 紧急修复 |
使用方法
# 运行评分
openclaw cron add --name "memory-health-check" \
--cron "0 9 * * *" --tz "Asia/Shanghai" \
--session isolated --agent main \
--message "运行记忆健康度评分，生成报告并更新 memory/health-score.json"输出格式
{
"timestamp": "2026-03-01T09:00:00Z",
"totalScore": 85,
"grade": "良好",
"dimensions": {
"completeness": { "score": 28, "max": 30, "issues": ["缺少 P0 标记"] },
"freshness": { "score": 25, "max": 25, "issues": [] },
"structure": { "score": 15, "max": 20, "issues": ["open issue 不足"] },
"density": { "score": 12, "max": 15, "issues": ["MEMORY.md 过长"] },
"consistency": { "score": 5, "max": 10, "issues": ["INDEX 与 MEMORY 不一致"] }
},
"recommendations": [
"添加更多 P0 标记到 MEMORY.md",
"创建至少 3 个 open issue",
"压缩 MEMORY.md，移除过时信息"
]
}自动修复建议
评分 <70 时，自动触发：
- 记忆压缩 — 合并重复内容
- 索引重建 — 同步 INDEX.md
- 任务清理 — 关闭过期 issue
集成到 AgentAwaken
在 Dashboard 显示：
- 大号分数 (85/100)
- 彩色进度条
- 各维度雷达图
- 一键修复按钮