@zooique/memora 0.1.0

package/dist/agent/managers/memoryInspector.js

@@ -0,0 +1,327 @@
+import { SOURCE_LABELS } from '../../memory/types.js';
+import { configError } from '../../utils/errors.js';
+import { logger } from '../../logging/logger.js';
+import { RECALL_LIMIT_MULTIPLIER, VECTOR_SCORE_WEIGHT, MEMORY_SCORE_WEIGHT, } from '../../memory/recall.js';
+// QC-R2-11：sourceHealth() + suggest() 已提取到 MemoryAdvisor
+import { MemoryAdvisor } from '../../agent/managers/memoryAdvisor.js';
+// ─── 常量 ────────────────────────────────────────────────
+/** 工作记忆预览条数（最近 N 条） */
+const WORKING_PREVIEW = 5;
+/** 内容预览字符数（快照层） */
+const CONTENT_PREVIEW_LEN = 80;
+/** 搜索结果内容预览字符数（比快照层略长，便于用户判断相关性） */
+const SEARCH_PREVIEW_LEN = 120;
+// ─── 类 ──────────────────────────────────────────────────
+export class MemoryInspector {
+    index;
+    loop;
+    history;
+    /** 向量存储（可选，提供时 searchHybrid 启用语义搜索） */
+    vectorStore = null;
+    /** 关系存储（可选，ADR-014 侧车，未注入时跳过关系查询） */
+    relationStore;
+    /** 记忆顾问（QC-R2-11：sourceHealth + suggest 委托） */
+    advisor;
+    /**
+     * @param index - 记忆存储（用于搜索 + 统计）
+     * @param loop - AgentLoop（用于获取工作记忆）
+     * @param history - MessageHistory（用于获取当前会话信息）
+     * @param relationStore - 关系存储侧车（可选，ADR-014，未注入时关系相关方法降级返回空）
+     */
+    constructor(index, loop, history, relationStore = null) {
+        this.index = index;
+        this.loop = loop;
+        this.history = history;
+        this.relationStore = relationStore;
+        // QC-R2-11：记忆顾问共享 index 引用（只读访问）
+        this.advisor = new MemoryAdvisor(index);
+    }
+    /**
+     * 注入向量存储（由 Agent 在初始化后调用，解决构造时序）
+     */
+    setVectorStore(vs) {
+        this.vectorStore = vs;
+    }
+    // ─── 写操作代理 ───────────────────────────────────────
+    // 宿主项目通过 agent.memory 访问写操作，
+    // 无需绕过 inspector 直接访问 agent.storage（分层违规）。
+    // 代理方法内部委托给 this.index（IMemoryStorage 实例）。
+    /**
+     * 插入或更新记忆
+     *
+     * @param memory 完整记忆对象
+     */
+    upsert(memory) {
+        this.index.upsert(memory);
+    }
+    /**
+     * 删除记忆
+     *
+     * @param id 记忆唯一标识（${source}:${name} 格式）
+     */
+    delete(id) {
+        this.index.delete(id);
+    }
+    /**
+     * 按 ID 获取单条记忆
+     *
+     * @param id 记忆唯一标识
+     * @returns 记忆对象，不存在时返回 null
+     */
+    getById(id) {
+        return this.index.getById(id);
+    }
+    /**
+     * 按来源标签获取记忆列表
+     *
+     * @param source 来源标签（如 'persona'、'rule'、'insight'）
+     * @returns 该来源的所有记忆
+     */
+    getBySource(source) {
+        return this.index.getBySource(source);
+    }
+    /**
+     * 列出所有记忆（用于宿主项目的记忆管理面板）
+     *
+     * 与 search() 不同，本方法允许空查询，返回按 score 降序排列的记忆列表。
+     * search() 拒绝空查询是为了防止"静默全量返回"的误用；
+     * list() 则是显式声明"我要列出所有记忆"的意图。
+     *
+     * @param limit 返回数量上限（默认 50）
+     * @returns 记忆列表（按 score 降序）
+     */
+    list(limit = 50) {
+        return this.index.search('', limit);
+    }
+    // ─── 快照 ─────────────────────────────────────────────
+    /**
+     * 统一查看记忆快照（3 层）
+     *
+     * 简化为 3 层（工作记忆 / Bootstrap / 归档记忆）。
+     *
+     * 设计原则：
+     * - **纯只读**——不动任何组件状态
+     * - **同步返回**——避免数据不一致（不调 LLM、不调 SQLite）
+     * - **轻量**——每层只返回前 N 条 + 总数
+     */
+    snapshot() {
+        // 第 1 层：工作记忆（AgentLoop 的 messages 数组）
+        const workingFull = this.loop.getMessages();
+        const workingTotal = workingFull.length;
+        const working = workingFull.slice(-WORKING_PREVIEW);
+        // 第 2 层：Bootstrap 记忆（永驻 + 领域）
+        // 直接按 source 查询，避免 search('', 50) 全量扫描
+        const rules = this.index.getBySource(SOURCE_LABELS.RULE);
+        const personas = this.index.getBySource(SOURCE_LABELS.PERSONA);
+        const skills = this.index.getBySource(SOURCE_LABELS.SKILL);
+        const bootstrap = [...rules, ...personas, ...skills];
+        // 第 3 层：归档记忆计数（insight + profile + work-projection）
+        const insightCount = this.index.countBySource(SOURCE_LABELS.INSIGHT);
+        const profileCount = this.index.countBySource(SOURCE_LABELS.PROFILE);
+        const workProjectionCount = this.index.countBySource(SOURCE_LABELS.WORK_PROJECTION);
+        const archiveTotal = insightCount + profileCount + workProjectionCount;
+        return {
+            working: {
+                total: workingTotal,
+                preview: working.map((m) => ({
+                    role: m.role,
+                    contentPreview: m.content.slice(0, CONTENT_PREVIEW_LEN),
+                    contentLength: m.content.length,
+                })),
+            },
+            bootstrap: {
+                total: bootstrap.length,
+                items: bootstrap.map((m) => ({
+                    id: m.id,
+                    source: m.source,
+                    name: m.name,
+                    contentPreview: m.content.slice(0, CONTENT_PREVIEW_LEN),
+                    score: m.score,
+                })),
+            },
+            archive: {
+                archiveCount: archiveTotal,
+                // ADR-014 关系边总数（relationStore 未注入时为 0）
+                relationCount: this.countRelations(),
+                currentSession: this.history.session ?? '(none)',
+                currentSessionName: this.history.currentSessionName ?? '(none)',
+                hint: '调 listAllSessions() 获取文件清单',
+                stats: {
+                    insight: insightCount,
+                    profile: profileCount,
+                    'work-projection': workProjectionCount,
+                },
+            },
+        };
+    }
+    // ─── 搜索 ─────────────────────────────────────────────
+    /**
+     * 搜索记忆（关键词 + FTS5 索引）
+     *
+     * 返回 CLI 友好的扁平结构（已处理内容截断）
+     */
+    search(query, limit = 10) {
+        // 空 query 会让 search() 退化为"返回所有"，对宿主程序是静默误导
+        if (!query || query.trim() === '') {
+            throw configError('搜索关键词为空', 'search() 需要非空 query', [
+                '传入非空字符串关键词',
+                '使用 snapshot().bootstrap.items 列出所有引导记忆',
+            ]);
+        }
+        if (limit <= 0 || !Number.isInteger(limit)) {
+            throw configError('无效 limit', `limit 必须是正整数，收到 ${limit}`, [
+                '使用 limit = 10（默认值）',
+            ]);
+        }
+        const hits = this.index.search(query, limit);
+        return hits.map((m) => ({
+            id: m.id,
+            name: m.name,
+            source: m.source,
+            score: m.score,
+            // 截断长内容到搜索预览长度
+            contentPreview: m.content.length > SEARCH_PREVIEW_LEN ? m.content.slice(0, SEARCH_PREVIEW_LEN) + '...' : m.content,
+            createdAt: m.createdAt,
+        }));
+    }
+    /**
+     * 混合搜索记忆（语义 + 关键词双通道）
+     *
+     * V-101：当 VectorStore 可用时，启用语义搜索通道，补强关键词召回的语义缺口。
+     * 向量搜索失败时静默降级到纯关键词（降级优先原则）。
+     *
+     * @returns 混合排序后的搜索结果（含相似度分数）
+     */
+    async searchHybrid(query, limit = 10) {
+        if (!query || query.trim() === '') {
+            throw configError('搜索关键词为空', 'searchHybrid() 需要非空 query', [
+                '传入非空字符串关键词',
+            ]);
+        }
+        if (limit <= 0 || !Number.isInteger(limit)) {
+            throw configError('无效 limit', `limit 必须是正整数，收到 ${limit}`, [
+                '使用 limit = 10（默认值）',
+            ]);
+        }
+        const merged = new Map();
+        // ── 通道 1：语义搜索（VectorStore 可用时） ──
+        if (this.vectorStore && this.vectorStore.size > 0) {
+            try {
+                const vectorResults = await this.vectorStore.search(query, limit * RECALL_LIMIT_MULTIPLIER, 0.3);
+                for (const vr of vectorResults) {
+                    const memory = this.index.getById(vr.id);
+                    if (memory) {
+                        merged.set(memory.id, { memory, vectorScore: vr.similarity });
+                    }
+                }
+            }
+            catch (err) {
+                logger.debug({ err }, '语义搜索失败，降级到关键词');
+            }
+        }
+        // ── 通道 2：关键词搜索（补齐语义通道未覆盖的） ──
+        const keywordResults = this.index.search(query, limit * RECALL_LIMIT_MULTIPLIER);
+        for (const m of keywordResults) {
+            if (!merged.has(m.id)) {
+                merged.set(m.id, { memory: m, vectorScore: 0 });
+            }
+        }
+        // ── 综合排序：vectorScore（语义相关度）+ memory.score（权重） ──
+        const sorted = [...merged.values()].sort((a, b) => {
+            const scoreA = a.vectorScore * VECTOR_SCORE_WEIGHT + a.memory.score * MEMORY_SCORE_WEIGHT;
+            const scoreB = b.vectorScore * VECTOR_SCORE_WEIGHT + b.memory.score * MEMORY_SCORE_WEIGHT;
+            return scoreB - scoreA;
+        });
+        return sorted.slice(0, limit).map(({ memory, vectorScore }) => ({
+            id: memory.id,
+            name: memory.name,
+            source: memory.source,
+            score: memory.score,
+            similarity: vectorScore,
+            contentPreview: memory.content.length > SEARCH_PREVIEW_LEN ? memory.content.slice(0, SEARCH_PREVIEW_LEN) + '...' : memory.content,
+            createdAt: memory.createdAt,
+        }));
+    }
+    // ─── 统计 ─────────────────────────────────────────────
+    /**
+     * 记忆库统计
+     *
+     * 返回记忆来源分布、数据库大小等关键指标。
+     * P2-2 优化：使用 getAllSources() 一次查询替代多次 countBySource + 全量 search，
+     * 复杂度从 O(n*knownSources + n) 降为 O(distinctSources)。
+     */
+    stats() {
+        const total = this.index.count();
+        // P2-2 直接使用 getAllSources() 获取所有 source 分布（含宿主自定义标签）
+        const sourceMap = this.index.getAllSources();
+        const bySource = {};
+        for (const [source, count] of sourceMap) {
+            if (count > 0)
+                bySource[source] = count;
+        }
+        return { bySource, total, relationCount: this.countRelations() };
+    }
+    // ─── 关系查询（ADR-014 侧车） ───────────────────────────
+    /**
+     * 查询指定记忆的关系边
+     *
+     * ADR-014 侧车模型：关系数据独立于 Memory 7 字段基元，存储在 IMemoryRelationStore。
+     * relationStore 未注入时返回空数组（向后兼容）。
+     *
+     * @param memoryId - 记忆 ID
+     * @param direction - 方向过滤：'outgoing'（出边）/ 'incoming'（入边）/ 'both'（双向，默认）
+     * @returns 关系边数组，按 createdAt 降序
+     */
+    getRelations(memoryId, direction = 'both') {
+        if (!this.relationStore)
+            return [];
+        return this.relationStore.getRelations(memoryId, direction);
+    }
+    /**
+     * 查询全部关系边
+     *
+     * 用于宿主 UI 渲染拓扑可视化（阶段 2.4）。
+     * relationStore 未注入时返回空数组（向后兼容）。
+     *
+     * @returns 全部关系边数组
+     */
+    getAllRelations() {
+        if (!this.relationStore)
+            return [];
+        return this.relationStore.getAllRelations();
+    }
+    /**
+     * 统计关系边总数
+     *
+     * 用于 stats() 和 snapshot() 的 relationCount 字段。
+     * relationStore 未注入时返回 0（向后兼容）。
+     */
+    countRelations() {
+        if (!this.relationStore)
+            return 0;
+        return this.relationStore.getAllRelations().length;
+    }
+    // ─── 源健康诊断 + 关联推荐（QC-R2-11：委托给 MemoryAdvisor） ───
+    /**
+     * 记忆源健康诊断（委托给 MemoryAdvisor）
+     *
+     * 为每个 source 计算健康指标（数量、平均 score、新鲜度、状态）。
+     * 实现已迁移至 MemoryAdvisor（QC-R2-11），此处保留委托以维持 API 契约。
+     */
+    sourceHealth() {
+        return this.advisor.sourceHealth();
+    }
+    /**
+     * 关联推荐（委托给 MemoryAdvisor）
+     *
+     * 基于 score + 时效性 + source 多样性推荐记忆。
+     * 实现已迁移至 MemoryAdvisor（QC-R2-11），此处保留委托以维持 API 契约。
+     *
+     * @param query - 可选的搜索关键词（提供时结合搜索结果推荐，省略时基于全局热度推荐）
+     * @param options - 推荐选项
+     */
+    suggest(query, options) {
+        return this.advisor.suggest(query, options);
+    }
+}
+//# sourceMappingURL=memoryInspector.js.map

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

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

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

