zilliztech/memsearch

A persistent, unified memory layer for all your AI agents (e.g. Claude Code, Codex, DSH), backed by Markdown and Milvus.

什么是 memsearch？

memsearch 是一个跨平台、开源的工具，为 AI 编码助手（Claude Code、Codex、DeepSeek Harness、OpenClaw、OpenCode 或任何自定义代理）提供持久、可搜索的记忆。它记录每一轮对话到纯文本 Markdown 文件中，使用 Milvus 进行索引，并让代理按需检索相关的历史笔记。

适用人群

代理用户 – 为您最喜欢的编码助手安装一个小插件，无需额外设置即可自动捕获和回忆过去的聊天记录。
代理开发者 – 使用提供的 CLI 或 Python 库，将相同的记忆引擎嵌入到您自己的机器人、RAG 管道或 harness 工程项目中。

核心概念

概念	工作原理
事实来源	所有记忆都存储为人类可编辑的 `.md` 文件（例如，`memory/2024-11-20.md`）。
影子索引	Milvus 向量存储（默认 Milvus Lite，或 Zilliz Cloud）对分块进行索引，以实现快速语义搜索。
混合检索	结合密集嵌入、BM25 稀疏匹配和倒数排名融合（RRF）重排序。
渐进式回忆	搜索 → 扩展到完整的 Markdown 部分 → 可选地获取原始转录。
实时同步	文件监视器监视 Markdown 文件夹，仅重新分块更改的部分（SHA-256 去重）。
可选远程重排序	结果可通过 Jev 的 TypeSafe API 进行重排序，无需下载模型。
程序性记忆	重复的工作流可以提炼为可安装的技能（Agent Skills 标准）。
后台维护	可选任务保持 `PROJECT.md`（项目状态）和 `USER.md`（个人偏好）的最新状态。

主要功能

零配置插件，适用于五种主流编码代理。安装插件后，对话会自动捕获，并可通过简单的命令（如 /memory-recall …）或自然提问进行回忆。
嵌入提供者 – 默认的 ONNX bge-m3 在本地免费运行；您可以切换到 OpenAI、Ollama 等。
Milvus 后端 – Milvus Lite（单文件）用于快速启动，Zilliz Cloud（托管）或通过 Docker 自托管 Milvus 用于大型团队。
技能提炼 – 将捕获的工作流转换为代理稍后可以调用的可复用命令。
CLI 和 Python API – memsearch index、memsearch search、memsearch config … 等，以及一个库（import memsearch）用于编程使用。
混合搜索 – 密集向量 + BM25 + RRF 比纯向量搜索提供更好的相关性。
实时文件监视器 – 当 Markdown 文件更改时立即更新索引。

用户的典型工作流

为您的代理安装插件（例如，plugin marketplace add zilliztech/memsearch）。
照常聊天 – 每一轮都会被摘要并追加到每日 Markdown 文件中。
回忆 – 运行 /memory-recall <问题> 或直接询问代理；它将自动调用记忆回忆技能。
（可选）启用 PROJECT/用户笔记或技能提炼，通过要求代理“启用 MemSearch 技能提炼”。

开发者的典型工作流

from memsearch import MemsearchClient
client = MemsearchClient()
# 索引一个新的 markdown 文件
client.index_path('my_project/memory/2024-11-20.md')
# 搜索
results = client.search('我们是如何配置 redis 的？', top_k=5)
for r in results:
    print(r.text)

相同的客户端为插件提供支持，因此任何自定义代理都可以重用完整的索引、搜索和维护逻辑。

为什么重要

连续性 – 代理在会话后会忘记；memsearch 跨会话甚至跨不同代理保留整个对话历史。
人类可读 – 因为记忆存储在 Markdown 中，开发者可以检查、编辑、版本控制或比较笔记。
成本效益 – 默认的本地 ONNX 嵌入避免 API 费用；Milvus Lite 开箱即用。
可扩展 – 通过 CLI/API 连接到任何 LLM，添加自定义摘要模型，或切换到托管的 Milvus 集群。

TL;DR：memsearch 是一个轻量级、基于 Markdown 的语义记忆系统，适用于 AI 编码助手，提供自动捕获、混合搜索、跨代理共享和可选的技能创建，同时提供现成的插件和完整的 CLI/Python API 供开发者使用。