autosnippet 3.3.5 → 3.3.7

package/dist/lib/service/panorama/PanoramaAggregator.js

@@ -8,6 +8,7 @@
  */
 var _a;
 import { DimensionAnalyzer } from './DimensionAnalyzer.js';
+import { profileTechStack } from './TechStackProfiler.js';
 /* ═══ PanoramaAggregator Class ════════════════════════════ */
 export class PanoramaAggregator {
     #roleRefiner;
@@ -22,12 +23,15 @@ export class PanoramaAggregator {
         this.#layerInferrer = opts.layerInferrer;
         this.#db = opts.db;
         this.#projectRoot = opts.projectRoot;
-        this.#dimensionAnalyzer = opts.dimensionAnalyzer ?? new DimensionAnalyzer(opts.db);
+        this.#dimensionAnalyzer =
+            opts.dimensionAnalyzer ?? new DimensionAnalyzer(opts.db, opts.projectRoot);
     }
     /**
      * 计算完整全景数据
+     * @param moduleCandidates 模块候选列表
+     * @param options.configLayers 来自配置文件的层级声明（如 Boxfile layer 定义）
      */
-    compute(moduleCandidates) {
+    compute(moduleCandidates, options) {
         // 1. RoleRefiner: 精化角色
         const refinedRoles = this.#roleRefiner.refineAll(moduleCandidates);
         // 2. 构建模块-文件映射
@@ -35,11 +39,21 @@ export class PanoramaAggregator {
         for (const mc of moduleCandidates) {
             moduleFiles.set(mc.name, mc.files);
         }
-        // 3. CouplingAnalyzer: 耦合分析
-        const coupling = this.#couplingAnalyzer.analyze(moduleFiles);
-        // 4. LayerInferrer: 层级推断
+        // 3. CouplingAnalyzer: 耦合分析（含外部依赖 fan-in）
+        const externalModules = this.#collectExternalModules();
+        const coupling = this.#couplingAnalyzer.analyze(moduleFiles, externalModules);
+        // 4. LayerInferrer: 层级推断（优先使用配置层级）
         const modules = moduleCandidates.map((m) => m.name);
-        const layers = this.#layerInferrer.infer(coupling.edges, modules, coupling.cycles);
+        const configModuleLayerMap = new Map();
+        for (const mc of moduleCandidates) {
+            if (mc.configLayer) {
+                configModuleLayerMap.set(mc.name, mc.configLayer);
+            }
+        }
+        const layers = this.#layerInferrer.infer(coupling.edges, modules, coupling.cycles, {
+            configLayers: options?.configLayers,
+            moduleLayerMap: configModuleLayerMap.size > 0 ? configModuleLayerMap : undefined,
+        });
         // 5. 构建层级映射 (模块名 → 层级号)
         const moduleLayerMap = new Map();
         for (const level of layers.levels) {
@@ -85,6 +99,9 @@ export class PanoramaAggregator {
         const { radar, gaps } = this.#dimensionAnalyzer.analyze(moduleRoles);
         // 10. 调用流概要
         const callFlowSummary = this.#computeCallFlowSummary();
+        // 11. 外部依赖概况 + 技术栈画像
+        const externalDeps = this.#buildExternalDepProfiles(coupling.externalDeps);
+        const techStack = externalDeps.length > 0 ? profileTechStack(externalDeps) : null;
         return {
             modules: panoramaModules,
             layers,
@@ -93,6 +110,8 @@ export class PanoramaAggregator {
             healthRadar: radar,
             callFlowSummary,
             projectRecipeCount,
+            externalDeps,
+            techStack,
             computedAt: Date.now(),
         };
     }
@@ -108,6 +127,65 @@ export class PanoramaAggregator {
             return 0;
         }
     }
+    /* ─── External Dependencies ─────────────────────── */
+    /**
+     * 从 code_entities 收集标记为 external 的模块名
+     */
+    #collectExternalModules() {
+        try {
+            const rows = this.#db
+                .prepare(`SELECT entity_id FROM code_entities
+           WHERE entity_type = 'module' AND project_root = ?
+             AND json_extract(metadata_json, '$.nodeType') IN ('external', 'host')`)
+                .all(this.#projectRoot);
+            return new Set(rows.map((r) => r.entity_id));
+        }
+        catch {
+            return new Set();
+        }
+    }
+    /**
+     * 将 CouplingAnalyzer 的外部依赖统计转为 ExternalDepProfile
+     * 并从 code_entities 补充 layer/version 元数据
+     */
+    #buildExternalDepProfiles(rawExternalDeps) {
+        if (rawExternalDeps.length === 0) {
+            return [];
+        }
+        // 批量查询外部依赖的元数据
+        const metadataMap = new Map();
+        try {
+            for (const dep of rawExternalDeps) {
+                const row = this.#db
+                    .prepare(`SELECT metadata_json FROM code_entities
+             WHERE entity_id = ? AND entity_type = 'module' AND project_root = ?
+             LIMIT 1`)
+                    .get(dep.name, this.#projectRoot);
+                if (row?.metadata_json) {
+                    const meta = typeof row.metadata_json === 'string'
+                        ? JSON.parse(row.metadata_json)
+                        : row.metadata_json;
+                    metadataMap.set(dep.name, {
+                        layer: meta.layer,
+                        version: meta.version,
+                    });
+                }
+            }
+        }
+        catch {
+            /* skip metadata enrichment errors */
+        }
+        return rawExternalDeps.map((dep) => {
+            const meta = metadataMap.get(dep.name);
+            return {
+                name: dep.name,
+                fanIn: dep.fanIn,
+                dependedBy: dep.dependedBy,
+                layer: meta?.layer,
+                version: meta?.version,
+            };
+        });
+    }
     /* ─── Layer Naming (role-based) ─────────────────── */
     /** 角色 → 层级名映射 */
     static #ROLE_TO_LAYER = {

package/dist/lib/service/panorama/PanoramaScanner.js

@@ -103,6 +103,34 @@ export class PanoramaScanner {
                     modules = phase2.depGraphData.nodes?.length ?? 0;
                 }
             }
+            // Phase 2-extra: CustomConfig 增强
+            // 当主 discoverer 不是 customConfig 时，尝试 CustomConfigDiscoverer
+            // 以获取更丰富的模块视图（混编项目常见：jvm/node/dart 获胜但模块数偏少）
+            if (phase1.discoverer && phase1.discoverer.id !== 'customConfig') {
+                try {
+                    const { CustomConfigDiscoverer } = await import('../../core/discovery/CustomConfigDiscoverer.js');
+                    const ccDiscoverer = new CustomConfigDiscoverer();
+                    const ccDetect = await ccDiscoverer.detect(this.#projectRoot);
+                    if (ccDetect.match && ccDetect.confidence >= 0.7) {
+                        await ccDiscoverer.load(this.#projectRoot);
+                        const ccTargets = await ccDiscoverer.listTargets();
+                        // 仅当 CustomConfig 发现更多模块时才采纳
+                        if (ccTargets.length > modules) {
+                            this.#logger.info(`[PanoramaScanner] CustomConfig enrichment: ${ccTargets.length} modules ` +
+                                `(primary discoverer '${phase1.discoverer.id}' found ${modules})`);
+                            const ccPhase2 = await runPhase2_DependencyGraph(ccDiscoverer, this.#container, this.#logger, 'custom-enrichment');
+                            edges += ccPhase2.depEdgesWritten;
+                            if (ccPhase2.depGraphData) {
+                                await runPhase2_1_ModuleEntities(ccPhase2.depGraphData, this.#projectRoot, this.#container, this.#logger);
+                                modules = Math.max(modules, ccPhase2.depGraphData.nodes?.length ?? 0);
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // CustomConfig 增强失败不阻塞主流程
+                }
+            }
             // Phase 2.2: 目录推断兜底
             // 当 Phase 2.1 未产出 module 实体时（无 Package.swift / build.gradle 等），
             // 从已有 code_entities 按顶层目录分组写入 module 实体

package/dist/lib/service/panorama/PanoramaService.js

@@ -187,11 +187,13 @@ export class PanoramaService {
         let prefix = paths[0];
         for (const p of paths) {
             while (!p.startsWith(prefix)) {
-                const lastSlash = prefix.lastIndexOf('/');
+                // Strip trailing slash before searching for last separator
+                const trimmed = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix;
+                const lastSlash = trimmed.lastIndexOf('/');
                 if (lastSlash < 0) {
                     return '';
                 }
-                prefix = prefix.slice(0, lastSlash + 1);
+                prefix = trimmed.slice(0, lastSlash + 1);
             }
         }
         return prefix;
@@ -328,8 +330,10 @@ export class PanoramaService {
             return;
         }
         if (!this.#scanPromise) {
-            this.#scanPromise = this.#scanner.ensureData().then(() => {
-                this.#cache = null; // 扫描后清除缓存以触发重新计算
+            this.#scanPromise = this.#scanner.ensureData().then((scanResult) => {
+                if (scanResult) {
+                    this.#cache = null; // 扫描后清除缓存以触发重新计算
+                }
             });
         }
         await this.#scanPromise;
@@ -357,7 +361,8 @@ export class PanoramaService {
             return this.#cache;
         }
         const candidates = this.#moduleDiscoverer.discover();
-        this.#cache = this.#aggregator.compute(candidates);
+        const configLayers = this.#moduleDiscoverer.readConfigLayers();
+        this.#cache = this.#aggregator.compute(candidates, { configLayers });
         return this.#cache;
     }
 }

package/dist/lib/service/panorama/PanoramaTypes.d.ts

@@ -33,6 +33,40 @@ export interface PanoramaModule {
     fileCount: number;
     recipeCount: number;
     coverageRatio: number;
+    /** 模块类型: local(有源码) / external(第三方) / host(宿主应用) */
+    kind?: 'local' | 'external' | 'host';
+}
+export interface ExternalDepProfile {
+    name: string;
+    /** 被多少本地模块依赖 */
+    fanIn: number;
+    /** 依赖此外部库的本地模块列表 */
+    dependedBy: string[];
+    /** 所属层级 */
+    layer?: string;
+    /** 声明版本 */
+    version?: string;
+    /** 技术栈分类标签 */
+    category?: string;
+}
+export interface TechStackProfile {
+    /** 按类别分组的外部依赖 */
+    categories: Array<{
+        name: string;
+        deps: Array<{
+            name: string;
+            fanIn: number;
+            version?: string;
+        }>;
+    }>;
+    /** 关键外部依赖（fan-in ≥ 3 的热点） */
+    hotspots: Array<{
+        name: string;
+        fanIn: number;
+        dependedBy: string[];
+    }>;
+    /** 外部依赖总数 */
+    totalExternalDeps: number;
 }
 export interface LayerLevel {
     level: number;
@@ -130,5 +164,9 @@ export interface PanoramaResult {
     callFlowSummary: CallFlowSummary;
     /** 项目级活跃 recipe 总数（不限模块匹配） */
     projectRecipeCount: number;
+    /** 外部依赖概况 */
+    externalDeps: ExternalDepProfile[];
+    /** 技术栈画像 */
+    techStack: TechStackProfile | null;
     computedAt: number;
 }

package/dist/lib/service/panorama/RoleRefiner.d.ts

@@ -33,6 +33,8 @@ export interface ModuleCandidate {
     name: string;
     inferredRole: ModuleRole;
     files: string[];
+    /** 来自配置文件的层级名称（如 Boxfile 中的 layer 声明） */
+    configLayer?: string;
 }
 export declare class RoleRefiner {
     #private;

package/dist/lib/service/panorama/RoleRefiner.js

@@ -21,6 +21,35 @@ const WEIGHTS = {
     entityGraph: 0.1,
     regex: 0.15,
 };
+/**
+ * 配置文件层级名 → 模块角色映射
+ * 当配置文件声明了层级时（如 Boxfile 的 layer），
+ * 层级名是判断模块角色的强信号
+ */
+const CONFIG_LAYER_TO_ROLE = {
+    vendors: 'utility',
+    vendor: 'utility',
+    basics: 'core',
+    basic: 'core',
+    foundation: 'core',
+    core: 'core',
+    services: 'service',
+    service: 'service',
+    components: 'feature',
+    component: 'feature',
+    accessories: 'feature',
+    accessory: 'feature',
+    underlays: 'feature',
+    application: 'app',
+    app: 'app',
+    ui: 'ui',
+    networking: 'networking',
+    network: 'networking',
+    storage: 'storage',
+    model: 'model',
+    test: 'test',
+    tests: 'test',
+};
 /** primary_lang / LanguageService 输出 → 语言族 */
 const LANG_TO_FAMILY = {
     swift: 'apple',
@@ -267,6 +296,18 @@ export class RoleRefiner {
         signals.push(...this.#extractFlowSignals(module));
         // 4. EntityGraph 拓扑信号 (0.10)
         signals.push(...this.#extractTopoSignals(module));
+        // 4.5. 配置层级信号 — 来自 Boxfile/Tuist 等配置文件的 layer 声明
+        if (module.configLayer) {
+            const layerRole = CONFIG_LAYER_TO_ROLE[module.configLayer.toLowerCase()];
+            if (layerRole) {
+                signals.push({
+                    role: layerRole,
+                    confidence: 0.85,
+                    weight: WEIGHTS.ast, // 与 AST 等权重级别 (0.30)
+                    source: 'config-layer',
+                });
+            }
+        }
         // 5. 正则基线 (0.15)
         signals.push({
             role: module.inferredRole,

package/dist/lib/service/panorama/TechStackProfiler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * TechStackProfiler — 技术栈画像聚合
+ *
+ * 根据外部依赖名称自动分类，生成项目技术栈画像。
+ * 使用已知库名映射表 + 关键词启发式进行分类。
+ *
+ * @module TechStackProfiler
+ */
+import type { ExternalDepProfile, TechStackProfile } from './PanoramaTypes.js';
+/**
+ * 对外部依赖进行分类，生成技术栈画像
+ */
+export declare function profileTechStack(externalDeps: ExternalDepProfile[]): TechStackProfile;

package/dist/lib/service/panorama/TechStackProfiler.js

@@ -0,0 +1,191 @@
+/**
+ * TechStackProfiler — 技术栈画像聚合
+ *
+ * 根据外部依赖名称自动分类，生成项目技术栈画像。
+ * 使用已知库名映射表 + 关键词启发式进行分类。
+ *
+ * @module TechStackProfiler
+ */
+/* ═══ Known Library Categories ════════════════════════════ */
+/**
+ * 知名开源库 → 技术栈分类映射
+ * 覆盖 iOS/Swift/ObjC + 跨平台常见 + Node/Web 常见
+ */
+const KNOWN_LIBRARIES = {
+    // 网络
+    afnetworking: 'Networking',
+    alamofire: 'Networking',
+    moya: 'Networking',
+    axios: 'Networking',
+    urlsession: 'Networking',
+    grpc: 'Networking',
+    starscream: 'Networking',
+    socketrocket: 'Networking',
+    // 图片
+    sdwebimage: 'Image',
+    kingfisher: 'Image',
+    nuke: 'Image',
+    yyimage: 'Image',
+    flanimatedimage: 'Image',
+    // UI / 布局
+    snapkit: 'UI',
+    masonry: 'UI',
+    flexlayout: 'UI',
+    yoga: 'UI',
+    texture: 'UI',
+    asyncdisplaykit: 'UI',
+    iglistkit: 'UI',
+    mbprogresshud: 'UI',
+    svprogresshud: 'UI',
+    lottie: 'UI',
+    yytext: 'UI',
+    dzzfloatingactionbutton: 'UI',
+    herocard: 'UI',
+    // 响应式 / 函数式
+    rxswift: 'Reactive',
+    rxcocoa: 'Reactive',
+    reactiveswift: 'Reactive',
+    combine: 'Reactive',
+    openombine: 'Reactive',
+    promisekit: 'Reactive',
+    // 数据 / 存储
+    realm: 'Storage',
+    coredata: 'Storage',
+    fmdb: 'Storage',
+    grdb: 'Storage',
+    sqlite: 'Storage',
+    wcdb: 'Storage',
+    mmkv: 'Storage',
+    userdefaults: 'Storage',
+    yymodel: 'Serialization',
+    objectmapper: 'Serialization',
+    codable: 'Serialization',
+    swiftyjson: 'Serialization',
+    mantle: 'Serialization',
+    handyjson: 'Serialization',
+    mjextension: 'Serialization',
+    // 日志 / 诊断
+    cocoalumberjack: 'Logging',
+    swiftybeaver: 'Logging',
+    oslog: 'Logging',
+    bugly: 'Diagnostics',
+    sentry: 'Diagnostics',
+    firebase: 'Diagnostics',
+    crashlytics: 'Diagnostics',
+    // 路由
+    urlnavigator: 'Routing',
+    deeplink: 'Routing',
+    arouter: 'Routing',
+    ctmediator: 'Routing',
+    // 测试
+    quick: 'Testing',
+    nimble: 'Testing',
+    xctest: 'Testing',
+    ocmock: 'Testing',
+    ohhttpstubs: 'Testing',
+    // 安全 / 加密
+    cryptoswift: 'Security',
+    keychain: 'Security',
+    keychainaccess: 'Security',
+    commonCrypto: 'Security',
+    // 依赖注入
+    swinject: 'Architecture',
+    needle: 'Architecture',
+    // 工具
+    swiftlint: 'Tooling',
+    r_swift: 'Tooling',
+    swiftgen: 'Tooling',
+    cocoapods: 'Tooling',
+};
+/**
+ * 关键词 → 分类的启发式映射
+ * 用于 KNOWN_LIBRARIES 未命中时的 fallback
+ */
+const KEYWORD_CATEGORIES = [
+    [/net(work)?|http|api|url|request|socket|grpc/i, 'Networking'],
+    [/image|photo|picture|avatar|thumbnail/i, 'Image'],
+    [/ui|view|layout|widget|button|label|cell|collection|table/i, 'UI'],
+    [/anim(at)?|lottie|transition|motion/i, 'Animation'],
+    [/rx|reactive|combine|signal|observable|promise/i, 'Reactive'],
+    [/db|database|sql|realm|store|cache|storage|persist/i, 'Storage'],
+    [/json|model|mapper|serial|codable|parse|decode/i, 'Serialization'],
+    [/log|debug|trace|monitor|crash|sentry|bugly|diagnostic/i, 'Diagnostics'],
+    [/route|router|navigation|deeplink|scheme|mediator/i, 'Routing'],
+    [/test|mock|stub|spec|expect|assert/i, 'Testing'],
+    [/crypto|encrypt|security|keychain|auth|token|oauth/i, 'Security'],
+    [/player|video|audio|media|av|stream/i, 'Media'],
+    [/map|location|geo|coordinate|clocation/i, 'Location'],
+    [/pay|purchase|billing|iap/i, 'Payment'],
+    [/push|notification|apns|message/i, 'Messaging'],
+    [/analytics|track|event|statistics/i, 'Analytics'],
+    [/ad|banner|interstitial|reward/i, 'Advertising'],
+];
+/* ═══ TechStackProfiler ═══════════════════════════════════ */
+/** Fan-in 阈值：高于此值视为关键依赖热点 */
+const HOTSPOT_THRESHOLD = 3;
+/**
+ * 对外部依赖进行分类，生成技术栈画像
+ */
+export function profileTechStack(externalDeps) {
+    if (externalDeps.length === 0) {
+        return { categories: [], hotspots: [], totalExternalDeps: 0 };
+    }
+    // 1. 分类每个外部依赖
+    const categoryMap = new Map();
+    for (const dep of externalDeps) {
+        const category = classifyDependency(dep.name);
+        dep.category = category;
+        if (!categoryMap.has(category)) {
+            categoryMap.set(category, []);
+        }
+        categoryMap.get(category).push({
+            name: dep.name,
+            fanIn: dep.fanIn,
+            version: dep.version,
+        });
+    }
+    // 2. 按分类排序（每个分类内按 fan-in 降序，分类间按依赖数降序）
+    const categories = [...categoryMap.entries()]
+        .map(([name, deps]) => ({
+        name,
+        deps: deps.sort((a, b) => b.fanIn - a.fanIn),
+    }))
+        .sort((a, b) => b.deps.length - a.deps.length);
+    // 3. 提取热点（fan-in ≥ 阈值）
+    const hotspots = externalDeps
+        .filter((d) => d.fanIn >= HOTSPOT_THRESHOLD)
+        .map((d) => ({ name: d.name, fanIn: d.fanIn, dependedBy: d.dependedBy }))
+        .sort((a, b) => b.fanIn - a.fanIn);
+    return {
+        categories,
+        hotspots,
+        totalExternalDeps: externalDeps.length,
+    };
+}
+/**
+ * 分类单个外部依赖
+ */
+function classifyDependency(name) {
+    // 标准化名称：移除前缀、转小写
+    const normalized = name
+        .replace(/^(BDMV|BDP|FMT|BD|MTL|Bai|Ali|TX|TT)/, '')
+        .toLowerCase()
+        .replace(/[-_]/g, '');
+    // 1. 精确匹配已知库
+    if (KNOWN_LIBRARIES[normalized]) {
+        return KNOWN_LIBRARIES[normalized];
+    }
+    // 尝试原始名称小写
+    const rawLower = name.toLowerCase().replace(/[-_]/g, '');
+    if (KNOWN_LIBRARIES[rawLower]) {
+        return KNOWN_LIBRARIES[rawLower];
+    }
+    // 2. 关键词启发式
+    for (const [pattern, category] of KEYWORD_CATEGORIES) {
+        if (pattern.test(name)) {
+            return category;
+        }
+    }
+    // 3. 默认分类
+    return 'Other';
+}

package/dist/lib/service/search/BM25Scorer.d.ts

@@ -6,7 +6,7 @@
  *
  * @module BM25Scorer
  */
-import type { BM25Document, BM25SearchResult, Scorer } from './SearchTypes.js';
+import type { BM25Document, Scorer } from './SearchTypes.js';
 /** BM25 评分器 */
 export declare class BM25Scorer implements Scorer {
     _idIndex: Map<string, number>;
@@ -31,7 +31,7 @@ export declare class BM25Scorer implements Scorer {
     /** 压缩 documents 数组，清除 tombstone 空洞 */
     _compact(): void;
     /** 查询文档，返回按 BM25 分数排序的结果 */
-    search(query: string, limit?: number): BM25SearchResult[];
+    search(query: string, limit?: number): import("./SearchTypes.js").ScorerResult[];
     /** 清空索引 */
     clear(): void;
 }

package/dist/lib/service/search/SearchEngine.d.ts

@@ -1,7 +1,7 @@
 /**
  * SearchEngine - 统一搜索引擎
  *
- * 三级搜索策略: keyword → BM25 ranking → semantic(可选)
+ * 三级搜索策略: keyword → FieldWeighted ranking → semantic(可选)
  * 从 V1 SearchServiceV2 迁移，适配 V2 架构
  */
 import Logger from '../../infrastructure/logging/Logger.js';
@@ -10,7 +10,7 @@ import { MultiSignalRanker } from './MultiSignalRanker.js';
 import type { DbRow, RankingContext, Scorer, SearchAiProvider, SearchCrossEncoder, SearchDb, SearchEngineOptions, SearchHybridRetriever, SearchOptions, SearchResponse, SearchResultItem, SearchVectorService, SearchVectorStore } from './SearchTypes.js';
 export { BM25Scorer } from './BM25Scorer.js';
 export { FieldWeightedScorer } from './FieldWeightedScorer.js';
-export type { BM25DocMeta, BM25SearchResult, DbRow, RankingContext, RrfHit, Scorer, SearchAiProvider, SearchCrossEncoder, SearchDb, SearchEngineOptions, SearchHybridRetriever, SearchOptions, SearchResponse, SearchResultItem, SearchVectorService, SearchVectorStore, SlimSearchResult, VectorHit, } from './SearchTypes.js';
+export type { BM25DocMeta, DbRow, DocMeta, RankingContext, RrfHit, Scorer, ScorerResult, SearchAiProvider, SearchCrossEncoder, SearchDb, SearchEngineOptions, SearchHybridRetriever, SearchOptions, SearchResponse, SearchResultItem, SearchVectorService, SearchVectorStore, SlimSearchResult, VectorHit, } from './SearchTypes.js';
 export { groupByKind, slimSearchResult } from './SearchTypes.js';
 export { tokenize } from './tokenizer.js';
 /**
@@ -97,18 +97,18 @@ export declare class SearchEngine {
     /**
      * 关键词搜索 - 直接 SQL LIKE
      * 返回包含 kind 字段的完整结果，使用 ESCAPE 防止通配符注入
-     * 当 SQL LIKE 无结果时，降级到 BM25 搜索以提升自然语言查询的召回率
+     * 当 SQL LIKE 无结果时，降级到 FieldWeighted 搜索以提升自然语言查询的召回率
      */
     _keywordSearch(query: string, type: string, limit: number): SearchResultItem[];
     /**
-     * BM25 排序搜索
+     * 加权字段搜索（FieldWeightedScorer）
      * 增加 Title/Trigger 精确匹配 bonus — 当 query 出现在标题/触发词中时
-     * 给予额外 BM25 分数加成，确保精确匹配的条目排名靠前
+     * 给予额外分数加成，确保精确匹配的条目排名靠前
      */
-    _bm25Search(query: string, type: string, limit: number): SearchResultItem[];
+    _scorerSearch(query: string, type: string, limit: number): SearchResultItem[];
     /**
      * 语义搜索 - 需要 AI Provider 的 embed 功能
-     * 降级到 BM25 如果 AI 不可用
+     * 不可用时降级到 FieldWeighted 搜索
      * @returns >}
      */
     _semanticSearch(query: string, type: string, limit: number): Promise<{
@@ -117,7 +117,7 @@ export declare class SearchEngine {
     }>;
     /**
      * 补充详细字段（content / description / trigger / delivery 字段）— 批量 IN 查询
-     * 用于向量搜索结果与 BM25 结果的一致性
+     * 用于向量搜索结果与 FieldWeighted 结果的一致性
      */
     _supplementDetails(items: SearchResultItem[]): void;
     /**
@@ -138,9 +138,10 @@ export declare class SearchEngine {
     /**
      * 从 DB 行构建索引文本
      *
-     * 使用 BM25F 思想：高价值字段（title, trigger）重复出现以提升 TF 权重
+     * 高价值字段（title, trigger）通过重复出现提升 TF 权重
      * — title ×3, trigger ×2, description ×1.5（通过重复 token 实现）
-     * 这确保标题匹配的文档获得显著更高的 BM25 分数
+     * 这确保标题匹配的文档获得显著更高的分数
+     * 注：此逻辑主要服务于 BM25Scorer，FieldWeightedScorer 内部已有字段权重机制
      */
     _buildDocText(r: DbRow): string;
     /**