开源 · MCP 原生 · Rust

给 AI Agent
装上长期记忆

NylonME 把记忆建模为多股记忆丝编织成的结构体,而不是简单的事件列表或相似度索引。 从种子节点出发,在网状记忆图上按关联强度、情境匹配与实时张力扩散激活,让 Agent 真正想起该想起的。

两分钟接入阅读文档查看源码
86.0%LoCoMo recall@10
82.9%LoCoMo 端到端问答
99%LongMemEval-S any-hit
83.0%LongMemEval-S 端到端

Why NylonME

记忆不是检索,是共振

现有记忆系统往往把记忆当成扁平的文本块,用 top-k 相似度找回。NylonME 把记忆织成一张活着的网络, 写入时理解、空闲时反思、检索时沿边扩散相互印证。

多股记忆丝

一条记忆不是一句话,而是事实、情感、时序、关系、置信与频次多股丝线的编织体。写入时理解,检索时共振。

网状记忆图

记忆节点以加权边连成网络而非层级树。关系不是静态标签,而是会在每一次编织中增强、衰减和重连。

情境共振检索

从种子节点出发,按关联强度、情境匹配与实时张力扩散激活,并用全局激活预算阻止高扇出节点爆炸。

张力遗忘

不再使用的记忆会沿张力遗忘曲线自然沉降,而不是无限堆积。高频、高共识和高情感的记忆则被保留。

双层写入

理解层在写入侧:LLM 是记忆的编译器,把原始会话编译成可检索的事实层,与叶子层原文共存互补。

异步反思

像人脑在睡眠中巩固记忆:空闲时自动做世界知识桥接与画像推断;最新全量评测 LoCoMo 召回 86.0%。

Memory Graph

从当前情境出发,扩散到相关记忆

检索从种子节点开始,沿加权边扩散激活。当前情境越匹配、关系越强、张力越高,被激活的概率越大。

当前情境项目约束相似事实时间线关系网络高张力记忆

Integrations

五种方式,接进你的 Agent

单机内嵌、零二进制 HTTP、多机共享桥接、直接调 SDK,甚至跑在手机 App 进程里——同一个引擎,同一条写路径。

MCP stdio

nylon-engine mcp 引擎内嵌在进程里,不开端口、不起守护进程,一段配置接入所有 MCP 客户端。

/mcp HTTP 端点

客户端零二进制:引擎常驻后暴露 Streamable HTTP MCP 端点,一个 URL + API key 即接入。

远程桥接

设一个 NYLON_SERVER,多台机器、多个 IDE 共享同一份记忆库,客户端进程零数据。

SDK 与生态集成

Python SDK(nylon-sdk)、LangChain / LlamaIndex 检索器、DSH 插件、gRPC 契约全开放。

手机进程内运行

nylon-mobile 以 UniFFI 绑定跑在 Android / iOS App 进程里——不开端口、不走网络,记忆完全留在端上。

On-Device

同一套引擎,跑进手机里

nylon-mobile 把与服务端完全一致的编织 / 共振 / 检索实现(共享 nylon-service 核心)编译进 Android / iOS App——无守护进程、无端口、 无网络请求,记忆数据不出设备。UniFFI 自动生成 Kotlin / Swift 绑定。

~55µs真机单次共振(词面通道)
24MB端上量化语义模型
8/8中文查询真机 top-1 命中
0网络请求 · 纯端上

可选端上语义通道:bge-small-zh 量化 ONNX + tract 纯 Rust 推理,纯语义探针 「家里养了宠物吗」与目标记忆零字面重叠也能正确命中。WAL-first 写入 + 自动 checkpoint(默认 32 写 / 300s),进程被杀不丢数据; onStop → checkpoint、onDestroy → shutdown 两行挂接即完成生命周期管理。详见文档 · 移动端 SDK。

Web Console

内置 Web 控制台,零安装

