@scotthuang/engram 0.1.0

package/dist/bm25.js

@@ -0,0 +1,172 @@
+/**
+ * Memory System Plugin - BM25 Short-term Memory Index
+ *
+ * 短期记忆的 BM25 索引构建与搜索
+ * 纯 TypeScript 实现，不依赖外部 BM25 库
+ */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+/**
+ * 简单中文分词：按字符 bigram + 单字
+ * 生产环境可替换为 jieba
+ */
+function tokenize(text) {
+    // 去除标点符号，转为小写
+    const cleaned = text.toLowerCase().replace(/[^\w\u4e00-\u9fff]/g, " ");
+    const tokens = [];
+    // 中文 bigram
+    const chinese = cleaned.match(/[\u4e00-\u9fff]+/g) || [];
+    for (const segment of chinese) {
+        for (let i = 0; i < segment.length - 1; i++) {
+            tokens.push(segment.substring(i, i + 2));
+        }
+        // 也保留单字
+        for (const char of segment) {
+            tokens.push(char);
+        }
+    }
+    // 英文按空格分
+    const english = cleaned.replace(/[\u4e00-\u9fff]/g, " ").split(/\s+/).filter(Boolean);
+    tokens.push(...english);
+    return tokens;
+}
+export class BM25Index {
+    docs = [];
+    idf = new Map();
+    avgDl = 0;
+    /**
+     * 从短期记忆文件构建索引
+     */
+    async buildFromDirectory(dir, maxAgeDays = 7) {
+        this.docs = [];
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - maxAgeDays);
+        try {
+            const files = await fs.readdir(dir);
+            for (const file of files.sort().reverse()) { // 最新的优先
+                if (!file.endsWith(".md"))
+                    continue;
+                const filePath = join(dir, file);
+                const stat = await fs.stat(filePath);
+                if (stat.mtime < cutoff)
+                    continue;
+                const content = await fs.readFile(filePath, "utf-8");
+                const entries = this.parseEntries(content, filePath, file);
+                this.docs.push(...entries);
+            }
+        }
+        catch {
+            // 目录不存在时忽略
+        }
+        this.buildIDF();
+    }
+    /**
+     * 解析结构化的短期记忆文件
+     * 格式：### HH:MM [分类标签]\n摘要内容
+     */
+    parseEntries(content, filePath, fileName) {
+        const entries = [];
+        const lines = content.split("\n");
+        const dateMatch = fileName.match(/(\d{4}-\d{2}-\d{2})/);
+        const date = dateMatch ? dateMatch[1] : new Date().toISOString().split("T")[0];
+        let currentCategory = "随聊";
+        let currentText = "";
+        for (const line of lines) {
+            const headerMatch = line.match(/^###\s+\d{2}:\d{2}\s+\[(\w+)\]/);
+            if (headerMatch) {
+                // 保存上一条
+                if (currentText.trim()) {
+                    const entry = {
+                        text: currentText.trim(),
+                        date,
+                        category: currentCategory,
+                        filePath,
+                    };
+                    entries.push({ tokens: tokenize(entry.text), entry });
+                }
+                currentCategory = headerMatch[1];
+                currentText = "";
+            }
+            else if (line.startsWith("#") || line.startsWith("---") || line.startsWith("```")) {
+                continue;
+            }
+            else {
+                currentText += line + " ";
+            }
+        }
+        // 最后一条
+        if (currentText.trim()) {
+            const entry = {
+                text: currentText.trim(),
+                date,
+                category: currentCategory,
+                filePath,
+            };
+            entries.push({ tokens: tokenize(entry.text), entry });
+        }
+        return entries;
+    }
+    /**
+     * 构建 IDF（逆文档频率）
+     */
+    buildIDF() {
+        const df = new Map(); // 文档频率
+        let totalLen = 0;
+        for (const doc of this.docs) {
+            const unique = new Set(doc.tokens);
+            for (const t of unique) {
+                df.set(t, (df.get(t) || 0) + 1);
+            }
+            totalLen += doc.tokens.length;
+        }
+        this.avgDl = this.docs.length > 0 ? totalLen / this.docs.length : 1;
+        const N = this.docs.length;
+        for (const [term, freq] of df) {
+            // IDF = log((N - df + 0.5) / (df + 0.5) + 1)
+            this.idf.set(term, Math.log((N - freq + 0.5) / (freq + 0.5) + 1));
+        }
+    }
+    /**
+     * BM25 搜索
+     * @returns 带分数的结果列表
+     */
+    search(query, topK = 3) {
+        const queryTokens = tokenize(query);
+        const k1 = 1.5; // 词频饱和参数
+        const b = 0.75; // 文档长度归一化参数
+        const scores = [];
+        for (const doc of this.docs) {
+            let score = 0;
+            for (const token of queryTokens) {
+                const idf = this.idf.get(token) || 0;
+                if (idf === 0)
+                    continue;
+                // 词频
+                const tf = doc.tokens.filter(t => t === token).length;
+                const dl = doc.tokens.length;
+                // BM25 分数
+                const tfComponent = (tf * (k1 + 1)) / (tf + k1 * (1 - b + b * (dl / this.avgDl)));
+                score += idf * tfComponent;
+            }
+            if (score > 0) {
+                scores.push({ entry: doc.entry, score });
+            }
+        }
+        scores.sort((a, b) => b.score - a.score);
+        return scores.slice(0, topK);
+    }
+    /**
+     * 添加单条记录（用于实时写入后的即时索引）
+     */
+    addEntry(entry) {
+        this.docs.push({
+            tokens: tokenize(entry.text),
+            entry,
+        });
+        this.buildIDF(); // 简单处理：重建 IDF
+    }
+    get size() {
+        return this.docs.length;
+    }
+}
+//# sourceMappingURL=bm25.js.map

