一个以 Markdown 为核心的 AI 代理记忆系统,基于 Milvus 提供语义搜索,支持多嵌入提供商和框架集成。
memsearch 是 Zilliz 推出的 AI 代理记忆系统,以 Markdown 文件作为数据真实来源,Milvus 向量数据库作为派生索引。核心设计理念:Markdown 作为人类可读、Git 友好、零供应商锁定的数据源,向量数据库为可随时重建的派生索引。
核心特性:
- 语义搜索:基于 Milvus 的向量相似度搜索,支持混合搜索(dense vector + BM25)与 RRF 重排序
- 智能去重:SHA-256 内容哈希,未更改内容不会被重复嵌入
- 实时同步:文件监控器自动索引更改(创建、编辑、删除),默认 1500ms 防抖
- LLM 压缩:将索引块压缩为简洁的 Markdown 摘要
嵌入提供商支持:OpenAI(默认)、Google Gemini、Voyage AI、Ollama(本地)、sentence-transformers(本地)
框架集成:LangChain(BaseRetriever)、LangGraph(ReAct 代理工具)、LlamaIndex(自定义检索器)、CrewAI(代理工具)
安装:
pip install memsearch
# 可选提供商
pip install memsearch[google] # Google Gemini
pip install memsearch[ollama] # Ollama 本地
pip install memsearch[local] # sentence-transformers
CLI 快速上手:
memsearch config init # 初始化配置
memsearch index ./memory/ # 索引 Markdown 文件
memsearch search "查询内容" # 语义搜索
memsearch watch ./memory/ # 实时监控
Python API:
from memsearch import MemSearch
mem = MemSearch(paths=["./memory"])
await mem.index()
results = await mem.search("query", top_k=3)
Milvus 部署模式:Lite(本地开发)、Server(自托管生产)、Cloud(云端托管)
Claude Code 插件:开箱即用的代理记忆实现,支持自动会话总结与语义搜索。
系统要求:Python >= 3.10,跨平台支持(macOS、Linux、Windows via WSL2)