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) - 彩色进度条 - 各维度雷达图 - 一键修复按钮

memory-health-score

Installation

Memory Health Score — 记忆健康度评分

概述

评分维度 (总分 100)

1. 完整性 (30分)

2. 新鲜度 (25分)

3. 结构化 (20分)

4. 密度 (15分)

5. 一致性 (10分)

健康等级

使用方法

输出格式

自动修复建议

集成到 AgentAwaken