package/dist/bm25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.js","sourceRoot":"","sources":["../src/bm25.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Memory System Plugin - Configuration
+ */
+export type MemorySystemConfig = {
+    shortTermDays: number;
+    halfLifeDays: number;
+    recallTopK: number;
+    minScore: number;
+    vectorWeight: number;
+    textWeight: number;
+    settleModel: string;
+    embeddingModel: string;
+};
+export declare const DEFAULTS: MemorySystemConfig;
+export declare function parseConfig(raw?: Record<string, unknown>): MemorySystemConfig;

package/dist/config.js

@@ -0,0 +1,28 @@
+/**
+ * Memory System Plugin - Configuration
+ */
+export const DEFAULTS = {
+    shortTermDays: 7,
+    halfLifeDays: 30,
+    recallTopK: 3,
+    minScore: 0.4,
+    vectorWeight: 0.7,
+    textWeight: 0.3,
+    settleModel: "volcengine-plan/ark-code-latest",
+    embeddingModel: "text-embedding-v3",
+};
+export function parseConfig(raw) {
+    if (!raw)
+        return { ...DEFAULTS };
+    return {
+        shortTermDays: typeof raw.shortTermDays === "number" ? raw.shortTermDays : DEFAULTS.shortTermDays,
+        halfLifeDays: typeof raw.halfLifeDays === "number" ? raw.halfLifeDays : DEFAULTS.halfLifeDays,
+        recallTopK: typeof raw.recallTopK === "number" ? raw.recallTopK : DEFAULTS.recallTopK,
+        minScore: typeof raw.minScore === "number" ? raw.minScore : DEFAULTS.minScore,
+        vectorWeight: typeof raw.vectorWeight === "number" ? raw.vectorWeight : DEFAULTS.vectorWeight,
+        textWeight: typeof raw.textWeight === "number" ? raw.textWeight : DEFAULTS.textWeight,
+        settleModel: typeof raw.settleModel === "string" ? raw.settleModel : DEFAULTS.settleModel,
+        embeddingModel: typeof raw.embeddingModel === "string" ? raw.embeddingModel : DEFAULTS.embeddingModel,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,EAAE;IAChB,UAAU,EAAE,CAAC;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,UAAU,EAAE,GAAG;IACf,WAAW,EAAE,iCAAiC;IAC9C,cAAc,EAAE,mBAAmB;CACpC,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,GAA6B;IACvD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACjC,OAAO;QACL,aAAa,EAAE,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa;QACjG,YAAY,EAAE,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY;QAC7F,UAAU,EAAE,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU;QACrF,QAAQ,EAAE,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ;QAC7E,YAAY,EAAE,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY;QAC7F,UAAU,EAAE,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU;QACrF,WAAW,EAAE,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW;QACzF,cAAc,EAAE,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc;KACtG,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Engram Plugin - Main Entry
+ *
+ * 分层语义记忆系统 OpenClaw Plugin
+ * kind: "memory" (exclusive slot)
+ */
+export default function register(api: any): void;

package/dist/index.js

@@ -0,0 +1,200 @@
+/**
+ * Engram Plugin - Main Entry
+ *
+ * 分层语义记忆系统 OpenClaw Plugin
+ * kind: "memory" (exclusive slot)
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// OpenClaw Plugin API 没有提供类型定义，需要使用 any
+import { parseConfig } from "./config.js";
+import { RecallEngine } from "./recall.js";
+import { ProfileManager } from "./profile.js";
+import { runSettlement } from "./settle.js";
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+export default function register(api) {
+    const rawConfig = api.pluginConfig || {};
+    const config = parseConfig(rawConfig);
+    const workspaceDir = api.workspaceDir || process.env.HOME + "/.openclaw/workspace";
+    // ---- 初始化引擎 ----
+    const recallEngine = new RecallEngine(workspaceDir, config);
+    const profileManager = new ProfileManager(workspaceDir);
+    // 向量搜索回调：复用现有 memory-lancedb 的能力
+    recallEngine.setVectorSearch(async (query, limit) => {
+        try {
+            // 尝试调用 OpenClaw 内置的 embedding 搜索
+            // 如果 memory-lancedb 不可用，返回空结果
+            const results = await api.memorySearch?.(query, limit);
+            if (results && Array.isArray(results)) {
+                return results.map((r) => ({
+                    text: r.text || "",
+                    source: "vector",
+                    score: r.score || 0,
+                    date: r.date,
+                    category: r.category,
+                }));
+            }
+            return [];
+        }
+        catch {
+            return [];
+        }
+    });
+    // ---- Agent Tools ----
+    api.registerTool({
+        name: "memory_system_search",
+        label: "Memory Search",
+        description: "搜索记忆（短期+长期双路召回+画像增强）。用于查找用户偏好、历史事件、之前讨论的话题。",
+        parameters: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "搜索查询" },
+                limit: { type: "number", description: "最大返回数（默认使用配置值）" },
+            },
+            required: ["query"],
+        },
+        async execute(_toolCallId, params) {
+            const { query, limit } = params;
+            const { results, memoryContext } = await recallEngine.recall(query);
+            return {
+                content: [{ type: "text", text: results || "No relevant memories found." }],
+                details: { count: results.split("\n").length },
+            };
+        },
+    }, { name: "memory_system_search" });
+    api.registerTool({
+        name: "memory_system_profile",
+        label: "User Profile",
+        description: "查看或更新用户语义画像。",
+        parameters: {
+            type: "object",
+            properties: {
+                action: { type: "string", enum: ["get", "update"], description: "操作类型" },
+                dimension: { type: "string", description: "标签维度（update 时使用）" },
+                value: { type: "string", description: "标签值（update 时使用）" },
+            },
+            required: ["action"],
+        },
+        async execute(_toolCallId, params) {
+            const { action, dimension, value } = params;
+            const profile = await profileManager.load();
+            if (action === "get") {
+                const context = profileManager.getRecallContext(profile);
+                const fullTags = Object.entries(profile.tags)
+                    .map(([dim, tags]) => `- **${dim}**: ${tags.map(t => `${t.value}(${(t.confidence * 100).toFixed(0)}%)`).join(", ")}`)
+                    .join("\n");
+                return {
+                    content: [{
+                            type: "text",
+                            text: `${context}\n\n## 完整画像\n${fullTags || "(暂无标签)"}`,
+                        }],
+                };
+            }
+            if (action === "update" && dimension && value) {
+                profileManager.addTag(profile, dimension, value);
+                await profileManager.save(profile);
+                return {
+                    content: [{ type: "text", text: `Added tag: [${dimension}] ${value}` }],
+                };
+            }
+            return { content: [{ type: "text", text: "Invalid action or missing params." }] };
+        },
+    }, { name: "memory_system_profile" });
+    // ---- Auto-Recall: before_prompt_build ----
+    api.on("before_prompt_build", async (event) => {
+        const prompt = event.prompt || "";
+        if (prompt.length < 5)
+            return;
+        try {
+            const { memoryContext } = await recallEngine.recall(prompt);
+            if (!memoryContext)
+                return;
+            return { prependContext: memoryContext };
+        }
+        catch (err) {
+            console.error(`[engram] Recall failed: ${err}`);
+        }
+    }, { priority: 5 });
+    // ---- Hooks: command:new 即时沉淀 ----
+    api.registerHook("command:new", async (event) => {
+        try {
+            // 快速保存：将 session 摘要写入当天短期记忆
+            const date = new Date().toISOString().split("T")[0];
+            const shortTermDir = join(workspaceDir, "memory", "short-term");
+            await fs.mkdir(shortTermDir, { recursive: true });
+            const filePath = join(shortTermDir, `${date}.md`);
+            const timestamp = new Date().toLocaleTimeString("zh-CN", { hour: "2-digit", minute: "2-digit" });
+            const entry = `\n### ${timestamp} [随聊]\nSession reset via /new at ${new Date().toISOString()}\n`;
+            await fs.appendFile(filePath, entry, "utf-8");
+            console.log(`[engram] Quick-save on /new: ${date}`);
+        }
+        catch (err) {
+            console.error(`[engram] Hook command:new failed: ${err}`);
+        }
+    }, {
+        name: "engram.command-new",
+        description: "会话重置时快速保存上下文",
+    });
+    // ---- Hooks: session:compact:before 保底沉淀 ----
+    api.registerHook("session:compact:before", async (event) => {
+        try {
+            const date = new Date().toISOString().split("T")[0];
+            const shortTermDir = join(workspaceDir, "memory", "short-term");
+            await fs.mkdir(shortTermDir, { recursive: true });
+            const filePath = join(shortTermDir, `${date}.md`);
+            const timestamp = new Date().toLocaleTimeString("zh-CN", { hour: "2-digit", minute: "2-digit" });
+            const entry = `\n### ${timestamp} [系统]\nCompaction triggered, saving context at ${new Date().toISOString()}\n`;
+            await fs.appendFile(filePath, entry, "utf-8");
+            console.log(`[engram] Pre-compaction save: ${date}`);
+        }
+        catch (err) {
+            console.error(`[engram] Hook session:compact:before failed: ${err}`);
+        }
+    }, {
+        name: "engram.compact-before",
+        description: "Compaction 前保底保存重要信息",
+    });
+    // ---- Service: 启动初始化 ----
+    api.registerService({
+        id: "engram",
+        async start() {
+            await recallEngine.startup();
+            console.log(`[engram] Service started (workspace: ${workspaceDir})`);
+        },
+        async stop() {
+            console.log("[engram] Service stopped");
+        },
+    });
+    // ---- CLI Commands ----
+    api.registerCli(({ program }) => {
+        const mem = program.command("memory-sys").description("Memory system commands");
+        mem.command("settle").description("Run settlement manually").action(async () => {
+            const results = await runSettlement({
+                workspaceDir,
+                config,
+                // LLM 和 vector 回调在 CLI 模式下使用默认实现
+                llmCall: async (prompt, sys) => {
+                    // 简单回显，实际应接入 LLM
+                    console.log("LLM call needed - configure in plugin");
+                    return "[]";
+                },
+            });
+            results.forEach(r => console.log(`  ${r}`));
+        });
+        mem.command("profile").description("Show user profile").action(async () => {
+            const profile = await profileManager.load();
+            const context = profileManager.getRecallContext(profile);
+            console.log(context || "(empty profile)");
+            console.log("\nFull tags:");
+            console.log(JSON.stringify(profile.tags, null, 2));
+        });
+        mem.command("stats").description("Show memory stats").action(async () => {
+            console.log(`Workspace: ${workspaceDir}`);
+            console.log(`Short-term days: ${config.shortTermDays}`);
+            console.log(`Half-life: ${config.halfLifeDays} days`);
+            // 可扩展更多统计
+        });
+    }, { commands: ["memory-sys"] });
+    console.log("[engram] Plugin registered");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/profile.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Memory System Plugin - Profile (语义画像)
+ *
+ * 画像 JSON 结构 + 读写 + 压缩摘要
+ */
+export type ProfileTag = {
+    value: string;
+    confidence: number;
+    lastSeen: string;
+};
+export type SemanticProfile = {
+    summary: string;
+    coreTags: string[];
+    tags: Record<string, ProfileTag[]>;
+    updatedAt: string;
+};
+export declare const EMPTY_PROFILE: SemanticProfile;
+export declare class ProfileManager {
+    private profile;
+    private profilePath;
+    constructor(workspaceDir: string);
+    ensureDir(): Promise<void>;
+    load(): Promise<SemanticProfile>;
+    save(profile: SemanticProfile): Promise<void>;
+    /**
+     * 获取召回用的摘要信息（控制 token 消耗）
+     */
+    getRecallContext(profile: SemanticProfile): string;
+    /**
+     * 添加标签（增量更新）
+     */
+    addTag(profile: SemanticProfile, dimension: string, value: string): SemanticProfile;
+    /**
+     * 降低标签置信度（遗忘）
+     */
+    decayTags(profile: SemanticProfile, factor?: number): SemanticProfile;
+}

package/dist/profile.js

@@ -0,0 +1,95 @@
+/**
+ * Memory System Plugin - Profile (语义画像)
+ *
+ * 画像 JSON 结构 + 读写 + 压缩摘要
+ */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+export const EMPTY_PROFILE = {
+    summary: "",
+    coreTags: [],
+    tags: {},
+    updatedAt: new Date().toISOString(),
+};
+export class ProfileManager {
+    profile = null;
+    profilePath;
+    constructor(workspaceDir) {
+        this.profilePath = join(workspaceDir, "memory", "profile", "semantic_profile.json");
+    }
+    async ensureDir() {
+        await fs.mkdir(join(this.profilePath, ".."), { recursive: true });
+    }
+    async load() {
+        if (this.profile)
+            return this.profile;
+        try {
+            const raw = await fs.readFile(this.profilePath, "utf-8");
+            this.profile = JSON.parse(raw);
+        }
+        catch {
+            this.profile = { ...EMPTY_PROFILE };
+        }
+        return this.profile;
+    }
+    async save(profile) {
+        this.profile = profile;
+        profile.updatedAt = new Date().toISOString();
+        await this.ensureDir();
+        await fs.writeFile(this.profilePath, JSON.stringify(profile, null, 2), "utf-8");
+    }
+    /**
+     * 获取召回用的摘要信息（控制 token 消耗）
+     */
+    getRecallContext(profile) {
+        if (!profile.summary && profile.coreTags.length === 0) {
+            return "";
+        }
+        const parts = [];
+        if (profile.summary) {
+            parts.push(`【用户画像】${profile.summary}`);
+        }
+        if (profile.coreTags.length > 0) {
+            parts.push(`【核心标签】${profile.coreTags.join(", ")}`);
+        }
+        return parts.join("\n");
+    }
+    /**
+     * 添加标签（增量更新）
+     */
+    addTag(profile, dimension, value) {
+        if (!profile.tags[dimension]) {
+            profile.tags[dimension] = [];
+        }
+        // 避免重复
+        const existing = profile.tags[dimension].find(t => t.value === value);
+        if (existing) {
+            existing.confidence = Math.min(1.0, existing.confidence + 0.1);
+            existing.lastSeen = new Date().toISOString();
+        }
+        else {
+            profile.tags[dimension].push({
+                value,
+                confidence: 0.7,
+                lastSeen: new Date().toISOString(),
+            });
+        }
+        return profile;
+    }
+    /**
+     * 降低标签置信度（遗忘）
+     */
+    decayTags(profile, factor = 0.95) {
+        for (const dimension of Object.keys(profile.tags)) {
+            profile.tags[dimension] = profile.tags[dimension]
+                .map(t => ({ ...t, confidence: t.confidence * factor }))
+                .filter(t => t.confidence > 0.2); // 淘汰低置信度标签
+            // 清理空维度
+            if (profile.tags[dimension].length === 0) {
+                delete profile.tags[dimension];
+            }
+        }
+        return profile;
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"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"}

package/dist/recall.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Memory System Plugin - Recall (自动召回)
+ *
+ * 双路召回：BM25(短期记忆) + Vector(长期记忆)
+ * 分数融合 → 排重 → 时间衰减 → MMR 去重 → 画像注入
+ */
+import { type MemorySystemConfig } from "./config.js";
+export type RecallResult = {
+    text: string;
+    source: "short-term" | "vector";
+    score: number;
+    date?: string;
+    category?: string;
+};
+export declare class RecallEngine {
+    private bm25;
+    private profileManager;
+    private config;
+    private workspaceDir;
+    private vectorSearch?;
+    constructor(workspaceDir: string, config: MemorySystemConfig);
+    /**
+     * 设置向量搜索回调（由 Plugin 主入口注入）
+     */
+    setVectorSearch(fn: (query: string, limit: number) => Promise<RecallResult[]>): void;
+    /**
+     * 启动时初始化：加载画像 + 构建 BM25 索引
+     */
+    startup(): Promise<void>;
+    /**
+     * 核心：双路召回
+     */
+    recall(query: string): Promise<{
+        results: string;
+        memoryContext: string;
+    }>;
+}