agentmemory：解决编码代理记忆难题，多特性优势显著，还支持多方面扩展与开发

核心特性

编码代理通常会话结束后遗忘信息，用户需重新介绍技术栈，而 agentmemory 基于 iii 引擎构建，为多种客户端提供持久内存，解决此问题。其核心特性包括自动记忆与上下文注入、多代理支持、高效检索与成本节约、会话回放、多语言与多平台支持。例如自动记忆与上下文注入能让代理记住之前会话设置，无需重新解释；在 Retrieval Accuracy 测试中表现出色，还能显著节省令牌成本。

技术细节

agentmemory 的技术细节包含记忆管道、4 层记忆整合、检索方式和嵌入提供者。记忆管道通过 PostToolUse 钩子触发，经过多步骤最终在 BM25 和向量中索引；4 层记忆整合受人类大脑启发，记忆会随时间衰减等；检索方式采用三重流检索并融合；支持多种嵌入提供者。

工具与资源

提供 51 个工具，包括核心工具和扩展工具，满足不同记忆管理需求；还有 6 个资源和 3 个提示，以及 4 个技能用于搜索记忆、保存到长期记忆等操作。

安装与配置

启动服务器使用 `npx @agentmemory/agentmemory`，不同代理有不同集成方式，一般需在配置文件添加 MCP 服务器配置信息，Windows 用户有多种安装方式可选。

诊断与维护

若 `npx @agentmemory/agentmemory` 失败，可用 `--verbose` 选项查看引擎错误信息，常见失败模式包括引擎启动失败、端口冲突等。使用 `npx @agentmemory/agentmemory upgrade` 命令更新本地运行时，但可能会修改工作区和更新依赖项等。

扩展功能

通过 `iii worker add` 命令可为 agentmemory 添加新功能，如实现多实例内存同步、定期生命周期管理、持久重试等。

环境变量配置

可在 `~/.agentmemory/.env` 文件中配置环境变量，涵盖 LLM 提供者、嵌入提供者等多方面。

REST API

在端口 3111 上有 107 个端点，默认绑定到 127.0.0.1，受保护端点和网状同步端点有相应认证要求，关键端点包括健康检查和混合搜索等。

开发与测试

开发使用 `npm run dev` 进行热重载开发，构建使用 `npm run build` 进行生产构建，测试使用 `npm test` 运行 800 个测试（约 1.7s），使用 `npm run test:integration` 进行 API 测试（需运行服务）。

前提条件

使用 agentmemory 需要 Node.js >= 20，以及 iii - engine 或 Docker，遵循 Apache - 2.0 许可证。