核心用法
Memory Compress 是一款专为 AI Agent 设计的本地日志压缩工具，采用三层记忆架构：稳定的身份层（SOUL.md）、压缩后的精华层（MEMORY.md）和原始日志层（daily logs）。用户通过 Node.js 命令行直接调用，无需配置 API 密钥或外部数据库。
使用方法极其简洁：
node scripts/memory-compress.js memory/2026-03-14.md [output-file]
工具会自动识别日志中的关键模式——包括进展、决策、教训、待办事项等 40+ 种中英文关键词，对无明确结构的时间戳日志则启用智能回退提取，确保零信息丢失。
显著优点
1. 极致压缩效率：基于古典中文写作哲学（去重复、留转折、去过程、留白、形式即内容），实现 4-8 倍压缩比，将 2500 字日志精简至 400 字结构化摘要
2. 真正零依赖：纯 Node.js 实现，无需向量数据库、无需 API 调用、无需网络连接
3. 智能混合策略：关键词匹配 + 结构回退双保险，兼顾精确性与覆盖率
4. 格式无关：支持任何 Markdown 日志，自动处理 BOM、编码异常等边缘情况
5. 通用兼容：OpenClaw、Cursor、Claude Code 及任何基于 Markdown 的记忆系统均可集成
潜在局限
- 无语义理解：基于规则的模式匹配，无法像 LLM 那样进行深层语义推理或跨段落关联
- 压缩质量依赖源格式：结构混乱的原始日志会导致摘要质量下降
- 无自动调度：需手动或配合 cron/systemd 实现定期运行
- 单文件处理：缺乏跨日期的智能去重或主题聚类
- 无可视化：纯 CLI 工具，无 Web 界面或进度反馈
适合人群
- 长期运行 AI Agent 的开发者（日志日产量 >1000 字）
- 使用 Cursor/Claude Code 进行多周项目的用户
- 对数据隐私敏感、拒绝云端记忆服务的用户
- 需要可审计、可版本控制的纯文本工作流的团队
常规风险
| 风险类别 | 说明 | 缓解措施 |
|---------|------|---------|
| 信息误删 | 规则匹配可能过滤掉非常规但重要的细节 | 保留原始日志 Layer 3，压缩结果人工复核 |
| 编码问题 | 非 UTF-8 文件可能产生警告或乱码 | 工具内置 BOM 检测，建议统一 UTF-8 编码 |
| 累积偏差 | 多层压缩后细节逐层丢失 | 控制压缩频率（2-3 天/次），关键决策单独存档 |
| 脚本注入 | 命令行参数未做严格过滤 | 避免将用户输入直接传入路径参数，使用绝对路径 |
该工具代表了"小而美"的本地优先工具哲学：用精心设计的规则替代重型 AI 服务，在隐私、成本、可控性之间取得优雅平衡。