autosnippet 3.2.9 → 3.2.11

package/dist/lib/service/bootstrap/BootstrapTaskManager.js

@@ -0,0 +1,398 @@
+/**
+ * BootstrapTaskManager — 冷启动异步任务管理器
+ *
+ * 核心职责：
+ *   1. 管理 bootstrap 异步任务的生命周期（skeleton → filling → completed）
+ *   2. 通过 EventBus 发射进度事件
+ *   3. 通过 RealtimeService 推送进度到前端 (Socket.io)
+ *   4. 支持查询当前 bootstrap 会话状态
+ *
+ * 任务状态流:
+ *   skeleton → filling → completed / failed
+ *
+ * 事件类型:
+ *   bootstrap:started      — 冷启动开始，携带任务清单
+ *   bootstrap:task-started  — 单个维度/Skill 开始填充
+ *   bootstrap:task-completed — 单个维度/Skill 填充完成
+ *   bootstrap:task-failed   — 单个任务失败
+ *   bootstrap:all-completed — 全部任务完成
+ */
+import Logger from '../../infrastructure/logging/Logger.js';
+/** 任务状态枚举 */
+export const TaskStatus = Object.freeze({
+    SKELETON: 'skeleton', // 骨架已创建，等待填充
+    FILLING: 'filling', // 内容正在填充中
+    COMPLETED: 'completed', // 填充完成
+    FAILED: 'failed', // 填充失败
+});
+/**
+ * 单个 Bootstrap 会话（一次冷启动的全部上下文）
+ */
+class BootstrapSession {
+    completedAt;
+    id;
+    startedAt;
+    status;
+    summary;
+    tasks;
+    constructor(sessionId) {
+        this.id = sessionId;
+        this.startedAt = Date.now();
+        this.completedAt = null;
+        this.status = 'running'; // running | completed | failed
+        this.tasks = new Map(); // taskId → TaskInfo
+        this.summary = null; // 完成后的摘要
+    }
+    addTask(taskId, meta) {
+        this.tasks.set(taskId, {
+            id: taskId,
+            status: TaskStatus.SKELETON,
+            meta, // { type: 'dimension'|'skill', dimId, label, skillWorthy }
+            startedAt: null,
+            completedAt: null,
+            result: null, // 填充结果摘要
+            error: null,
+        });
+    }
+    getTask(taskId) {
+        return this.tasks.get(taskId);
+    }
+    get totalTasks() {
+        return this.tasks.size;
+    }
+    get completedTasks() {
+        return [...this.tasks.values()].filter((t) => t.status === TaskStatus.COMPLETED).length;
+    }
+    get failedTasks() {
+        return [...this.tasks.values()].filter((t) => t.status === TaskStatus.FAILED).length;
+    }
+    get fillingTasks() {
+        return [...this.tasks.values()].filter((t) => t.status === TaskStatus.FILLING).length;
+    }
+    get skeletonTasks() {
+        return [...this.tasks.values()].filter((t) => t.status === TaskStatus.SKELETON).length;
+    }
+    get isAllDone() {
+        return this.skeletonTasks === 0 && this.fillingTasks === 0;
+    }
+    get totalToolCalls() {
+        let count = 0;
+        for (const t of this.tasks.values()) {
+            if (t.result?.toolCallCount) {
+                count += t.result.toolCallCount;
+            }
+        }
+        return count;
+    }
+    get progress() {
+        const total = this.totalTasks;
+        if (total === 0) {
+            return 100;
+        }
+        return Math.round(((this.completedTasks + this.failedTasks) / total) * 100);
+    }
+    toJSON() {
+        return {
+            id: this.id,
+            status: this.status,
+            startedAt: this.startedAt,
+            completedAt: this.completedAt,
+            progress: this.progress,
+            total: this.totalTasks,
+            completed: this.completedTasks,
+            failed: this.failedTasks,
+            filling: this.fillingTasks,
+            skeleton: this.skeletonTasks,
+            totalToolCalls: this.totalToolCalls,
+            tasks: [...this.tasks.values()].map((t) => ({
+                id: t.id,
+                status: t.status,
+                meta: t.meta,
+                startedAt: t.startedAt,
+                completedAt: t.completedAt,
+                result: t.result,
+                error: t.error,
+            })),
+            summary: this.summary,
+        };
+    }
+}
+export class BootstrapTaskManager {
+    /** @type {BootstrapSession|null} */
+    #currentSession = null;
+    /** @type {import('../../infrastructure/event/EventBus.js').EventBus|null} */
+    #eventBus = null;
+    /** @type {Function|null} 获取 RealtimeService 的 getter（延迟获取，避免循环依赖） */
+    #getRealtimeService = null;
+    constructor({ eventBus, getRealtimeService } = {}) {
+        this.#eventBus = eventBus || null;
+        this.#getRealtimeService = getRealtimeService || null;
+    }
+    // ═══════════════════════════════════════════════════════════
+    //  Session 管理
+    // ═══════════════════════════════════════════════════════════
+    /**
+     * 启动新的 bootstrap 会话
+     *
+     * 如果上一个会话仍在运行，自动 abort 后再创建新会话（防止重复触发产出重复 Candidate）。
+     *
+     * @param {Array<{id: string, meta: object}>} taskDefs 任务定义列表
+     * @returns {BootstrapSession}
+     */
+    startSession(taskDefs) {
+        // ── 并发锁：如果上一个 session 还在运行，先中止 ──
+        if (this.isRunning) {
+            Logger.warn(`[Bootstrap] Previous session ${this.#currentSession?.id} still running — aborting before starting new session`);
+            this.abortSession('Superseded by new bootstrap request');
+        }
+        const sessionId = `bs_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        this.#currentSession = new BootstrapSession(sessionId);
+        for (const { id, meta } of taskDefs) {
+            this.#currentSession.addTask(id, meta);
+        }
+        Logger.info(`[Bootstrap] Session ${sessionId} started with ${taskDefs.length} tasks`);
+        this.#emit('bootstrap:started', {
+            sessionId,
+            tasks: taskDefs.map((t) => ({ id: t.id, ...t.meta })),
+            total: taskDefs.length,
+            startedAt: this.#currentSession.startedAt,
+        });
+        return this.#currentSession;
+    }
+    /**
+     * 中止当前 bootstrap 会话
+     *
+     * 将所有未完成的任务标记为 failed，并将 session 标记为 aborted。
+     * 异步填充函数通过 `isSessionValid(sessionId)` 检测到 session 已变更后自动退出。
+     *
+     * @param {string} [reason='Aborted by user']
+     */
+    abortSession(reason = 'Aborted by user') {
+        const session = this.#currentSession;
+        if (!session || session.status !== 'running') {
+            return;
+        }
+        // 将未完成的任务全部标记 FAILED
+        for (const task of session.tasks.values()) {
+            if (task.status === TaskStatus.SKELETON || task.status === TaskStatus.FILLING) {
+                task.status = TaskStatus.FAILED;
+                task.completedAt = Date.now();
+                task.error = reason;
+            }
+        }
+        session.status = 'aborted';
+        session.completedAt = Date.now();
+        session.summary = {
+            duration: session.completedAt - session.startedAt,
+            totalTasks: session.totalTasks,
+            completed: session.completedTasks,
+            failed: session.failedTasks,
+            aborted: true,
+            reason,
+        };
+        Logger.info(`[Bootstrap] Session ${session.id} aborted: ${reason}`);
+        this.#emit('bootstrap:all-completed', {
+            sessionId: session.id,
+            summary: session.summary,
+            tasks: [...session.tasks.values()].map((t) => ({
+                id: t.id,
+                status: t.status,
+                meta: t.meta,
+                result: t.result,
+                error: t.error,
+            })),
+        });
+    }
+    /**
+     * 验证 sessionId 是否仍然是活跃 session
+     *
+     * 用于异步填充函数在每次循环迭代前检测：如果 session 已被新请求覆盖，
+     * 则当前异步填充应立即停止，避免产出重复内容。
+     *
+     * @param {string} sessionId
+     * @returns {boolean}
+     */
+    isSessionValid(sessionId) {
+        // Session 在 running 或 completed 状态都有效 — completed 表示维度填充完成，
+        // 但 Phase 5.5 Skills 生成仍需运行。只有被新 session 替代时才无效。
+        return (this.#currentSession?.id === sessionId &&
+            (this.#currentSession?.status === 'running' ||
+                this.#currentSession?.status === 'completed' ||
+                this.#currentSession?.status === 'completed_with_errors'));
+    }
+    /**
+     * 标记单个任务开始填充
+     */
+    markTaskFilling(taskId) {
+        const session = this.#currentSession;
+        if (!session) {
+            return;
+        }
+        const task = session.getTask(taskId);
+        if (!task) {
+            return;
+        }
+        task.status = TaskStatus.FILLING;
+        task.startedAt = Date.now();
+        Logger.info(`[Bootstrap] Task "${taskId}" filling started`);
+        this.#emit('bootstrap:task-started', {
+            sessionId: session.id,
+            taskId,
+            meta: task.meta,
+            progress: session.progress,
+        });
+    }
+    /**
+     * 标记单个任务完成
+     * @param {string} taskId
+     * @param {object} result 填充结果摘要 { created, items, ... }
+     */
+    markTaskCompleted(taskId, result = {}) {
+        const session = this.#currentSession;
+        if (!session) {
+            return;
+        }
+        const task = session.getTask(taskId);
+        if (!task) {
+            return;
+        }
+        task.status = TaskStatus.COMPLETED;
+        task.completedAt = Date.now();
+        task.result = result;
+        Logger.info(`[Bootstrap] Task "${taskId}" completed (${session.completedTasks}/${session.totalTasks})`);
+        this.#emit('bootstrap:task-completed', {
+            sessionId: session.id,
+            taskId,
+            meta: task.meta,
+            result,
+            progress: session.progress,
+            completed: session.completedTasks,
+            total: session.totalTasks,
+            totalToolCalls: session.totalToolCalls,
+            elapsedMs: Date.now() - session.startedAt,
+        });
+        // 检查是否所有任务都已完成
+        if (session.isAllDone) {
+            this.#finishSession();
+        }
+    }
+    /**
+     * 标记单个任务失败
+     */
+    markTaskFailed(taskId, error) {
+        const session = this.#currentSession;
+        if (!session) {
+            return;
+        }
+        const task = session.getTask(taskId);
+        if (!task) {
+            return;
+        }
+        task.status = TaskStatus.FAILED;
+        task.completedAt = Date.now();
+        task.error =
+            typeof error === 'string' ? error : error instanceof Error ? error.message : 'Unknown error';
+        Logger.warn(`[Bootstrap] Task "${taskId}" failed: ${task.error}`);
+        this.#emit('bootstrap:task-failed', {
+            sessionId: session.id,
+            taskId,
+            meta: task.meta,
+            error: task.error,
+            progress: session.progress,
+        });
+        // 检查是否所有任务都已完成（包括失败）
+        if (session.isAllDone) {
+            this.#finishSession();
+        }
+    }
+    // ═══════════════════════════════════════════════════════════
+    //  查询接口
+    // ═══════════════════════════════════════════════════════════
+    /**
+     * 获取当前 session 状态（供 HTTP 轮询）
+     */
+    getSessionStatus() {
+        if (!this.#currentSession) {
+            return { status: 'idle', message: 'No active bootstrap session' };
+        }
+        return this.#currentSession.toJSON();
+    }
+    /**
+     * 是否有正在进行的 bootstrap
+     */
+    get isRunning() {
+        return this.#currentSession?.status === 'running';
+    }
+    // ═══════════════════════════════════════════════════════════
+    //  通用进度推送（供 refine 等非 bootstrap 流程复用双通道）
+    // ═══════════════════════════════════════════════════════════
+    /**
+     * 向 EventBus + Socket.io 发射任意进度事件
+     *
+     * 用途：不走 bootstrap session 模型的长操作（如 AI 润色）也能复用
+     * 同一套 EventBus + RealtimeService 双通道推送。
+     *
+     * @param {string} eventName 事件名（如 'refine:started'）
+     * @param {object} data      事件负载
+     */
+    emitProgress(eventName, data) {
+        this.#emit(eventName, data);
+    }
+    // ═══════════════════════════════════════════════════════════
+    //  内部方法
+    // ═══════════════════════════════════════════════════════════
+    #finishSession() {
+        const session = this.#currentSession;
+        if (!session) {
+            return;
+        }
+        session.status = session.failedTasks > 0 ? 'completed_with_errors' : 'completed';
+        session.completedAt = Date.now();
+        session.summary = {
+            duration: session.completedAt - session.startedAt,
+            totalTasks: session.totalTasks,
+            completed: session.completedTasks,
+            failed: session.failedTasks,
+        };
+        const durationSec = ((session.completedAt - session.startedAt) / 1000).toFixed(1);
+        Logger.info(`[Bootstrap] Session ${session.id} finished: ${session.completedTasks} completed, ${session.failedTasks} failed (${durationSec}s)`);
+        this.#emit('bootstrap:all-completed', {
+            sessionId: session.id,
+            summary: session.summary,
+            tasks: [...session.tasks.values()].map((t) => ({
+                id: t.id,
+                status: t.status,
+                meta: t.meta,
+                result: t.result,
+                error: t.error,
+            })),
+        });
+    }
+    /**
+     * 发射事件到 EventBus + 推送到前端 Socket.io
+     */
+    #emit(eventName, data) {
+        // EventBus（供后端监听者使用）
+        if (this.#eventBus) {
+            try {
+                this.#eventBus.emit(eventName, data);
+            }
+            catch (e) {
+                Logger.warn(`[Bootstrap] EventBus emit failed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+        }
+        // RealtimeService（推送到前端 Socket.io）
+        if (this.#getRealtimeService) {
+            try {
+                const realtime = this.#getRealtimeService();
+                if (realtime) {
+                    realtime.broadcastEvent(eventName, data);
+                }
+            }
+            catch {
+                // RealtimeService 可能未初始化（CLI 模式），静默忽略
+            }
+        }
+    }
+}
+//# sourceMappingURL=BootstrapTaskManager.js.map

