Context Vault LOCAL-FIRST
GitHub
v0.7 · 检索内核 v2 · 本地优先 · MIT 开源

换模型、换工具,
会话上下文不再清零

Context Vault 把 AI 编程会话导出为你自己机器上的中立快照:内容寻址、不可变、带谱系。双向迁移、深度检索、token 账本、双时态记忆、MCP 后端——agent 来来去去,vault 一直在。

Python 3.9+ · 纯标准库零第三方依赖 · Windows / Linux / macOS

01 · 核心能力

七个能力,一个位置

市面上的迁移工具是一次性搬运工;Context Vault 是资产库——存储、谱系、账本、审计。

快照资产库

Codex / Claude Code / ZCode / Antigravity 与 18 种桥接 harness 的会话,导出为供应商中立 context-snapshot 格式:内容寻址、不可变、幂等,自动 lineage 会话树与按天保留裁剪。

深度检索内核

代码感知分词(camelCase / snake_case / 路径 / 错误码 复合+子词双索引)× 块角色加权 BM25 × Lineage 折叠——同一演进链只回最新版命中。SQLite 紧凑倒排让千级快照索引体积降 87%,检索 P95 39ms。

双向迁移

Codex ⇄ Claude Code 双向真机验证,Antigravity 原生 .db 双向迁回,实验性 ZCode 写回。默认 dry-run,逐字段报告什么保住了、什么搬不走;另可按 token 预算产出五槽位交接简报(停靠态 / 裁决 / 已证伪死路 / 文件拓扑 / 活上下文)。

token 账本

按模型成本、缓存命中率,全部聚合自你会话文件内嵌的 usage 记录——不需要任何代理;估算会标注为估算。

双时态记忆

决策、偏好、踩坑、架构红线自动提取,每条带 快照#块 与真实时间出处。方案被推翻时旧记忆自动标记 superseded 并默认隐藏(过期记忆入侵率 0.0),--history 追溯完整演变链。

MCP 记忆后端

vault_remember 等 6 个工具,一条命令接入 Claude Code / Codex / Cursor,让任意 MCP 客户端变成"记得住的 agent"。

本地控制台

cv serve 在 127.0.0.1:8791 起一个零外部请求的 Web 工作台:概览台账、快照检索、迁移工作台、上游哨兵。

02 · 界面

与控制台同源的瑞士国际主义网格

官网与 tools/ui/console.css 内置控制台共用同一套 Swiss Grid × Signal Red 设计 Token,亮暗三态自适应。

界面示意:HTML/CSS 重绘,非截图,与内置控制台同一套设计 Token。台账数字为 README 记录的作者本机实测口径,表行数据为示意。
03 · 实测

真机验证记录

2026-10-27 ~ 11-18 本机实测;与 docs/BENCHMARK.md、benchmarks/results 同源,不挑选、不修饰。

124+测试用例 · 含冷热双路径等价
-87%千级快照索引体积(778.5 → 100.9 MiB)
39ms千级快照检索 P95(加权 BM25 + Lineage 折叠)
0.0过期记忆入侵率(双时态冲突覆盖)
162金标评测题 · 五维度消融一键复现(CodingVault-Bench)
0第三方依赖 · 纯 Python 标准库

双向迁移在 Claude Code 2.1.181 与 Codex 0.153.4 真机 resume 续写验证;桥接读 / 写各覆盖 18 种 harness 格式。CodingVault-Bench:162 题五维度金标消融(v0 词集交集 → v2 全演进链对照)随仓库开源,python benchmarks/run_bench.py 一键复现,详见 docs/BENCHMARK.md。

04 · 快速开始

三条命令跑起来

纯 Python 标准库,克隆即用;核心功能不需要任何 API key。

$ git clone https://github.com/nghqqa/context-vault
$ cd context-vault
$ python tools/cv.py doctor             # 环境体检:零依赖,Python 3.9+
$ python tools/cv.py sync               # 扫描全部本地会话源入库(增量 + lineage)
$ python tools/cv.py serve              # Web 控制台 → http://127.0.0.1:8791
$ python tools/cv.py mcp install --all  # claude / codex / cursor 一键接入 MCP

试一次迁移(默认 dry-run,不加 --apply 绝不碰真实会话目录)

$ python tools/cv.py migrate ~/.claude/transcripts/ses_xxx.jsonl --target codex  # 产物先落 vault/outbox/
$ python tools/cv.py import cv_xxxx --target codex --apply                       # --apply 才写真实目录
只读源文件 · 永不改写 只绑回环 127.0.0.1 · Host/Origin 校验 零遥测 · 零账号 · 核心 0 API key