@devflow-tools/memory-engine

持久化 session events、结构化 observations 和审核记忆，并提供混合搜索与 embedding 实现。（v0.17.8）

安装

npm install @devflow-tools/memory-engine

快速开始

import { MemoryGate } from '@devflow-tools/memory-engine';

const memory = new MemoryGate(process.cwd());
await memory.forceWarmUp();
console.log(await memory.getProjectContext());

公共 API / 命令

MemoryEngine、MemoryGate、MemoryStore、HybridSearch、EmbeddingProvider、runMemoryMaintenance、consolidate 和 memory capsule/semantic helpers。

配置与运行时

memory-engine 依赖 SDK 的 embedding contract，并提供具体 provider；宿主模型通过 MCP 提炼事件，不要求本地 LLM 服务。

宿主模型蒸馏流程

1. 宿主模型调用 memory_request_distill 获取待处理事件租约，并按 nextPage 读取全部分页。
2. 宿主模型只根据事件证据生成结构化 observations，并为每条 observation 绑定 sourceEvidenceIds。
3. 宿主模型使用同一 batchId 调用 memory_save_distilled，由 memory-engine 校验 capsule、写入记忆并提交租约。

该流程由宿主模型完成语义判断，不要求本地 LLM 服务，也不会在 memory-engine 进程内自行生成 observations。

版本与兼容性

• 当前包版本：0.17.8
• Node.js：未在 package manifest 声明更高版本时，使用 Node.js 18+；原生 SQLite/Playwright 能力请按对应依赖安装
• workspace 内部包应使用同一 DevFlow minor/patch 版本，避免类型和数据库 schema 不一致

相关链接

• DevFlow 仓库
• 问题反馈

License

MIT