5 分钟，把它接进你的 AI

装好之后你不用改任何习惯 —— 该怎么跟 AI 说话还怎么说话。 它会在需要回忆的时候自己去翻本地记忆库，只把命中的那一小段送进上下文。

01检查一下环境

你需要 Python 3.10 以上，以及一个支持 MCP 的 AI 客户端（Claude Desktop、Cursor、Windsurf、Cline、WorkBuddy 都行）。

python --version          # 看到 Python 3.10.x 以上即可
# Windows 若提示"不是内部或外部命令"，说明装 Python 时没勾 Add to PATH

02安装

pip install memsave

python -m memsave stats   # 看到统计输出就装好了

核心只用 Python 标准库，不装 numpy 也能跑。想让语义检索更准，可以再装可选的 24MB 本地模型（CPU 跑，永不上网）：

python -m memsave embedder install   # 可选，不装也能用

03接进你的 AI

把下面这段加进客户端的 MCP 配置文件。command 填 python；如果你的 Python 不在 PATH 里，就写完整路径（Windows 形如 C:/Users/你/AppData/Local/Programs/Python/Python313/python.exe）。

{
  "mcpServers": {
    "memsave": {
      "command": "python",
      "args": ["-m", "memsave", "serve"]
    }
  }
}

配置文件在哪：

各家还要多做一步（不做就等于没装）

3 秒自检：确认它真的接上了

别靠"看起来开着"判断。让 AI 跑一次检索，有命中才算装好：

用 memory_search 查一下"项目 背景"，告诉我命中了几条

04试一下

跟你的 AI 说这句话（它会调用 memory_add 存下来）：

记住：Alpha 项目因 H800 到货延迟，上线时间推迟到 11 月 15 日。

然后开一个新会话，问它：

Alpha 上线时间改到什么时候了？

它会自己去翻记忆库，只把命中那一条送进上下文 —— 而不是把整个历史重读一遍。每次检索返回末尾都会附一行：

本次检索省下 33,302 token ≈ ¥0.09（累计 1,284,300）

05平时怎么用

你不需要记命令，AI 会自己判断什么时候该存、什么时候该翻。它手上就 9 个工具：

想自己操作就用命令行，效果完全一样：

python -m memsave add "Alpha 延期" --summary "推到 11/15" --kind decision
python -m memsave search "Alpha 排期"
python -m memsave export ~/memories.md     # 随时打包带走
python -m memsave stats                    # 省了多少 token / 多少钱

让每个新对话都自动用上

MCP 服务是被动的 —— AI 不主动调，记忆就永远躺在硬盘里。解决办法是在项目里放一句规则， 一条命令搞定：

memsave rules --write --client claude --scope 项目名

它往规则文件里写一段话（CLAUDE.md / .cursorrules / .windsurfrules / .clinerules / AGENTS.md）， 要求 AI「开会话先查索引、遇事先检索、结束前写结论」。不指定 --client 时按目录自动判断。 重复执行不会重复叠加。

记忆不要混淆（命名空间）

默认所有记忆在一个空间里，A 项目和 B 项目会互相串味。给项目配一个命名空间， 检索就只在本空间内进行：

{
  "mcpServers": {
    "memsave": {
      "command": "python",
      "args": ["-m", "memsave", "serve"],
      "env": { "MEMSAVE_SCOPE": "alpha项目" }
    }
  }
}

规则：scope 内的记忆只对同空间可见；global 空间的记忆 （用户偏好、团队规范）在所有空间都能查到；想跨空间全查就传 scope="*"。 AI 也可以在单次调用里临时指定，不必改配置。老数据自动落在 default，不受影响。

06Pro 授权

免费版 500 条记忆，本地检索不限次数。买了 Pro 终身版，把授权码激活一次即可，不绑机器：

python -m memsave license activate "MSV1-XXXXXXXX.XXXXXXXX"
python -m memsave license status

授权码以 . 分两段，复制时别漏掉后半段。换机器直接重新激活同一串码。

07出问题先看这里

上面都试过还不行，把 python -m memsave stats 的输出发我（购买渠道内私信即可），我直接帮你看。

08还没做的，我不骗你

• 多机同步 / 团队共享库：还没上线，属于 Pro 路线图内，买了不会二次收费。
• 移动端：没有，短期也不打算做。
• 语义检索：可选装的本地模型，不装也能用（关键词检索在中文场景命中率本来就高）。