agentmemory 是面向编码代理的本地记忆服务器，负责捕获观察结果、建立混合检索索引，并通过 REST 和 MCP 返回。它构建在 iii 引擎之上。
iii 原语：在 iii 引擎中一切皆为函数、触发器或工作器状态，没有独立的插件系统。工作器注册函数（mem::）与 HTTP 触发器（api::），由引擎进行路由；agentmemory 不绕过 iii，新增能力即新增函数加触发器。
检索模型：召回结合 BM25 关键词搜索与已配置的向量相似度及图扩展。未配置嵌入提供方的干净安装仅使用 BM25，无需 API 密钥。设置 EMBEDDING_PROVIDER=local 可启用设备端嵌入（可能需下载模型），也可配置远程提供方。LLM 压缩与摘要需要配置提供方及相应选项。
存储与生命周期：记忆包含内容、概念、文件、重要性和时间戳，按会话分组，可选关联到提交。捕获、压缩、整合、遗忘的生命周期让存储长期保持可用，而非无限增长。
端口：REST 为锚点 3111；流为 N+1（3112），查看器为 N+2（3113），引擎为 N+46023（49134）。--instance N 将整个端口块偏移 N*100。
查看器：位于 http://localhost:3113 的实时 Web 查看器可在会话运行时展示记忆的构建过程，适合演示以及确认捕获是否正常工作。
相关条目：agentmemory-mcp-tools 与 agentmemory-rest-api 介绍对外接口，agentmemory-hooks 介绍自动捕获，agentmemory-config 介绍端口与功能开关。