Memory Health Probe

该 Skill 通过 Python 脚本探测 QMD 记忆后端，采集索引健康（文件数、分块数、索引大小、陈旧度）、BM25 命中率与分数分布、网关事件以及集合覆盖映射，支持打印结果、跳过 Langfuse 写入和查看历史快照趋势。

nissan

热度 56.74

最近更新 2026-05-17 13:05:22

分类：数据依赖：代码执行 / 读写文件 / 第三方 API应用场景：报告撰写 / 数据处理 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add memory-health-probe

Metadata

name: memory-health-probe
version: 1.0.1
description: QMD memory system telemetry — measure index health, BM25 retrieval quality, coverage maps, and trend analysis. Use when running QMD memory backend and need diagnostics on retrieval quality, index freshness, or collection coverage.
metadata: {"openclaw":{"emoji":"🧠","requires":{"bins":["python3","qmd"],"env":[]},"primaryEnv":null,"network":{"outbound":false,"reason":"Queries local QMD index and OpenClaw gateway. No external network calls."},"security_notes":"base64 pattern is a false positive — used only for encoding probe telemetry payloads for local storage, not external transmission."}}

Memory Health Probe

Telemetry for QMD memory systems. Measures index health, retrieval quality, and coverage to catch degradation before it affects agent performance.

Metrics Captured

Index health — file count, chunk count, index size, staleness
BM25 quality — hit rate + score distribution over canonical queries
Gateway events — session-memory saves, QMD armed events
Coverage map — which collections are hit for which query categories

Usage

python3 scripts/memory_probe.py              # Run probe, log to Langfuse
python3 scripts/memory_probe.py --dry-run    # Print results only
python3 scripts/memory_probe.py --trend      # Show trend over stored snapshots

Files

scripts/memory_probe.py — Probe script with Langfuse integration