---
title: Vault Memory System
status: active
created: 2026-02-25
project: vault-memory-pgvector
---

# Vault Memory System

为 Obsidian Vault 提供语义记忆能力的独立工具项目。通过 OpenRouter Embedding + 本地 pgvector，让 Claude Agent 在跨 Session 时能召回相关笔记上下文。

## 项目位置

- 代码仓库：`D:/tmp/vault-memory-pgvector/`
- Vault 脚本（旧）：`.scripts/memory/`（已迁移，可删除）

## 文档导航

**系统文档**
- [[architecture]] — 系统架构与设计决策
- [[deployment]] — 部署与配置步骤
- [[status]] — 当前运行状态与已知问题

**审查与重构**
- [[review-2026-02-26]] — 代码审查报告（2026-02-26）
- [[refactor-plan]] — 重构计划（3 阶段）
- [[refactor-board]] — 重构看板（任务进度跟踪）

## 快速命令

```bash
# 查询记忆
uv run python query_pgvector.py "最近的重点项目"

# 带记忆启动 Claude
bash agent-with-memory.sh "帮我整理本周进展"

# 重建全量索引
uv run python ingest_vault.py
```

## 关键指标（2026-02-25）

| 指标 | 目标 | 实测 | 状态 |
|---|---|---|---|
| Recall@5 | ≥ 70% | 90% | ✅ |
| 增量 P95 延迟 | < 1s | 1.4s | ⚠️ |
| 冷启动 | ≤ 4.5s | 未测 | 🔲 |
| 敏感内容隔离 | 红线 | 通过 | ✅ |
| 删除/重命名一致性 | 红线 | 通过 | ✅ |