Back to Details

agentmemory-architecture

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
agentmemory is a memory server for coding agents. It runs locally, captures observations, indexes them for hybrid retrieval, and serves them back over REST and MCP. It is built on the iii engine.
agentmemory 是面向编码Agent的内存服务器。它在本地运行，捕获观测数据，为混合检索建立索引，并通过REST和MCP提供数据服务。它基于iii engine构建。

iii primitives

iii 原语

Everything is a function, a trigger, or worker state on the iii engine. There is no separate plugin system; the worker registers functions (
mem::*
) and HTTP triggers (
api::*
) and the engine routes calls. agentmemory does not bypass iii; new capability is a new function plus a trigger.
在iii engine上，所有事物都是函数、触发器或工作器状态。没有独立的插件系统；工作器会注册函数（
mem::*
）和HTTP触发器（
api::*
），由引擎处理调用路由。agentmemory不会绕过iii engine；新增功能就是添加新函数和对应的触发器。

Retrieval model

检索模型

Recall is hybrid: BM25 keyword search plus vector similarity plus graph expansion over linked concepts. The default install needs no API key because embeddings run on-device and BM25 needs none. An LLM provider only adds richer summaries and auto-injection, both opt-in.
召回采用混合方式：BM25关键词搜索 + 向量相似度匹配 + 关联概念的图扩展。默认安装无需API密钥，因为嵌入在设备本地运行，且BM25不需要密钥。LLM提供商仅提供更丰富的摘要和自动注入功能，两者均为可选配置。

Storage and lifecycle

存储与生命周期

Memories carry content, concepts, files, importance, and timestamps, grouped into sessions and optionally linked to commits. A lifecycle of capture, compress, consolidate, and forget keeps the store useful over time rather than letting it grow unbounded.
内存包含内容、概念、文件、重要性和时间戳，按会话分组，还可选择性关联到提交记录。通过捕获、压缩、合并和遗忘的生命周期管理，确保存储库长期可用，而非无限制增长。

Ports

端口

REST is the anchor at 3111. Streams = N+1 (3112), viewer = N+2 (3113), engine = N+46023 (49134). 
--instance N
shifts the whole block by N*100.
REST服务的默认端口为3111。流服务端口为N+1（3112），查看器端口为N+2（3113），引擎端口为N+46023（49134）。使用
--instance N
参数可将整个端口块偏移N*100。

Viewer

查看器

A real-time web viewer at 
http://localhost:3113
shows memory building as sessions run. Useful for demos and for confirming capture is working.
实时Web查看器位于
http://localhost:3113
，可展示会话运行时内存的构建过程。适用于演示和确认数据捕获是否正常工作。

See also

另请参阅

  • agentmemory-mcp-tools and agentmemory-rest-api for the surfaces.
  • agentmemory-hooks for automatic capture.
  • agentmemory-config for ports and feature flags.
  • agentmemory-mcp-tools 和 agentmemory-rest-api：相关交互接口工具
  • agentmemory-hooks：自动捕获工具
  • agentmemory-config：端口与功能配置工具