@zooique/memora 0.3.0 → 2.0.0

package/dist/agent/managers/memoryDecayScheduler.js

@@ -6,6 +6,7 @@
  *   2. 衰减指标统计（执行次数 / 累计衰减记忆数 / 上次衰减时间）
  *   3. 衰减可观测性（Tracer Span 埋点）
  *   4. 衰减完成事件发射（decayCompleted）
+ *   5. L2 时效性评估（可选，backgroundProvider + index 注入后启用）
  *
  * 设计理由：
  *   agent.ts 原承担 15+ 职责，记忆衰减是独立的生命周期职责，
@@ -17,6 +18,12 @@
  *   - work-projection（作品投影）
  *   不衰减 persona/rule/skill（配置型记忆不应衰减）
  *
+ * L2 时效性评估（可选增强）：
+ *   - 衰减后扫描低分记忆（score < TIMELINESS_LOW_SCORE_THRESHOLD）
+ *   - 调用 LLM 判断是否"已过时"（如过时的技术栈、已变更的偏好）
+ *   - 过时则进一步降级（score → TIMELINESS_OUTDATED_SCORE）
+ *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
+ *
  * 自然生长原则：
  *   - 不持有 storage 引用（start 时注入，stop 时释放）
  *   - 通过回调发射事件（不继承 TypedEventEmitter，避免与 Agent 事件系统耦合）
@@ -28,6 +35,22 @@ import { toError } from '../../utils/errors.js';
 import { nowIso } from '../../utils/time.js';
 import { SOURCE_LABELS } from '../../memory/types.js';
 import { NOOP_TRACER, TRACE_SPANS } from '../../agent/tracer.js';
+// parseLlmJson 用于解析 LLM 时效性判断结果（与 SessionArchiver 同模式）
+import { parseLlmJson } from '../../utils/json.js';
+import { truncate } from '../../utils/strings.js';
+// ─── L2 时效性评估常量 ────────────────────────────────────
+/** 参与时效性评估的 source 标签（与衰减范围一致） */
+const TIMELINESS_SOURCES = [SOURCE_LABELS.INSIGHT, SOURCE_LABELS.PROFILE, SOURCE_LABELS.WORK_PROJECTION];
+/** 低分记忆阈值（score 低于此值的记忆进入 LLM 时效性评估） */
+const TIMELINESS_LOW_SCORE_THRESHOLD = 0.3;
+/** 单次时效性评估的记忆条数上限（控制 LLM 调用量） */
+const TIMELINESS_EVALUATE_LIMIT = 20;
+/** LLM 时效性判断超时（ms） */
+const TIMELINESS_TIMEOUT_MS = 15_000;
+/** 被判定为过时的记忆降级到此 score（接近物理删除阈值，但保留可恢复性） */
+const TIMELINESS_OUTDATED_SCORE = 0.05;
+/** 候选记忆内容预览长度（截断后送入 LLM） */
+const TIMELINESS_CONTENT_PREVIEW_LEN = 200;
 /**
  * 记忆衰减调度器
  *
@@ -43,6 +66,10 @@ export class MemoryDecayScheduler {
     tracer;
     /** 衰减完成事件发射回调 */
     onDecayCompleted;
+    /** 后台 LLM Provider（可选，用于 L2 时效性评估，未注入时跳过） */
+    backgroundProvider;
+    /** 完整记忆存储（可选，用于 L2 读取低分记忆和降级，未注入时跳过） */
+    index;
     /** 衰减定时器（null 表示未启动） */
     decayTimer = null;
     /** 衰减目标存储（start 时注入，stop 时释放） */
