导语:AI 编程助手越来越强,但一个根本问题始终存在:每次新会话,Agent 都是"失忆"的。Mneme 是一个专门为 AI Agent 设计的长期记忆系统,今天正式开源(Apache-2.0)。本文介绍它的设计理念、核心能力和使用方式。
一、Agent 的"失忆症"
如果你用过 AI 编程工具(OpenCode、Claude Code、Codex 等),一定熟悉这个流程:
- 打开一个新 session
- 用自然语言描述当前任务
- Agent 开始检索文件、理解项目结构
- 工作完成,关闭 session
- 下次再开——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 种记忆类型完整参考