vantagrid-memory-v5
"VantaGrid (v5.7.1) - Agent 记忆领域的 V12 发动机 | 确定性结晶 + 控制论降解 + 意图路由"
Install
npx skillscat add groaries/agent-memory-dna-v51 Install via the SkillsCat registry.
SKILL.md
🕸️ VantaGrid (暗格矩阵) v5.7.1 "Agent-Readable Crystallization"
The VantaGrid Protocol — Agent 的确定性世界模型与决策中枢
🏎️ Agent 记忆领域的 V12 发动机 — 不靠堆砌上下文，靠确定性结构与控制论代谢，实现 O(1) 极速寻址与 0% 传话失真。
就像特斯拉的占用网络 (Occupancy Network) 过滤视觉幻觉；
VantaGrid 通过体素化感知过滤语义噪声——只保留“存在”的事实。
v5.7.0 实现结晶自动解压 (Auto-Expansion) 与控制论降解，打通「记忆->智能」的任督二脉。
📜 设计理念：从「被动检索」到「主动感知」
VantaGrid 是 Agent 的感知与认知进化。它不再依赖模糊的语义搜索，而是通过体素网格构建世界模型。
- v5.1 (基石): 赋予了系统「感知世界」的能力 (Voxel, Shadow)。
- v5.2.1 (优化): 赋予了系统「按需感知」的能力 (Intent Router)。
- v5.3.0 (进化): 赋予了系统「对抗熵增」的能力 (Digital Metabolism)。
- v5.4.0 (觉醒): 赋予了系统「知识结晶」与「多谋善断」的能力 (Synapse & Resonance)。
- v5.5.0 (通用化): 实现了「配置驱动架构」 (Configuration-Driven Architecture)，彻底剥离硬编码。
- v5.6.0 (通用皮层): 引入了**「动力学体素协议 (Kinematic Voxel Protocol)」**，赋予系统运动学感知与受控涌现能力。
- v5.7.0 (可读结晶): 引入**「内容自动展开 (Auto-Expansion)」与「无效结晶降解」**，实现高频记忆的 Agent 直读与系统自愈。
| 维度 | v5.1 (静态感知) | v5.3.0 (代谢) | v5.6.0 (当前) |
|---|---|---|---|
| 上下文注入 | 固定加载全局体素 (~66 Tokens) | 引力加权 + 动态切片 | 意图路由 + 占据过滤 (~41 Tokens avg) |
| 领域适应 | 偏向单一领域 | 多领域自适应 + 免疫排毒 | 通用策略共振 (交易/编程/生活) |
| 资源效率 | 恒定消耗 | 动态平衡 (Homeostasis) | 指数级压缩 (vs v4.0 -99.8%) |
| 决策边界 | 软性加权 | 冲突消解 | 配置化约束 (JSON Rules) |
| 代码架构 | 硬编码逻辑 | 硬编码逻辑 | 数据与逻辑分离 (Data-Code Decoupling) |
📊 Token 效率与动态消耗实测 (766 节点基准)
测试环境: 766 个 L1 节点 (memory: 607, trade: 59, strategy: 27, config: 56, bugfix: 13, rule: 4)
测试脚本:bin/benchmark_token_usage.py
跨版本对比
| 系统架构 | 检索方式 | 单次决策 Token (avg) | 综合评分 | 等级 |
|---|---|---|---|---|
| v5.6.0 (当前) | 意图路由 + 占据过滤 + 概念结晶 | ~41 | 99.5 | 🏆 |
| v5.3.0 (代谢+引力) | 引力加权 + 动态切片 | ~259 | 92.0 | ✅ |
| v5.1 (静态体素) | 固定全局体素 | ~66 | 89.0 | ✅ |
| 主流方案 | 最近 10 + Top-5 向量 | ~795 | 85.4 | ✅ |
| v4.0 (旧版) | 全量 Dump | ~30,500 | 48.0 | ❌ |
分场景实测
| 场景 | v4.0 | v5.1 | v5.3 | v5.6.0 | vs v4.0 📉 | vs v5.3 📉 |
|---|---|---|---|---|---|---|
| 🔴 交易决策 | ~30,500 | ~66 | ~605 | ~92 | -99.7% | -84.8% |
| 🟡 系统维护 | ~30,500 | ~66 | ~190 | ~26 | -99.9% | -86.3% |
| 🔵 代码开发 | ~30,500 | ~66 | ~120 | ~26 | -99.9% | -78.3% |
| ⚪ 日常闲聊 | ~30,500 | ~66 | ~120 | ~22 | -99.9% | -81.7% |
| 平均 | ~30,500 | ~66 | ~259 | ~41 | -99.8% | -82.0% |
结论: 从「把整本字典扔给 LLM」进化到「只给它需要的那一行」。
🧘 设计哲学：缘起 vs 预设
"缘起性空 — 一切现象因缘和合而生，无独立自性。"
VantaGrid 与主流 Agent 记忆系统 (如 Honcho/Hermes) 存在根本分歧：
| 维度 | 预设建模派 (Honcho) | 缘起生长派 (VantaGrid) |
|---|---|---|
| 核心理念 | "用 LLM 辩证对话，主动构建用户画像" | "用户去用，系统自然生长出适配结构" |
| 实现方式 | 定期 LLM 对话 + 辩证摘要 + 向量画像 | 体素占据 + 控制论降解 + 结晶自发形成 |
| 幻觉风险 | ⚠️ LLM 摘要可能扭曲用户偏好 | ✅ 只记录确定性事实，零幻觉 |
| Token 成本 | 每次检索烧数百 token | ~19 tokens (交易决策)，-99.9% 压缩 |
第一性原理：用户的偏好不是"设计"出来的，是"用"出来的。
系统不需要"理解"你，它只需要"记录"你，然后让结构自然浮现 — 就像河流不需要规划自己的河道。
🏗️ 架构全景 (Architecture)
┌────────────────────────────────────────────────────────────┐
│ L4: 观测层 (OBSERVER / WORLD MODEL) — 始于 v5.1, 进化于 v5.6.0 │
│ ┌────────────────────────────────────────────────────────┐│
│ │ [v5.5.0] 🧠 Resonance Engine (配置驱动决策) [OPTIMIZED]││
│ │ - 架构升级：规则 JSON 化 / 通用匹配器 / 动态约束注入 ││
│ └──────────────────────────────┬─────────────────────────┘│
│ ┌──────────────────────────────▼─────────────────────────┐│
│ │ [v5.4.0] 🕸️ Synapse Manager (联想突触) [NEW] ││
│ │ - 知识压缩：高频共现节点结晶为"元节点" (Meta-Node) ││
│ └──────────────────────────────┬─────────────────────────┘│
│ ┌──────────────────────────────▼─────────────────────────┐│
│ │ [v5.2.1] 🧭 Intent Router (意图路由) ││
│ │ - 识别意图 (TRADING / CODING / SYSTEM) ││
│ │ - 动态加载对应体素组 (Dynamic Slicing) ││
│ └──────────────────────────────┬─────────────────────────┘│
│ ┌──────────────────────────────▼─────────────────────────┐│
│ │ [v5.3.0] 🌿 Metabolizer (新陈代谢) ││
│ │ - 对抗熵增：粉碎死节点 (Energy < 0) ││
│ └──────────────────────────────┬─────────────────────────┘│
│ ┌──────────────────────────────▼─────────────────────────┐│
│ │ [v5.1] 🧠 Voxel Engine (语义体素) ││
│ │ - 聚合离散 L1 节点 (引力加权) ││
│ │ [v5.1] 🛡️ Shadow Genome (影子基因组) ││
│ │ - 变更规则前进行历史回放仿真 (零风险验证) ││
│ └────────────────────────────────────────────────────────┘│
├────────────────────────────────────────────────────────────┤
│ L0: 核心基因组 (CORE GENOME) — 永久只读 │
│ [GenomeCore] 独占 genome/ 目录，冲突拦截 │
├────────────────────────────────────────────────────────────┤
│ L1: 原子节点层 (ATOMIC NODES) — 事实锚点 │
│ [NodeManager] 唯一 ID 分配 (TYPE-YYYYMMDD-SEQ) │
├────────────────────────────────────────────────────────────┤
│ L2: 图谱关联层 (EXPLICIT EDGES) — 逻辑网络 │
│ [GraphEngine] 显式边管理，路径查询 │
├────────────────────────────────────────────────────────────┤
│ L3: 事件溯源层 (EVENT LOG) — 全链路审计 │
│ [EventLogger] Append-Only JSONL 日志 │
└────────────────────────────────────────────────────────────┘🛠️ 核心模块
| 模块 | 文件名 | 职责 | 版本 |
|---|---|---|---|
| Resonance Engine | bin/resonance_engine.py |
L4: 通用决策中枢 (配置驱动/动态约束) | ✅ v5.5.0 |
| Node Manager | bin/node_manager.py |
L1: 结晶节点管理与自动解压 (expand_node) |
✅ v5.7.0 |
| Agent Loop | bin/agent_loop.py |
L4: 智能注入入口，感知阶段自动解压结晶内容 | ✅ v5.7.0 |
| Synapse Manager | bin/synapse_manager.py |
L4: 联想突触与概念结晶 (Meta-Node) | ✅ v5.4.0 |
| Metabolizer | bin/metabolizer.py |
L4: 数字新陈代谢 (能量衰减/熵减粉碎) | ✅ v5.3.0 |
| Intent Router | bin/intent_router.py |
L4: 意图识别与动态体素切片路由 | ✅ v5.2.1 |
| Dynamic Voxel | bin/dynamic_voxel.py |
L4: 动力学体素协议 (占据+运动学) | ✅ v5.6.0 |
| Agent Loop | bin/agent_loop.py |
L4: 智能注入入口，集成共振与路由 | ✅ v5.2 |
| Voxel Engine | bin/voxel_engine.py |
L4: 聚合离散节点，生成语义体素 | ✅ v5.1 |
| Shadow Genome | bin/shadow_genome.py |
L4: 规则变更仿真与历史回放 | ✅ v5.1 |
| Verify System | bin/verify_system.py |
工具: 系统层级完整性验证 | ✅ v5.4 |
| Auto Maintenance | bin/auto_maintenance.py |
工具: 自动维护/心跳巡检 | ✅ v5.1 |
🛡️ 鲁棒性审计 (MRS)
MRS (Memory Robustness Score) 是 VantaGrid 系统的发布标准。
- 测试工具: 独立部署于
skills/agent-memory-robustness-auditor。 - 测试内容: 图谱翻转、时序错乱、节点物理删除、JSON 截断、结晶完整性 (v5.4)、共振一致性 (v5.4)、动力学体素占据过滤 (v5.6.0)。
- 当前得分 (v5.6.0): 🏆 100.0 / 100 (EXCELLENT)。
🔍 系统层级验证报告 (v5.6.0 实时检测)
验证时间: 2026-04-13 | 状态: ✅ 全通过 (PASSED)
| 检测项 | 结果 | 说明 |
|---|---|---|
| L0 基因组完整性 | ✅ | genome_core.py 正常加载，只读规则无损 |
| L1 节点完整性 | ✅ | 766 个原子节点在线 |
| L2 图谱连通性 | ✅ | 显式边有效，路径查询无断裂 |
| L3 事件溯源 | ✅ | events.jsonl 正常追加，审计链路完整 |
| L3.5 代谢连通性 | ✅ | metabolizer.py 成功扫描 L1，无死节点 |
| L4 体素连通性 | ✅ | voxel_engine.py 聚合正常，MARKET/PERFORMANCE 在线 |
| L4 动态体素网格 | ✅ | dynamic_voxel.py 占据过滤/运动学状态验证通过 |
| L4 意图路由 | ✅ | TRADING/CODING/SYSTEM/GENERAL 全通过 |
| L4 共振连通性 | ✅ | resonance_engine.py 环境感知与冲突消解正常 |
| L4 突触连通性 | ✅ | synapse_manager.py 共现分析与结晶逻辑验证通过 |
🚀 系统当前状态
| 组件 | 状态 | 详情 |
|---|---|---|
| L0 基因组 | ✅ HEALTHY | 只读规则集 (永久保护) |
| L1 节点 | ✅ HEALTHY | 766 个原子节点 (持续积累中) |
| L2 图谱 | ✅ HEALTHY | 显式边有效，零断裂 |
| L3 事件日志 | ✅ HEALTHY | Append-Only 溯源完整 |
| L3.5 代谢层 | ✅ HEALTHY | 新陈代谢引擎在线 |
| L4 观测层 | ✅ HEALTHY | Dynamic Voxel + Resonance + Synapse + Intent Router 在线 |
| MRS 评分 | 🏆 100.0/100 | 连续多版本满分通过 |
| 实测基准 | ✅ 通过 | 766 节点 / 4 场景实测 / 跨 6 版本对比 / Token -99.8% vs v4.0 |
📋 快速开始
# 1. 安装依赖
pip install networkx>=3.0
# 2. 系统层级自检 (推荐)
python bin/verify_system.py
# 3. 运行 Agent 主循环 (含 Token 实测)
python bin/agent_loop.py
# 4. Token 效能实测 (跨版本对比)
python bin/benchmark_token_usage.py
# 5. 影子模式测试 (规则变更模拟)
python bin/memory_cli.py genome simulate --rule "max_daily_trades=10"版本: 5.7.0 (Agent-Readable Crystallization)
最后更新: 2026-04-13
维护者: Atlas (阿特拉斯)
GitHub: https://github.com/GroAries/agent-memory-dna-v51