@@ -57,6 +84,9 @@ export class MemoryDecayScheduler {
     constructor(opts) {
         this.tracer = opts.tracer ?? NOOP_TRACER;
         this.onDecayCompleted = opts.onDecayCompleted;
+        // L2 可选依赖：未注入时 evaluateTimeliness 静默跳过
+        this.backgroundProvider = opts.backgroundProvider ?? null;
+        this.index = opts.index ?? null;
     }
     /**
      * 启动定期衰减
@@ -130,5 +160,190 @@ export class MemoryDecayScheduler {
             lastRunAt: this.metricLastDecayAt,
         };
     }
+    // ─── L2 时效性评估（可选，backgroundProvider + index 注入后启用） ───
+    /**
+     * 时效性评估：扫描低分记忆，调用 LLM 判断是否已过时
+     *
+     * 流程：
+     *   1. 从 insight/profile/work-projection 加载低分记忆（score < 0.3）
+     *   2. 对每条低分记忆（上限 20 条），调用 LLM 判断是否"已过时"
+     *   3. 过时则进一步降级（score → 0.05，接近物理删除阈值但保留可恢复性）
+     *   4. 返回评估报告
+     *
+     * 使用场景：
+     *   - 衰减后调用（onDecayCompleted 回调中），对低分记忆做 LLM 二次评估
+     *   - 宿主定时任务定期调用（如每天一次）
+     *   - 用户手动触发（记忆管理面板的"清理过时记忆"按钮）
+     *
+     * 安全设计：
+     *   - 不物理删除——仅降级 score，保留可恢复性
+     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
+     *   - 单条 LLM 失败不阻塞后续评估
+     *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
+     *
+     * @param signal 可选的 AbortSignal（取消正在进行的 LLM 评估）
+     * @returns 评估报告
+     */
+    async evaluateTimeliness(signal) {
+        // 可选依赖未注入时静默降级（向后兼容）
+        if (!this.backgroundProvider || !this.index) {
+            return {
+                scannedCount: 0,
+                outdatedCount: 0,
+                demotedIds: [],
+                skippedReason: 'backgroundProvider 或 index 未注入',
+            };
+        }
+        // ── 步骤 1：加载低分记忆 ──
+        const lowScoreMemories = [];
+        for (const source of TIMELINESS_SOURCES) {
+            const memories = this.index.getBySource(source);
+            // 筛选低分记忆（score 低于阈值）
+            lowScoreMemories.push(...memories.filter((m) => m.score < TIMELINESS_LOW_SCORE_THRESHOLD));
+        }
+        if (lowScoreMemories.length === 0) {
+            return {
+                scannedCount: 0,
+                outdatedCount: 0,
+                demotedIds: [],
+                skippedReason: '无低分记忆需评估',
+            };
+        }
+        // 按 score 升序排列（最低分优先评估），取前 20 条
+        lowScoreMemories.sort((a, b) => a.score - b.score);
+        const limited = lowScoreMemories.slice(0, TIMELINESS_EVALUATE_LIMIT);
+        // ── 步骤 2：逐条调用 LLM 判断时效性 ──
+        const demotedIds = [];
+        let outdatedCount = 0;
+        for (const memory of limited) {
+            try {
+                const verdict = await this.judgeTimeliness(memory, signal);
+                if (verdict.isOutdated) {
+                    this.demoteOutdatedMemory(memory);
+                    demotedIds.push(memory.id);
+                    outdatedCount++;
+                    logger.info({ memoryId: memory.id, reason: verdict.reason }, '时效性评估：降级过时记忆');
+                }
+            }
+            catch (err) {
+                // 单条 LLM 判断失败不阻塞后续评估
+                logger.warn({ err, memoryId: memory.id }, '时效性评估：LLM 判断失败，跳过此条');
+            }
+        }
+        return {
+            scannedCount: limited.length,
+            outdatedCount,
+            demotedIds,
+        };
+    }
+    /**
+     * 调用 LLM 判断单条记忆的时效性
+     *
+     * 使用结构化 JSON 输出（isOutdated + reason），
+     * 参照 SessionArchiver.generateSummary 的 parseLlmJson 模式。
+     *
+     * LLM 失败时抛出异常（由 evaluateTimeliness 捕获并降级跳过此条）。
+     *
+     * @param memory 待评估的记忆
+     * @param signal 可选的 AbortSignal
+     * @returns LLM 判断结果
+     */
+    async judgeTimeliness(memory, signal) {
+        const messages = buildTimelinessMessages(memory);
+        let llmResponse = '';
+        // 流式累积模式（与 TextPolishManager / SessionArchiver 一致）
+        for await (const chunk of this.backgroundProvider.chat(messages, {
+            maxTokens: 200,
+            temperature: 0,
+            timeoutMs: TIMELINESS_TIMEOUT_MS,
+            signal,
+        })) {
+            if (chunk.content)
+                llmResponse += chunk.content;
+        }
+        // 解析 LLM 响应（JSON 格式）
+        const parsed = parseLlmJson(llmResponse.trim());
+        if (!parsed) {
+            throw new Error('LLM 时效性判断返回非法 JSON');
+        }
+        return {
+            memoryId: memory.id,
+            isOutdated: parsed.isOutdated === true,
+            reason: typeof parsed.reason === 'string' ? parsed.reason : '(LLM 未提供理由)',
+        };
+    }
+    /**
+     * 降级过时记忆（score → TIMELINESS_OUTDATED_SCORE）
+     *
+     * 安全设计：
+     *   - 不物理删除，仅降低 score，保留可恢复性
+     *   - 通过 upsert 覆盖原记忆（保持 id/source/name/createdAt 不变）
+     *   - 更新 accessedAt，标记最近被处理过
+     *
+     * @param memory 待降级的过时记忆
+     */
+    demoteOutdatedMemory(memory) {
+        const demoted = {
+            ...memory,
+            score: TIMELINESS_OUTDATED_SCORE,
+            accessedAt: nowIso(),
+        };
+        this.index.upsert(demoted);
+    }
+}
+// ─── L2 时效性评估 Prompt 模板（模块级函数，与 buildDedupMessages 同模式） ───
+/**
+ * 构建时效性判断的 LLM 消息
+ *
+ * 设计要点：
+ *   - system 消息定义判断规则（过时 = 信息已失效/不再适用）
+ *   - user 消息携带记忆内容和元数据（source/score/createdAt）
+ *   - 要求输出结构化 JSON（isOutdated + reason）
+ *   - few-shot 示例降低 LLM 误判率
+ *
+ * @param memory 待评估的记忆
+ * @returns system + user 消息数组
+ */
+function buildTimelinessMessages(memory) {
+    const content = memory.content.length > TIMELINESS_CONTENT_PREVIEW_LEN
+        ? truncate(memory.content, TIMELINESS_CONTENT_PREVIEW_LEN, '…[截断]')
+        : memory.content;
+    return [
+        {
+            role: 'system',
+            content: `你是记忆时效性评估助手。判断给定的记忆是否已过时（信息已失效或不再适用）。
+
+判断规则：
+- 已过时 = 信息明确失效（如旧版本号、已废弃的 API、已变更的偏好）
+- 未过时 = 信息仍然有效（如通用编程原则、长期偏好、历史事件记录）
+- 不确定时倾向"未过时"（避免误删有效记忆）
+
+输出 JSON 格式：
+{
+  "isOutdated": true/false,
+  "reason": "判断理由（简短说明）"
+}
+
+示例：
+输入: "用户使用 React 16 进行开发"（createdAt: 2020-01-01）
+输出: {"isOutdated": true, "reason": "React 16 已是旧版本，当前普遍使用 React 18+"}
+
+输入: "用户偏好函数式编程风格"
+输出: {"isOutdated": false, "reason": "编程风格偏好通常是长期的"}`,
+        },
+        {
+            role: 'user',
+            content: `请判断以下记忆是否已过时：
+
+记忆详情：
+- 名称：${memory.name}
+- 来源：${memory.source}
+- 当前 score：${memory.score}（低分，可能因长期未访问而衰减）
+- 创建时间：${memory.createdAt}
+- 内容：${content}
+
+请输出 JSON 判断结果。`,
+        },
+    ];
 }
 //# sourceMappingURL=memoryDecayScheduler.js.map