引擎二进制自带控制台与 REST API(默认 http://127.0.0.1:50052):浏览记忆(实时张力)、 调试共振查询、手工编织入库,深色 / 浅色主题与中英文界面随你切。

六个视图各管一件事:总览(引擎统计、最新记忆、活动流、张力分布直方图)、记忆、 图谱(力导向记忆网络图)、共振(带一键回答质量反馈条,驱动空闲反思)、 编织(单条 + 会话批量)、审计。节点抽屉里还能直接遗忘一条记忆。

NylonME Web 控制台:总览仪表盘

Quick Start

一条 MCP 配置,接进你的 Agent

nylon-engine mcp 通过 stdio 提供 Model Context Protocol,引擎内嵌在进程里, 不需要守护进程、不开端口,数据自动落到 ~/.nylonme/data。

json
{
  "mcpServers": {
    "nylonme": {
      "command": "/path/to/nylon-engine",
      "args": ["mcp"],
      "env": { "NYLON_OWNER": "my-project" }
    }
  }
}

想先跑起来看看?没有 Docker 也能装——Windows 用户从 Releases 下个压缩包解压即用; 有 Docker 的话一条命令还能顺带拉起 ollama 嵌入模型:

shell
# 方式一(推荐):免 Docker,Windows / macOS / Linux 都行
# 从 GitHub Releases 下载 nylonme-windows-x64.zip,解压后:
nylon-engine.exe serve 127.0.0.1:50051
start http://127.0.0.1:50052
# 不需要 Rust 工具链、不需要 key——单机默认开放模式,开箱即用
shell
# 方式二:Docker(顺带拉起 ollama 嵌入模型,获得语义召回)
git clone https://github.com/nylon-memory/NylonME.git
cd NylonME
docker compose -f docker-compose.prebuilt.yml up -d
# 引擎 gRPC :50051 · Web 控制台 / REST / /mcp 都在 :50052
# 打开 http://localhost:50052 开始浏览你的第一份记忆

Architecture

九个 crate,各司其职

引擎是一个 Rust workspace,从记忆丝数据模型到 gRPC / HTTP 服务化,模块边界清晰。 外围还有 proto 契约、sdk/python、integrations、plugins 与 helm 部署图表。

nylon-core

记忆丝数据模型 + 张力遗忘曲线

nylon-graph

CSR 主图 + Delta 缓冲 + 共振遍历

nylon-vector

HNSW 向量索引,语义召回

nylon-embed

ollama / OpenAI 兼容嵌入客户端

nylon-llm

理解层:事实编织、冲突检测

nylon-storage

RocksDB 持久化,WAL + 崩溃恢复

nylon-service

服务端 / 移动端共享核心

nylon-engine

引擎入口 + gRPC / HTTP 服务

nylon-mobile

UniFFI 绑定:Android / iOS 进程内引擎

调参旋钮

变量默认值作用
NYLON_MAX_SEEDS20种子集大小上限(词面 + 向量双通道)
NYLON_RERANK_VEC0查询向量余弦相似度混入共振排序的权重
NYLON_WORLD_BRIDGES_ASYNC关异步反思:常识世界知识桥接
NYLON_PERSONA_REFLECT关异步反思中的画像节点抽取
NYLON_SESSION_DEDUP关weave_session 同原文复用既有节点,重试/回灌安全
NYLON_HTTP_ADDR127.0.0.1:50052Web 控制台 / REST / /mcp 监听地址(off 关闭)
NYLON_CHECKPOINT_SECS600周期快照间隔(秒,0 关闭)
NYLON_API_KEYS_FILE—API key 表文件,设置后启用鉴权(热加载)

LoCoMo Benchmark

86.0%,不是从一个指标里挑出来的

全量 10 会话语料、1536 个可答 QA,词面与向量融合检索。每一层实验都带来了可以解释的提升。

47.1%词面基线
70.6%向量种子 + 图扩散
79.2%双层写入
84.6%查询向量重排
85.4%异步常识反思
86.0%最新全量复测

分类召回:多跳 82.3% · 时序 89.1% · 单跳 89.1% · 常识 58.7%。 端到端问答(LLM 基于检索证据作答,裁判判定):论文口径 82.9% (同一编织库与作答模型:76.4% → 反弃答提示词 80.1% → 作答上下文加宽 82.9%)。

第二套基准 LongMemEval-S(100 实例切片):证据召回 any-hit 99%, 端到端 83.0%。作答上下文从 Top-10 加宽到 Top-15 带来 +5pp, 同一机制在 LoCoMo 复现 +2.8pp——方法在仓库 docs/ 的两份评测报告里完整公开。

Enterprise Ready

从个人玩具,到团队共享

一个常驻引擎服务整个团队:租户隔离、三档鉴权、审计事件流与快照备份,全部已在生产环境跑着我们自己的记忆。

多租户隔离

租户 × owner 二维命名空间,跨租户读取与"节点不存在"无法区分,隔离在引擎内核强制。

API key 三档鉴权

read < write < admin 三档权限,key 表热加载,keys add / list / revoke 一条命令发 key。

审计事件流

NYLON_AUDIT 开启后记录谁在用、谁在刷,GET /v1/audit 随时查询。

快照与备份

周期 checkpoint + WAL 截断,支持热备份与恢复演练,生产部署有据可查。

Docker Compose 一键部署,Helm chart 直上 Kubernetes。

Roadmap

从能跑,到能被广泛接入

引擎能力 · 已完成

从词面基线 47.1% 一路实验到召回 86.0% / 问答 82.9%,每一步都有可解释的提升与可复现的评测脚本。

  • WeaveSession 双层写入
  • 混合种子 + 自适应联想深度
  • 查询向量重排 + 异步反思

生产化 · 已完成

REST/OpenAPI 与 Web 控制台、Python SDK、框架集成,到多租户、鉴权、审计、备份与一键部署。

  • REST / 控制台 / SDK / 集成
  • 多租户 + API key + 审计 + 快照
  • Docker / Helm / DSH 插件 / 手机端

下一步

继续压榨召回上限,并为记忆模型积累学术与工程背书。

  • 交叉编码器 reranker
  • 百万节点内存 profiling
  • 论文与博客系列

现在就把记忆还给你的 Agent

下载预编译二进制,加一段 MCP 配置,两分钟后你的 Agent 会开始记得你。

开始使用