npm - autosnippet - Versions diffs - 3.3.6 → 3.3.8 - Mend

autosnippet 3.3.6 → 3.3.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (275) hide show

package/dashboard/dist/index.html CHANGED Viewed

@@ -5,13 +5,13 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-DDdAOpYT.js"></script>
+    <script type="module" crossorigin src="/assets/index-DV8biUkH.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-BZEJEVBn.js">
-    <link rel="modulepreload" crossorigin href="/assets/icons-D1aVZYFW.js">
+    <link rel="modulepreload" crossorigin href="/assets/icons-BMNb0V6L.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-42ANG6Sg.js">
     <link rel="modulepreload" crossorigin href="/assets/framer-motion-CZfOSYpP.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-CxHOu8Hd.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-DHJ1Dj7u.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/bin/cli.js CHANGED Viewed

@@ -753,8 +753,9 @@ program
         const projectRoot = resolve(scanPath || '.');
         const { bootstrap, container } = await initContainer({ projectRoot });
         const panoramaService = container.get('panoramaService');
+        await panoramaService.ensureData();
         if (opts.gaps) {
-            const gaps = panoramaService.getGaps();
+            const gaps = await panoramaService.getGaps();
             if (opts.json) {
                 cli.log(JSON.stringify(gaps, null, 2));
             }
@@ -772,7 +773,7 @@ program
             return;
         }
         if (opts.health) {
-            const health = panoramaService.getHealth();
+            const health = await panoramaService.getHealth();
             if (opts.json) {
                 cli.log(JSON.stringify(health, null, 2));
             }
@@ -789,7 +790,7 @@ program
             return;
         }
         // 默认: 全景概览
-        const overview = panoramaService.getOverview();
+        const overview = await panoramaService.getOverview();
         if (opts.json) {
             cli.log(JSON.stringify(overview, null, 2));
         }
@@ -913,9 +914,12 @@ program
             const { getRealtimeService } = await import('../lib/infrastructure/realtime/RealtimeService.js');
             const db = container.get('database');
             const agentFactory = container.get('agentFactory');
