memory-curator

🗂️ 智能日志压缩与记忆索引工具

基于索引优先架构的本地安全工具,将冗长日志智能压缩为结构化摘要,高效构建可检索的个人记忆系统。

收藏
2.3k
安装
696
版本
v1.0.0
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

Memory Curator 是一款专注于日志压缩与记忆索引的本地工具,旨在将冗长的日常记录(通常 200-500 行)智能浓缩为 50-80 行的结构化摘要。该工具采用索引优先架构,通过层级化的文件组织方式,帮助用户高效管理个人或 AI 代理的记忆文件,实现从原始日志到可检索摘要的快速转换。

核心用法围绕 generate-digest.sh 脚本展开。用户可通过命令行指定日期生成摘要骨架,或设置定时任务在每日结束时自动执行。生成的摘要遵循固定结构:包含当日总结、统计数据、关键事件、学习心得、人际连接、待解疑问和明日计划等七大模块。工作流程遵循「扫描索引→定位摘要→按需深入」的原则,只有在必要时才回溯原始日志,极大提升了信息检索效率。

该工具的显著优点体现在多个维度。首先是极高的压缩率,通过 aggressive compression 策略,在保证关键信息完整的前提下将内容缩减至原体积的 20% 以下。其次是结构化的知识管理,预定义的模板确保了信息记录的一致性和完整性。再者是纯粹的本地方案,所有数据处理均在用户本地完成,无需网络连接,既保证了隐私安全又确保了离线可用性。此外,工具仅依赖 POSIX 标准命令(grep、awk、sed 等),无需安装复杂的运行时环境或第三方依赖。

然而,Memory Curator 也存在一定的局限性。最显著的是需要人工干预——生成的摘要模板中包含注释占位符,需要用户手动填充 Summary、Learnings 和 Tomorrow 等主观性较强的内容,无法做到完全自动化。其次,人物名称提取依赖正则表达式匹配,尽管已过滤常见假阳性词汇,但仍可能存在误识别风险。另外,工具硬编码了操作路径,在多用户协作环境或需要自定义目录结构的场景中灵活性不足。

该工具特别适合需要管理大量日常记录的个人用户、研究人员以及构建 AI 代理记忆系统的开发者。对于习惯详细记录但苦于信息过载的日记爱好者,或是需要维护项目日志、实验记录的知识工作者,Memory Curator 能有效降低信息检索的认知负荷。同时,其索引优先的架构理念也适合作为个人知识管理系统的基础组件。

在使用过程中,用户需注意以下常规风险。首先,必须确保工作目录结构预先存在,否则脚本可能无法正常运行。其次,虽然工具本身设计为只读原始日志并生成新文件,不涉及破坏性操作,但建议定期备份摘要目录以防意外。最后,由于摘要质量很大程度上依赖于用户手动填充的内容,长期维护需要一定的自律性,如果中断手动整理,索引系统的效果将大打折扣。

安全解读

核心用法

Memory Curator 是一款专为 AI 代理设计的日志管理与记忆压缩工具。它将每日 200-500 行的原始日志压缩为 50-80 行的结构化摘要,采用「索引优先」架构实现高效检索。

工作流程
1. 通过 ./scripts/generate-digest.sh 自动生成摘要骨架

2. 填充六大核心模块:Summary(当日精髓)、Stats(关键指标)、Key Events(重要事件)、Learnings(洞察沉淀)、Connections(人脉记录)、Open Questions(待解疑问)、Tomorrow(明日优先级)

3. 建立层级索引:INDEX.mddigests/topics/daily/,实现三级跳检索

技术实现:纯 Bash 脚本,零依赖,使用 grep/sed/awk/wc 等 POSIX 标准工具

---

显著优点

| 维度 | 优势 |
|------|------|
| **效率** | 将检索成本从数百行降至数十行,token 消耗降低 80%+ |
| **结构化** | 强制分类沉淀,避免信息淹没在原始日志中 |
| **连续性** | Open Questions 模块创造跨会话记忆纽带 |
| **离线安全** | 纯本地运行,零网络暴露面 |
| **可复现** | 原始日志保留,摘要可重建、可审计 |

---

局限性与注意事项

  • 仍需人工干预:骨架生成后,Summary/Learnings/Tomorrow 等核心字段需手动填写,无法全自动完成
  • 压缩损失风险: aggressively compression 策略可能导致边缘信息丢失,关键决策需回溯原始日志
  • Bash 可移植性:虽使用 POSIX 工具,但在非 Unix-like 环境(Windows 原生)需额外适配
  • 规模天花板:当日志量达到 GB 级时,纯文本索引效率会下降,需考虑数据库化改造

---

适合人群

  • 长期运行的 AI 代理/数字助手用户
  • 需要跨会话保持上下文的对话系统开发者
  • 注重隐私、拒绝云端记忆方案的个人用户
  • 知识管理爱好者(Second Brain / Zettelkasten 实践者)

---

常规风险

| 风险类型 | 等级 | 说明 |
|----------|------|------|
| 数据丢失 | 低 | 仅读取、不删除原始文件,但建议定期备份 |
| 路径注入 | 极低 | 日期参数未严格校验格式,存在理论上的路径遍历可能 |
| 隐私泄露 | 无 | 完全离线,无网络传输 |
| 依赖失效 | 无 | 零第三方依赖 |

---

安全认证结论

经 CLS-Certify v2.1.0 全面扫描:S+ 级安全,100 分满分。无危险函数、无网络请求、无敏感数据收集,来自 T2 级可信组织 openclaw。堪称本地工具类 Skill 的安全典范。

memory-curator 内容

scripts文件夹
手动下载zip · 4.1 kB
generate-digest.shtext/x-shellscript
请选择文件