memory-system-v2

核心用法

Memory System v2.0 是一款专为AI Agent设计的文件级持久化记忆系统，通过命令行工具实现记忆的捕获、检索与管理。用户可通过 capture 命令记录五类记忆（学习、决策、洞察、事件、交互），每条记忆支持1-10重要性评分与标签分类；search 命令实现多关键词语义检索，平均响应<20ms；recent 按类型与时间窗口筛选近期记忆；consolidate 自动生成周度汇总报告。所有数据以JSON索引+Markdown日志的混合结构存储于本地文件系统，无需数据库依赖。

显著优点

极致性能：36项测试全部通过，搜索操作平均8-18ms，捕获<50ms，满足实时交互需求。零依赖架构：仅依赖bash与jq，无数据库、无网络服务、无复杂运行时，部署成本极低。智能组织：自动按日期分片存储，支持重要性加权搜索与标签体系，周度自动汇总降低信息过载。场景适配：五类记忆类型覆盖知识管理全场景，context字段保留原始工作上下文，实现精准场景回溯。开源透明：完整设计文档、测试报告与GitHub溯源，MIT协议允许自由修改。

潜在局限

规模天花板：文件架构设计上限约1万条记忆，超出后性能衰减。语义能力边界：当前为关键词匹配，无向量嵌入支持，复杂语义关联检索能力有限。单用户设计：无多租户隔离机制，团队协作场景不适用。跨平台限制：依赖bash环境，Windows原生支持需WSL。输入处理粗放：content/tags/context参数未做严格转义过滤，极端输入可能导致文件格式异常。

目标群体

AI Agent开发者：为LLM应用添加跨会话记忆能力的工程师。个人知识工作者：需要追踪学习轨迹、决策依据与项目里程碑的开发者、产品经理、研究者。ClawdHub生态用户：已与Clawdbot深度集成，适合该平台的Agent增强场景。轻量级工具偏好者：排斥Notion/Obsidian等重型方案，追求本地优先、速度优先的技术用户。

使用风险

数据持久化风险：文件级存储无自动备份机制，磁盘故障或误删将导致记忆丢失，建议配合git或云同步工具。性能退化风险：长期高频使用接近1万条阈值时，JSON索引解析开销将显著上升，需关注stats输出。依赖项风险：jq为必需依赖，若系统环境变更导致jq不可用，整个系统将失效。输入污染风险：未过滤的特殊字符（如未转义的引号、控制字符）可能破坏JSON索引结构，导致搜索异常。