package/dist/lib/service/bootstrap/BootstrapTaskManager.js.map

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

package/dist/lib/service/candidate/CandidateAggregator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CandidateAggregator — 候选条目去重聚合
+ *
+ * 对候选列表按 title 进行模糊去重，保留最优条目。
+ * 被 knowledge handler 的 submitKnowledgeBatch 使用。
+ *
+ * @module service/candidate/CandidateAggregator
+ */
+interface CandidateItem {
+    title: string;
+    code?: string;
+    [key: string]: unknown;
+}
+interface AggregateOpts {
+    threshold?: number;
+}
+/**
+ * 对候选条目列表进行去重聚合
+ *
+ * @param {CandidateItem[]} items
+ * @param {AggregateOpts} [opts]
+ * @returns {{ items: CandidateItem[], duplicates: Array<{item: CandidateItem, duplicateOf: string}> }}
+ */
+export declare function aggregateCandidates(items: CandidateItem[], opts?: AggregateOpts): {
+    items: CandidateItem[];
+    duplicates: {
+        item: CandidateItem;
+        duplicateOf: string;
+    }[];
+};
+export {};
+//# sourceMappingURL=CandidateAggregator.d.ts.map

package/dist/lib/service/candidate/CandidateAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CandidateAggregator.d.ts","sourceRoot":"","sources":["../../../../lib/service/candidate/CandidateAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,IAAI,GAAE,aAAkB;;;cAOxD,aAAa;qBAAe,MAAM;;EAsB7D"}

