Layer Memory

本地优先、Markdown 原生的 AI 代理分层记忆系统。基于 Midway.js 的 MCP 服务，SQLite 存储，pnpm monorepo。

---

项目架构

layer-memory/
├── packages/
│   └── core/                  # 记忆核心库（框架无关）
│       └── src/store/         # 存储层抽象、SQLite 实现、类型定义
├── apps/
│   ├── mcp-server/            # MCP 服务端（Midway.js 4.0）
│   │   └── src/tools/         # 4 个 MCP Tools
├── docs/                       # 文档站（dumi 2.x）
├── skill/                     # AI Agent skill 定义
├── .husky/                    # Git hooks
├── .changeset/                # 版本管理
├── docker-compose.yml
├── Dockerfile
└── pnpm-workspace.yaml

MCP Tools

工具	说明	参数
memory_store	存储一条记忆	key, value, type(可选), tags(可选)
memory_recall	搜索已存储的记忆	query, type(可选), tags(可选), limit(可选)
memory_export	导出所有记忆为 JSON	outputPath
memory_import	从 JSON 文件导入记忆	inputPath

记忆类型: working (工作记忆) / persona (人格画像) / fact (事实知识)

---

快速开始

前置要求

• Node.js >= 20
• pnpm 10.x（安装：corepack enable && corepack prepare pnpm@10.15.0 --activate）

安装

git clone https://github.com/Dante926/layer-memory.git
cd layer-memory
pnpm install

本地开发

pnpm dev

服务启动在 http://localhost:3000，MCP endpoint 在 /mcp。

构建

pnpm build

所有包编译到各自 dist/ 目录。

文档站

pnpm docs:dev

---

Docker 部署

启动服务

docker compose up -d

服务运行在 http://localhost:3000。

数据持久化

记忆数据存储在 Docker volume layer-memory-data 中，容器重启/更新不会丢失。

重新构建

docker compose build
docker compose up -d

---

连接到 AI Agent

Claude Code

在 ~/.claude/settings.json 中配置 MCP：

{
  "mcpServers": {
    "layer-memory": {
      "type": "url",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Codex / Cursor

在项目的 .cursor/mcp.json 中配置：

{
  "mcpServers": {
    "layer-memory": {
      "type": "url",
      "url": "http://localhost:3000/mcp"
    }
  }
}

---

使用示例

存储记忆：

调用 memory_store(
  key="架构决策",
  value="选择 Midway.js 4.0 MCP + SQLite",
  type="fact",
  tags="项目:layer-memory"
)

搜索记忆：

调用 memory_recall(query="架构决策", limit=5)

导出备份：

调用 memory_export(outputPath="backup.json")

---

版本管理

本项目使用 Changeset 管理版本：

pnpm changeset       # 创建变更记录
pnpm version         # 更新版本号
pnpm publish         # 发布

---

开发

提交规范

使用 Conventional Commits：

• feat: 新功能
• fix: 修复
• chore: 工程化
• docs: 文档

代码格式化

pnpm format