smart-memory

Smart Memory v2.1 是一款专为AI代理设计的上下文感知记忆系统，采用SQLite单文件数据库作为后端，实现了零配置、完全本地化的记忆管理方案。该系统最大的特色在于其双模态检索架构：Fast Mode提供基于向量相似性的快速检索，适合简单事实查询；而Focus Mode则通过多阶段策展流程（检索→排序→综合→交付），为复杂决策和多事实合成场景提供结构化上下文。

核心用法方面，用户通过npx clawhub install完成安装后，首先运行--sync命令同步记忆文件，随后可通过CLI或JavaScript API进行搜索。系统创新性地融合了FTS5关键词搜索（BM25算法）与语义向量搜索，采用70%向量权重+30%关键词权重的混合评分机制，确保既能捕捉语义相关性，又能匹配精确词条。Focus Agent在启用时会执行20+片段的广泛检索，通过加权相关性排序和来源提升，最终合成连贯的叙述性上下文。

该系统的显著优势包括：100%本地运行（基于Transformers.js的嵌入计算，无需API密钥）、单文件SQLite存储便于备份与迁移、混合搜索算法兼顾速度与准确性、以及可在Fast与Focus模式间无缝切换的灵活性。对于注重数据隐私的用户而言，所有向量计算和存储均在本地完成，彻底消除了云端泄露风险。

然而，系统也存在一定局限性。首先，来源为T3级个人开发者（getmolty），缺乏组织级背书与长期维护保障。其次，虽然主打"零配置"，但若要获得最佳性能（~10,000 chunks/sec），需手动安装sqlite-vec扩展，该组件需从GitHub Releases下载，增加了部署复杂度。此外，纯本地化架构意味着无法实现多设备同步，限制了团队协作场景的应用。性能方面，在未安装sqlite-vec的情况下，大规模数据库的检索速度会降至约100 chunks/sec。

该技能最适合以下群体：需要为AI代理构建长期记忆能力的开发者、处理敏感数据且必须本地存储的企业用户、以及需要复杂上下文检索（如项目历史回溯、决策依据综合）的知识工作者。对于仅需简单关键词搜索或云端同步记忆的场景，该系统可能过于复杂。

使用风险主要包括：npm供应链风险（依赖Transformers.js等外部包）、可选组件sqlite-vec的下载来源可靠性、以及作为个人项目可能面临的长期维护不确定性。建议用户定期备份vector-memory.db文件，并在生产环境使用前对依赖项进行安全审计。