package/dist/lib/service/candidate/CandidateAggregator.js

@@ -0,0 +1,44 @@
+/**
+ * CandidateAggregator — 候选条目去重聚合
+ *
+ * 对候选列表按 title 进行模糊去重，保留最优条目。
+ * 被 knowledge handler 的 submitKnowledgeBatch 使用。
+ *
+ * @module service/candidate/CandidateAggregator
+ */
+import { jaccardSimilarity, tokenizeForSimilarity } from '../../shared/similarity.js';
+/** title 相似度阈值，超过此值视为重复 */
+const TITLE_SIMILARITY_THRESHOLD = 0.85;
+/**
+ * 对候选条目列表进行去重聚合
+ *
+ * @param {CandidateItem[]} items
+ * @param {AggregateOpts} [opts]
+ * @returns {{ items: CandidateItem[], duplicates: Array<{item: CandidateItem, duplicateOf: string}> }}
+ */
+export function aggregateCandidates(items, opts = {}) {
+    if (!Array.isArray(items) || items.length === 0) {
+        return { items: [], duplicates: [] };
+    }
+    const threshold = opts.threshold ?? TITLE_SIMILARITY_THRESHOLD;
+    const kept = [];
+    const duplicates = [];
+    for (const item of items) {
+        const titleTokens = tokenizeForSimilarity(item.title || '');
+        let isDuplicate = false;
+        for (const existing of kept) {
+            const existingTokens = tokenizeForSimilarity(existing.title || '');
+            const sim = jaccardSimilarity(titleTokens, existingTokens);
+            if (sim >= threshold) {
+                duplicates.push({ item, duplicateOf: existing.title });
+                isDuplicate = true;
+                break;
+            }
+        }
+        if (!isDuplicate) {
+            kept.push(item);
+        }
+    }
+    return { items: kept, duplicates };
+}
+//# sourceMappingURL=CandidateAggregator.js.map

