Vestige

記憶

在每個會話開始時：

1. 在 Vestige 中搜索用戶偏好和項目上下文
2. 自動保存 bug 修復、決策和模式
3. 當用戶提及截止日期時創建提醒

| 你說 | AI 操作 |
|---------|---------|
| "Remember this" | 立即保存 |
| "I prefer..." / "I always..." | 保存為偏好 |
| "Remind me..." | 創建未來觸發器 |
| "This is important" | 保存並提升 |

[完整 CLAUDE.md 模板 ->](docs/CLAUDE-SETUP.md)

## 📦 安裝指南
見快速開始部分，包含不同平臺的安裝方法。

## 💻 使用示例
### 基礎用法
```bash
# 安裝 Vestige（macOS Apple Silicon）
curl -L https://github.com/samvallad33/vestige/releases/latest/download/vestige-mcp-aarch64-apple-darwin.tar.gz | tar -xz
sudo mv vestige-mcp vestige vestige-restore /usr/local/bin/

# 連接到 Claude Code
claude mcp add vestige vestige-mcp -s user

# 測試
# "Remember that I prefer TypeScript over JavaScript"
# ...新會話...
# "What are my coding preferences?"
# → "You prefer TypeScript over JavaScript."

高級用法

# Metal GPU 加速（Apple Silicon — 更快的嵌入推理）
cargo build --release -p vestige-mcp --features metal

# Nomic Embed Text v2 MoE（475M 參數，305M 活躍，8 個專家）
cargo build --release -p vestige-mcp --features nomic-v2

# Qwen3 重排器（Candle 後端，高精度交叉編碼器）
cargo build --release -p vestige-mcp --features qwen3-reranker

# SQLCipher 加密
cargo build --release -p vestige-mcp --no-default-features --features encryption,embeddings,vector-search

📚 詳細文檔

🔧 技術細節

可選特性

# Metal GPU 加速（Apple Silicon — 更快的嵌入推理）
cargo build --release -p vestige-mcp --features metal

# Nomic Embed Text v2 MoE（475M 參數，305M 活躍，8 個專家）
cargo build --release -p vestige-mcp --features nomic-v2

# Qwen3 重排器（Candle 後端，高精度交叉編碼器）
cargo build --release -p vestige-mcp --features qwen3-reranker

# SQLCipher 加密
cargo build --release -p vestige-mcp --no-default-features --features encryption,embeddings,vector-search

📄 許可證

本項目採用 AGPL - 3.0 許可證，可免費使用、修改和自託管。如果將 Vestige 作為網絡服務提供，則必須開源修改內容。

🔧 CLI 命令

vestige stats                    # 記憶統計
vestige stats --tagging          # 保留分佈
vestige stats --states           # 認知狀態分解
vestige health                   # 系統健康檢查
vestige consolidate              # 運行記憶維護
vestige restore <file>           # 從備份恢復
vestige dashboard                # 在瀏覽器中打開 3D 儀表盤

🛠 故障排除

which vestige-mcp
# 或者使用完整路徑：
claude mcp add vestige /usr/local/bin/vestige-mcp -s user

export HTTPS_PROXY=your-proxy:port

curl http://localhost:3927/api/health
# 應返回 {"status":"healthy",...}