Repository navigation
Releases
Context Vault v0.7.0 — Core v2 (检索与记忆内核升级)
Context Vault v0.7.0 — Core v2 / 检索与记忆内核升级
EN | The retrieval and memory kernel is rewritten: code-aware weighted BM25 over a compact SQLite inverted index (-87% index size at thousand-snapshot scale, P95 39ms), lineage folding so one evolving session yields one hit, temporal memory that automatically supersedes stale decisions (stale-memory intrusion 0.0), a token-budgeted five-slot handoff brief, and a fully reproducible 162-query ablation benchmark (CodingVault-Bench) shipping with the repo.
中文 | 本版重写了检索与记忆内核:代码感知加权 BM25 跑在 SQLite 紧凑倒排上(千级快照索引体积 -87%、检索 P95 39ms),Lineage 折叠让同一演进链只回一个最新版命中,双时态记忆自动覆盖过期决策(过期记忆入侵率 0.0),交接简报支持 token 预算五槽位装配,并随仓库开源 162 题可一键复现的消融基准 CodingVault-Bench。
✨ Highlights / 亮点
🔍 Deep retrieval core / 深度检索内核
- EN: code-aware tokenizer (camelCase/PascalCase/snake_case/kebab-case/paths/error-codes — composite + subword dual indexing so
VaultIndexandvault_indexfind each other, exact original writing ranks first); block-role-weighted BM25 (global IDF, length normalization, saturating snapshot aggregation kills the v0 tool_result flood); lineage folding; time decay; optional OpenAI-compatible dense rerank (CV_EMBEDDINGS_URL, off by default). - 中文:代码感知分词(复合词 + 子词双索引,精确原写法优先、跨写法照常召回);块角色加权 BM25(全局 IDF + 长度归一 + 饱和聚合,终结 v0 时代 tool_result 刷分);Lineage 折叠 + 时间衰减;可选稠密重排(缺省关闭零外发)。
- Storage / 存储: compact SQLite inverted index (
search_index.db, zlib postings, chain-first-seen block dedup) replaces the ~800MBindex_cache.pkl. Measured on 2,006 snapshots / 1.8GB: 778.5 MiB → 100.9 MiB (-87.0%), query P50 23.1ms / P95 39.0ms; first serve/tray restart after upgrade auto-migrates (old pickle removed; it is derived data and rebuilds from snapshots).
🧠 Temporal memory / 双时态记忆 (default engine v2)
- EN: five kinds (decision / preference / summary / pitfall / constraint), every item provenance-cited (snapshot#block + real session time) with topic signatures; explicit re-decisions auto-mark earlier memories
superseded— retrieval returns only currently-valid facts (stale intrusion 0.0 on the bench),--history/include_historytraces the full A→B→C chain; cross-snapshot duplicates collapse into one confidence-scored entry. - 中文:五类别提取 + 出处(快照#块 + 会话真实时间)+ 主题签名;同槽位显式推翻自动把旧记忆标记
superseded——默认检索不再回过期事实;跨快照重复摘录合并记信心。v0.1 噪音闸门误杀含代码实体决策的缺陷已修复(规则引擎 v0/v0.1 原样保留作消融基线)。
📄 Budgeted handoff brief / 预算受限交接简报
--target markdown --budget-tokens 4000: five utility slots (stop state / active decisions / disproven dead-ends / touched-file topology / live-context tail), repeated file reads and duplicate errors folded, compression stats attached. 4K budget on a >100K-token session: generated <100ms with ≥95% touched-file recall.
📊 CodingVault-Bench (open, reproducible / 公开可复现消融基准)
- 162 gold queries × 5 dimensions (single-session / multi-session / temporal update / handoff / abstention) over a seeded synthetic corpus (18 evolving chains, 3 fictional projects, zero secrets).
- Ablation (same corpus & queries, 162 gold): cross-writing retrieval R@1 0.69 (vanilla BM25) → 0.89 (v2 code-aware weighted BM25); abstention accuracy 0.46 (v0 set-overlap) → 0.92 (v2); version intrusion 0.86 → 0.0 (lineage folding); memory active recall 0.48 (v0) / 0.50 (v0.1, which false-kills 100% of technical decisions) → 0.88 with stale intrusion 0.0 (v2); handoff file-pass 0.92 (naive truncation) → 1.0 (five-slot, compression 0.42).
- One command:
python benchmarks/run_bench.py· scale probe:python benchmarks/bench_scale_local.py --vault <your vault>· details:docs/BENCHMARK.md.
🔧 Upgrade notes / 升级说明
- 自动迁移:升级后首次启动 serve/托盘会自动构建
search_index.db并移除旧index_cache.pkl(纯派生数据,可随时从快照重建)。 - 记忆:
memory_items老库自动补列迁移;要切换到 v2 提取请跑一次cv memory extract --force --engine v2(v0/v0.1 规则引擎仍可用--engine rule回溯对照)。 - MCP 工具新增
include_history参数(vault_remember);cv memory search --history同语义。 - 纯 Python 3.9+ 标准库,零第三方依赖不变;快照只读铁律不变。
✅ Verification receipts / 验证回执
- pytest 124 green(新增 33 条 v2 验收:冷热等价 / 防刷分 / 折叠 / A→B→C 推翻 / 老库迁移 / dense stub)· CI ubuntu+windows × py3.10/3.12 全绿
- 生产割接实测(2,010 快照 / 1.8GB):索引 779.8MB → 100.9MB;记忆 2,078 → 2,751 条(active 2,747 / superseded 4,全带出处)
- 割接前完整备份:
cv-backup-20261118-*.zip(533MB,随 keep=10 轮换)
Full diff: v0.6.0...v0.7.0
v0.6.0 — 现代控制台重塑 · 双向会话迁回 · 性能与裁剪
v0.6.0 发布(88 tests 通过,含控制台 JS 静态/运行回归与 Playwright 多视口渲染溢出探针):
- 🎨 现代控制台全面重塑 (
CONSOLE_HTML): 采用 Mineral Slate × Forest Teal 自适应亮暗三态主题(light-dark())、@container响应式零溢出桌面表格与移动端叠放卡片、线性 SVG 图标体系、独立工程树筛选区、可搜索双栏迁移工作台(摘要条 + 风险/恢复双栏预览)、会话时间线抽屉及原生<dialog>/ Popover 交互。新增PRODUCT.md与DESIGN.md设计规范,官网docs/site/index.html同步对比度(WCAG AA)与剪贴板反馈修复。 - 🔁 双向会话迁回与工程清理 (
Antigravity/ZCode/Codex/Claude): 新增确定性session_id导出、Antigravity 原生.db/ Proto(f1/f2 schema)双向导入导出与摘要注册(支持--dedup去重、已删工程清理与空工程 JSON 清理、严格 agent 过滤及tools/antigravity_batch.py批处理)、实验性 ZCode 写回(含自动备份);控制台暴露POST /sync、GET/POST /antigravity/sync、GET/POST /antigravity/batch与POST /migrate_project。 - ✂️ 存储裁剪与全链路性能: 新增
cv prune(按会话/按天保留快照并重连血缘)、热索引内存压降(~12x)、持久化增量索引缓存(重启耗时由3-5min降至~3s)、后台节流原子索引刷新、Windows 保留端口段动态回退与vault/serve.json服务发现。 - 📊 精确账本与血缘统计:
owned_stats仅按血缘叶节点统计避免累计快照重复计算;接入 ZCodemodel_usage账本准确统计消费量。 - ✅ 测试与 CI 加固: 测试套件从
24扩增至88 tests,补充控制台 JS 执行/单元测试(tools/check_console_js.py)与 Playwright 多视口布局溢出检查(tools/check_console_overflow.py)。
v0.5.0 — Markdown 交接简报 · serve 鉴权档 · 官网上线
面向商业化方向的三个增量 (24 tests, CI 含内嵌脚本语法检查):
- 📄 Markdown 交接简报 (新迁移档):
cv migrate <file> --target markdown生成 ≤48KB 的可携交接简报——它停在哪儿 / 最近动作 / 活上下文尾部; 精确迁移不可用或不值得时, 任何 agent 都能吃 Markdown。控制台迁移工作台同步新增该档。 - 🔑 serve 鉴权档 (可选):
cv serve --token xxx或环境变量CV_SERVE_TOKEN启用后, 所有请求需凭据 (X-Vault-Token 头 / vault_token cookie / 首访 ?token= 自动种 HttpOnly cookie)。MCP 联动读同一环境变量。默认本地回环模式完全不变——这是为局域网/远程访问商业化铺路。 - 🌐 官网落地页首版: docs/site/index.html 单文件静态页 (痛点 hero + 复制安装 + 六能力卡 + 诚实保真度表 + 隐私网格 + FAQ), 控制台同族设计语言, 对比度过 WCAG AA。
- 🧹 顺带: longxia relay 已从探测列表移除 (401 噪音源); 托盘自动入库提速至每 2 分钟 (记忆提取解耦至 ~10 分钟一轮)。
v0.4.2 — 首个发布:安全加固 + vault 备份 + 22 项测试
首个版本发布。Context Vault 把你的 AI 编程会话变成自己机器上的中立资产:19+ harness 会话自动入库 → 不可变内容寻址快照 → 双向迁移(codex ⇄ claude,真机验证过)→ token 账本 → 跨会话记忆 → MCP 记忆后端,全部本地、零第三方依赖(Python 3.9+ 纯标准库)。
本版重点
- 🔒 本地访问防护:
cv serve(127.0.0.1)对 Host/Origin 做回环白名单校验、POST 强制application/json——浏览器跨站请求(drive-by POST)与 DNS rebinding 读取被 403 拦截;本地进程(MCP 热索引联动、托盘、同源控制台)不受影响 - 💾
cv backup:vault 一致性备份——sqlite 走在线 backup API(WAL 下不撕裂、不锁常驻服务),快照/基线/水位打包为带时间戳的 zip 并轮换保留(--keep,默认 10);恢复 = 解压到空目录后--vault指向它 - 🐛 账本修复:relay billing 导入的双计入缺陷、
/stats端点 500 - ⚡ 数据完整性:sqlite WAL + busy 超时(多线程常驻与 CLI 并发不再 database is locked);快照/迁移产物/基线/水位全部原子写入(进程被杀不留截断文件)
- 🧪 测试 17 → 22:serve 防护与路由、MCP JSON-RPC 分发、"常驻只是加速不是依赖"的冷热双路径等价性、备份内容与轮换
验证回执(Verification receipts)
- 22 tests green — CI: ubuntu + windows × Python 3.10/3.12
- 冷热双路径等价测试:常驻热索引与文件扫描回退返回一致结果("常驻只是加速,不是依赖"已由测试强制执行)
- serve 防护对真实常驻实例 curl 实测:本地 200 / 恶意 Host 403 / 恶意 Origin 403 / text/plain 跨站 POST 403
- 真实 vault 在常驻服务运行中备份实测:749 快照 / 219.9 MB / 零锁冲突(sqlite 在线 backup API)
- 双向迁移双端真机验证(此前完成):Codex→Claude 2.1.181 resume 续写;Claude→Codex 0.153.4 恢复 373,160 tokens 全量上下文
- 测试套件零付费 API 调用、零账号、零遥测
快速开始
python tools/cv.py doctor # 环境体检
python tools/cv.py sync # 三源扫描自动入库 (增量 + lineage)
python tools/cv.py serve # 控制台 http://127.0.0.1:8791
python tools/cv.py mcp install --all # claude/codex/cursor 一键接入 MCP格式规范见 docs/snapshot-format.md(context-snapshot v0.1,含 txcript 六块模型互操作映射)。迁移保真度表(what survives / what cannot move)见 README。