package/dist/lib/service/candidate/CandidateAggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CandidateAggregator.js","sourceRoot":"","sources":["../../../../lib/service/candidate/CandidateAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,2BAA2B;AAC3B,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAYxC;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAsB,EAAE,OAAsB,EAAE;IAClF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,0BAA0B,CAAC;IAC/D,MAAM,IAAI,GAAoB,EAAE,CAAC;IACjC,MAAM,UAAU,GAAmD,EAAE,CAAC;IAEtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,WAAW,GAAG,KAAK,CAAC;QAExB,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC5B,MAAM,cAAc,GAAG,qBAAqB,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACnE,MAAM,GAAG,GAAG,iBAAiB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAC3D,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;gBACrB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBACvD,WAAW,GAAG,IAAI,CAAC;gBACnB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACrC,CAAC"}

package/dist/lib/service/candidate/SimilarityService.d.ts

@@ -0,0 +1,32 @@
+/**
+ * SimilarityService — 轻量级 Recipe 相似度检测
+ * 基于 Jaccard 相似度对候选与已有 Recipe 进行去重检测
+ */
+interface SimilarityCandidate {
+    title: string;
+    summary?: string;
+    description?: string;
+    code: string;
+    [key: string]: unknown;
+}
+interface SimilarityOpts {
+    threshold?: number;
+    topK?: number;
+}
+/**
+ * 在项目知识库中查找与候选相似的 Recipe
+ * @param {string} projectRoot 项目根目录
+ * @param {object} candidate - { title, summary, usageGuide, code }
+ * @param {object} [opts] - { threshold: 0.7, topK: 5 }
+ * @returns {Array<{file, title, similarity}>}
+ */
+export declare function findSimilarRecipes(projectRoot: string, candidate: SimilarityCandidate, opts?: SimilarityOpts): {
+    file: string;
+    title: string;
+    similarity: number;
+}[];
+declare const _default: {
+    findSimilarRecipes: typeof findSimilarRecipes;
+};
+export default _default;
+//# sourceMappingURL=SimilarityService.d.ts.map