@@ -0,0 +1,89 @@
+/**
+ * 会话管理器
+ *
+ * 从 Agent 类中提取会话管理职责（ADR-010 §Agent 类拆分）。
+ * 负责会话切换、分叉、恢复和消息加载，通过回调函数访问 Agent 的当前组件状态，
+ * 避免与 Agent 的 history/loop 引用生命周期耦合。
+ *
+ * Agent 通过组合方式持有 SessionManager 实例，将会话相关操作委托给它。
+ */
+import type { AgentLoop } from '../../agent/loop.js';
+import type { MessageHistory } from '../../agent/messageHistory.js';
+import type { SessionMessage } from '../../memory/sessionStore.js';
+import type { ISessionStore } from '../../memory/sessionStore.js';
+/**
+ * Agent.forkSession() 返回值类型
+ *
+ * 注意：与 MessageHistory.forkSession() 的内部返回类型 ForkResult 不同，
+ * Agent 层做了简化封装，只暴露宿主需要的 newSession 和 messageCount。
+ */
+export interface AgentForkResult {
+    /** 新分支会话名（不含日期前缀的简短名，可直接传给 switchSession()） */
+    newSession: string;
+    /** 分叉时复制的消息数量 */
+    messageCount: number;
+}
+/**
+ * 会话管理器
+ *
+ * 通过回调函数访问 Agent 的当前组件状态，支持 Agent 重建组件后自动获取最新引用。
+ */
+export declare class SessionManager {
+    /** 获取当前 MessageHistory 实例的回调 */
+    private getHistory;
+    /** 获取当前 AgentLoop 实例的回调 */
+    private getLoop;
+    /** 会话存储（可选，由宿主注入） */
+    private sessionStore;
+    /** 检查对话是否繁忙的回调 */
+    private isChatBusy;
+    /** 发射事件（委托给 Agent 的 TypedEventEmitter） */
+    private emitEvent;
+    constructor(getHistory: () => MessageHistory, getLoop: () => AgentLoop, sessionStore: ISessionStore | undefined, isChatBusy: () => boolean, emitEvent: (event: string, data: Record<string, unknown>) => void);
+    /**
+     * 切换当前会话
+     *
+     * 与 forkSession() 对齐：底层 MessageHistory.switchSession 是纯同步操作（字段赋值），
+     * Agent 层不引入无意义的 async 包装。返回新会话名。
+     */
+    switchSession(newSession: string): string;
+    /**
+     * 分叉当前会话：复制完整消息历史到新分支，切换到新分支继续对话
+     *
+     * 分叉后：
+     * - 原会话完整保留，可随时通过 switchSession() 切回（用原会话简短名）
+     * - 新分支拥有独立的消息历史，后续对话互不干扰
+     * - 记忆索引（IMemoryStorage）全局共享，不受分叉影响
+     *
+     * **注意**：fork 不隔离记忆。分支 A 中提取的 insight 会在分支 B
+     * 的召回中出现，反之亦然。如需要完全独立的记忆空间（如多用户场景），
+     * 应创建独立 Agent 实例 + 独立 dataDir，而非 fork。
+     *
+     * @param targetSession - 自定义新分支名（可选，不传则自动生成）
+     * @returns { newSession, messageCount }
+     */
+    forkSession(targetSession?: string): AgentForkResult;
+    /**
+     * 恢复最近的会话对话
+     *
+     * 通过 ISessionStore 加载最近的会话消息，恢复到 AgentLoop 工作记忆。
+     * 宿主项目需注入 ISessionStore 实现，否则返回 0。
+     */
+    restoreMostRecentSession(preferredSession?: string): Promise<number>;
+    /**
+     * 恢复指定会话的对话
+     */
+    restoreSession(date: string, session: string): Promise<number>;
+    /**
+     * 对外暴露的 loadSessionMessages 委托
+     *
+     * **注意：此方法会切换当前会话**（更新 currentDate/currentSession）。
+     * 加载后，下一次 chat() 的消息会写入被加载的会话。
+     */
+    loadSessionMessages(date: string, session: string): Promise<SessionMessage[]>;
+    /**
+     * 将会话消息恢复到 AgentLoop 工作记忆
+     */
+    private applySessionToLoop;
+}
+//# sourceMappingURL=sessionManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManager.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/sessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,gCAAgC;IAChC,OAAO,CAAC,UAAU,CAAuB;IACzC,2BAA2B;IAC3B,OAAO,CAAC,OAAO,CAAkB;IACjC,qBAAqB;IACrB,OAAO,CAAC,YAAY,CAA4B;IAChD,kBAAkB;IAClB,OAAO,CAAC,UAAU,CAAgB;IAClC,0CAA0C;IAC1C,OAAO,CAAC,SAAS,CAAyD;gBAGxE,UAAU,EAAE,MAAM,cAAc,EAChC,OAAO,EAAE,MAAM,SAAS,EACxB,YAAY,EAAE,aAAa,GAAG,SAAS,EACvC,UAAU,EAAE,MAAM,OAAO,EACzB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI;IASnE;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAWzC;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe;IA+BpD;;;;;OAKG;IACG,wBAAwB,CAAC,gBAAgB,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAiD1E;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBpE;;;;;OAKG;IACG,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAWnF;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/agent/managers/sessionManager.js

