初始提交:工具安裝與使用筆記
包含 MemPalace、MarkItDown、Playwright 的安裝與使用筆記。 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
94
mempalace-notes.md
Normal file
94
mempalace-notes.md
Normal file
@@ -0,0 +1,94 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user