package/dist/lib/service/candidate/SimilarityService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimilarityService.d.ts","sourceRoot":"","sources":["../../../../lib/service/candidate/SimilarityService.ts"],"names":[],"mappings":"AAKA;;;GAGG;AAEH,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAUD,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA8DD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,mBAAmB,EAC9B,IAAI,GAAE,cAAmB;UAOF,MAAM;WAAS,MAAM;gBAAc,MAAM;IAcjE;;;;AAED,wBAAsC"}

package/dist/lib/service/candidate/SimilarityService.js

@@ -0,0 +1,82 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { getProjectRecipesPath } from '../../infrastructure/config/Paths.js';
+import { jaccardSimilarity, tokenizeForSimilarity } from '../../shared/similarity.js';
+/**
+ * 计算候选与单个 Recipe 的综合相似度
+ */
+function computeSimilarity(candidate, recipe) {
+    const titleSim = jaccardSimilarity(tokenizeForSimilarity(candidate.title), tokenizeForSimilarity(recipe.title));
+    const summarySim = jaccardSimilarity(tokenizeForSimilarity(candidate.summary || candidate.description || ''), tokenizeForSimilarity(recipe.summary || recipe.description || ''));
+    const codeSim = jaccardSimilarity(tokenizeForSimilarity(candidate.code, 3), tokenizeForSimilarity(recipe.code, 3));
+    // 加权: title 30%, summary 30%, code 40%
+    return titleSim * 0.3 + summarySim * 0.3 + codeSim * 0.4;
+}
+/**
+ * 从磁盘读取所有 Recipe MD 文件并提取基本结构
+ */
+function loadRecipesFromDisk(recipesDir) {
+    const recipes = [];
+    if (!fs.existsSync(recipesDir)) {
+        return recipes;
+    }
+    const walk = (dir) => {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (entry.name.startsWith('.')) {
+                continue;
+            }
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                walk(full);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                try {
+                    const content = fs.readFileSync(full, 'utf8');
+                    const titleMatch = content.match(/^#\s+(.+)/m);
+                    const _fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+                    const codeMatch = content.match(/```\w*\n([\s\S]*?)```/);
+                    const summaryMatch = content.match(/summary[_cn]*:\s*(.+)/i);
+                    recipes.push({
+                        file: path.relative(recipesDir, full),
+                        title: titleMatch?.[1]?.trim() || path.basename(full, '.md'),
+                        summary: summaryMatch?.[1]?.trim() || '',
+                        code: codeMatch?.[1]?.trim() || '',
+                    });
+                }
+                catch {
+                    /* skip unreadable */
+                }
+            }
+        }
+    };
+    walk(recipesDir);
+    return recipes;
+}
+/**
+ * 在项目知识库中查找与候选相似的 Recipe
+ * @param {string} projectRoot 项目根目录
+ * @param {object} candidate - { title, summary, usageGuide, code }
+ * @param {object} [opts] - { threshold: 0.7, topK: 5 }
+ * @returns {Array<{file, title, similarity}>}
+ */
+export function findSimilarRecipes(projectRoot, candidate, opts = {}) {
+    const threshold = opts.threshold ?? 0.7;
+    const topK = opts.topK ?? 5;
+    const recipesDir = getProjectRecipesPath(projectRoot);
+    const recipes = loadRecipesFromDisk(recipesDir);
+    const results = [];
+    for (const recipe of recipes) {
+        const sim = computeSimilarity(candidate, recipe);
+        if (sim >= threshold) {
+            results.push({
+                file: recipe.file,
+                title: recipe.title,
+                similarity: Math.round(sim * 1000) / 1000,
+            });
+        }
+    }
+    results.sort((a, b) => b.similarity - a.similarity);
+    return results.slice(0, topK);
+}
+export default { findSimilarRecipes };
+//# sourceMappingURL=SimilarityService.js.map

