导语: AI 编程助手越来越强,但一个根本问题始终存在:每次新会话,Agent 都是"失忆"的。Mneme 是一个专门为 AI Agent 设计的长期记忆系统,今天正式开源(Apache-2.0)。本文介绍它的设计理念、核心能力和使用方式。

一、Agent 的"失忆症"

如果你用过 AI 编程工具(OpenCode、Claude Code、Codex 等),一定熟悉这个流程:

  1. 打开一个新 session
  2. 用自然语言描述当前任务
  3. Agent 开始检索文件、理解项目结构
  4. 工作完成,关闭 session
  5. 下次再开——Agent 又"忘了"一切,从头开始

这本质上是一个上下文断裂的问题。Agent 在 session 内的上下文窗口是有限的,而跨 session 的上下文则是完全不存在的。

Mneme 解决的就是这个"跨 session 上下文"问题。

二、Mneme 是什么

Mneme(来自希腊语 μνήμη,记忆)是一个Agent 认知运行时。它提供:

  • 长期记忆存储:Agent 可以把每次工作的内容、决策、错误、发现持久化
  • 知识图谱:模块依赖、文件关系、项目约束以结构化方式存储
  • 工作区状态:当前活跃文件、待定决策、测试状态等临时上下文
  • 混合检索:词汇 + 语义 + 关系 + 时间四维搜索

它不是一个"文档数据库",而是一个认知模型——它理解事件、知识、经验、模拟、情绪、意图、信念、过程、任务、偏好、决策、约束和关系等 14 种不同的记忆类型。

三、Agent 怎么用 Mneme

# 会话开始时——先查记忆
Agent: mneme.search_memory(query="dark mode 上次改了什么")

# 工作时——边做边记
Agent: mneme.capture_decision(summary="用CSS变量实现主题切换", rationale="改动最小")
Agent: mneme.add_fact("module:theme-provider", "implements", "CSS变量方案")

# 会话结束时——写回总结
Agent: mneme.session_end(
  summary="实现黑暗模式切换",
  changed_files=["ThemeProvider.tsx", "theme.css"],
  decisions=["CSS变量方案"]
)

下次会话开始时,Agent 不需要你重新描述项目结构和任务背景——它已经从 Mneme 中恢复了上下文。

四、技术架构

Mneme 采用 open-core 模式:

  • 开放核心(Mneme-open):客户端 SDK(Python/TypeScript/Go/CLI)、协议契约、API 文档、预编译二进制
  • Enterprise Edition:PostgreSQL/PGVector 存储后端、LLM 重排序/提取、图重排、云连接器

内置 MCP Server,支持 OpenCode、Claude Code、Codex 即插即用。也支持 JSON-RPC、REST、gRPC 三种协议。

五、开源信息

  • 协议:Apache-2.0
  • GitHub: https://github.com/axisrobo/mneme-open/tree/main
  • 客户端支持:Python、TypeScript、Go
  • 预编译二进制:Windows、Linux、macOS(amd64/arm64)
  • 配套资料:SDK 文档、API 参考、Agent 集成指南、14 种记忆类型完整参考

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