Memory Health Score

Provides a comprehensive score (0-100) evaluating the Agent's memory system health across completeness, freshness, structure, density, and consistency.

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 时，自动触发：

1. 记忆压缩 — 合并重复内容
2. 索引重建 — 同步 INDEX.md
3. 任务清理 — 关闭过期 issue

集成到 AgentAwaken

在 Dashboard 显示：

• 大号分数 (85/100)
• 彩色进度条
• 各维度雷达图
• 一键修复按钮