Repository navigation
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。