Timmy
f3f832df20
包含 MemPalace、MarkItDown、Playwright 的安裝與使用筆記。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
95 lines
2.3 KiB
Markdown
95 lines
2.3 KiB
Markdown
# 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`
|