中文 English 日本語

# mempal

Coding Agent 的项目记忆工具。单二进制，混合检索，10 秒内带出处找回历史决策。

`cargo install mempal`
GitHub crates.io 设计书稿

## 核心特性

🔍

### 混合检索

BM25 关键词匹配 + 向量语义搜索，通过 RRF 融合。精确匹配错误码、函数名，也能理解语义相似性。

🧠

### 知识图谱

三元组（主语-谓语-宾语）+ 时态验证。支持 timeline 视图和 stats 统计。关系会过期。

🌐

### 跨项目隧道

当同一 Room 出现在多个 Wing（项目）中，自动发现跨域链接。搜索结果内联 tunnel 提示。

🤖

### 自描述协议

MEMORY_PROTOCOL（9 条规则）嵌入 MCP ServerInfo。任何 agent 连接后立刻知道怎么用——零配置。

🌍

### 多语言嵌入

model2vec-rs（BGE-M3 蒸馏）作为默认嵌入器。零原生依赖，支持中日韩英等多语言。

📦

### 单文件存储

一切数据在 ~/.mempal/palace.db（SQLite + sqlite-vec）。备份是 cp，迁移是 scp。

🔗

### 7 个 MCP 工具

status、search、ingest、delete、taxonomy、kg、tunnels。每个工具自带字段级文档。

📝

### Agent 日记

跨 session 行为学习。agent 记录 OBSERVATION / LESSON / PATTERN，未来 session 可搜索。

🔒

### 安全操作

Soft-delete + purge 两步删除。审计日志。语义去重检测。dry-run 预览模式。

## 数据流

    query → BM25 (FTS5)         → 关键词排序
          → Vector (sqlite-vec) → 语义相似度排序
          → RRF 融合 (k=60)     → 合并排序
          → Wing/Room 过滤      → 范围限定
          → Tunnel 提示         → 跨项目引用
          → 引用（drawer_id + source_file）

8.5MB
Release 二进制
95.2%
R@5 检索精度
0
原生依赖
5
导入格式