+            const knowledgeRepo = container.get('knowledgeRepository');
+            const auditRepo = container.get('auditRepository');
             const signalCollector = new SignalCollector({
                 projectRoot,
-                database: db,
+                knowledgeRepo: knowledgeRepo,
+                auditRepo: auditRepo,
                 agentFactory,
                 container,
                 mode: process.env.ASD_SIGNAL_MODE || 'auto',

package/dist/lib/agent/AgentRuntime.d.ts CHANGED Viewed

@@ -29,7 +29,7 @@
  */
 import { AgentEventBus } from './AgentEventBus.js';
 import type { AgentMessage } from './AgentMessage.js';
-import { type AgentResult, type FileCacheEntry, type ProgressEvent, type ReactLoopOpts, type RuntimeConfig, type ToolCallEntry, type ToolCallHook } from './AgentRuntimeTypes.js';
+import { type AgentResult, type FileCacheEntry, type ReactLoopOpts, type RuntimeConfig, type ToolCallEntry, type ToolCallHook } from './AgentRuntimeTypes.js';
 import { AgentState } from './AgentState.js';
 import { Capability } from './capabilities.js';
 import { PolicyEngine } from './policies.js';
@@ -50,7 +50,7 @@ export declare class AgentRuntime {
     policies: PolicyEngine;
     persona: Record<string, unknown>;
     memoryConfig: Record<string, unknown>;
-    onProgress: ((event: ProgressEvent) => void) | null;
+    onProgress: ((event: import("./AgentRuntimeTypes.js").ProgressEvent) => void) | null;
     lang: string | null;
     logger: import("winston").Logger;
     iterationCount: number;

package/dist/lib/agent/AgentRuntime.js CHANGED Viewed

@@ -739,25 +739,33 @@ export class AgentRuntime {
             const recipeCount = ctx.toolCalls.filter((tc) => (tc.tool || tc.name) === 'collect_scan_recipe').length;
             ctx.lastReply = `[scan complete: ${recipeCount} recipes collected]`;
         }
-        // 强制摘要 (系统场景或 tracker 场景)
-        if (!ctx.lastReply && (ctx.tracker || ctx.isSystem)) {
-            const forcedResult = await produceForcedSummary({
-                aiProvider: this.aiProvider,
-                source: ctx.source,
-                toolCalls: ctx.toolCalls,
-                tracker: ctx.tracker ?? undefined,
-                contextWindow: ctx.contextWindow,
-                prompt: ctx.prompt,
-                tokenUsage: this.tokenUsage,
-            });
-            ctx.lastReply = forcedResult.reply;
-            if (forcedResult.tokenUsage) {
-                this.tokenUsage.input += forcedResult.tokenUsage.input || 0;
-                this.tokenUsage.output += forcedResult.tokenUsage.output || 0;
-                ctx.addTokenUsage({
-                    inputTokens: forcedResult.tokenUsage.input || 0,
-                    outputTokens: forcedResult.tokenUsage.output || 0,
+        // 强制摘要 — 循环结束后无文本回复时，生成摘要
+        // 覆盖所有场景: 系统管线、tracker 管线、用户对话(有/无工具调用)
+        if (!ctx.lastReply) {
+            if (ctx.toolCalls.length > 0 || ctx.tracker || ctx.isSystem) {
+                const forcedResult = await produceForcedSummary({
+                    aiProvider: this.aiProvider,
+                    source: ctx.source,
+                    toolCalls: ctx.toolCalls,
+                    tracker: ctx.tracker ?? undefined,
+                    contextWindow: ctx.contextWindow,
+                    prompt: ctx.prompt,
+                    tokenUsage: this.tokenUsage,
                 });
+                ctx.lastReply = forcedResult.reply;
+                if (forcedResult.tokenUsage) {
+                    this.tokenUsage.input += forcedResult.tokenUsage.input || 0;
+                    this.tokenUsage.output += forcedResult.tokenUsage.output || 0;
+                    ctx.addTokenUsage({
+                        inputTokens: forcedResult.tokenUsage.input || 0,
+                        outputTokens: forcedResult.tokenUsage.output || 0,
+                    });
+                }
+            }
+            else {
+                // 兜底: 既无工具调用也无文本回复
+                ctx.lastReply = '抱歉，AI 未能生成有效回复。请重试或换个问题。';
+                this.logger.warn(`[AgentRuntime] ⚠ finalize: no reply, no tool calls (iter=${ctx.iteration}) — fallback message`);
             }
         }
         return ctx.buildResult();

package/dist/lib/agent/core/ChatAgentPrompts.js CHANGED Viewed

@@ -1,5 +1,7 @@
 /** ChatAgentPrompts — Agent 提示词构建和文本处理方法 */
 import fs from 'node:fs';
+import { and, count, eq, inArray } from 'drizzle-orm';
+import { knowledgeEntries } from '../../infrastructure/database/drizzle/schema.js';
 /**
  * 构建原生函数调用模式的系统提示词
  *
@@ -82,31 +84,65 @@ submit_knowledge 的 code 字段必须是「项目特写」— 将技术的基
  */
 export async function buildProjectBriefing({ container }) {
     try {
-        const db = container?.get?.('database');
-        if (!db) {
+        const dbService = container?.get?.('database');
+        const drizzle = dbService?.getDrizzle?.();
+        if (!drizzle) {
             return '';
         }
-        // knowledgeType → kind 映射:
-        //   rule: code-standard, code-style, best-practice, boundary-constraint
-        //   pattern: code-pattern, architecture, solution
-        //   fact: code-relation, inheritance, call-chain, data-flow, module-dependency
-        // V3: knowledge_entries 统一表（candidates 已合并，lifecycle 替代 status）
-        const stats = db
-            .prepare(`
-        SELECT
-          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active') as recipeCount,
-          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType IN ('code-standard','code-style','best-practice','boundary-constraint')) as ruleCount,
-          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType IN ('code-pattern','architecture','solution')) as patternCount,
-          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType IN ('code-relation','inheritance','call-chain','data-flow','module-dependency')) as factCount,
-          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'active' AND knowledgeType = 'boundary-constraint') as guardRuleCount,
-          (SELECT COUNT(*) FROM knowledge_entries WHERE lifecycle = 'pending') as pendingCandidates,
-          (SELECT COUNT(*) FROM knowledge_entries) as totalCandidates
-      `)
-            .get();
-        if (!stats || stats.recipeCount === 0) {
+        const ruleTypes = ['code-standard', 'code-style', 'best-practice', 'boundary-constraint'];
+        const patternTypes = ['code-pattern', 'architecture', 'solution'];
+        const factTypes = [
+            'code-relation',
+            'inheritance',
+            'call-chain',
+            'data-flow',
+            'module-dependency',
+        ];
+        const activeCondition = eq(knowledgeEntries.lifecycle, 'active');
+        const [recipeCount] = drizzle
+            .select({ value: count() })
+            .from(knowledgeEntries)
+            .where(activeCondition)
+            .all();
+        const [ruleCount] = drizzle
+            .select({ value: count() })
+            .from(knowledgeEntries)
+            .where(and(activeCondition, inArray(knowledgeEntries.knowledgeType, ruleTypes)))
+            .all();
+        const [patternCount] = drizzle
+            .select({ value: count() })
+            .from(knowledgeEntries)
+            .where(and(activeCondition, inArray(knowledgeEntries.knowledgeType, patternTypes)))
+            .all();
+        const [factCount] = drizzle
+            .select({ value: count() })
+            .from(knowledgeEntries)
+            .where(and(activeCondition, inArray(knowledgeEntries.knowledgeType, factTypes)))
+            .all();
+        const [guardRuleCount] = drizzle
+            .select({ value: count() })
+            .from(knowledgeEntries)
+            .where(and(activeCondition, eq(knowledgeEntries.knowledgeType, 'boundary-constraint')))
+            .all();
+        const [pendingCandidates] = drizzle
+            .select({ value: count() })
+            .from(knowledgeEntries)
+            .where(eq(knowledgeEntries.lifecycle, 'pending'))
+            .all();
+        const [totalCandidates] = drizzle.select({ value: count() }).from(knowledgeEntries).all();
+        const stats = {
+            recipeCount: recipeCount?.value ?? 0,
+            ruleCount: ruleCount?.value ?? 0,
+            patternCount: patternCount?.value ?? 0,
+            factCount: factCount?.value ?? 0,
+            guardRuleCount: guardRuleCount?.value ?? 0,
+            pendingCandidates: pendingCandidates?.value ?? 0,
+            totalCandidates: totalCandidates?.value ?? 0,
+        };
+        if (stats.recipeCount === 0) {
             return '\n## 项目状态\n⚠️ 知识库为空。建议先执行冷启动（bootstrap_knowledge）。\n';
         }
-        let section = `\n## 项目状态\n- 知识库: ${stats.recipeCount} 条 Recipe（${stats.ruleCount || 0} rule / ${stats.patternCount || 0} pattern / ${stats.factCount || 0} fact）\n- Guard 规则: ${stats.guardRuleCount || 0} 条\n- 候选: ${stats.pendingCandidates} 条待审 / ${stats.totalCandidates} 条总计\n`;
+        let section = `\n## 项目状态\n- 知识库: ${stats.recipeCount} 条 Recipe（${stats.ruleCount} rule / ${stats.patternCount} pattern / ${stats.factCount} fact）\n- Guard 规则: ${stats.guardRuleCount} 条\n- 候选: ${stats.pendingCandidates} 条待审 / ${stats.totalCandidates} 条总计\n`;
         if (stats.pendingCandidates > 10) {
             section += `\n⚠️ 有 ${stats.pendingCandidates} 条候选积压，建议执行批量审核。\n`;
         }

package/dist/lib/agent/core/LoopContext.d.ts CHANGED Viewed

@@ -29,6 +29,7 @@ interface TokenUsage {
 interface SharedState {
     submittedTitles?: Set<string>;
     submittedPatterns?: Set<string>;
+    submittedTriggers?: Set<string>;
     submitToolName?: string;
     _dimensionMeta?: {
         id?: string;

package/dist/lib/agent/core/ToolExecutionPipeline.js CHANGED Viewed

@@ -229,12 +229,25 @@ export const submitDedup = {
         const isError = typeof result === 'object' && (resultObj?.error || resultObj?.status === 'error');
         if (!isRejected && !isError && sharedState.submittedTitles) {
             const normalizedTitle = title.toLowerCase().trim();
+            // ── trigger 去重 (防止不同 title 相同 trigger 的跨维度重复) ──
+            const trigger = String(call.args?.trigger || '')
+                .toLowerCase()
+                .trim();
+            if (trigger && sharedState.submittedTriggers?.has(trigger)) {
+                meta.dedupMessage = `⚠ 重复 trigger: "${trigger}" 已被其他候选占用。`;
+                ctx.runtime.logger.info(`[ToolPipeline] 🔁 duplicate trigger: "${trigger}"`);
+                return;
+            }
             if (sharedState.submittedTitles.has(normalizedTitle)) {
                 meta.dedupMessage = `⚠ 重复提交: "${title}" 已存在。`;
                 ctx.runtime.logger.info(`[ToolPipeline] 🔁 duplicate: "${title}"`);
             }
             else {
                 sharedState.submittedTitles.add(normalizedTitle);
+                // trigger 去重注册
+                if (trigger && sharedState.submittedTriggers) {
+                    sharedState.submittedTriggers.add(trigger);
+                }
                 // 模式指纹去重
                 const contentObj = call.args?.content;
                 const pattern = String(contentObj?.pattern || '');

package/dist/lib/agent/domain/ChatAgentTasks.js CHANGED Viewed

@@ -61,6 +61,10 @@ ${highSim.map((s) => `- ${s.title} (相似度: ${s.similarity})`).join('\n')}
 export async function taskDiscoverAllRelations(context, { batchSize = 20 } = {}) {
     const { container } = context;
     const agentFactory = container.get('agentFactory');
+    // Mock 模式下跳过 AI 关系发现
+    if (agentFactory.getAiProviderInfo?.()?.name === 'mock') {
+        return { discovered: 0, message: 'AI Provider 未配置（Mock 模式），跳过关系发现。' };
+    }
     return agentFactory.discoverRelations({ batchSize });
 }
 /** 任务: 批量 AI 补全候选语义字段 */

package/dist/lib/agent/forced-summary.js CHANGED Viewed

@@ -37,7 +37,7 @@ export async function produceForcedSummary({ aiProvider, source, toolCalls = [],
     const candidateCount = toolCalls.filter((tc) => tc.tool === 'submit_knowledge' || tc.tool === 'submit_with_check').length;
     let finalReply;
     // 如果熔断器已打开，跳过 AI 调用直接合成摘要
-    const isCircuitOpen = aiProvider._circuitState === 'OPEN';
+    const isCircuitOpen = aiProvider._circuitState === 'OPEN' || aiProvider.name === 'mock';
     if (isCircuitOpen) {
         const outputType = isAnalyst ? 'analysis' : isSystem ? 'digest' : 'summary';
         logger.warn(`[ForcedSummary] circuit breaker is OPEN — skipping AI summary, using synthetic ${outputType}`);
@@ -160,7 +160,7 @@ ${toolContextSummary}
                 .slice(0, 8);
             const classesExplored = toolCalls
                 .filter((tc) => tc.tool === 'get_class_info' || tc.tool === 'get_class_hierarchy')
-                .map((tc) => (tc.args || tc.params || {}).className)
+                .map((tc) => (tc.args || tc.params)?.className)
                 .filter((v) => Boolean(v))
                 .slice(0, 10);
             finalReply = `## 代码分析报告\n\n通过 **${toolCalls.length} 次工具调用**（${iterations} 轮迭代）探索了项目代码。\n\n`;
@@ -228,6 +228,11 @@ ${toolContextSummary}
             finalReply += '> ⚠️ AI 服务异常，未能生成完整分析。请稍后重试或缩小分析范围。';
         }
     }
+    // 兜底: 确保 finalReply 始终非空
+    if (!finalReply) {
+        logger.warn('[ForcedSummary] ⚠ finalReply is empty after all paths — using fallback');
+        finalReply = `## 分析总结\n\n通过 **${toolCalls.length} 次工具调用**探索了项目代码，但未能生成完整分析。请重试或缩小分析范围。`;
+    }
     logger.info(`[ForcedSummary] ✅ forced summary — ${finalReply.length} chars`);
     return { reply: finalReply, tokenUsage: resultTokenUsage };
 }

package/dist/lib/agent/memory/ActiveContext.d.ts CHANGED Viewed

@@ -1,8 +1,6 @@
 /**
  * ActiveContext — 合并 WorkingMemory + ReasoningTrace 为统一的会话工作记忆
  *
- * 设计来源: docs/copilot/memory-system-redesign.md §4.3, §6.2
- *
  * 三个内部子区:
  *   1. Scratchpad   — Agent 通过 note_finding 主动标记的发现 (不可压缩)
  *   2. ObservationLog — 每轮 ReAct 记录 (合并原 RT.rounds + WM.observations，滑动窗口压缩)

package/dist/lib/agent/memory/ActiveContext.js CHANGED Viewed

@@ -1,8 +1,6 @@
 /**
  * ActiveContext — 合并 WorkingMemory + ReasoningTrace 为统一的会话工作记忆
  *
- * 设计来源: docs/copilot/memory-system-redesign.md §4.3, §6.2
- *
  * 三个内部子区:
  *   1. Scratchpad   — Agent 通过 note_finding 主动标记的发现 (不可压缩)
  *   2. ObservationLog — 每轮 ReAct 记录 (合并原 RT.rounds + WM.observations，滑动窗口压缩)

package/dist/lib/agent/memory/MemoryEmbeddingStore.d.ts ADDED Viewed

@@ -0,0 +1,49 @@
+/**
+ * MemoryEmbeddingStore — 向量嵌入的 JSON sidecar 存储
+ *
+ * 将 Agent Memory 的向量嵌入从 SQLite BLOB 迁移到独立 JSON 文件，
+ * 与 Knowledge 侧 HNSW `.asvec` 的设计理念对齐：
+ * **结构化数据存 SQLite，向量存独立文件。**
+ *
+ * 设计:
+ *   - 内存 Map<id, number[]> 缓存，启动时一次性加载
+ *   - 写入时更新内存 + debounced flush 到 JSON
+ *   - 崩溃丢失可通过 embedAllMemories() backfill 恢复
+ *
+ * 文件位置: .autosnippet/context/memory_embeddings.json
+ *
+ * @module MemoryEmbeddingStore
+ */
+export declare class MemoryEmbeddingStore {
+    #private;
+    /**
+     * @param projectRoot 项目根目录
+     * @param opts.filePath 覆盖默认文件路径 (测试用)
+     */
+    constructor(projectRoot: string, opts?: {
+        filePath?: string;
+    });
+    /** 获取单条 embedding */
+    get(id: string): number[] | null;
+    /** 设置单条 embedding */
+    set(id: string, embedding: number[]): void;
+    /** 批量设置 embeddings */
+    batchSet(entries: Array<{
+        id: string;
+        embedding: number[];
+    }>): number;
+    /** 删除单条 embedding */
+    delete(id: string): boolean;
+    /** 检查是否有 embedding */
+    has(id: string): boolean;
+    /** 返回所有缺少 embedding 的 ID (给定候选 ID 列表) */
+    getMissingIds(candidateIds: string[]): string[];
+    /** 缓存大小 */
+    get size(): number;
+    /** 清除所有 embeddings (用于重建) */
+    clear(): void;
+    /** 立即刷写到磁盘 (shutdown / 测试用) */
+    flushSync(): void;
+    /** GC: 移除不在给定 ID 集合中的 embeddings */
+    gc(activeIds: Set<string>): number;
+}

package/dist/lib/agent/memory/MemoryEmbeddingStore.js ADDED Viewed

@@ -0,0 +1,159 @@
+/**
+ * MemoryEmbeddingStore — 向量嵌入的 JSON sidecar 存储
+ *
+ * 将 Agent Memory 的向量嵌入从 SQLite BLOB 迁移到独立 JSON 文件，
+ * 与 Knowledge 侧 HNSW `.asvec` 的设计理念对齐：
+ * **结构化数据存 SQLite，向量存独立文件。**
+ *
+ * 设计:
+ *   - 内存 Map<id, number[]> 缓存，启动时一次性加载
+ *   - 写入时更新内存 + debounced flush 到 JSON
+ *   - 崩溃丢失可通过 embedAllMemories() backfill 恢复
+ *
+ * 文件位置: .autosnippet/context/memory_embeddings.json
+ *
+ * @module MemoryEmbeddingStore
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** debounce flush 延迟 (ms) */
+const FLUSH_DELAY_MS = 2000;
+export class MemoryEmbeddingStore {
+    /** 内存缓存: id → embedding vector */
+    #cache = new Map();
+    /** JSON 文件路径 */
+    #filePath;
+    /** debounce timer */
+    #flushTimer = null;
+    /** dirty flag */
+    #dirty = false;
+    /**
+     * @param projectRoot 项目根目录
+     * @param opts.filePath 覆盖默认文件路径 (测试用)
+     */
+    constructor(projectRoot, opts) {
+        this.#filePath =
+            opts?.filePath ?? join(projectRoot, '.autosnippet', 'context', 'memory_embeddings.json');
+        this.#load();
+    }
+    /** 获取单条 embedding */
+    get(id) {
+        return this.#cache.get(id) ?? null;
+    }
+    /** 设置单条 embedding */
+    set(id, embedding) {
+        this.#cache.set(id, embedding);
+        this.#scheduleDirtyFlush();
+    }
+    /** 批量设置 embeddings */
+    batchSet(entries) {
+        let count = 0;
+        for (const { id, embedding } of entries) {
+            this.#cache.set(id, embedding);
+            count++;
+        }
+        if (count > 0) {
+            this.#scheduleDirtyFlush();
+        }
+        return count;
+    }
+    /** 删除单条 embedding */
+    delete(id) {
+        const existed = this.#cache.delete(id);
+        if (existed) {
+            this.#scheduleDirtyFlush();
+        }
+        return existed;
+    }
+    /** 检查是否有 embedding */
+    has(id) {
+        return this.#cache.has(id);
+    }
+    /** 返回所有缺少 embedding 的 ID (给定候选 ID 列表) */
+    getMissingIds(candidateIds) {
+        return candidateIds.filter((id) => !this.#cache.has(id));
+    }
+    /** 缓存大小 */
+    get size() {
+        return this.#cache.size;
+    }
+    /** 清除所有 embeddings (用于重建) */
+    clear() {
+        this.#cache.clear();
+        this.#scheduleDirtyFlush();
+    }
+    /** 立即刷写到磁盘 (shutdown / 测试用) */
+    flushSync() {
+        if (this.#flushTimer) {
+            clearTimeout(this.#flushTimer);
+            this.#flushTimer = null;
+        }
+        if (!this.#dirty) {
+            return;
+        }
+        this.#writeFile();
+        this.#dirty = false;
+    }
+    /** GC: 移除不在给定 ID 集合中的 embeddings */
+    gc(activeIds) {
+        let removed = 0;
+        for (const id of this.#cache.keys()) {
+            if (!activeIds.has(id)) {
+                this.#cache.delete(id);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            this.#scheduleDirtyFlush();
+        }
+        return removed;
+    }
+    // ═══════════════════════════════════════════════════════════
+    // Private
+    // ═══════════════════════════════════════════════════════════
+    #load() {
+        try {
+            if (existsSync(this.#filePath)) {
+                const raw = readFileSync(this.#filePath, 'utf-8');
+                const data = JSON.parse(raw);
+                for (const [id, vec] of Object.entries(data)) {
+                    if (Array.isArray(vec)) {
+                        this.#cache.set(id, vec);
+                    }
+                }
+            }
+        }
+        catch {
+            // 文件不存在或解析失败 → 空缓存，后续 backfill 会重建
+        }
+    }
+    #writeFile() {
+        try {
+            const dir = dirname(this.#filePath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const obj = {};
+            for (const [id, vec] of this.#cache) {
+                obj[id] = vec;
+            }
+            writeFileSync(this.#filePath, JSON.stringify(obj), 'utf-8');
+        }
+        catch {
+            // 写入失败不阻塞运行时；下次 flush 或 backfill 会重试
+        }
+    }
+    #scheduleDirtyFlush() {
+        this.#dirty = true;
+        if (this.#flushTimer) {
+            return; // 已有 pending timer
+        }
+        this.#flushTimer = setTimeout(() => {
+            this.#flushTimer = null;
+            if (this.#dirty) {
+                this.#writeFile();
+                this.#dirty = false;
+            }
+        }, FLUSH_DELAY_MS);
+    }
+}

package/dist/lib/agent/memory/MemoryRetriever.d.ts CHANGED Viewed

@@ -10,6 +10,7 @@
  *
  * @module MemoryRetriever
  */
+import type { MemoryEmbeddingStore } from './MemoryEmbeddingStore.js';
 import type { DeserializedMemory } from './MemoryStore.js';
 import { MemoryStore } from './MemoryStore.js';
 /** 带评分的记忆检索结果 */
@@ -49,6 +50,7 @@ export declare class MemoryRetriever {
     /** @param [opts.embeddingFn] 向量嵌入函数 (异步) */
     constructor(store: MemoryStore, opts?: {
         embeddingFn?: EmbeddingFn;
+        embeddingStore?: MemoryEmbeddingStore;
     });
     /**
      * 综合检索: recency × importance × relevance

package/dist/lib/agent/memory/MemoryRetriever.js CHANGED Viewed

@@ -25,10 +25,13 @@ export class MemoryRetriever {
     #store;
     /** 向量嵌入函数 */
     #embeddingFn;
+    /** 向量嵌入存储 (JSON sidecar) */
+    #embeddingStore;
     /** @param [opts.embeddingFn] 向量嵌入函数 (异步) */
     constructor(store, opts = {}) {
         this.#store = store;
         this.#embeddingFn = typeof opts.embeddingFn === 'function' ? opts.embeddingFn : null;
+        this.#embeddingStore = opts.embeddingStore ?? null;
     }
     // ═══════════════════════════════════════════════════════════
     // 综合检索
@@ -71,14 +74,15 @@ export class MemoryRetriever {
             const importance = (m.importance || 5) / 10;
             // Relevance: 词汇相关性 (lexical)
             const lexicalRelevance = MemoryRetriever.#computeRelevance(lowerQuery, queryTokens, m.content);
-            // 向量相关性: 对有 embedding 的记忆计算余弦相似度
+            // 向量相关性: 从 embeddingStore 查找 embedding 做余弦相似度
             const deserialized = MemoryStore.deserialize(m);
             let vectorRelevance = 0;
-            if (queryVec && deserialized.embedding) {
-                vectorRelevance = Math.max(0, cosineSimilarity(queryVec, deserialized.embedding));
+            const storedEmbedding = this.#embeddingStore?.get(m.id) ?? null;
+            if (queryVec && storedEmbedding) {
+                vectorRelevance = Math.max(0, cosineSimilarity(queryVec, storedEmbedding));
             }
             // 混合相关性: 有向量时 0.6 * vector + 0.4 * lexical，否则纯 lexical
-            const relevance = queryVec && deserialized.embedding
+            const relevance = queryVec && storedEmbedding
                 ? 0.6 * vectorRelevance + 0.4 * lexicalRelevance
                 : lexicalRelevance;
             const score = WEIGHT_RECENCY * recency + WEIGHT_IMPORTANCE * importance + WEIGHT_RELEVANCE * relevance;
@@ -199,18 +203,28 @@ export class MemoryRetriever {
      * @returns 成功嵌入的记忆数
      */
     async embedAllMemories(batchSize = 20) {
-        if (!this.#embeddingFn) {
+        if (!this.#embeddingFn || !this.#embeddingStore) {
             return 0;
         }
-        const missing = this.#store.getWithoutEmbedding(batchSize);
-        if (missing.length === 0) {
+        // 从 MemoryStore 获取所有活跃记忆 ID，找出 embeddingStore 中缺失的
+        const allActive = this.#store.getAllActive();
+        const allIds = allActive.map((m) => m.id);
+        const missingIds = this.#embeddingStore.getMissingIds(allIds);
+        if (missingIds.length === 0) {
             return 0;
         }
+        // 取前 batchSize 条
+        const batch = missingIds.slice(0, batchSize);
+        const contentMap = new Map(allActive.map((m) => [m.id, m.content]));
         const entries = [];
-        for (const item of missing) {
+        for (const id of batch) {
+            const content = contentMap.get(id);
+            if (!content) {
+                continue;
+            }
             try {
-                const vec = await this.#embeddingFn(item.content);
-                entries.push({ id: item.id, embedding: vec });
+                const vec = await this.#embeddingFn(content);
+                entries.push({ id, embedding: vec });
             }
             catch {
                 // 单条失败不阻塞
@@ -219,7 +233,7 @@ export class MemoryRetriever {
         if (entries.length === 0) {
             return 0;
         }
-        return this.#store.batchUpdateEmbeddings(entries);
+        return this.#embeddingStore.batchSet(entries);
     }
     /**
      * 使用嵌入函数计算语义相关性 (余弦相似度)