@ai-agent-forge/plugin-memory

中文文档
0.88.28发布于 2026/11/02MITTypeScriptES Module近 30 天下载 4937

代理 Forge (Memory write/ recall/ list/forget) 的第一当事方内存能力插件

中文使用文档
文档目录4 节
  1. 库面对插件条目
  2. 捆绑模块
  3. 身份
  4. 能力

@ agent-forge/plugin-memory (英语)

代理 Forge 的第一当事方内存能力插件: memory_write 编号 : memory_recall 编号 : memory_list 编号 : memory_forget 编号 : memory_enable 模型面额 从主机嵌入式内置中提取的 M5 记忆基金会 能力(D-075 S4,第四批).

库面对插件条目

  • createMemoryCapability(api, context, override?) ——明确内容 用于嵌入和试验的工厂。 代理目录、 解析模式、 经验教训 设置、存储组件和仅测试的向量覆盖被注入 当然.
  • createCapabilityWithVectorComponents(api, context, override) ——只测试 利用能力(登记清单加上矢量/增强能力状态) 钩子),为定型模拟门.
  • ./dist/entry.js (默认导出) —— 显示装入的插件厂. 这个 将主机服务映射到同一上下文 :
    • api.host.agentDir • 分类根 <agentDir>/memory/ + 代理目录 配置频道 <agentDir>/capabilities/builtin.memory.json
    • api.host.memoryStorage + A1/A2 存储注入面 (单位:千美元)MemoryStorageComponentsV1);缺 = 本地执行
    • 模式分辨率再利用 resolveMemoryMode: 配置 memoryMode (主持人) 与主机剪接批次相接的重叠接线地) • env AGENT_FORGE_MEMORY_MODE (在条目中阅读) • 配置 memorySettingsMode / 遗产别名 / 轻 (自 ; 无效值无法关闭到 off(中文(简体) )
    • 解决模式 off持续拒绝同意 (单位:千美元)memoryConsent: "declined" 在代理目录配置中抑制 默认分级),或没有主机 agentDir 无注册( 一个调试) 日志行; 工厂从不为已禁用的配置投放)
    • 模型下载在背景中运行(主机预热通过 memory_enable(三); memoryConsent 和坚持 memorySettingsMode 预设在代理目录配置通道中,并且是 撰写人: /memory 命令脸
    • vectorComponents 不搭乘条目——它是库/测试面孔 仅(决定性模拟门)

配置频道: 主机声明 api.host.agentDir 起来 <agentDir>/capabilities/builtin.memory.json 合并在明显的配置之上 (缺少文件 = 未配置; 无法读取/无效 JSON 失败插件负载).

捆绑模块

29个基础/语义模块(目录原子+存储+耐用分类账, 候选机器,生命周期,排程器 +排程器-api 外观,校正, 续作,召回代理/索引/包装, egress 政策,内存网络, 优先解决者/分歧者/生命周期/促进、清洗门/期刊、, 套接字外观, 传输 + 向上显示器, 向量索引, 嵌入 提供者/调整者, 写预算, 代码记忆, 助理优先卡)和 确定性内存 testkit 生活在此套件中并被再导出 从索引。 记忆公共合同(奇异原子家族, 储存/铅管/水管接合器, MemoryStorageComponentsV1, (中文(简体) ), MEMORY_RECALL_TOOL_NAME)来自 @agent-forge/plugin-sdk。 。 。 .

重跑时间依赖性保持懒惰 : @lancedb/lancedb 财务报告和审定财务报表 @huggingface/transformers 通过动态加载 import() 只有内部 矢量通道启用路径——默认 light 模式(向导频道) 继续禁用直到 memory_enable 同意),模式 off和纯洁 存储/引导路径从不碰它们.

本地装配失败和插件卸载会释放本实例的模型与索引。已进入的原生推理先完成再释放 * STERR, API 某一资源或诊断输出失败不会阻断其他资源释放。 变压器 4.3.0 尚不提供逐调用下载取消, 卸载后只阻止新推理与后续重试 晚到加载会释放而不会发布通道。共享推理服务的模型由服务进程持有,会话卸载只断开客户端。。 成功缓存不删除,非空权重和手工导入文件保持原有检查契约。。 真实验收先经公开 memory_enable({action:"download"}) 单独准备资源,随后用同一测试私有 (原始内容存档于2018-09-29). Agent Dir QQ; QQ, QQ。 * 固定; * 侧车 *。 详见 docs/design/冷资源准备与取消边界.md键。

身份

插件显示 ID agent-forge.plugin.memory; 嵌入能力 显示编号 agent-forge.builtin.memory 保留为 长久的事实(铅笔写出理由,清洗授权参考) 磁盘状态持续解决.

能力

要求数 session + 键 events + 键 tools提供 memory.scheduler 服务(v1).

版本与发布记录

@ai-agent-forge/plugin-memory 共发布 62 个版本,首次发布于 2026/09/29;过去 12 个月发布了 62 个版本。

版本发布日期距今
0.88.28latest2026/11/024 天前
0.88.272026/11/014 天前
0.88.262026/11/015 天前
0.88.252026/10/316 天前
0.88.242026/10/306 天前
0.88.232026/10/307 天前

关于 @ai-agent-forge/plugin-memory 的常见问题

@ai-agent-forge/plugin-memory 是什么?

代理 Forge (Memory write/ recall/ list/forget) 的第一当事方内存能力插件

如何安装 @ai-agent-forge/plugin-memory?

在项目目录运行 npm install @ai-agent-forge/plugin-memory,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-forge-memory-inference,可以用 npx agent-forge-memory-inference 直接运行。

@ai-agent-forge/plugin-memory 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@ai-agent-forge/plugin-memory 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@ai-agent-forge/plugin-memory 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ai-agent-forge/plugin-memory 可以商用吗?

@ai-agent-forge/plugin-memory 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ai-agent-forge/plugin-memory 的下载量有多少?

根据 npm 官方下载统计,@ai-agent-forge/plugin-memory 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,937 次,日均约 165 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ai-agent-forge/plugin-memory 还在维护吗?

最新版本 0.88.28 发布于 2026/11/02(4 天前);至今共发布 62 个版本,其中过去 12 个月发布了 62 个;首次发布于 2026/09/29。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。