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",...}