# @felan-ai/ext-memory 中文文档

规范地址：https://npmcn.com/package/%40felan-ai/ext-memory/

版本：0\.13\.2
npm 元数据更新时间：2026-11-13T14:01:05.578Z
中文译文更新时间：2026-11-14T14:04:41.486Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：699 kB，136 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：0 个
- peer 依赖：@felan-ai/agent-core ^0\.15\.0
- 首次发布：2026-08-20T16:42:14.463Z
- 最新版本发布：2026-11-13T14:01:05.215Z
- 近 30 天下载量：2250（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

Felan的便携式本地第一存储合同和延期

## 安装

```sh
npm install @felan-ai/ext-memory
```

也可以使用：`pnpm add @felan-ai/ext-memory`、`yarn add @felan-ai/ext-memory`、`bun add @felan-ai/ext-memory`

## README

# @felan-ai/下册

便携式本地第一记忆合同,马克当文物政策,验证, 以及Felan主机的Pi扩展行为.

软件包根需要核心 `felan.runtime@1`, (中文(简体) ), `felan.models@1`,以及 `felan.sessions@1` 服务。 它拥有当地商店,项目协调, 检查站恢复、梦想、保留和 `/memory` 命令.

守护进程通过它每个代理目录共享一个内存协调员 届会。 已装入的根会话, 主机提供工人和运行时间 寿命可以驱动处理。 读者会话和有限的主机可以记住 - 读者不记录检查站. 处理工作由事件驱动,有针对性地进行复原复试和编剧再检查 而不是一个投票监视器。 文件与原子 存储操作使用范围 运行时; 模型选择使用认证 模型外观. 受限制的梦想会 和生命周期的结算 会议。 缺少工人或终身能力使加工无法进行,而不是 开设独立无轨工人.

`@felan-ai/ext-memory/daemon` 导出默认守护进程提供者,并 `createMemoryDaemonProvider(options?)`它规定 `felan.memory.scheduler@1`, (中文(简体) ), 需求 `felan.host.maintenance@1`,可选择使用 `felan.host.models@1`。 。 。 . 提供者与扩展的协调员分享,并保持一个持续 每个已发现的工程附件, 因此未完成的工作可以运行, 没有装入 届会。 它在两秒内会合协调器状态并重新扫描 每十分钟一次 没有主机模型, 它跟踪项目, 但禁用调度 . 计时器 `status()` 返回每个被跟踪的工程根及其内存状态. 主机可以提供 a `runtime` 实例或实例 `() => AgentRuntime` 工厂呼叫 启动时, 额外 `projects`,以及项目对会 `selector`。 。 。 . 明确项目根解每活化一次. `discover` 默认为 `true`· ; 准备吧 `false` 只跟踪 `projects` 不列出存储的项目目录. 对于共享团队记忆,通过团队工作空间在 `projects`, (中文(简体) ), `discover: false`, (中文(简体) ), 和返回的选择器 `{ kind: 'all' }`。默认情况下,会话列表包括 cwd 解决同一项目,包括 git 子目录. 检查点和历史记录显示使用宿主的全部授权库存. 附件使用主机允许的模型范围,并在重新扫描时刷新. 主机排出 立即停止 排出每个持续附件. 和解解开提供者并释放其 协调员的参考资料,而不结束其他会议的附件.

运河布局仍然 `<agentDir>/memory/v1/projects/<projectKey>` 财务报告和审定财务报表 保留日记 `<agentDir>/sessions/memory`一会 `.memory` 目录为非授权投影. 现有检查站和文物 不被此更改迁移或重置.

保留工人编成一个记忆类的Pi期刊;运行时将其条目附加到 保存的文件并在记录结果之前冲出它们。 延期 不使用 Pi 的本地文件系统持久性 .

`materializeMemorySessionCheckpoint` 读取以修订为主的、平分的会话 具有原始身份和完整日记的历史,包括废弃的 树枝。 缺少历史、订正漂移和证据变化仍然明确 失败,而不是空置成功的预测.

状态、历史视图和命令反馈使用 `pi.ui`客户可以提供 内存历史提示,但它得到的通用元素和行动与 其他客户. `/memory open` 在启动前询问合格的主机控制台 文件系统查看器。 无法获取的演示文稿不会阻止检查站的捕捉.

内存是一个 Markdown wiki 包含 `summary.md`, (中文(简体) ), `index.md`主题 下页 `pages/`. 概述只是取向:实质性索赔 应遵循相关领域和主题页面的索引并引用其路径 财务报告和审定财务报表 `Sources` 会话标识 。 主机对每个项目进行非授权复制 root会话并保留在客户存储库外的cononial存储.

Markdown链接是普通的不可信内容,从不制作文物 无效。 出版物验证执行 文物形状和版本,安全 和唯一路径,需要快速文件、资源限制、页面出处,以及 可选源片段允许列表; 链接目标和导航质量 最佳内容关注。 对供应问题敏感的消费者可以使用 `mode: 'read'`安全地执行固定的Markdown文件, 独一无二的路径,但将出处缺陷视为非致命和供应空的 当两个快速文件都不存在时,摘要/索引默认值。 出版物征集者 可禁用来源检查 `requireSources` 并限制引用 `sourceSessionIds`。 。 。 .

扩展附件 : 会话开始 。 后来的提供者调用复用该会话语境,而不是 在每个信件上插入新信件 `context` 活动。 如果收缩或树 导航从活动分支中删除消息,扩展恢复 一个副本。 信件被排除在检查站证据之外,所以内存不能 学习自己的注射快感.

当用户明确要求记住、忘记或改变记忆时,会话 即时请求代理商留下简洁的,归属的内存注释而不是 要求立即更新证据 后作梦者取出原作 用户授权请求作为直接证据; 助理注释只是指针 对这一要求.

