关于 agentmemory-architecture
agentmemory 是面向编码 Agent 的本地记忆服务。本概览说明 iii 引擎、混合检索、记忆生命周期、存储方式及实时查看器。
主要功能
- 01BM25 与向量检索
- 02基于图的检索扩展
- 03记忆采集与生命周期管理
- 04本地嵌入选项
- 05实时网页查看器
适用场景
- 01了解系统架构
- 02选择检索与嵌入设置
- 03检查会话中的记忆采集
MCP 相关
agentmemory 通过 MCP 和 REST 提供记忆功能。MCP 接口见 agentmemory-mcp-tools。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/agentmemory-architecture确认已加载。
附带文件TROUBLESHOOTING.md
详细介绍
agentmemory 是面向编码 Agent 的记忆服务。它在本地运行，捕获观察结果，为其建立索引以支持混合检索，并通过 REST 和 MCP 提供这些内容。Worker Compose 会运行固定版本的 iii 引擎，以及 AgentMemory 和注册表中的 state 与 http worker。默认情况下，state worker 使用基于文件的 KV 存储，也可通过配置使用 Redis；它不是 SQLite。
iii 基元
在 iii 引擎上，一切都是函数、触发器或 worker 状态。没有单独的插件系统；worker 会注册函数（mem::*）和 HTTP 触发器（api::*），由引擎路由调用。agentmemory 不会绕过 iii；新增功能需要添加一个函数和一个触发器。
检索模型
召回会结合 BM25 关键词搜索、配置的向量相似度和图扩展。未配置嵌入提供商的全新安装可在无需 API 密钥的情况下使用 BM25。设置 EMBEDDING_PROVIDER=local 可启用设备端嵌入，这可能会下载模型；也可以配置远程提供商。LLM 压缩和摘要需要配置提供商及相关选项。
存储与生命周期
记忆包含内容、概念、文件、重要性和时间戳，并按会话分组，还可选择关联到提交。通过捕获、压缩、整合和遗忘的生命周期，可以让存储随着时间推移保持实用，避免无限增长。
端口
REST 默认使用端口 3111，查看器使用 3113，内部引擎 WebSocket 使用 49134。使用 --port <N> 或 --instance <N> 可选择其他本地运行时。
查看器
实时 Web 查看器位于 http://localhost:3113，可在会话运行时显示记忆的构建过程，并通过 REST 端口接收经过身份验证的 SSE 更新。适用于演示，也可用于确认捕获功能正常工作。
另请参阅
- agentmemory-mcp-tools 和 agentmemory-rest-api，了解各类接口。
- agentmemory-hooks，用于自动捕获。
- agentmemory-config，了解端口和功能开关。