核心用法
memory-compress 是一款面向 AI Agent 和开发者的本地日志压缩工具，采用三层记忆架构（身份层/精华层/原始层），通过智能混合提取算法将每日日志从约 2,500 字压缩至 400 字。用户只需执行 node scripts/memory-compress.js <log-file> [output-file] 即可完成压缩，支持批量处理和多日文件。
显著优点
- 零依赖设计：纯 Node.js 实现，无需 API 密钥、向量数据库或外部服务
- 高压缩比：4-8 倍压缩率，通过关键词匹配（40+ 中英模式）+ 智能回退机制确保零数据丢失
- 古典中文压缩哲学：提炼「去重复、留转折、去过程、留白、形式即内容」五大原则，结构优于冗长叙述
- 三层记忆架构：RAW LOGS → CURATED MEMORY → IDENTITY 的渐进式提炼，平衡细节与可用性
- 边缘场景完善：BOM 自动检测、目录自动创建、空文件跳过、多编码兼容
潜在局限
- 仅支持 Markdown 格式输入，非结构化文本需预处理
- 压缩质量依赖原始日志的标题层级结构
- 无内置版本控制，多次压缩可能产生重复条目
- 中文关键词优先，纯英文日志的提取精度可能略有下降
适合人群
- 使用 OpenClaw、Cursor、Claude Code 等 AI 编程助手的开发者
- 需要维护长期项目记忆的独立开发者或小团队
- 每日产生大量日志、需要周期性归档的技术写作者
- 对数据隐私敏感、拒绝云端服务的本地优先用户
常规风险
- 数据完整性：虽宣称「零信息丢失」，但压缩本质不可逆，建议保留原始日志作为 Layer 3
- 路径遍历：CLI 参数直接传入文件系统，需确保输入路径可信
- 编码问题：非 UTF-8 文件仅触发警告继续执行，可能产生乱码
- 无签名验证：未提供校验机制，需从可信来源获取脚本