扩展的协调员梦想着做一个一次性的无头派 页 次 `.dreaming/input` 财务报告和审定财务报表 `.memory` 目录. 梦中人 使用读取/列表/grep/edit/write文件工具外加删除范围化工具 阶段中单个非索引马克下页 `.memory/pages`它没有 普通扩展,技能,寄存器访问,或 shell 执行. Grep 可以吗 仅发射 `rg` 超过已分阶段输入和wiki文件;任意命令仍然被拒绝。 它回来了 在编辑了 Markdown 工艺品之后, 才进行总结。 扩展验证 ,并公布文件系统输出;失败或被取消的工作仍有待完成. 带有可选运行时间分类器的可移植扩展组毗连 将证据切入提供者大小块并询问每个条目是否需要 检查或是完全短暂的噪音。 模型服务提供 分类器;每个会话的扩展阶段只读检查和噪音,以及 写一个剪切的已上演路径地图。 对于只检查文本的记录,主机 工读器 `inspect.txt` 视图,带有会话/条目标识、角色、, 工具名称和完整文本。 混合区块或未支持区块留在原区内 检查JSONL 而不是默默地缩短。 工人看风景 如果有,否则JSONL的来源, 可能 grep 噪声用于上下文, 组织 wiki, 并保存原始条目 ID 和来源。 原始笔录仍在制作中,可供 核查或全面审计后退。 超规模或不确定的项目 检查; 缺少或无法使用的分类使用原始全审计 工作流程。 Triage不决定最终维基保留或即时放置. 分类器按会话排列问题 `canEvaluate` 能力; 超大小的条目、缺失的答案和交互式用户答案仍然安全 检查。 工人核对所有证据 和会话,独立审核前维基,并使用介质思维. 它从 根会话配置的模型范围, 偏爱它的提供者和模型 家庭,没有升级;没有合格模型时,证据仍未确定 已提供。 带有分类符的笔录摘录可能会留下 本地进程; 已识别的证书模式被编辑, 但未知 秘密可能会留下. 它不实行单独的转折、工具调用或每个文件I/O预算;它唯一的 执行故障安全 是一个一小时的墙上时间超时。 主机可以通过可重播 async JSONL 线源到 `materializeMemoryInputDelta` 以验证检查站 分出分出分出,并形成一个定型的,被修改的可见分出分出三角洲. 差异 线条发出完整的当前分支 。 输出限制拒绝超大小 而不是切换 JSONL 记录。 会话提供者提供完整的日记;扩展阶段成功 预测。 大型源会话 文件不只因其总大小而被拒绝。 无法设置的检查站 实现被删除并被记住 `state.json`所以它没有被重审 在重新启动后; 运行将补足其批次的下一个待定检查站.

记忆计划保持了维基稀疏. 它优先考虑持久用户授权 事实、偏好、决定、更正和未编码的理由陈述 未经核实的发现、事件和运行时间或外部系统 观察。 它不映射寄存器的来源,文档,配置, 测试、常规任务状态、原始工具输出或重复摘要。 仓库 只有掌握了有用的理由、事件和事实,才保留事实 错配,或未记录在 仓库。 每个梦想运行 审计完整的 现有wiki 并删除 不合格、陈旧、重复、重叠或不必要的内容;有效来源 单凭引文并不能提出值得保留的索赔.

## 发展

资料来源: `packages/ext-memory` 内 [https://github.com/felan-ai/felan 页面存档备份,存于互联网档案馆](https://github.com/felan-ai/felan)。 。 。 .

```sh
pnpm --filter @felan-ai/ext-memory build
pnpm --filter @felan-ai/ext-memory type-check
pnpm --filter @felan-ai/ext-memory test
```

## 一揽子边界和要求

软件包拥有记忆政策和生命周期行为. 运行时供应商拥有 文件系统/进程访问,模型提供者拥有证书和允许模式 课程提供方拥有工人录用和课程 一辈子 软件包需要兼容 `@felan-ai/agent-core` 对等并有 没有应用程序, TUI, Supabase 或云运行时依赖.

内存和笔录内容是不信任的参考数据,不能覆盖 系统、开发者、用户、授权或工具安全规则.

## 相关文件

-   [背景和记忆](https://npmcn.com/package/docs/user-guide/context-and-memory.md)
-   [本地内存架构](https://npmcn.com/package/docs/concepts/local-memory.md)
-   [运行时间和安全](https://npmcn.com/package/docs/concepts/runtime-and-security.md)

## 归属

马克下沉的记忆计划 和梦想政策 改自费兰 文件系统-模拟执行。 剩下的包代码是原始的 Felan 项目代码。 见 [通知](https://npmcn.com/package/%40felan-ai/ext-memory/NOTICE) 财务报告和审定财务报表 [自由主义](https://npmcn.com/package/%40felan-ai/ext-memory/LICENSE)。 。 。 .

## 常见问题

### @felan-ai/ext-memory 是什么？

Felan的便携式本地第一存储合同和延期

### 如何安装 @felan-ai/ext-memory？

在项目目录运行 npm install @felan-ai/ext-memory，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@felan-ai/agent-core（^0\.15\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @felan-ai/ext-memory 支持 TypeScript 吗？

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

### @felan-ai/ext-memory 支持 ESM 还是 CommonJS？

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

### @felan-ai/ext-memory 需要什么版本的 Node\.js？

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

### @felan-ai/ext-memory 可以商用吗？

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

### @felan-ai/ext-memory 的下载量有多少？

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

### @felan-ai/ext-memory 还在维护吗？

最新版本 0\.13\.2 发布于 2026/11/13（1 天前）；至今共发布 22 个版本，其中过去 12 个月发布了 22 个；首次发布于 2026/08/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。