# MemPalace 安裝與使用筆記

## 基本資訊

- **專案**: https://github.com/MemPalace/mempalace
- **版本**: 3.3.0
- **授權**: MIT
- **需求**: Python 3.9+
- **安裝日期**: 2026-04-15

## 安裝

```bash
pip install mempalace
```

主要相依套件：ChromaDB（向量資料庫）、PyYAML、ONNX Runtime。

## 核心概念

MemPalace 用階層式結構組織記憶：

- **Wing**（翼）— 對應一個專案或一個人
- **Room**（房間）— 對應一個主題
- **Drawer**（抽屜）— 原始內容（不做摘要，保留完整原文）

所有資料存在本地，不需要雲端服務或 API key。

## 常用指令

### 初始化專案

```bash
mempalace init ~/projects/my_app
mempalace init ~/projects/my_app --yes  # 非互動模式，自動接受
```

### 匯入資料

```bash
# 匯入專案檔案（程式碼、文件、筆記）
mempalace mine ~/projects/my_app

# 匯入對話記錄（Claude、ChatGPT、Slack 匯出檔）
mempalace mine ~/chats/ --mode convos
```

### 搜尋

```bash
mempalace search "為什麼改用 GraphQL"
mempalace search "定價討論" --wing my_app --room costs
```

### 其他指令

```bash
mempalace status                  # 查看已歸檔內容
mempalace wake-up                 # 顯示 L0 + L1 喚醒上下文（~600-900 tokens）
mempalace wake-up --wing my_app   # 特定專案的喚醒上下文
mempalace compress                # 用 AAAK Dialect 壓縮（~30x）
mempalace split <dir>             # 將合併的大檔拆成個別 session 檔
mempalace repair                  # 重建向量索引（修復損壞）
mempalace migrate                 # 跨 ChromaDB 版本遷移
mempalace mcp                     # 顯示 MCP 設定指令
```

## Claude Code MCP 整合

### 註冊 MCP Server

```bash
claude mcp add mempalace -- python -m mempalace.mcp_server
```

### 指定自訂 palace 路徑

```bash
claude mcp add mempalace -- python -m mempalace.mcp_server --palace /path/to/palace
```

### 直接啟動 MCP Server

```bash
python -m mempalace.mcp_server
```

註冊後，下次啟動 Claude Code 會自動載入，提供 29 個 MCP 工具可在對話中使用。

## 目前設定

- Palace 設定檔：`./mempalace.yaml`
- MCP 設定位置：`~/.claude.json`（本專案範圍）
- 預設 palace 存放路徑：`~/.mempalace/palace`