package/dist/agent/managers/memoryDecayScheduler.js.map

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

package/dist/agent/managers/memoryInspector.d.ts

@@ -1,21 +1,35 @@
 /**
- * 记忆查看器 — 统一查看记忆快照 + 搜索 + 统计
+ * 记忆管理器 — 统一的记忆读写入口
  *
- * 从 Agent 拆分出来，负责只读记忆查询操作。
+ * 从 Agent 拆分出来，负责记忆的查询 + 写入操作。
+ * 写方法以 writeXxx 前缀命名，与读方法明确区分。
  *
  * 设计原则：
- *   - 纯只读——不动任何组件状态
- *   - 同步返回——避免数据不一致（不调 LLM、不调 SQLite 写入）
+ *   - 读写统一入口——writeXxx 前缀区分写操作，降低认知负荷
+ *   - 同步返回——避免数据不一致（不调 LLM、不调 SQLite 异步写入）
  *   - 轻量——每层只返回前 N 条 + 总数
+ *   - 静默降级——relationStore 未注入时关系方法静默 no-op（ADR-014 降级优先）
+ *
+ * 方法清单：
+ *   - 只读查询：snapshot / search / searchHybrid / stats /
+ *     getRelations / getAllRelations / getRelationPath / getRelationNeighbors /
+ *     getById / getBySource / list / listDeleted / getDeletedById /
+ *     sourceHealth / suggest
+ *   - 写操作（writeXxx 前缀）：
+ *     writeUpsert / writeDelete / writeRestore / writePurge / writePurgeExpired /
+ *     writeAddRelation / writeRemoveRelation
+ *   - LLM 记忆治理（异步，backgroundProvider 未注入时静默降级）：
+ *     deduplicateMemories（语义去重）
  */
 import type { Memory } from '../../memory/types.js';
 import type { IMemoryStorage } from '../../memory/storageInterface.js';
 import type { IMemoryRelationStore } from '../../memory/relationStore.js';
 import type { MemoryRelation, RelationDirection, RelationPath, RelationNeighbor } from '../../memory/types.js';
