@zooique/memora 1.0.1 → 2.0.3

package/dist/agent/managers/memoryAdvisor.js

@@ -1,6 +1,14 @@
 import { SOURCE_LABELS } from '../../memory/types.js';
 import { ONE_DAY_MS } from '../../memory/recall.js';
 import { nowIso } from '../../utils/time.js';
+import { roundTo } from '../../utils/math.js';
+// LLM judge 三件套高阶函数（流式累积 + parseLlmJson + configError 异常封装）
+import { judgeWithLlm } from '../../agent/managers/llmJudgeHelper.js';
+import { byScoreDesc } from '../../utils/array.js';
+import { truncate } from '../../utils/strings.js';
+import { logger } from '../../logging/logger.js';
+// LLM 治理源列表（v2 REPEAT-1 闭环，消除 5 处独立维护的 [INSIGHT, PROFILE, WORK_PROJECTION] 列表）
+import { GOVERNANCE_SOURCES } from '../../memory/governance.js';
 // ─── 常量 ────────────────────────────────────────────────
 /** 关联推荐：每个 source 采样 top-N 条 */
 const SUGGEST_TOP_PER_SOURCE = 3;
@@ -19,6 +27,16 @@ const SOURCE_HEALTH_THRESHOLDS = {
     /** 超过此天数未访问 → warning */
     WARNING_DAYS: 7,
 };
