← 工具

OptMem

为 AI Agent 提供永久记忆能力的单文件 Python 工具加 426 token 提示词,无需任何依赖,按需调用 memo 命令即可完成记忆与回忆。区别于同类向量数据库方案,OptMem 用纯文本追加日志 + 树形摘要,零基础设施即可用,Stars 769+

#131
推荐排名
769
GitHub Stars
538
推荐得分
AI Agent 记忆管理 / 长期上下文
适用场景
AI工具AI AgentLLMPython自动化

为什么需要

出海产品里接的 Claude Code 或 Codex,每次开新会话都从零开始——上周跟用户敲定的方案、上次修过的边界条件,全部丢光。常见解法是外挂向量数据库或专用记忆服务,又要部署又要嵌 SDK,一个人维护两套栈非常累。

OptMem 走另一条路:把全部记忆写进一个纯文本日志(LOG.txt),再加一棵可重建的摘要树,Agent 通过 memo wake / memo note / memo recall 三个命令操作。整套东西装在 ~/.optmem/,一个 Python 文件,零依赖,零后台进程。

怎么用

一行安装:

sh
curl -fsSL https://raw.githubusercontent.com/VictorTaelin/OptMem/main/install.sh | sh

把脚本打印的 ## Memory 段贴到项目 AGENTS.md 或 CLAUDE.md 顶部,Agent 就自动按规则调用命令。常用命令:

sh
memo wake                     # 每个会话开头必跑:加载相关记忆
memo note "尝试了 Stripe 订阅模式,月费 $9"  # 记一条新记忆
memo recall 订阅              # 全文搜索历史记忆
memo nap                      # 触发后台合并摘要
memo config WAKE_LINES=300    # 调整每次唤醒的预算

存到一百万条记忆(608 MB)时,wake 仍是 0.03 秒。日志追加不变,记忆树能从日志完全重建。

使用案例

独立开发者用 Claude Code 维护一个面向海外用户的 SaaS 项目。三个月里 Agent 调试过支付、踩过 Stripe Webhook 坑、改过定价页文案。每次新会话开头跑一次 memo wake,Agent 直接续上之前的判断,不用再口头复述上下文。

另一个常见用法:把 ~/.optmem/memory/ 软链到一个 git 仓库或者云同步盘(iCloud / Dropbox),多台机器共用同一份记忆。换电脑不用迁移。

注意事项

  • MIT 开源,完全免费
  • 单文件 Python 3,无第三方依赖,复制即可运行
  • 记录固定宽度,位置即身份,百万级规模仍线性扫描
  • 不适合需要语义检索的场景——它是字面召回,配合正则最稳
  • 摘要树是缓存,丢了能从 LOG 重建,但 LOG 别动