package/dist/lib/service/candidate/SimilarityService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SimilarityService.js","sourceRoot":"","sources":["../../../../lib/service/candidate/SimilarityService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AA4BtF;;GAEG;AACH,SAAS,iBAAiB,CAAC,SAA8B,EAAE,MAAwB;IACjF,MAAM,QAAQ,GAAG,iBAAiB,CAChC,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,EACtC,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CACpC,CAAC;IACF,MAAM,UAAU,GAAG,iBAAiB,CAClC,qBAAqB,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC,EACvE,qBAAqB,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAClE,CAAC;IACF,MAAM,OAAO,GAAG,iBAAiB,CAC/B,qBAAqB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,EACxC,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CACtC,CAAC;IACF,uCAAuC;IACvC,OAAO,QAAQ,GAAG,GAAG,GAAG,UAAU,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,UAAkB;IAC7C,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACjE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;oBAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;oBAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;oBACxD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;oBACzD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;oBAC7D,OAAO,CAAC,IAAI,CAAC;wBACX,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;wBACrC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;wBAC5D,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;wBACxC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;qBACnC,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,qBAAqB;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,CAAC;IACjB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,SAA8B,EAC9B,OAAuB,EAAE;IAEzB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;IAC5B,MAAM,UAAU,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEhD,MAAM,OAAO,GAA0D,EAAE,CAAC;IAC1E,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,GAAG,IAAI,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI;aAC1C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,eAAe,EAAE,kBAAkB,EAAE,CAAC"}