# @ai-agent-forge/plugin-memory 中文文档

规范地址：https://npmcn.com/package/%40ai-agent-forge/plugin-memory/

版本：0\.88\.28
npm 元数据更新时间：2026-11-02T01:07:54.094Z
中文译文更新时间：2026-11-06T05:07:10.788Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ai-agent-forge/plugin-memory
原文对照：https://npmcn.com/package/%40ai-agent-forge/plugin-memory/?lang=original
项目主页：https://github.com/agent-forge/agent-forge#readme
源码仓库：https://github.com/agent-forge/agent-forge

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.1 MB，210 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：4 个
- 首次发布：2026-09-28T16:26:47.861Z
- 最新版本发布：2026-11-02T01:07:53.886Z
- 近 30 天下载量：4937（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：62（近 12 个月 62 个）

## 中文简介

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

## 安装

```sh
npm install @ai-agent-forge/plugin-memory
```

也可以使用：`pnpm add @ai-agent-forge/plugin-memory`、`yarn add @ai-agent-forge/plugin-memory`、`bun add @ai-agent-forge/plugin-memory`

## README

# @ 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 是什么？

代理 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 和提交记录判断。