内容
# Human Memory — AI Agent 五层类人记忆框架
为 AI Agent 提供跨会话的情景记忆、语义知识、程序技能和代码结构感知能力。
基于 [OpenCode](https://opencode.ai) 构建，由 open-mem 插件和三个 MCP 服务器驱动。
## 架构
```
┌──────────────────────────────────────────────────────┐
│ L4 元记忆 mcp-memory-engine* (Rust) │
├──────────────────────────────────────────────────────┤
│ L3a 语义知识图谱 server-memory │
│ L3b 程序技能 core-memory-mcp │
│ L3a+ 代码结构 codebase-memory-mcp │
├──────────────────────────────────────────────────────┤
│ L2 情景记忆 open-mem (插件) │
├──────────────────────────────────────────────────────┤
│ L1 工作记忆 LLM 上下文窗口 │
├──────────────────────────────────────────────────────┤
│ L0 感官捕获 open-mem hooks │
└──────────────────────────────────────────────────────┘
```
| 层 | 功能 | 组件 | 使用方式 |
|----|------|------|---------|
| **L0+L2** | 捕获历史会话 + 回忆 | open-mem 插件 | 自动上下文注入，`mem-find`，`mem-create` |
| **L3a** | 知识图谱（事实与概念） | memory-kg (MCP) | `search_nodes`，`create_entities`，`add_observations` |
| **L3b** | 可复用的技能提取 | memory-skills (MCP) | `create_skill`，`list_skills`，`get_skill` |
| **L3a+** | 代码结构智能 | memory-code (MCP) | `search_graph`，`get_callers`，`get_callees` |
## 快速开始
**环境要求：** OpenCode v1.17+，Node.js 20+ / Bun 1+
```bash
# 1. 将 open-mem 添加到全局 OpenCode 配置
# 编辑 ~/.config/opencode/opencode.jsonc:
# "plugin": ["oh-my-openagent@latest", "open-mem"]
# 2. 安装 open-mem
npm install open-mem
npx open-mem --quick
# 3. 在项目的 opencode.json 中添加 MCP 服务器配置
# （参见下方配置模板）
# 4. 重启 OpenCode
```
### 项目 opencode.json 配置
```json
{
"plugin": ["open-mem"],
"mcpServers": {
"memory-kg": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"description": "语义知识图谱"
},
"memory-skills": {
"type": "stdio",
"command": "core-memory",
"description": "程序技能提取"
},
"memory-code": {
"type": "stdio",
"command": "codebase-memory-mcp",
"description": "代码结构智能"
}
},
"contextPaths": ["AGENTS.md", "MEMORY_ARCHITECTURE.md"]
}
```
### 安装可选 MCP 服务器
```bash
# memory-code — 代码结构（推荐）
npx codebase-memory-mcp install opencode
# memory-skills — 程序技能（需要编译）
git clone https://github.com/danielmriley/core-memory-mcp
cd core-memory-mcp && npm install && npm run build && npm link
```
## 使用
在 OpenCode 中加载 skill：
```
skill(name="human-memory")
```
### 会话启动协议
```python
1. 读取 open-mem 自动注入的上下文
2. memory-kg → search_nodes("") # 加载项目知识
3. memory-code → search_graph("") # 加载代码结构
```
### 工作中
```python
# 保存学到的知识：
memory-kg → create_entities() + add_observations()
memory-kg → create_relations() # 关联相关实体
# 提取可复用的模式：
memory-skills → create_skill(confidence=0.7)
# 探索不熟悉的代码：
memory-code → search_graph("模块名")
```
## 工具参考
| 目标 | 调用方式 | MCP 服务器 |
|------|---------|------------|
| 保存事实 | `create_entities` + `add_observations` | memory-kg |
| 关联实体 | `create_relations` | memory-kg |
| 搜索知识 | `search_nodes(查询)` | memory-kg |
| 浏览历史会话 | `mem-find(查询)` | open-mem |
| 创建技能 | `create_skill()` | memory-skills |
| 查找技能 | `list_skills(关键词)` | memory-skills |
| 探索代码 | `search_graph(符号)` | memory-code |
| 查找调用方 | `get_callers(函数)` | memory-code |
## 项目结构
```
human-memory/
├── SKILL.md # 可加载的 skill 定义
├── references/
│ └── MEMORY_ARCHITECTURE.md # 完整架构设计文档
├── package.json # npm 包定义
├── setup.sh # 一键安装脚本
├── LICENSE # MIT
└── README.md # 本文件
```
## 许可证
MIT
