51 lines
1.3 KiB
Markdown
51 lines
1.3 KiB
Markdown
|
---
|
|||
|
|
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 | 未测 | 🔲 |
|
|||
|
|
| 敏感内容隔离 | 红线 | 通过 | ✅ |
|
|||
|
|
| 删除/重命名一致性 | 红线 | 通过 | ✅ |
|