📦 memory-guardian-agnet — memory-guardian-agent — 记忆守护代理
v1.0.0通过10个MCP工具和批量维护来管理Agent工作区内存生命周期，包括MEMORY.md、memory/目录、meta.json、质量门、贝叶斯衰减、案例生命周期和压缩功能。
1· 34·0 当前·0 累计
by 安全扫描
OpenClaw
安全
high confidence该技能的代码、测试和运行时指令与其声明的用途（本地工作区内存生命周期管理）保持一致；它修改和写入工作区文件，但不请求无关凭证或远程安装。
评估建议
这个包的功能与其描述相符：维护Agent工作区的本地文件（meta.json、MEMORY.md、memory/文件、压缩、衰减、案例工作流）。在安装或启用前：(1) 审查并备份您关心的任何真实工作区——该工具会自动写入并可能自动升级meta.json；(2) 使用明确的--workspace或将MG_WORKSPACE/OPENCLAW_WORKSPACE设置为隔离的测试目录，以避免意外写入默认主工作区；(3) 如需审计数据流，请查看mg_events/telemetry.py和任何写入日志的代码，以确认没有远程网络接收端（该包似乎是本地的）；(4) 由于MCP服务器在运行时导入并执行捆绑脚本，请检查任何您不信任的第三方代码，如果来源不明，最好在沙盒环境中运行；(5) 注意小的文档不匹配：SKILL.md和代码期望MG_WORKSPACE/OPENCLAW_WORKSPACE，但技能元数据中未列出所需的环境变量——明确设置它们以避免意外。...详细分析 ▾
✓ 用途与能力
名称和描述（管理MEMORY.md、memory/、meta.json、质量门、衰减、压缩、案例生命周期）与包含的脚本、MCP服务器、CLI和参考文档相符。大型测试套件和模块对应于声称的功能（同步、摄取、衰减、压缩、质量门、L3确认）。
ℹ 指令范围
SKILL.md指导本地文件操作（meta.json、MEMORY.md、memory/目录、access_log.jsonl）和cron创建；它还指示代理在memory_get后追加到access_log.jsonl并运行维护（run_batch）。这些副作用操作对于内存维护工具来说是预期的，但比只读技能的范围更广——代理将写入/修改工作区文件，并可能在运行期间自动升级meta.json。
✓ 安装机制
没有声明外部安装程序，包直接包含Python脚本。MCP服务器动态导入并执行本地脚本文件（importlib），这是此打包工具包的预期做法。提供的元数据中没有从外部URL或包注册表下载。
ℹ 凭证需求
该技能没有声明必需的环境变量或凭证，也不请求云密钥。它确实依赖OPENCLAW_WORKSPACE和MG_WORKSPACE作为工作区选择器（DEFAULT_WORKSPACE回退到OPENCLAW_WORKSPACE，然后是MG_WORKSPACE，然后是~/workspace/agent/workspace）。这些环境变量对工作区配置来说是合理的，但未在元数据中列为必需——良性的，但属于小的文档不匹配。
✓ 持久化与权限
always:false（不强制包含）。该技能可以自主调用（disable-model-invocation:false），这是正常的。它执行持久的本地操作（自动创建工作区目录、写入meta.json/memory文件、追加access_log），这与其声明的目的相符，对于内存生命周期管理器来说不是意外的权限。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/15
memory-guardian-agent 1.0.0 初始版本：提供使用10个工具和批量维护工作流的工区内存生命周期管理；支持贝叶斯衰减、四状态质量门、案例生命周期和MEMORY.md压缩；包括内存膨胀、质量异常和案例审查/失效的诊断；提供计划任务（cron/batch）和按需内存维护；在MCP不可用时提供CLI备用方案。
● 无害
安装命令
点击复制官方npx clawhub@latest install memory-guardian-agent
镜像加速npx clawhub@latest install memory-guardian-agent --registry https://cn.longxiaskill.com
技能文档
工作区内存生命周期系统。双层贝叶斯衰减 + 四状态质量门 + 案例生命周期 + 压缩。
设计原则
- 写入前先检查状态 — 先执行
memory_status - 应用前先预览 — 预览破坏性操作
- 默认行为 > 开关 — 工作区默认值来自
MG_WORKSPACE - 写入顺序 > 内容正确性 — 顺序很重要
- 可观测但不高脆弱 — 信号降级 → WARNING，而非崩溃
- 单一真相来源 — 所有默认值在
mg_schema/meta_defaults.py
MCP 工具（10个）
工作区默认值来自 MG_WORKSPACE 环境变量；仅列出非默认参数。
查询
memory_status()— 系统概览（内存数量 / 门状态 / 案例摘要 / 引用完整性）memory_query(type="active", min_score=0.3)— 搜索记忆（关键词/memory_type 过滤）
写入
memory_ingest(content="...", importance="auto", tags=[])— 创建新记忆memory_decay(lambda=0.01, dry_run=false)— 执行五轨贝叶斯衰减
审计
quality_check(layer="all")— 质量门（retire_rate / similar_case_signal / stale_cases）case_query(filter="frozen")— 查询案例（active/frozen/retired/stale/ignored）case_review(case_id, action="retire", origin_type="agent_initiated")— 案例操作（active/frozen/retired/unfreeze/ignore）
批量
run_batch(skip_compact=true, dry_run=false, timeout=300)— 完整维护（包括同步 + 信号合并）memory_sync(dry_run=true)— 同步文件变更 → meta.json（在 run_batch 中自动运行）memory_compact(dry_run=true, aggressive=false)— 压缩 MEMORY.md
工作流
新安装
memory_status→ 确认references.complete: true- 如果为 false，根据缺失列表创建缺失文件，重新验证
- 创建 cron 任务（参见 signal-loop.md 的 cron 模板）
- 手动触发一次以验证
每日维护（cron）
run_batch(skip_compact=true) 自动运行。包括：
- memory_sync（增量文件扫描）
- 信号合并（access_log + cron 推断）
- 衰减 + 质量门检查
- 仅当 MEMORY.md > 15KB 时触发压缩
诊断
D1: 内存膨胀 → memory_compact(dry_run=true) → 如需要则应用 → 参见 compaction.md
D2: 质量异常 → quality_check(layer="all") → 参见 error_recovery.md
D3: 案例失效 → case_query(filter="stale") → case_review(action="retire"|"active"|"unfreeze") → 参见 case-management.md
信号循环（v0.4.6）
双层访问信号馈送衰减引擎：
- Layer 1（权重 1.0）：
access_log.jsonl— 代理在memory_get后追加 - Layer 2（权重 0.5）：cron 从每日笔记推断关键词
- 健康检查在 access_log 过期时自动降级到 Layer 2
代理必须在每次 memory_get 调用后追加到 access_log.jsonl。参见 signal-loop.md 的集成代码。
参考文档
根据场景按需加载：
- signal-loop.md — 信号循环设置、AGENTS.md 集成代码、cron 模板、配置字段
- triggers.md — 触发/反触发规则
- parameters.md — 衰减参数、β 疤痕、PID 增益、TTL
- compaction.md — D1 诊断和压缩策略
- error_recovery.md — D2 诊断、异常状态、自愈
- case-management.md — D3 诊断、案例审计、L3 审查
- advanced-tools.md — 静默降级、主题锁、PID 自适应
CLI 备用方案
当 MCP 不可用时，CLI 路径相对于技能目录：
python3 scripts/memory_guardian.py [--workspace ]
命令：status、ingest、bootstrap、snapshot、run、violations、migrate