初始提交:工具安裝與使用筆記

包含 MemPalace、MarkItDown、Playwright 的安裝與使用筆記。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-15 09:29:01 +08:00
commit f3f832df20
4 changed files with 479 additions and 0 deletions

94
mempalace-notes.md Normal file
View 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`