-import type { VectorStore } from '../../memory/vectorStore.js';
+import type { IVectorStore } from '../../memory/vectorStore.js';
 import type { MessageHistory } from '../../agent/messageHistory.js';
 import type { AgentLoop } from '../../agent/loop.js';
-import type { MemoryAdvisor, SourceHealthReport, SuggestOptions, SuggestHit } from '../../agent/managers/memoryAdvisor.js';
+import type { MemoryAdvisor, SourceHealthReport, SuggestOptions, SuggestHit, ConflictReport } from '../../agent/managers/memoryAdvisor.js';
+import type { LlmProvider } from '../../llm/provider.js';
 export type { SourceHealthStatus, SourceHealthEntry, SourceHealthReport, SuggestOptions, SuggestHit, } from '../../agent/managers/memoryAdvisor.js';
 /** 记忆快照 */
 export interface MemorySnapshot {
@@ -91,61 +105,82 @@ export interface AgentStats {
     /** 关系边总数（ADR-014，relationStore 未注入时为 0） */
     relationCount: number;
 }
+/** 名称高度相似的候选记忆对（待 LLM 判断语义等价性） */
+export interface DedupPair {
+    /** 记忆 A（score 较高，作为保留候选） */
+    a: Memory;
+    /** 记忆 B（score 较低，作为降级候选） */
+    b: Memory;
+    /** 名称归一化相似度（0-1，越小越相似） */
+    nameSimilarity: number;
+}
+/** LLM 对单对记忆的语义等价判断结果 */
+export interface DedupVerdict {
+    /** 是否语义等价（true → 降级低分记忆） */
+    isDuplicate: boolean;
+    /** 合并后的内容（isDuplicate=true 时提供，保留更完整的信息） */
+    mergedContent?: string;
+    /** LLM 判断理由（便于审计和调试） */
+    reason: string;
+}
+/** 降级记忆的审计详情（DedupReport.verdicts 元素，供 UI 展示"为什么降级"） */
+export interface DedupVerdictSummary {
+    /** 被降级的记忆 ID（与 demotedIds 元素一一对应） */
+    demotedId: string;
+    /** LLM 判断理由（便于用户审计降级是否合理） */
+    reason: string;
+    /** 合并后的完整内容（便于用户验证合并质量；未提供 mergedContent 时省略，渲染器负责截断展示） */
+    mergedContent?: string;
+}
+/** 语义去重报告（deduplicateMemories 返回值） */
+export interface DedupReport {
+    /** 扫描的候选记忆总数 */
+    scannedCount: number;
+    /** 发现的名称相似对数 */
+    pairCount: number;
+    /** LLM 判定为语义等价并执行降级的对数 */
+    deduplicatedCount: number;
+    /** 被降级的记忆 ID 列表（score 降至 DEDUP_LOW_SCORE，未物理删除） */
+    demotedIds: string[];
+    /** 降级审计详情（与 demotedIds 一一对应，供 UI 展示 reason + mergedContentPreview） */
+    verdicts?: DedupVerdictSummary[];
+    /** 跳过原因（LLM 不可用 / 无候选对 / LLM 失败降级） */
+    skippedReason?: string;
+}
 export declare class MemoryInspector {
     private readonly index;
     private readonly loop;
     private readonly history;
     /** 向量存储（可选，提供时 searchHybrid 启用语义搜索） */
     private vectorStore;
-    /** 关系存储（可选，ADR-014 侧车，未注入时跳过关系查询） */
+    /** 关系存储（可选，ADR-014 侧车，未注入时关系方法静默降级） */
     private readonly relationStore;
     /** 记忆顾问（sourceHealth + suggest 委托） */
     private readonly advisor;
+    /** 后台 LLM Provider（可选，用于语义去重等异步治理任务，未注入时降级跳过） */
+    private readonly backgroundProvider;
     /**
-     * @param index - 记忆存储（用于搜索 + 统计）
+     * @param index - 记忆存储（用于读写操作）
      * @param loop - AgentLoop（用于获取工作记忆）
      * @param history - MessageHistory（用于获取当前会话信息）
      * @param advisor - 记忆顾问（组合根一致性，由 assembler.ts 显式注入，必填）
-     * @param relationStore - 关系存储侧车（可选，ADR-014，未注入时关系相关方法降级返回空）
+     * @param relationStore - 关系存储侧车（可选，ADR-014，未注入时关系方法降级返回空/no-op）
+     * @param backgroundProvider - 后台 LLM Provider（可选，用于语义去重，未注入时降级跳过）
      */
-    constructor(index: IMemoryStorage, loop: AgentLoop, history: MessageHistory, advisor: MemoryAdvisor, relationStore?: IMemoryRelationStore | null);
+    constructor(index: IMemoryStorage, loop: AgentLoop, history: MessageHistory, advisor: MemoryAdvisor, relationStore?: IMemoryRelationStore | null, backgroundProvider?: LlmProvider | null);
     /**
      * 注入向量存储（由 Agent 在初始化后调用，解决构造时序）
      */
-    setVectorStore(vs: VectorStore | null): void;
-    /**
-     * 插入或更新记忆
-     *
-     * @param memory 完整记忆对象
-     */
-    upsert(memory: Memory): void;
-    /**
-     * 删除记忆（软删除，写入 deletedAt）
-     *
-     * @param id 记忆唯一标识（${source}:${name} 格式）
-     */
-    delete(id: string): void;
+    setVectorStore(vs: IVectorStore | null): void;
     /**
-     * 恢复软删除的记忆（清除 deletedAt）
-     *
-     * @param id 记忆唯一标识
-     */
-    restore(id: string): void;
-    /**
-     * 物理删除记忆（不可恢复，用于回收站彻底删除）
-     *
-     * @param id 记忆唯一标识
-     */
-    purge(id: string): void;
-    /**
-     * 列出回收站中的软删除记忆
+     * 列出回收站中的软删除记忆（只读查询）
      *
      * @param limit 返回数量上限（默认 50）
      * @returns 软删除记忆列表（按 deletedAt 降序）
      */
     listDeleted(limit?: number): Memory[];
     /**
-     * 按 ID 获取单条软删除记忆
+     * 按 ID 获取单条软删除记忆（只读查询）
      *
      * 用于 restore/purge 操作前的存在性校验，避免 listDeleted 默认 50 上限
      * 导致回收站超量时操作失效。
@@ -154,13 +189,6 @@ export declare class MemoryInspector {
      * @returns 软删除记忆，不存在或未软删除时返回 null
      */
     getDeletedById(id: string): Memory | null;
-    /**
-     * 清理过期的软删除记忆
-     *
-     * @param before 时间阈值，deletedAt 早于此值的记忆将被物理删除
-     * @returns 被清理的记忆数量
-     */
-    purgeExpired(before: Date): number;
     /**
      * 按 ID 获取单条活跃记忆（已软删除的返回 null）
      *
@@ -243,26 +271,6 @@ export declare class MemoryInspector {
      * @returns 全部关系边数组
      */
     getAllRelations(): MemoryRelation[];
-    /**
-     * 添加记忆关系（透传 relationStore）
-     *
-     * 用于宿主 UI 手动创建关系（关系图右键菜单 → 连线 → 创建关系）。
-     * relationStore 未注入时静默降级（不阻塞）。
-     *
-     * @param relation 关系边数据
-     */
-    addRelation(relation: MemoryRelation): void;
-    /**
-     * 删除记忆关系（透传 relationStore）
-     *
-     * 用于宿主 UI 手动删除关系（关系图右键菜单 → 编辑关系 → 删除）。
-     * relationStore 未注入时静默降级（不阻塞）。
-     *
-     * @param sourceId 关系起点
-     * @param targetId 关系终点
-     * @param type 关系类型
-     */
-    removeRelation(sourceId: string, targetId: string, type: string): void;
     /**
      * 记忆关系路径追溯（ADR-014 扩展，Phase 5.1）
      *
@@ -317,5 +325,163 @@ export declare class MemoryInspector {
      * @param options - 推荐选项
      */
     suggest(query?: string, options?: SuggestOptions): SuggestHit[];
+    /**
+     * L3 冲突检测（委托给 MemoryAdvisor.detectConflicts）
+     *
+     * 同 source 内配对，调用 LLM 判断语义冲突，仅检测不修复（需用户决策）。
+     * backgroundProvider 未注入时由 advisor 内部静默跳过（返回 skippedReason 报告）。
+     *
+     * 委托方法存在理由：agent.ts 仅持有 memoryInspector 引用，不直接持有 memoryAdvisor，
+     * 通过此转发保持"inspector 是读写 + 治理统一入口"语义。
+     *
+     * @param signal 可选的 AbortSignal
+     * @returns 冲突报告（扫描数 / 冲突数 / 冲突详情列表 / 跳过原因）
+     */
+    detectConflicts(signal?: AbortSignal): Promise<ConflictReport>;
+    /**
+     * 插入或更新记忆
+     *
+     * @param memory 完整记忆对象
+     */
+    writeUpsert(memory: Memory): void;
+    /**
+     * 提升记忆的 score（L2 采纳反哺内核）
+     *
+     * 用户在补全模块采纳某条候选后，通过 IPC 调用此方法反哺到内核 Memory.score。
+     * 与 recall.ts 的 boostScore 路径语义一致（"越常用越重要"），但触发源不同：
+     *   - recall.ts boostScore：召回时触发（被动）
+     *   - writeBoost：用户主动采纳时触发（主动）
+     *
+     * 设计原则：
+     *   - 复用现有 upsert 路径，不新增存储层接口
+     *   - score 上限 1.0（与 recall.ts SCORE_CEILING 一致）
+     *   - 同步更新 accessedAt，避免被衰减机制误降级
+     *   - 记忆不存在时静默返回 false（补全候选可能来自对话历史，无对应记忆）
+     *
+     * @param id 记忆唯一标识（${source}:${name} 格式）
+     * @param increment score 提升量（默认 0.05，与 recall.ts BOOST_INCREMENT 一致）
+     * @returns 是否成功提升（记忆不存在时返回 false）
+     */
+    writeBoost(id: string, increment?: number): boolean;
+    /**
+     * 软删除记忆（写入 deletedAt）
+     *
+     * @param id 记忆唯一标识（${source}:${name} 格式）
+     */
+    writeDelete(id: string): void;
+    /**
+     * 恢复软删除的记忆（清除 deletedAt）
+     *
+     * @param id 记忆唯一标识
+     */
+    writeRestore(id: string): void;
+    /**
+     * 物理删除记忆（不可恢复，用于回收站彻底删除）
+     *
+     * @param id 记忆唯一标识
+     */
+    writePurge(id: string): void;
+    /**
+     * 清理过期的软删除记忆
+     *
+     * 物理删除所有 deletedAt 早于 before 的记忆。
+     * 由宿主项目的定时器调用（默认 30 天保留期）。
+     *
+     * @param before 时间阈值，deletedAt 早于此值的记忆将被物理删除
+     * @returns 被清理的记忆数量
+     */
+    writePurgeExpired(before: Date): number;
+    /**
+     * 添加记忆关系（透传 relationStore）
+     *
+     * 用于宿主 UI 手动创建关系（关系图右键菜单 → 连线 → 创建关系）。
+     * relationStore 未注入时静默降级（不阻塞）。
+     *
+     * @param relation 关系边数据
+     */
+    writeAddRelation(relation: MemoryRelation): void;
+    /**
+     * 删除记忆关系（透传 relationStore）
+     *
+     * 用于宿主 UI 手动删除关系（关系图右键菜单 → 编辑关系 → 删除）。
+     * relationStore 未注入时静默降级（不阻塞）。
+     *
+     * @param sourceId 关系起点
+     * @param targetId 关系终点
+     * @param type 关系类型
+     */
+    writeRemoveRelation(sourceId: string, targetId: string, type: string): void;
+    /**
+     * 语义去重：扫描名称高度相似的记忆对，调用 LLM 判断语义等价性
+     *
+     * 流程：
+     *   1. 从 insight/profile/work-projection 加载候选记忆（上限 50 条）
+     *   2. 按名称归一化 Levenshtein 距离筛选相似对（上限 10 对）
+     *   3. 对每对调用 LLM 判断语义等价性（结构化 JSON 输出）
+     *   4. 等价则降级低分记忆（score → 0.1，不物理删除，保留可恢复性）
+     *   5. 返回去重报告
+     *
+     * 安全设计：
+     *   - 不物理删除——仅降级 score，用户可通过宿主 UI 手动恢复
+     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
+     *   - 异步执行——不阻塞主对话热路径（由宿主定时任务或用户手动触发）
+     *   - backgroundProvider 未注入时静默跳过（返回 skippedReason）
+     *
+     * @param signal 可选的 AbortSignal（取消正在进行的 LLM 判断）
+     * @returns 去重报告
+     */
+    deduplicateMemories(signal?: AbortSignal): Promise<DedupReport>;
+    /**
+     * 筛选名称高度相似的候选记忆对
+     *
+     * 判定规则（满足任一即视为名称相似）：
+     *   1. 归一化 Levenshtein 距离 ≤ 0.3（如 "用户偏好" vs "用户偏爱"）
+     *   2. 一个名称包含另一个（如 "用户偏好" vs "用户偏好设置"）
+     *
+     * 去重设计：
+     *   - 已配对的记忆不再参与后续配对（避免 A-B-C 三元组产生 A-B + A-C + B-C 三对）
+     *   - 候选对按相似度升序排列（越相似越优先），取前 10 对
+     *
+     * @param candidates 候选记忆列表（已按 score 降序）
+     * @returns 名称相似的记忆对列表（a.score ≥ b.score）
+     */
+    private findNameOverlapPairs;
+    /**
+     * 计算两个名称的归一化相似度（0-1，越小越相似）
+     *
+     * 综合两种规则取较小值：
+     *   1. 归一化 Levenshtein 距离 = distance / max(len_a, len_b)
+     *   2. 包含关系：若一个名称包含另一个，相似度 = 0（完全相似）
+     *
+     * @param nameA 名称 A
+     * @param nameB 名称 B
+     * @returns 相似度（0=完全相似，1=完全不同）
+     */
+    private static computeNameSimilarity;
+    /**
+     * 调用 LLM 判断单对记忆的语义等价性
+     *
+     * 使用结构化 JSON 输出（isDuplicate + mergedContent + reason），
+     * 参照 SessionArchiver.generateSummary 的 parseLlmJson 模式。
+     *
+     * LLM 失败时抛出异常（由 deduplicateMemories 捕获并降级跳过此对）。
+     *
+     * @param pair 候选记忆对
+     * @param signal 可选的 AbortSignal
+     * @returns LLM 判断结果
+     */
+    private judgeDuplicate;
+    /**
+     * 降级重复记忆（score → DEDUP_LOW_SCORE，可选合并内容）
+     *
+     * 安全设计：
+     *   - 不物理删除，仅降低 score，保留可恢复性
+     *   - 若提供 mergedContent，更新保留记忆（a）的 content 为合并后内容
+     *   - 通过 upsert 覆盖原记忆（保持 id/source/name/createdAt 不变）
+     *
+     * @param memory 待降级的记忆（低分方）
+     * @param mergedContent 可选的合并后内容（更新到保留方，由调用方负责）
+     */
+    private demoteMemory;
 }
 //# sourceMappingURL=memoryInspector.d.ts.map

package/dist/agent/managers/memoryInspector.d.ts.map

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