+// ─── L3 冲突检测常量 ────────────────────────────────────
+// 注：CONFLICT_SOURCES 已统一为 GOVERNANCE_SOURCES（governance.ts），消除 5 处独立维护
+/** 单个 source 内参与配对的记忆条数上限（控制 O(n²) 配对规模） */
+const CONFLICT_CANDIDATES_PER_SOURCE = 10;
+/** 单次 LLM 冲突判断的候选对数上限 */
+const CONFLICT_PAIR_LIMIT = 10;
+/** LLM 冲突判断超时（ms） */
+const CONFLICT_TIMEOUT_MS = 15_000;
+/** 候选记忆内容预览长度（截断后送入 LLM） */
+const CONFLICT_CONTENT_PREVIEW_LEN = 200;
 // ─── 类 ──────────────────────────────────────────────────
 /**
  * 记忆顾问
@@ -26,18 +44,23 @@ const SOURCE_HEALTH_THRESHOLDS = {
  * 从 MemoryInspector 拆分，负责基于记忆数据的分析计算：
  *   - sourceHealth()：记忆源健康诊断（数量、score、新鲜度）
  *   - suggest()：关联推荐（基于 score + 时效性 + 多样性）
+ *   - detectConflicts()：语义冲突检测（L3，可选，backgroundProvider 注入后启用）
  *
  * 与 MemoryInspector 的分工：
  *   - MemoryInspector：直接数据查询（snapshot/search/stats/relations + 写操作代理）
- *   - MemoryAdvisor：分析计算（健康诊断 + 推荐排序）
+ *   - MemoryAdvisor：分析计算（健康诊断 + 推荐排序 + 冲突检测）
  */
 export class MemoryAdvisor {
     index;
+    /** 后台 LLM Provider（可选，用于 L3 冲突检测，未注入时跳过） */
+    backgroundProvider;
     /**
      * @param index - 记忆存储（只读访问，用于健康诊断和推荐计算）
+     * @param backgroundProvider - 后台 LLM Provider（可选，用于 L3 冲突检测，未注入时跳过）
      */
-    constructor(index) {
+    constructor(index, backgroundProvider = null) {
         this.index = index;
+        this.backgroundProvider = backgroundProvider;
     }
     // ─── 源健康诊断 ─────────────────────────────────────────
     /**
@@ -94,8 +117,8 @@ export class MemoryAdvisor {
             entries.push({
                 source,
                 count,
-                avgScore: Math.round(avgScore * 1000) / 1000,
-                daysSinceLastAccess: Math.round(daysSinceLastAccess * 10) / 10,
+                avgScore: roundTo(avgScore, 3),
+                daysSinceLastAccess: roundTo(daysSinceLastAccess, 1),
                 status,
             });
         }
@@ -138,14 +161,13 @@ export class MemoryAdvisor {
                 }
             }
         }
-        // 补充：按 source 分组采样，确保来源多样性
-        const knownSources = [SOURCE_LABELS.INSIGHT, SOURCE_LABELS.PROFILE, SOURCE_LABELS.WORK_PROJECTION];
-        for (const source of knownSources) {
+        // 补充：按 source 分组采样，确保来源多样性（治理源列表统一来自 governance.ts）
+        for (const source of GOVERNANCE_SOURCES) {
             const count = this.index.countBySource(source);
             if (count > 0 && !excludeSources.includes(source)) {
                 const memories = this.index.getBySource(source);
                 // 取 score 最高的前 N 条
-                const top = memories.sort((a, b) => b.score - a.score).slice(0, SUGGEST_TOP_PER_SOURCE);
+                const top = memories.sort(byScoreDesc).slice(0, SUGGEST_TOP_PER_SOURCE);
                 for (const m of top) {
                     if (!candidates.has(m.id)) {
                         candidates.set(m.id, { memory: m, searchHit: false });
@@ -191,10 +213,232 @@ export class MemoryAdvisor {
             id: memory.id,
             name: memory.name,
             source: memory.source,
-            relevance: Math.round(relevance * 100) / 100,
-            contentPreview: memory.content.length > ADVISOR_PREVIEW_LEN ? memory.content.slice(0, ADVISOR_PREVIEW_LEN) + '...' : memory.content,
+            relevance: roundTo(relevance, 2),
+            contentPreview: truncate(memory.content, ADVISOR_PREVIEW_LEN),
             reason,
         }));
     }
+    // ─── L3 语义冲突检测（可选，backgroundProvider 注入后启用） ───
+    /**
+     * 语义冲突检测：扫描同 source 的记忆对，调用 LLM 判断是否存在语义冲突
+     *
+     * 流程：
+     *   1. 从 insight/profile/work-projection 加载候选记忆（每个 source 取 top 10 条）
+     *   2. 同 source 内两两配对，取前 10 对
+     *   3. 对每对调用 LLM 判断是否存在语义冲突
+     *   4. 返回冲突报告（仅检测，不修复——冲突需要用户决策）
+     *
+     * 安全设计：
+     *   - 仅检测不修复——不自动降级任何记忆，返回冲突详情供用户决策
+     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
+     *   - 单对 LLM 失败不阻塞后续检测
+     *   - backgroundProvider 未注入时静默跳过（向后兼容）
+     *
+     * 使用场景：
+     *   - 宿主定时任务定期检测（如每天一次）
+     *   - 用户手动触发（记忆管理面板的"检测冲突"按钮）
+     *   - 健康诊断报告的补充（sourceHealth 显示数量，本方法显示质量冲突）
+     *
+     * @param signal 可选的 AbortSignal（取消正在进行的 LLM 判断）
+     * @returns 冲突检测报告
+     */
+    async detectConflicts(signal) {
+        // backgroundProvider 未注入时静默降级（向后兼容）
+        if (!this.backgroundProvider) {
+            return {
+                scannedCount: 0,
+                pairCount: 0,
+                conflictCount: 0,
+                conflicts: [],
+                skippedReason: 'backgroundProvider 未注入',
+            };
+        }
+        // ── 步骤 1：加载候选记忆（每个 source 取 top 10 条，按 score 降序） ──
+        const candidates = [];
+        for (const source of GOVERNANCE_SOURCES) {
+            const memories = this.index.getBySource(source);
+            // 按 score 降序取 top N
+            const top = memories.sort(byScoreDesc).slice(0, CONFLICT_CANDIDATES_PER_SOURCE);
+            candidates.push(...top);
+        }
+        if (candidates.length < 2) {
+            return {
+                scannedCount: candidates.length,
+                pairCount: 0,
+                conflictCount: 0,
+                conflicts: [],
+                skippedReason: '候选记忆不足（少于 2 条）',
+            };
+        }
+        // ── 步骤 2：同 source 内两两配对，取前 10 对 ──
+        const pairs = this.findConflictCandidates(candidates);
+        if (pairs.length === 0) {
+            return {
+                scannedCount: candidates.length,
+                pairCount: 0,
+                conflictCount: 0,
+                conflicts: [],
+                skippedReason: '无同 source 候选对',
+            };
+        }
+        // ── 步骤 3：逐对调用 LLM 判断冲突 ──
+        const conflicts = [];
+        for (const pair of pairs) {
+            try {
+                const verdict = await this.judgeConflict(pair[0], pair[1], signal);
+                if (verdict.hasConflict) {
+                    conflicts.push(verdict);
+                    logger.info({ memoryA: verdict.memoryA.id, memoryB: verdict.memoryB.id, reason: verdict.reason }, '冲突检测：发现语义冲突');
+                }
+            }
+            catch (err) {
+                // 单对 LLM 判断失败不阻塞后续检测
+                logger.warn({ err, pairId: `${pair[0].id}↔${pair[1].id}` }, '冲突检测：LLM 判断失败，跳过此对');
+            }
+        }
+        return {
+            scannedCount: candidates.length,
+            pairCount: pairs.length,
+            conflictCount: conflicts.length,
+            conflicts,
+        };
+    }
+    /**
+     * 筛选同 source 内的候选冲突对
+     *
+     * 策略：
+     *   - 按 source 分组，同 source 内两两配对
+     *   - 限制每个 source 的配对数，避免 O(n²) 爆炸
+     *   - 总候选对数上限 10 对
+     *
+     * @param candidates 候选记忆列表（已按 source 分组混合）
+     * @returns 同 source 候选对列表
+     */
+    findConflictCandidates(candidates) {
+        // 按 source 分组
+        const bySource = new Map();
+        for (const m of candidates) {
+            const list = bySource.get(m.source) ?? [];
+            list.push(m);
+            bySource.set(m.source, list);
+        }
+        // 同 source 内两两配对，均匀分配配对数
+        const pairs = [];
+        const sources = [...bySource.keys()];
+        // 每个 source 分配的配对数配额（总上限 / source 数，至少 1 对/source）
+        const quotaPerSource = Math.max(1, Math.ceil(CONFLICT_PAIR_LIMIT / sources.length));
+        for (const source of sources) {
+            const list = bySource.get(source);
+            if (!list || list.length < 2)
+                continue;
+            let count = 0;
+            for (let i = 0; i < list.length && count < quotaPerSource; i++) {
+                for (let j = i + 1; j < list.length && count < quotaPerSource; j++) {
+                    pairs.push([list[i], list[j]]);
+                    count++;
+                }
+            }
+            if (pairs.length >= CONFLICT_PAIR_LIMIT)
+                break;
+        }
+        return pairs.slice(0, CONFLICT_PAIR_LIMIT);
+    }
+    /**
+     * 调用 LLM 判断两条记忆是否存在语义冲突
+     *
+     * 使用结构化 JSON 输出（hasConflict + conflictDescription + recommendation + reason），
+     * 流式累积 + parseLlmJson + 异常封装委托给 llmJudgeHelper.judgeWithLlm。
+     *
+     * LLM 失败时抛出 MemoraError（由 detectConflicts 捕获并降级跳过此对）。
+     *
+     * @param memoryA 记忆 A
+     * @param memoryB 记忆 B
+     * @param signal 可选的 AbortSignal
+     * @returns LLM 判断结果
+     */
+    async judgeConflict(memoryA, memoryB, signal) {
+        const messages = buildConflictMessages(memoryA, memoryB);
+        const parsed = await judgeWithLlm(this.backgroundProvider, messages, { maxTokens: 300, timeoutMs: CONFLICT_TIMEOUT_MS, signal }, 'LLM 冲突判断返回非法 JSON');
+        // 校验 recommendation 字段（允许 'a' / 'b' / 'both'，其他值忽略）
+        const recRaw = parsed.recommendation;
+        const recommendation = recRaw === 'a' || recRaw === 'b' || recRaw === 'both' ? recRaw : undefined;
+        return {
+            memoryA,
+            memoryB,
+            hasConflict: parsed.hasConflict === true,
+            conflictDescription: typeof parsed.conflictDescription === 'string' ? parsed.conflictDescription : undefined,
+            recommendation,
+            reason: typeof parsed.reason === 'string' ? parsed.reason : '(LLM 未提供理由)',
+        };
+    }
+}
+// ─── L3 冲突检测 Prompt 模板（模块级函数，与 buildDedupMessages 同模式） ───
+/**
+ * 构建冲突判断的 LLM 消息
+ *
+ * 设计要点：
+ *   - system 消息定义判断规则（冲突 = 两条记忆表达互相矛盾的信息）
+ *   - user 消息携带两条记忆的内容预览（截断到 200 字符）
+ *   - 要求输出结构化 JSON（hasConflict + conflictDescription + recommendation + reason）
+ *   - few-shot 示例降低 LLM 误判率
+ *
+ * @param memoryA 记忆 A
+ * @param memoryB 记忆 B
+ * @returns system + user 消息数组
+ */
+function buildConflictMessages(memoryA, memoryB) {
+    const contentA = memoryA.content.length > CONFLICT_CONTENT_PREVIEW_LEN
+        ? truncate(memoryA.content, CONFLICT_CONTENT_PREVIEW_LEN, '…[截断]')
+        : memoryA.content;
+    const contentB = memoryB.content.length > CONFLICT_CONTENT_PREVIEW_LEN
+        ? truncate(memoryB.content, CONFLICT_CONTENT_PREVIEW_LEN, '…[截断]')
+        : memoryB.content;
+    return [
+        {
+            role: 'system',
+            content: `你是记忆冲突检测助手。判断给定的两条记忆是否存在语义冲突（表达互相矛盾的信息）。
+
+判断规则：
+- 存在冲突 = 两条记忆表达的信息互相矛盾，不能同时为真（如"喜欢 X" vs "讨厌 X"）
+- 无冲突 = 两条记忆信息互补、独立或不相关
+- 不同维度不构成冲突（如"擅长后端" vs "偏好前端"是不同维度，非冲突）
+- 时间演化不构成冲突（如"用 React 16" vs "用 React 18"是版本升级，非冲突）
+
+输出 JSON 格式：
+{
+  "hasConflict": true/false,
+  "conflictDescription": "冲突点描述（仅 hasConflict=true 时提供）",
+  "recommendation": "a/b/both（建议保留哪条：a=保留A，b=保留B，both=都保留需用户裁决）",
+  "reason": "判断理由（简短说明）"
+}
+
+示例：
+输入 A: "用户喜欢使用 JavaScript"
+输入 B: "用户讨厌 JavaScript"
+输出: {"hasConflict": true, "conflictDescription": "对 JavaScript 的态度矛盾", "recommendation": "both", "reason": "需用户裁决当前偏好"}
+
+输入 A: "用户擅长后端开发"
+输入 B: "用户偏好前端开发"
+输出: {"hasConflict": false, "reason": "擅长领域与偏好领域是不同维度，非冲突"}`,
+        },
+        {
+            role: 'user',
+            content: `请判断以下两条记忆是否存在语义冲突：
+
+记忆 A（score: ${memoryA.score}）：
+- 名称：${memoryA.name}
+- 来源：${memoryA.source}
+- 创建时间：${memoryA.createdAt}
+- 内容：${contentA}
+
+记忆 B（score: ${memoryB.score}）：
+- 名称：${memoryB.name}
+- 来源：${memoryB.source}
+- 创建时间：${memoryB.createdAt}
+- 内容：${contentB}
+
+请输出 JSON 判断结果。`,
+        },
+    ];
 }
 //# sourceMappingURL=memoryAdvisor.js.map

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

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

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

@@ -6,6 +6,7 @@
  *   2. 衰减指标统计（执行次数 / 累计衰减记忆数 / 上次衰减时间）
  *   3. 衰减可观测性（Tracer Span 埋点）
  *   4. 衰减完成事件发射（decayCompleted）
+ *   5. L2 时效性评估（可选，backgroundProvider + index 注入后启用）
  *
  * 设计理由：
  *   agent.ts 原承担 15+ 职责，记忆衰减是独立的生命周期职责，
@@ -17,12 +18,20 @@
  *   - work-projection（作品投影）
  *   不衰减 persona/rule/skill（配置型记忆不应衰减）
  *
+ * L2 时效性评估（可选增强）：
+ *   - 衰减后扫描低分记忆（score < TIMELINESS_LOW_SCORE_THRESHOLD）
+ *   - 调用 LLM 判断是否"已过时"（如过时的技术栈、已变更的偏好）
+ *   - 过时则进一步降级（score → TIMELINESS_OUTDATED_SCORE）
+ *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
+ *
  * 自然生长原则：
  *   - 不持有 storage 引用（start 时注入，stop 时释放）
  *   - 通过回调发射事件（不继承 TypedEventEmitter，避免与 Agent 事件系统耦合）
  *   - 指标统计内聚（getMetrics 返回快照，Agent.getMetrics 直接合并）
  */
 import { type ITracer } from '../../agent/tracer.js';
+import type { LlmProvider } from '../../llm/provider.js';
+import type { IMemoryStorage } from '../../memory/storageInterface.js';
 /** 衰减完成的回调类型（Agent 注入 emit('decayCompleted', ...)） */
 export type DecayCompletedCallback = (payload: {
     decayedCount: number;
@@ -33,6 +42,30 @@ export interface MemoryDecaySchedulerOptions {
     readonly tracer?: ITracer;
     /** 衰减完成事件发射回调（Agent 注入 this.emit.bind(this, 'decayCompleted')） */
     readonly onDecayCompleted: DecayCompletedCallback;
+    /** 后台 LLM Provider（可选，用于 L2 时效性评估，未注入时跳过） */
+    readonly backgroundProvider?: LlmProvider | null;
+    /** 完整记忆存储（可选，用于 L2 读取低分记忆和降级，未注入时跳过） */
+    readonly index?: IMemoryStorage | null;
+}
+/** 单条记忆的时效性判断结果 */
+export interface TimelinessVerdict {
+    /** 记忆 ID */
+    memoryId: string;
+    /** 是否已过时（true → 降级到 TIMELINESS_OUTDATED_SCORE） */
+    isOutdated: boolean;
+    /** LLM 判断理由 */
+    reason: string;
+}
+/** 时效性评估报告（evaluateTimeliness 返回值） */
+export interface TimelinessReport {
+    /** 扫描的低分记忆总数 */
+    scannedCount: number;
+    /** LLM 判定为过时并执行降级的记忆数 */
+    outdatedCount: number;
+    /** 被降级的记忆 ID 列表 */
+    demotedIds: string[];
+    /** 跳过原因（LLM 不可用 / 无低分记忆 / LLM 失败降级） */
+    skippedReason?: string;
 }
 /** 衰减指标快照（供 Agent.getMetrics 合并） */
 export interface DecayMetrics {
@@ -58,10 +91,29 @@ export declare class MemoryDecayScheduler {
     private readonly tracer;
     /** 衰减完成事件发射回调 */
     private readonly onDecayCompleted;
+    /** 后台 LLM Provider（可选，用于 L2 时效性评估，未注入时跳过） */
+    private readonly backgroundProvider;
+    /** 完整记忆存储（可选，用于 L2 读取低分记忆和降级，未注入时跳过） */
+    private readonly index;
     /** 衰减定时器（null 表示未启动） */
     private decayTimer;
     /** 衰减目标存储（start 时注入，stop 时释放） */
     private storage;
+    /**
+     * L2 时效性评估的 AbortController
+     *
+     * FIX-P0-1：stop() 时 abort，让正在进行的 evaluateTimeliness 尽快结束，
+     * 防止 close 后 LLM 回调 upsert 已关闭的 storage。
+     * 每次 evaluateTimeliness 启动时重置为新的 controller。
+     */
+    private evaluateAbortController;
+    /**
+     * 当前正在进行的 evaluateTimeliness Promise（null 表示无）
+     *
+     * FIX-P0-1：close() 通过 awaitInflight() 等待此 Promise 完成，
+     * 确保关闭时所有 L2 评估的 upsert 都落在 storage 关闭前。
+     */
+    private inflightEvaluate;
     /** 衰减执行次数（每次 runOnce 实际执行 +1） */
     private metricDecayRunCount;
     /** 累计衰减记忆数（score 被调低的记忆条数总和） */
@@ -79,9 +131,24 @@ export declare class MemoryDecayScheduler {
     /**
      * 停止定期衰减，释放资源
      *
-     * 清理定时器和 storage 引用，防止 close 后回调触发。
+     * FIX-P0-1：清理定时器 + abort 正在进行的 L2 时效性评估 + 释放 storage 引用，
+     * 防止 close 后回调触发 upsert 已关闭的 storage。
+     *
+     * 注意：stop() 不等待 inflightEvaluate 完成（避免阻塞 close 流程），
+     * 调用方如需等待应使用 awaitInflight()。abort 后 LLM 调用会快速失败，
+     * evaluateTimeliness 内部的 try/catch 会捕获并降级返回。
      */
     stop(): void;
+    /**
+     * 等待正在进行的 L2 时效性评估完成
+     *
+     * FIX-P0-1：Agent.close() 在 stop() 后调用此方法，确保所有 inflight 的
+     * evaluateTimeliness Promise 完成（要么正常返回，要么因 abort 快速 reject），
+     * 防止 close 后 LLM 回调 upsert 已关闭的 storage。
+     *
+     * @returns 完成 Promise，无 inflight 时立即 resolve
+     */
+    awaitInflight(): Promise<void>;
     /**
      * 执行一次记忆衰减
      *
@@ -99,6 +166,65 @@ export declare class MemoryDecayScheduler {
      * 供 Agent.getMetrics() 合并到完整 AgentMetrics 中。
      */
     getMetrics(): DecayMetrics;
+    /**
+     * 时效性评估：扫描低分记忆，调用 LLM 判断是否已过时
+     *
+     * 流程：
+     *   1. 从 insight/profile/work-projection 加载低分记忆（score < 0.3）
+     *   2. 对每条低分记忆（上限 20 条），调用 LLM 判断是否"已过时"
+     *   3. 过时则进一步降级（score → 0.05，接近物理删除阈值但保留可恢复性）
+     *   4. 返回评估报告
+     *
+     * 使用场景：
+     *   - 衰减后调用（onDecayCompleted 回调中），对低分记忆做 LLM 二次评估
+     *   - 宿主定时任务定期调用（如每天一次）
+     *   - 用户手动触发（记忆管理面板的"清理过时记忆"按钮）
+     *
+     * 安全设计：
+     *   - 不物理删除——仅降级 score，保留可恢复性
+     *   - LLM 失败降级——返回已处理的报告，不阻塞调用方
+     *   - 单条 LLM 失败不阻塞后续评估
+     *   - backgroundProvider / index 未注入时静默跳过（向后兼容）
+     *
+     * FIX-P0-1：每次启动评估创建新的 AbortController，注册到 inflightEvaluate。
+     * stop() 时 abort 让 LLM 调用快速失败，awaitInflight() 等待 Promise 完成。
+     * 外部 signal 仍可与内部 abort 信号同时使用（任一触发即取消）。
+     *
+     * @param signal 可选的外部 AbortSignal（与内部 abort 信号叠加，任一触发即取消）
+     * @returns 评估报告
+     */
+    evaluateTimeliness(signal?: AbortSignal): Promise<TimelinessReport>;
+    /**
+     * 实际执行 L2 时效性评估的核心逻辑
+     *
+     * 从 evaluateTimeliness 拆出，便于 inflightEvaluate Promise 注册和清理。
+     *
+     * @param combinedSignal 已叠加内部 + 外部的 AbortSignal
+     */
+    private doEvaluateTimeliness;
+    /**
+     * 调用 LLM 判断单条记忆的时效性
+     *
+     * 使用结构化 JSON 输出（isOutdated + reason），
+     * 流式累积 + parseLlmJson + 异常封装委托给 llmJudgeHelper.judgeWithLlm。
+     *
+     * LLM 失败时抛出 MemoraError（由 evaluateTimeliness 捕获并降级跳过此条）。
+     *
+     * @param memory 待评估的记忆
+     * @param signal 可选的 AbortSignal
+     * @returns LLM 判断结果
+     */
+    private judgeTimeliness;
+    /**
+     * 降级过时记忆（score → TIMELINESS_OUTDATED_SCORE）
+     *
+     * 安全设计：
+     *   - 不物理删除，仅降低 score，保留可恢复性
+     *   - 更新 accessedAt，标记最近被处理过
+     *
+     * @param memory 待降级的过时记忆
+     */
+    private demoteOutdatedMemory;
 }
 /**
  * IMemoryStorage 的衰减子接口（接口隔离原则）

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

@@ -1 +1 @@
-{"version":3,"file":"memoryDecayScheduler.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/memoryDecayScheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE3E,sDAAsD;AACtD,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAEjF,gCAAgC;AAChC,MAAM,WAAW,2BAA2B;IAC1C,uCAAuC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;CACnD;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,iBAAiB;IACjB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAE1D,wBAAwB;IACxB,OAAO,CAAC,UAAU,CAA+C;IACjE,iCAAiC;IACjC,OAAO,CAAC,OAAO,CAAmC;IAGlD,iCAAiC;IACjC,OAAO,CAAC,mBAAmB,CAAa;IACxC,gCAAgC;IAChC,OAAO,CAAC,uBAAuB,CAAa;IAC5C,oCAAoC;IACpC,OAAO,CAAC,iBAAiB,CAAuB;gBAEpC,IAAI,EAAE,2BAA2B;IAK7C;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ5D;;;;OAIG;IACH,IAAI,IAAI,IAAI;IAQZ;;;;;;;;;OASG;IACH,OAAO,IAAI,IAAI;IAyBf;;;;OAIG;IACH,UAAU,IAAI,YAAY;CAO3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;CAC5D"}
+{"version":3,"file":"memoryDecayScheduler.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/memoryDecayScheduler.ts"],"names":[],"mappings":"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"}