agentmemory背后的iii-engine三个原语组成的新运行时【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemoryagentmemory 是一个为 AI 编程智能体打造的持久化记忆系统它让 Claude Code、Cursor、Codex 等编码智能体过目不忘。而它的全部魔法来自底层 iii-engine 提供的三个原语Worker、Function、Trigger。没有 Postgres、没有 Redis、没有 Express——一个进程就装下了整个记忆运行时。为什么记忆系统需要新运行时传统的做法是给一个记忆服务搭一整套技术栈Express 管 HTTP、SQLite 管存储、pm2 管进程、Prometheus 管监控……组件越多维护成本越高。agentmemory 选择了另一条路。官方架构规则写得很直接Everything goes throughregisterFunction/registerTrigger/sdk.trigger()— never bypass iii-engine. —— AGENTS.md意思是所有能力都是 iii-engine 上的一个函数、一个触发器或一段 Worker 状态绝不绕开引擎。184 个源文件、约 4.2 万行代码、264 个函数、50 个 KV 作用域全部跑在三个原语之上。上图是 iii 的开发者控制台Developer Console左侧导航的Workers / Functions / Triggers / States / Streams五个入口正是理解这套运行时的钥匙。三个原语Worker、Function、Trigger1️⃣ Worker可独立运行的能力单元Worker 是 iii-engine 里最小的自治进程。agentmemory 本身就是一个 worker通过 WebSocket 连接 iii-engine端口 49134状态由 iii-state worker 以文件形式持久化到./data/state_store.db基于 SQLite见 AGENTS.md 的架构说明。关键能力在于组合一条命令iii worker add就能给 agentmemory 叠加全新能力无需重装、无需新容器一条命令得到的能力iii worker add iii-cron定时记忆整合、衰减扫描、快照轮转iii worker add iii-pubsub多实例同步每次写入自动扇出到所有实例iii worker add iii-queue嵌入/压缩任务的持久化重试iii worker add iii-observability每次记忆操作的 OTEL 追踪完整清单见 README.md 的 Extend agentmemory with one command 一节。2️⃣ Function记忆操作的最小执行单元agentmemory 把每个记忆操作注册成一个命名函数统一以mem::前缀如mem::your-function。函数内部只做三件事读写 KV 状态、执行逻辑、写审计日志。REST 端点api::前缀和 MCP 工具都只是薄薄一层转发最终都调用sdk.trigger()触发对应的 mem 函数——这个模式在 src/index.ts 中大量出现REST 端点的注册则集中在 src/triggers/api.ts。对用户的实际意义你看到的54 个 MCP 工具、130 个 REST 端点本质上是同一批函数在不同门面上的投影。3️⃣ Trigger事件到函数的自动路由Trigger 负责谁在什么条件下调用哪个函数。以 HTTP 触发器为例api::your-endpoint函数绑定一条路径如/agentmemory/your-path和 HTTP 方法后引擎自动完成路由——这就是为什么 agentmemory 不需要 Express.jsHTTP 触发器本身就是 Web 框架同理iii-stream 用 WebSocket 替代了 SSE/Socket.io。上图展示了 iii-state 提供的键值状态视图——每个 KV group 就像一张可查询的表。agentmemory 的 50 个 KV 作用域记忆、会话、审计、快照……全部托管在这里这就是它宣称0 外部数据库的原因。iii 替代了什么一张表看懂传统技术栈agentmemory 的 iii 方案Express.js / Fastifyiii HTTP TriggersSQLite / Postgres pgvectoriii KV State 内存向量索引SSE / Socket.ioiii StreamsWebSocketpm2 / systemdiii 引擎内置的 worker 守护Prometheus / Grafanaiii OTEL 健康监控自定义插件系统iii worker add name最妙的是最后一行插件系统本身就是 iii。想扩展 agentmemory不是装插件而是加一个 worker。上图是 OTEL 追踪瀑布图每一次sdk.trigger()的调用耗时、调用树、服务归属都清晰可见由 iii-observability worker 默认开启配置就在 iii-config.yaml 中。新手如何跑起来三步体验安装npx agentmemory/agentmemory首次运行会交互式地选择要接入的智能体、LLM 提供方并启动记忆服务器默认端口 3111。验证召回agentmemory demo --serve种子会话入库后立刻看混合检索BM25 向量 知识图谱如何命中。打开实时查看器访问http://localhost:3113亲眼看着记忆在会话中生长出来。写在最后对新手而言agentmemory 最有价值的地方不只是让 AI 记住你的项目而是它示范了一种极简运行时哲学一个进程、三个原语替代一整套基础设施。当你理解了 Worker / Function / Trigger 的组合方式就不难看懂为什么 1674 个测试、264 个函数能如此紧凑地组织在一起。想深入架构细节推荐从 plugin/skills/agentmemory-architecture/SKILL.md 和 src/functions/ 目录读起——那里正是 20 多个记忆生命周期函数observe、consolidate、search、evict…的家。【免费下载链接】agentmemory#1 Persistent memory for AI coding agents based on real-world benchmarks项目地址: https://gitcode.com/GitHub_Trending/age/agentmemory创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