@@ -0,0 +1,178 @@
+/**
+ * 会话管理器
+ *
+ * 从 Agent 类中提取会话管理职责（ADR-010 §Agent 类拆分）。
+ * 负责会话切换、分叉、恢复和消息加载，通过回调函数访问 Agent 的当前组件状态，
+ * 避免与 Agent 的 history/loop 引用生命周期耦合。
+ *
+ * Agent 通过组合方式持有 SessionManager 实例，将会话相关操作委托给它。
+ */
+import { logger } from '../../logging/logger.js';
+import { configError } from '../../utils/errors.js';
+/**
+ * 会话管理器
+ *
+ * 通过回调函数访问 Agent 的当前组件状态，支持 Agent 重建组件后自动获取最新引用。
+ */
+export class SessionManager {
+    /** 获取当前 MessageHistory 实例的回调 */
+    getHistory;
+    /** 获取当前 AgentLoop 实例的回调 */
+    getLoop;
+    /** 会话存储（可选，由宿主注入） */
+    sessionStore;
+    /** 检查对话是否繁忙的回调 */
+    isChatBusy;
+    /** 发射事件（委托给 Agent 的 TypedEventEmitter） */
+    emitEvent;
+    constructor(getHistory, getLoop, sessionStore, isChatBusy, emitEvent) {
+        this.getHistory = getHistory;
+        this.getLoop = getLoop;
+        this.sessionStore = sessionStore;
+        this.isChatBusy = isChatBusy;
+        this.emitEvent = emitEvent;
+    }
+    /**
+     * 切换当前会话
+     *
+     * 与 forkSession() 对齐：底层 MessageHistory.switchSession 是纯同步操作（字段赋值），
+     * Agent 层不引入无意义的 async 包装。返回新会话名。
+     */
+    switchSession(newSession) {
+        // FD-31: 对话进行中切换会话会导致消息持久化分散
+        if (this.isChatBusy()) {
+            throw configError('对话繁忙', '上一轮对话尚未完成，请等待其结束后再切换会话', [
+                '等待上一轮 chat() 的 AsyncGenerator 耗尽',
+            ]);
+        }
+        return this.getHistory().switchSession(newSession);
+    }
+    /**
+     * 分叉当前会话：复制完整消息历史到新分支，切换到新分支继续对话
+     *
+     * 分叉后：
+     * - 原会话完整保留，可随时通过 switchSession() 切回（用原会话简短名）
+     * - 新分支拥有独立的消息历史，后续对话互不干扰
+     * - 记忆索引（IMemoryStorage）全局共享，不受分叉影响
+     *
+     * **注意**：fork 不隔离记忆。分支 A 中提取的 insight 会在分支 B
+     * 的召回中出现，反之亦然。如需要完全独立的记忆空间（如多用户场景），
+     * 应创建独立 Agent 实例 + 独立 dataDir，而非 fork。
+     *
+     * @param targetSession - 自定义新分支名（可选，不传则自动生成）
+     * @returns { newSession, messageCount }
+     */
+    forkSession(targetSession) {
+        if (this.isChatBusy()) {
+            throw configError('对话繁忙', '上一轮对话尚未完成，请等待其结束后再分叉', [
+                '等待上一轮 chat() 的 AsyncGenerator 耗尽',
+            ]);
+        }
+        const history = this.getHistory();
+        // 记录源会话名（用于事件，含日期前缀的完整名）
+        const sourceSessionName = history.currentSessionName;
+        // 委托 MessageHistory 完成分叉
+        const result = history.forkSession(targetSession);
+        // 将消息恢复到 AgentLoop 的工作记忆
+        this.applySessionToLoop(result.messages);
+        // 发射事件（供 UI 响应）
+        this.emitEvent('sessionForked', {
+            from: sourceSessionName,
+            to: `${result.date}-${result.newSession}`,
+            messageCount: result.messages.length,
+        });
+        return {
+            newSession: result.newSession,
+            messageCount: result.messages.length,
+        };
+    }
+    /**
+     * 恢复最近的会话对话
+     *
+     * 通过 ISessionStore 加载最近的会话消息，恢复到 AgentLoop 工作记忆。
+     * 宿主项目需注入 ISessionStore 实现，否则返回 0。
+     */
+    async restoreMostRecentSession(preferredSession = 'main') {
+        // FD-21: 对话进行中恢复会话会导致 loop 工作记忆被替换
+        if (this.isChatBusy()) {
+            throw configError('对话繁忙', '上一轮对话尚未完成，请等待其结束后再恢复会话', [
+                '等待上一轮 chat() 的 AsyncGenerator 耗尽',
+            ]);
+        }
+        if (!this.sessionStore) {
+            logger.debug({ hasSessionStore: false }, '未注入 ISessionStore，无法恢复会话');
+            return 0;
+        }
+        // 从 sessionStore 列出所有会话，找到最近的
+        const sessions = this.sessionStore.listSessions();
+        if (sessions.length === 0) {
+            logger.debug({ sessionCount: 0 }, '没有找到可恢复的历史会话');
+            return 0;
+        }
+        // 优先匹配 preferredSession，否则取最后一个
+        const today = new Date().toISOString().slice(0, 10);
+        const preferred = sessions.find((s) => s === `${today}-${preferredSession}`) ?? sessions[sessions.length - 1];
+        // 解析 "YYYY-MM-DD-session" 格式
+        const match = (preferred ?? '').match(/^(\d{4}-\d{2}-\d{2})-(.+)$/);
+        if (!match) {
+            logger.debug({ session: preferred }, '会话标识格式不匹配');
+            return 0;
+        }
+        const [, date, session] = match;
+        // match 已经保证 date 和 session 存在（正则匹配两个捕获组），但 TypeScript 类型收窄有限
+        if (!date || !session) {
+            logger.debug({ session: preferred }, '会话标识解析失败');
+            return 0;
+        }
+        const sessionMessages = this.sessionStore.loadMessages(date, session);
+        if (sessionMessages.length === 0) {
+            logger.debug({ messageCount: 0 }, '没有找到可恢复的历史会话');
+            return 0;
+        }
+        this.applySessionToLoop(sessionMessages);
+        return sessionMessages.length;
+    }
+    /**
+     * 恢复指定会话的对话
+     */
+    async restoreSession(date, session) {
+        // FD-21: 对话进行中恢复会话会导致 loop 工作记忆被替换
+        if (this.isChatBusy()) {
+            throw configError('对话繁忙', '上一轮对话尚未完成，请等待其结束后再恢复会话', [
+                '等待上一轮 chat() 的 AsyncGenerator 耗尽',
+            ]);
+        }
+        const sessionMessages = await this.getHistory().loadSessionMessages(date, session);
+        if (sessionMessages.length === 0) {
+            return 0;
+        }
+        this.applySessionToLoop(sessionMessages);
+        return sessionMessages.length;
+    }
+    /**
+     * 对外暴露的 loadSessionMessages 委托
+     *
+     * **注意：此方法会切换当前会话**（更新 currentDate/currentSession）。
+     * 加载后，下一次 chat() 的消息会写入被加载的会话。
+     */
+    async loadSessionMessages(date, session) {
+        // FD-34: 对话进行中加载会话会切换 currentDate/currentSession，导致消息持久化分散
+        if (this.isChatBusy()) {
+            throw configError('对话繁忙', '上一轮对话尚未完成，请等待其结束后再加载会话', [
+                '等待上一轮 chat() 的 AsyncGenerator 耗尽',
+            ]);
+        }
+        return this.getHistory().loadSessionMessages(date, session);
+    }
+    /**
+     * 将会话消息恢复到 AgentLoop 工作记忆
+     */
+    applySessionToLoop(sessionMessages) {
+        const messages = sessionMessages.map((tm) => ({
+            role: tm.role,
+            content: tm.content,
+        }));
+        this.getLoop().restoreHistory(messages);
+    }
+}
+//# sourceMappingURL=sessionManager.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * 用户事实提取器 — 从对话输入中提取结构化用户画像
+ *
+ * 职责：
+ *   - 正则 + 关键词规则提取用户身份、偏好、专长等事实
+ *   - 输出结构化 ExtractedFact，供 UserProfile 归档
+ *
+ * 设计原则：
+ *   - 语义解析属于 agent/ 层，memory/ 只做存储
+ *   - 兼顾阶段一低成本需求（正则规则），后续可升级为 LLM 提取
+ */
+import type { ExtractedFact } from '../../memory/userProfile.js';
+export type { ExtractedFact } from '../../memory/userProfile.js';
+/**
+ * 从用户输入中提取事实
+ *
+ * 使用正则 + 关键词规则，兼顾阶段一的低成本需求。
+ * 高置信度规则（≥0.9）→ 直接归档
+ * 中置信度（0.7-0.8）→ 标记待确认
+ *
+ * @param input 用户原始输入
+ * @param turnIndex 当前轮次标识
+ */
+export declare function extractUserFacts(input: string, turnIndex: string): ExtractedFact[];
+//# sourceMappingURL=userFactExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"userFactExtractor.d.ts","sourceRoot":"","sources":["../../../src/agent/managers/userFactExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAgFlF"}