autosnippet 3.2.15 → 3.2.16

package/dist/lib/service/skills/FeedbackStore.js

@@ -0,0 +1,255 @@
+/**
+ * FeedbackStore — 推荐反馈持久化与用户偏好推导
+ *
+ * 存储位置: {projectRoot}/.autosnippet/feedback.jsonl
+ * 格式: 每行一个 JSON 对象 (append-only log)
+ *
+ * 职责:
+ *   - 记录用户对推荐的反馈 (adopted / dismissed / expired / viewed / modified)
+ *   - 计算采纳率、查看率、按来源分组的采纳率
+ *   - 推导用户偏好向量 (喜欢/回避的类别和来源)
+ *   - 检测被频繁忽略的推荐类别
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { RUNTIME_DIR } from '#shared/ProjectMarkers.js';
+import Logger from '../../infrastructure/logging/Logger.js';
+const FEEDBACK_FILE = 'feedback.jsonl';
+/** 频繁忽略阈值: 该类别至少 5 次且忽略率 >= 70% */
+const DISMISS_MIN_COUNT = 5;
+const DISMISS_THRESHOLD = 0.7;
+/** 内存缓存条数上限 (JSONL 可无限追加，但内存只保留最近 N 条) */
+const MAX_MEMORY_ENTRIES = 2000;
+export class FeedbackStore {
+    #filePath;
+    #logger;
+    #entries = [];
+    #loaded = false;
+    constructor(projectRoot) {
+        this.#filePath = path.join(projectRoot, RUNTIME_DIR, FEEDBACK_FILE);
+        this.#logger = Logger.getInstance();
+    }
+    // ─── 公共 API ──────────────────────────────────────────
+    /**
+     * 记录一条反馈
+     */
+    async record(feedback) {
+        this.#ensureLoaded();
+        const entry = {
+            ...feedback,
+            timestamp: feedback.timestamp || new Date().toISOString(),
+            _ts: new Date().toISOString(),
+        };
+        this.#entries.push(entry);
+        // 内存溢出保护
+        if (this.#entries.length > MAX_MEMORY_ENTRIES) {
+            this.#entries = this.#entries.slice(-MAX_MEMORY_ENTRIES);
+        }
+        // 追加写入 JSONL
+        try {
+            const dir = path.dirname(this.#filePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.appendFileSync(this.#filePath, `${JSON.stringify(entry)}\n`, 'utf-8');
+        }
+        catch (err) {
+            this.#logger.warn('FeedbackStore: failed to persist feedback', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    /**
+     * 获取采纳率
+     * @param source 可选 — 按推荐来源过滤
+     */
+    getAdoptionRate(source) {
+        this.#ensureLoaded();
+        const filtered = source ? this.#entries.filter((e) => e.source === source) : this.#entries;
+        const adopted = filtered.filter((e) => e.action === 'adopted' || e.action === 'modified').length;
+        const dismissed = filtered.filter((e) => e.action === 'dismissed').length;
+        const total = adopted + dismissed;
+        if (total === 0) {
+            return 0;
+        }
+        return adopted / total;
+    }
+    /**
+     * 获取用户偏好向量 (基于历史反馈推导)
+     */
+    getUserPreference() {
+        this.#ensureLoaded();
+        const categoryStats = new Map();
+        const sourceStats = new Map();
+        for (const entry of this.#entries) {
+            const cat = entry.category ?? 'unknown';
+            const src = entry.source ?? 'unknown';
+            // 按类别
+            if (!categoryStats.has(cat)) {
+                categoryStats.set(cat, { adopted: 0, dismissed: 0 });
+            }
+            const cs = categoryStats.get(cat);
+            if (entry.action === 'adopted' || entry.action === 'modified') {
+                cs.adopted++;
+            }
+            if (entry.action === 'dismissed') {
+                cs.dismissed++;
+            }
+            // 按来源
+            if (!sourceStats.has(src)) {
+                sourceStats.set(src, { adopted: 0, dismissed: 0 });
+            }
+            const ss = sourceStats.get(src);
+            if (entry.action === 'adopted' || entry.action === 'modified') {
+                ss.adopted++;
+            }
+            if (entry.action === 'dismissed') {
+                ss.dismissed++;
+            }
+        }
+        const preferredCategories = [];
+        const avoidedCategories = [];
+        for (const [cat, stats] of categoryStats) {
+            const total = stats.adopted + stats.dismissed;
+            if (total < 3) {
+                continue;
+            }
+            const rate = stats.adopted / total;
+            if (rate >= 0.6) {
+                preferredCategories.push(cat);
+            }
+            if (rate <= 0.3) {
+                avoidedCategories.push(cat);
+            }
+        }
+        const preferredSources = [];
+        for (const [src, stats] of sourceStats) {
+            const total = stats.adopted + stats.dismissed;
+            if (total >= 3 && stats.adopted / total >= 0.5) {
+                preferredSources.push(src);
+            }
+        }
+        return {
+            preferredCategories,
+            avoidedCategories,
+            preferredSources,
+            adoptionRate: this.getAdoptionRate(),
+        };
+    }
+    /**
+     * 特定类别的推荐是否被用户频繁忽略
+     */
+    isFrequentlyDismissed(category) {
+        this.#ensureLoaded();
+        const entries = this.#entries.filter((e) => e.category === category);
+        const dismissed = entries.filter((e) => e.action === 'dismissed').length;
+        const adopted = entries.filter((e) => e.action === 'adopted' || e.action === 'modified').length;
+        const total = dismissed + adopted;
+        if (total < DISMISS_MIN_COUNT) {
+            return false;
+        }
+        return dismissed / total >= DISMISS_THRESHOLD;
+    }
+    /**
+     * 获取推荐效果指标快照
+     */
+    getMetricsSnapshot(since) {
+        this.#ensureLoaded();
+        const sinceTs = since?.toISOString() ?? '1970-01-01T00:00:00.000Z';
+        const filtered = this.#entries.filter((e) => e.timestamp >= sinceTs);
+        const totalRecommendations = filtered.length;
+        const totalViewed = filtered.filter((e) => e.action === 'viewed').length;
+        const totalAdopted = filtered.filter((e) => e.action === 'adopted' || e.action === 'modified').length;
+        const totalDismissed = filtered.filter((e) => e.action === 'dismissed').length;
+        const totalExpired = filtered.filter((e) => e.action === 'expired').length;
+        // 按来源分组采纳率
+        const sourceMap = new Map();
+        for (const entry of filtered) {
+            const src = entry.source ?? 'unknown';
+            if (!sourceMap.has(src)) {
+                sourceMap.set(src, { adopted: 0, total: 0 });
+            }
+            const s = sourceMap.get(src);
+            if (entry.action === 'adopted' ||
+                entry.action === 'modified' ||
+                entry.action === 'dismissed') {
+                s.total++;
+            }
+            if (entry.action === 'adopted' || entry.action === 'modified') {
+                s.adopted++;
+            }
+        }
+        const adoptionRateBySource = {};
+        for (const [src, stats] of sourceMap) {
+            adoptionRateBySource[src] = stats.total > 0 ? stats.adopted / stats.total : 0;
+        }
+        const decisionTotal = totalAdopted + totalDismissed;
+        return {
+            totalRecommendations,
+            totalViewed,
+            totalAdopted,
+            totalDismissed,
+            totalExpired,
+            adoptionRate: decisionTotal > 0 ? totalAdopted / decisionTotal : 0,
+            viewRate: totalRecommendations > 0 ? totalViewed / totalRecommendations : 0,
+            adoptionRateBySource,
+            since: sinceTs,
+        };
+    }
+    /**
+     * 获取指定推荐 ID 的反馈历史
+     */
+    getFeedbackFor(recommendationId) {
+        this.#ensureLoaded();
+        return this.#entries.filter((e) => e.recommendationId === recommendationId);
+    }
+    /**
+     * 全部反馈条数
+     */
+    get size() {
+        this.#ensureLoaded();
+        return this.#entries.length;
+    }
+    // ─── 内部方法 ──────────────────────────────────────────
+    /**
+     * 惰性加载: 首次访问时从 JSONL 文件读取历史
+     */
+    #ensureLoaded() {
+        if (this.#loaded) {
+            return;
+        }
+        this.#loaded = true;
+        this.#loadFromDisk();
+    }
+    #loadFromDisk() {
+        try {
+            if (!fs.existsSync(this.#filePath)) {
+                return;
+            }
+            const content = fs.readFileSync(this.#filePath, 'utf-8');
+            const lines = content.trim().split('\n').filter(Boolean);
+            const entries = [];
+            for (const line of lines) {
+                try {
+                    entries.push(JSON.parse(line));
+                }
+                catch {
+                    // 跳过损坏行
+                }
+            }
+            // 只保留最近 N 条
+            this.#entries =
+                entries.length > MAX_MEMORY_ENTRIES ? entries.slice(-MAX_MEMORY_ENTRIES) : entries;
+            if (this.#entries.length > 0) {
+                this.#logger.debug(`FeedbackStore: loaded ${this.#entries.length} entries from disk`);
+            }
+        }
+        catch (err) {
+            this.#logger.warn('FeedbackStore: failed to load from disk', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+}
+export default FeedbackStore;
+//# sourceMappingURL=FeedbackStore.js.map

package/dist/lib/service/skills/FeedbackStore.js.map

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

package/dist/lib/service/skills/RecommendationMetrics.d.ts

@@ -0,0 +1,60 @@
+/**
+ * RecommendationMetrics — 推荐效果度量追踪
+ *
+ * 追踪推荐系统的关键指标:
+ *   - 展示次数 (display)
+ *   - 查看次数 (view)
+ *   - 采纳次数 (adopt)
+ *   - 忽略次数 (dismiss)
+ *   - 采纳率 = adopt / (adopt + dismiss)
+ *   - CTR = view / display
+ *
+ * 所有数据委托给 FeedbackStore 持久化。
+ * 本类只负责实时聚合 + 对外暴露接口。
+ */
+import type { FeedbackStore } from './FeedbackStore.js';
+import type { RecommendationMetricsSnapshot, ScoredRecommendation } from './types.js';
+interface MetricsCounters {
+    displayed: number;
+    viewed: number;
+    adopted: number;
+    dismissed: number;
+    expired: number;
+}
+export declare class RecommendationMetrics {
+    #private;
+    constructor(feedbackStore: FeedbackStore);
+    /**
+     * 记录推荐已展示 (dashboard/MCP 返回推荐列表时调用)
+     */
+    trackDisplayed(recommendations: ScoredRecommendation[]): void;
+    /**
+     * 记录推荐被采纳
+     */
+    trackAdopted(recommendationId: string, source?: string, category?: string): Promise<void>;
+    /**
+     * 记录推荐被忽略
+     */
+    trackDismissed(recommendationId: string, reason?: string, source?: string, category?: string): Promise<void>;
+    /**
+     * 记录推荐过期
+     */
+    trackExpired(recommendationId: string, source?: string): Promise<void>;
+    /**
+     * 获取当前会话的指标
+     */
+    getSessionMetrics(): MetricsCounters & {
+        adoptionRate: number;
+        ctr: number;
+    };
+    /**
+     * 获取全局指标快照 (含持久化历史)
+     */
+    getGlobalSnapshot(since?: Date): RecommendationMetricsSnapshot;
+    /**
+     * 获取指定来源的采纳率
+     */
+    getAdoptionRateBySource(source: string): number;
+}
+export default RecommendationMetrics;
+//# sourceMappingURL=RecommendationMetrics.d.ts.map

package/dist/lib/service/skills/RecommendationMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecommendationMetrics.d.ts","sourceRoot":"","sources":["../../../../lib/service/skills/RecommendationMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEtF,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,qBAAqB;;gBAapB,aAAa,EAAE,aAAa;IAOxC;;OAEG;IACH,cAAc,CAAC,eAAe,EAAE,oBAAoB,EAAE,GAAG,IAAI;IAqB7D;;OAEG;IACG,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/F;;OAEG;IACG,cAAc,CAClB,gBAAgB,EAAE,MAAM,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5E;;OAEG;IACH,iBAAiB,IAAI,eAAe,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAU5E;;OAEG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,IAAI,GAAG,6BAA6B;IAI9D;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGhD;AAED,eAAe,qBAAqB,CAAC"}

package/dist/lib/service/skills/RecommendationMetrics.js

@@ -0,0 +1,120 @@
+/**
+ * RecommendationMetrics — 推荐效果度量追踪
+ *
+ * 追踪推荐系统的关键指标:
+ *   - 展示次数 (display)
+ *   - 查看次数 (view)
+ *   - 采纳次数 (adopt)
+ *   - 忽略次数 (dismiss)
+ *   - 采纳率 = adopt / (adopt + dismiss)
+ *   - CTR = view / display
+ *
+ * 所有数据委托给 FeedbackStore 持久化。
+ * 本类只负责实时聚合 + 对外暴露接口。
+ */
+import Logger from '../../infrastructure/logging/Logger.js';
+export class RecommendationMetrics {
+    #feedbackStore;
+    #logger;
+    /** 内存计数器 — 只追踪本次进程的增量 */
+    #session = {
+        displayed: 0,
+        viewed: 0,
+        adopted: 0,
+        dismissed: 0,
+        expired: 0,
+    };
+    constructor(feedbackStore) {
+        this.#feedbackStore = feedbackStore;
+        this.#logger = Logger.getInstance();
+    }
+    // ─── 事件记录 ──────────────────────────────────────────
+    /**
+     * 记录推荐已展示 (dashboard/MCP 返回推荐列表时调用)
+     */
+    trackDisplayed(recommendations) {
+        this.#session.displayed += recommendations.length;
+        // 记录 viewed 事件到 FeedbackStore (展示即视为曝光)
+        for (const rec of recommendations) {
+            this.#feedbackStore
+                .record({
+                recommendationId: rec.recommendationId,
+                action: 'viewed',
+                timestamp: new Date().toISOString(),
+                source: rec.source,
+                category: rec.signals.category,
+            })
+                .catch((err) => {
+                this.#logger.warn('RecommendationMetrics: failed to record viewed', {
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }
+    }
+    /**
+     * 记录推荐被采纳
+     */
+    async trackAdopted(recommendationId, source, category) {
+        this.#session.adopted++;
+        await this.#feedbackStore.record({
+            recommendationId,
+            action: 'adopted',
+            timestamp: new Date().toISOString(),
+            source,
+            category,
+        });
+    }
+    /**
+     * 记录推荐被忽略
+     */
+    async trackDismissed(recommendationId, reason, source, category) {
+        this.#session.dismissed++;
+        await this.#feedbackStore.record({
+            recommendationId,
+            action: 'dismissed',
+            timestamp: new Date().toISOString(),
+            source,
+            category,
+            reason,
+        });
+    }
+    /**
+     * 记录推荐过期
+     */
+    async trackExpired(recommendationId, source) {
+        this.#session.expired++;
+        await this.#feedbackStore.record({
+            recommendationId,
+            action: 'expired',
+            timestamp: new Date().toISOString(),
+            source,
+        });
+    }
+    // ─── 查询 ──────────────────────────────────────────────
+    /**
+     * 获取当前会话的指标
+     */
+    getSessionMetrics() {
+        const s = this.#session;
+        const decisionTotal = s.adopted + s.dismissed;
+        return {
+            ...s,
+            adoptionRate: decisionTotal > 0 ? s.adopted / decisionTotal : 0,
+            ctr: s.displayed > 0 ? s.viewed / s.displayed : 0,
+        };
+    }
+    /**
+     * 获取全局指标快照 (含持久化历史)
+     */
+    getGlobalSnapshot(since) {
+        return this.#feedbackStore.getMetricsSnapshot(since);
+    }
+    /**
+     * 获取指定来源的采纳率
+     */
+    getAdoptionRateBySource(source) {
+        return this.#feedbackStore.getAdoptionRate(source);
+    }
+}
+export default RecommendationMetrics;
+//# sourceMappingURL=RecommendationMetrics.js.map

package/dist/lib/service/skills/RecommendationMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecommendationMetrics.js","sourceRoot":"","sources":["../../../../lib/service/skills/RecommendationMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,MAAM,MAAM,wCAAwC,CAAC;AAY5D,MAAM,OAAO,qBAAqB;IACvB,cAAc,CAAgB;IAC9B,OAAO,CAAwC;IAExD,yBAAyB;IACzB,QAAQ,GAAoB;QAC1B,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;KACX,CAAC;IAEF,YAAY,aAA4B;QACtC,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,sDAAsD;IAEtD;;OAEG;IACH,cAAc,CAAC,eAAuC;QACpD,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,eAAe,CAAC,MAAM,CAAC;QAElD,wCAAwC;QACxC,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,IAAI,CAAC,cAAc;iBAChB,MAAM,CAAC;gBACN,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;gBACtC,MAAM,EAAE,QAAQ;gBAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,QAA8B;aACrD,CAAC;iBACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACtB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE;oBAClE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,gBAAwB,EAAE,MAAe,EAAE,QAAiB;QAC7E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAC/B,gBAAgB;YAChB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM;YACN,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,gBAAwB,EACxB,MAAe,EACf,MAAe,EACf,QAAiB;QAEjB,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAC/B,gBAAgB;YAChB,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM;YACN,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,gBAAwB,EAAE,MAAe;QAC1D,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAC/B,gBAAgB;YAChB,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,wDAAwD;IAExD;;OAEG;IACH,iBAAiB;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,MAAM,aAAa,GAAG,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,SAAS,CAAC;QAC9C,OAAO;YACL,GAAG,CAAC;YACJ,YAAY,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC/D,GAAG,EAAE,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;SAClD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,KAAY;QAC5B,OAAO,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,MAAc;QACpC,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;CACF;AAED,eAAe,qBAAqB,CAAC"}

package/dist/lib/service/skills/RecommendationPipeline.d.ts

@@ -0,0 +1,43 @@
+/**
+ * RecommendationPipeline — 统一推荐管线
+ *
+ * 多阶段处理:
+ *   1. Recall  — 多策略并行召回候选 (Rule / AI / Vector / Popularity)
+ *   2. Score   — 综合评分 (信号强度 × 用户偏好 × 新鲜度)
+ *   3. Rank    — 排序 + 截断
+ *   4. Filter  — 去重、过滤已有 Skill、过滤频繁忽略的类别
+ *   5. Deliver — 输出最终推荐列表 + 触发 Hook
+ *
+ * 设计原则:
+ *   - 静默降级: 任何策略失败不影响其他策略
+ *   - 离线优先: 无 AI 时降级到规则召回
+ *   - 反馈闪环: 利用 FeedbackStore 调整排序权重
+ */
+import type { FeedbackStore } from './FeedbackStore.js';
+import type { SkillHooks } from './SkillHooks.js';
+import type { RecallStrategy, RecommendationContext, ScoredRecommendation } from './types.js';
+export declare class RecommendationPipeline {
+    #private;
+    constructor(opts?: {
+        feedbackStore?: FeedbackStore | null;
+        skillHooks?: SkillHooks | null;
+    });
+    /**
+     * 注册召回策略
+     */
+    addStrategy(strategy: RecallStrategy): void;
+    /**
+     * 获取已注册策略列表
+     */
+    getStrategies(): ReadonlyArray<RecallStrategy>;
+    /**
+     * 执行推荐管线
+     *
+     * @param context 推荐上下文
+     * @param topK 最多返回数量
+     * @returns 排序后的推荐结果列表
+     */
+    recommend(context: RecommendationContext, topK?: number): Promise<ScoredRecommendation[]>;
+}
+export default RecommendationPipeline;
+//# sourceMappingURL=RecommendationPipeline.d.ts.map

package/dist/lib/service/skills/RecommendationPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecommendationPipeline.d.ts","sourceRoot":"","sources":["../../../../lib/service/skills/RecommendationPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,cAAc,EAEd,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAmBpB,qBAAa,sBAAsB;;gBAO/B,IAAI,GAAE;QACJ,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KAC3B;IASR;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK3C;;OAEG;IACH,aAAa,IAAI,aAAa,CAAC,cAAc,CAAC;IAM9C;;;;;;OAMG;IACG,SAAS,CACb,OAAO,EAAE,qBAAqB,EAC9B,IAAI,GAAE,MAAsB,GAC3B,OAAO,CAAC,oBAAoB,EAAE,CAAC;CA0NnC;AAED,eAAe,sBAAsB,CAAC"}