VESTIGE
/ˈvɛs.tɪdʒ/ · VESS-tij
源自拉丁语 vestīgium,指压入土地的物理足迹,也是 investigate 的直接词根(in-vestīgāre:沿足迹回溯)。
面向 AI 智能体的确定性、本地优先记忆与安全内核
无嵌入、无 LLM、无 GPU、无 API 密钥。它在 CPU 上本地运行。
为什么选择 Vestige?
罗马的追踪者读取土壤中的 vestigia,以重建曾经过的是什么、有多重、朝哪个方向移动、以及发生在多久之前。Vestige 对智能体记忆做同样的事。它在仅追加日志中记录不可变的足迹,并沿着轨迹回溯,而不是从向量空间中猜测含义。
人类记忆系统在严苛限制下解决了真值、顺序和来源问题,长达 5,000 年:Pāṇini 的 anuvṛtti 结转寄存器、isnād 见证链、安第斯的 khipu 顶绳汇总、Torrens 产权帷幕,以及考古学的 Harris 矩阵。Vestige 将这些结构性思想带入一个本地 Rust 内核。
架构
- Strata。一个仅追加、哈希链式、带签名的日志。帧携带 BLAKE3 载荷摘要与双时态有效边界(valid_from_ms、valid_until_ms)。被接纳的写入返回回执。后续声明取代先前的声明;旧事实仍留在日志上。
- FSRS-6。间隔重复调度,让未使用的噪声逐渐淡出。
- RSB(回溯显著性回填)。护城河所在。原因从不长得像症状。后续轮次可以提升更早的记忆,即使两者没有共享任何词语。显著性在写入时设定,而新的学习可以在之后将其提高或降低,这一模式在 Sheena Josselyn 的印迹研究中有所描述。在生日晚餐演示中,一条被埋没的「在 Bangkok Garden 之后感觉不对劲」的记忆,在记录下 Maya 的花生过敏后被提升,因此之后关于她生日晚餐的问题能够检索到它。
- Backfill。上游因果回溯,从一次失败或一个后续事实回溯到导致它的更早轮次。
- Rank-1 seating。对检索集施加确定性的 slot-1 规则,例如让助手回复让位于覆盖它的用户轮次,无需向量索引。
- GhostLink。将已记录的记忆两两配对,每一对都带证明。
- Operator 钩子、一次性许可与回执。npx @vestige/init --guard 安装 Operator 门禁。一次性所有者许可持续 15 分钟,被使用一次后即消耗,并停止或允许写入回执。
基准测试
这些数字衡量的是检索:正确的记忆是否落入前 k 名。它们不衡量答案准确率。它们是合并到 main 的最新分数,来自 PR 709(RSB v4,commit 5fb269b0)。运行使用本地 retrieval_bench 二进制,在 Intel Core i5-2520M 与 8 GB RAM 上,仅用 CPU,无嵌入、无 LLM、无 GPU、无 API 密钥。
| Benchmark | Level | Metric | Score |
|---|---|---|---|
| LoCoMo-10 CORE(1,536 个问题) | Turn | Exact R@1 / R@5 | 736/1536 (47.92%) / 1030/1536 (67.06%) |
| LongMemEval-S official(470 个非弃权) | Session | Any@1 / Any@5 / All@5 / NDCG@10 | 423/470 (90.00%) / 458/470 (97.45%) / 407/470 (86.60%) / 0.9229 |
| LongMemEval-S official(470 个非弃权) | Turn | Any@1 / Any@5 | 255/470 (54.26%) / 364/470 (77.45%) |
| BEAM 100K(355 个计分问题) | Turn | Any@5 / MRR | 203/355 (57.18%) / 0.4563 |
| MemoryAgentBench QA2 421K(100 个问题) | Document | All@5 | 85/100 (85.00%) |
bash benchmarks/run_all.sh
完整表格与方法说明见 benchmarks/README.md。
快速开始
npx @vestige/init --guard
这会为任意 AI 智能体设置本地二进制文件与 MCP 连接。--guard 添加 Operator 门禁。MCP 命令为 vestige-mcp:
{
"mcpServers": {
"vestige": { "command": "vestige-mcp" }
}
}
从源码构建:
git clone https://github.com/samvallad33/vestige.git
cd vestige
cargo build --release --package vestige-mcp
更多内容见 Getting started。
许可证
文章标题:Show HN: 一个用 Rust 编写、不依赖 LLM 的确定性 agent 记忆引擎
正文: 由 Sam Valladares(@samvallad33)构建。采用 AGPL-3.0 许可证。
循迹而行。