Skip to content

v0.4.2 — 首个发布:安全加固 + vault 备份 + 22 项测试

Choose a tag to compare

@nghqqa nghqqa released this 29 Oct 15:05
· 76 commits to main since this release

首个版本发布。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。