smart-memory

🧠 AI 上下文感知智能记忆管家

本地 AI 记忆系统,支持混合向量检索与智能策展,零配置即开即用,100% 本地运行保障数据隐私。

收藏
2.6k
安装
671
版本
127.0.0
CLS 安全性认证2026-05-22
点击查看完整报告 >

使用说明

Smart Memory v2.1 是 BluePointDigital 开发的 AI 代理记忆增强工具,作为 OpenClaw 记忆系统的替代方案,提供上下文感知的双模检索能力。该系统采用 SQLite 作为后端存储,结合 FTS5 全文搜索与本地向量嵌入,实现了无需外部 API 密钥的完全本地化运行。

核心用法方面,用户可通过 CLI 或 JavaScript API 调用两种检索模式:Fast Mode 直接执行混合向量搜索(BM25 + 余弦相似度),适用于快速事实查找;Focus Mode 则启用多轮策展流程,通过 Focus Agent 对 20+ 个候选片段进行加权排序、相关性过滤和叙事合成,适用于复杂决策与多事实关联分析。安装后执行 --sync 初始化数据库,随后可通过 --search 进行查询,或使用 --focus/--unfocus 切换模式。

显著优点包括:100% 本地运行保障数据隐私,使用 Transformers.js 在本地计算嵌入向量;零配置设计,单文件 SQLite 数据库自动创建;混合搜索算法结合关键词与语义匹配,显著提升检索准确率;双模架构允许用户在响应速度与上下文质量间灵活权衡;可选的 sqlite-vec 扩展可将向量搜索性能从每秒 100 块提升至 10,000 块。

潜在局限在于:首次运行需从 Hugging Face 下载约 80MB 的 AI 模型(Xenova/all-MiniLM-L6-v2),在网络受限环境可能受阻;作为 T3 级社区项目,长期维护稳定性不如企业级方案;尽管支持无限规模,但纯 JavaScript 向量计算在超大文档集(百万级块)下性能仍逊于专业向量数据库;Focus Mode 的策展过程会增加 50-100ms 延迟。

适合群体主要为:注重数据隐私、不愿将记忆内容上传至云端 AI 服务的开发者;使用 OpenClaw 或其他 AI 代理框架需要长期上下文记忆的技术用户;需要在本地进行项目文档、知识库语义检索的个人或小型团队;以及对响应速度要求不极端苛刻、更看重检索质量的场景。

使用风险主要包括:依赖 Hugging Face 模型下载的可用性;SQLite 数据库文件需定期备份以防损坏;虽然已实现路径遍历防护,但仍需确保 MEMORY_DIR 等环境变量指向预期目录,避免敏感文件被意外索引;child_process 的使用虽经转义,但在极端输入下仍需警惕命令注入风险。建议定期关注 GitHub 仓库安全更新。

安全解读

核心用法

Smart Memory v2.1 是专为AI Agent设计的本地记忆系统,提供双模式检索

Fast Mode(默认):直接向量相似度搜索,适合快速事实查找,延迟最低
Focus Mode(策展模式):多轮智能筛选——检索20+片段→加权排序→综合叙事→输出结构化上下文,适合复杂决策、多事实合成

工作流--sync 同步记忆文件 → --search "query" 检索 → --focus/--unfocus 动态切换模式

API工具memory_search() 智能检索、memory_get() 精准读取、memory_mode() 模式切换

显著优点

| 维度 | 优势 |
|------|------|
| 搜索质量 | 混合BM25+向量检索,兼得语义理解与精确匹配 |
| 灵活性 | 一键切换Fast/Focus,按需平衡速度vs深度 |
| 部署零负担 | SQLite单文件、Transformers.js本地嵌入、无需API Key |
| 性能可扩展 | 原生sqlite-vec支持时达10,000 chunks/sec |
| 数据主权 | 100%本地运行,零数据外泄 |

潜在缺点/局限性

  • 首启网络依赖:需从Hugging Face下载~80MB嵌入模型(可预缓存离线)
  • Focus模式延迟:策展流程增加50-100ms,不适合高频实时场景
  • 无分布式能力:单SQLite文件,不适合多机协同或超大规模记忆
  • 语义局限:基于all-MiniLM-L6-v2,跨语言/专业领域效果可能下降

适合人群

  • 个人开发者/小团队:需要为AI Agent添加长期记忆,但拒绝云服务成本与隐私风险
  • 隐私敏感场景:医疗、法律、金融等数据不可出境的领域
  • 离线/边缘环境:无稳定网络或需完全数据隔离的部署
  • OpenClaw用户:官方推荐的OpenClaw记忆系统替代方案,即装即用

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 外部模型下载 | Low | Hugging Face可信源,HTTPS传输,本地缓存后续离线可用 |
| 数据库文件安全 | Low | 默认工作目录创建,建议通过`MEMORY_DB_PATH`规范存储路径并设权限600 |
| 依赖供应链 | Low | 仅better-sqlite3与@xenova/transformers两个知名库,需定期`npm audit` |

最佳实践:预下载模型至隔离环境、配置环境变量统一管理路径、定期备份vector-memory.db

smart-memory 内容

skills文件夹
vector-memory文件夹
smart-memory文件夹
references文件夹
手动下载zip · 43.4 kB
README.mdtext/markdown
请选择文件