@llangtop/pwiki-core 0.3.4 → 0.4.5

package/dist/semantic-compiler.js

@@ -0,0 +1,376 @@
+// semantic-compiler.ts — 语义编译器 prompt (v5.2)
+//
+// v5.2: 文件级编译为主，块级编译兜底。
+//   LLM 只做 4 件事: topic, normalizedText, concepts, aliases + 自判语义边界
+//   程序做其余 7 件事 (→ preprocessor.ts)
+//
+// 蓝图参考: §24 Agent System Prompt, §25 User Prompt Template, §14 embedding_text
+// ============================================================
+// 常量
+// ============================================================
+/** 推荐每批处理的 chunk 数（平衡上下文大小和效率） */
+export const BATCH_SIZE = 25;
+// ============================================================
+// System Prompt (蓝图 §24)
+// ============================================================
+export const COMPILE_SYSTEM_PROMPT = `你是一个"知识语义编译器"。
+
+你的任务不是总结内容。
+
+你的任务是：
+将人类随手记录的非结构化笔记，
+转换为适合机器语义索引、概念检索、
+知识聚类、长期演化的"认知知识单元"。
+
+核心原则：
+1. 保留原始信息 — 不删技术细节
+2. 不改变原意 — 只规范化表达
+3. 补全隐式表达 — 补充省略的主语、展开缩写
+4. 统一术语 — 将同义表达归一（如 "状态污染" ↔ "stale closure"）
+5. 提取核心概念 — 识别技术关键词
+6. 保持单主题 — 一个 chunk 只描述一个认知主题
+7. 输出结构化 JSON — 严格遵循 schema
+
+禁止：
+1. 过度总结
+2. 删除原文
+3. 改写逻辑
+4. 主观推断
+5. 引入不存在的信息
+
+你的角色是："语义标准化器"，不是"内容作者"。`;
+// ============================================================
+// User Prompt 构建 (蓝图 §25)
+// ============================================================
+/** 为一批 chunk 构建编译 prompt */
+export function buildCompilePrompt(chunks) {
+    const chunkBlocks = chunks
+        .map((c, i) => {
+        const contextLines = [
+            `--- CHUNK #${i + 1} ---`,
+            `KEY: ${c.key}`,
+            `FILE: ${c.relPath}`,
+            `HEADING: ${c.heading || "(无标题)"}`,
+        ];
+        // E2: 注入文件级上下文
+        if (c.fileTags?.length) {
+            contextLines.push(`FILE_TAGS: [${c.fileTags.join(", ")}]`);
+        }
+        if (c.headingPath) {
+            contextLines.push(`HEADING_PATH: ${c.headingPath}`);
+        }
+        if (c.siblingHeadings?.length) {
+            contextLines.push(`SIBLING_HEADINGS: [${c.siblingHeadings.join(" | ")}]`);
+        }
+        if (c.totalChunks && c.totalChunks > 1) {
+            const pos = `${(c.chunkIndex ?? 0) + 1}/${c.totalChunks}`;
+            const role = (c.chunkIndex ?? 0) === 0
+                ? " (开头)"
+                : (c.chunkIndex ?? 0) === c.totalChunks - 1
+                    ? " (结尾)"
+                    : " (中间)";
+            contextLines.push(`CHUNK_POSITION: ${pos}${role}`);
+        }
+        contextLines.push("", c.rawText);
+        return contextLines.join("\n");
+    })
+        .join("\n\n");
+    return `请分析以下 ${chunks.length} 个笔记块。
+
+## 上下文说明
+
+每个块附带以下上下文信息，请善用以理解块在文件和笔记体系中的位置：
+- FILE_TAGS: 文件级别的标签，反映所属领域（如 AMI, DLMS）
+- HEADING_PATH: 块的标题层级路径（如 "10.18AMI更新 > 排查过程"）
+- SIBLING_HEADINGS: 同一文件内所有块的标题，帮助你理解块之间的前后关系
+- CHUNK_POSITION: 本块在文件中的位置和角色（开头/中间/结尾）
+
+## 输出字段
+
+对每个块，输出一个 JSON 对象，包含以下字段：
+
+{
+  "key": "块标识（与输入的 KEY 一致）",
+  "topic": "核心主题（一句话）",
+  "summary": "一句话摘要（≤30 字）",
+  "concepts": ["提取的技术概念"],
+  "entities": ["实体名称"],
+  "aliases": ["同义表达，格式 '中文 ↔ English'"],
+  "keywords": ["检索关键词"],
+  "normalizedText": "规范化后的文本（补全省略、统一术语、保留所有技术细节）",
+  "chunkType": "concept | note | code | reference | todo | idea | question | architecture | decision | log | research",
+  "importance": 0.0-1.0,
+  "confidence": 0.0-1.0,
+  "contentClass": "knowledge | event | conversation | reference",
+  "temporalAnchor": "如果内容是事件类，提取时间锚点（如 '2024-10-18'），否则省略",
+  "followsChunk": "如果有 SIBLING_HEADINGS 且本块不是第一个，填写前一个块的 KEY",
+  "precedesChunk": "如果有 SIBLING_HEADINGS 且本块不是最后一个，填写后一个块的 KEY",
+  "siblingHeadings": ["同文件所有块的标题列表（复制 SIBLING_HEADINGS）"]
+}
+
+## 关系字段判断指南
+
+contentClass 判断：
+- knowledge: 无时间性的技术知识、编码规范、原理说明
+- event: 有时间锚点的故障记录、更新日志、会议记录
+- conversation: 对话推理链中的片段（隐式引用前文）
+- reference: 纯参考列表、配置清单、目录结构
+
+followsChunk/precedesChunk：
+- 仅在 SIBLING_HEADINGS 明确显示了前后顺序时填写
+- 使用 CHUNK #N 中的 KEY 值
+- 如果块之间无明显因果/时序关系，留空
+
+temporalAnchor：
+- 仅在 contentClass=event 时尝试提取
+- 从 FILE_TAGS、HEADING_PATH 或文本本身提取日期
+- 格式: YYYY-MM-DD，无法确定则留空
+
+## 注意事项
+
+- normalizedText 必须保留 ALL 技术细节
+- importance: 高价值技术知识 0.8+，TODO/碎片 0.3-，普通笔记 0.5
+- confidence: 信息完整明确 0.9+，曖昧 0.5-
+- 所有关系字段为可选 —— 如果无法判断，留空而非猜测
+
+返回格式：一个 JSON 数组，包含 ${chunks.length} 个对象。
+不要 markdown 代码块包裹，直接输出 JSON 数组。
+
+${chunkBlocks}`;
+}
+// ============================================================
+// embeddingText 构建 (蓝图 §14)
+// ============================================================
+/**
+ * 从编译后的 ChunkInfo 构建最优 embedding 输入
+ *
+ * 蓝图推荐格式:
+ *   [TOPIC] + [CONCEPTS] + [ALIASES] + [KEYWORDS] + [NORMALIZED] + [RAW]
+ *
+ * 原因: 增强隐式语义，让向量模型在检索时更稳定地匹配
+ */
+export function buildEmbeddingText(topic, normalizedText, concepts, aliases, keywords, contentClass, temporalAnchor, rawText) {
+    const parts = [];
+    if (contentClass)
+        parts.push(`[CLASS] ${contentClass}`);
+    if (temporalAnchor)
+        parts.push(`[TIME] ${temporalAnchor}`);
+    if (topic)
+        parts.push(`[TOPIC] ${topic}`);
+    if (concepts?.length)
+        parts.push(`[CONCEPTS] ${concepts.join("; ")}`);
+    if (aliases?.length)
+        parts.push(`[ALIASES] ${aliases.join("; ")}`);
+    if (keywords?.length)
+        parts.push(`[KEYWORDS] ${keywords.join("; ")}`);
+    if (normalizedText)
+        parts.push(`[NORMALIZED] ${normalizedText}`);
+    if (rawText)
+        parts.push(`[RAW] ${rawText.slice(0, 400)}`);
+    return parts.join("\n");
+}
+// ============================================================
+// 工具：解析 AI 返回的 JSON 数组
+// ============================================================
+/** 尝试从 LLM 响应中提取 CompiledChunk 数组 */
+export function parseCompiledResult(text) {
+    try {
+        // 去除可能的 markdown 代码块包裹
+        let json = text.trim();
+        if (json.startsWith("```")) {
+            json = json.replace(/^```json?\s*\n?/, "").replace(/\n?```\s*$/, "");
+        }
+        const arr = JSON.parse(json);
+        if (!Array.isArray(arr))
+            return null;
+        // 基本校验
+        for (const item of arr) {
+            if (!item.key || !item.normalizedText)
+                return null;
+        }
+        return arr;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================
+// v5.2 文件级编译
+// ============================================================
+/** 文件级编译 System Prompt（只要求 LLM 做 4 件事） */
+export const FILE_COMPILE_SYSTEM_PROMPT = `你是一个"知识语义编译器"。
+
+你的任务: 将整篇笔记转换为结构化的语义知识单元。
+
+你需要做的 4 件事:
+1. 自行判断语义边界 — 将文件分成若干连续的语义片段（segments）
+2. 为每个片段写出 topic（核心主题，一句话）
+3. 为每个片段写出 normalizedText（规范化文本：补全省略、统一术语、保留所有技术细节）
+4. 为每个片段提取 concepts（技术概念）和 aliases（同义表达，格式 "中文 ↔ English"）
+
+核心原则:
+- 保留原始信息 — 不删技术细节（API 名、参数、错误信息、缩写）
+- 不改变原意 — 只规范化表达
+- 语义边界 = 同一认知主题的自然段或连续段落
+- 如果整个文件是单一主题，只输出 1 个 segment
+
+禁止: 过度总结、删除原文、改写逻辑、主观推断、引入不存在的信息。`;
+/**
+ * 为文件级编译构建 prompt
+ * @param relPath      文件路径
+ * @param fullText     文件全文
+ * @param preprocessed 预处理器输出（仅展示给 LLM 参考）
+ */
+export function buildFileCompilePrompt(relPath, fullText, preprocessed) {
+    const preSummary = preprocessed
+        .slice(0, 5)
+        .map((p) => `  - ${p.heading || "(无标题)"} [${p.chunkType}, ${p.contentClass}, imp=${p.importance.toFixed(1)}]`)
+        .join("\n");
+    return `请分析以下笔记文件。
+
+文件: ${relPath}
+程序预分析（仅供参考，你不需填写这些字段）:
+${preSummary}
+
+你需要输出一个 JSON 对象:
+
+{
+  "segments": [
+    {
+      "text": "片段原文（从文件中截取）",
+      "topic": "核心主题（一句话）",
+      "normalizedText": "规范化文本",
+      "concepts": ["技术概念"],
+      "aliases": ["同义表达 (格式: 中文 ↔ English)"]
+    }
+  ]
+}
+
+注意事项:
+- segments 按文件顺序排列
+- 语义边界你自己判断: 同一认知主题归为一个 segment
+- 一个 segment 可以包含多个自然段
+- 至少输出 1 个 segment
+- normalizedText 必须保留 ALL 技术细节
+- 不要 markdown 代码块包裹，直接输出 JSON
+
+=== 文件全文 ===
+
+${fullText}`;
+}
+/** 从 LLM 响应中提取 FileSegment 数组 */
+export function parseFileSegments(text) {
+    try {
+        let json = text.trim();
+        if (json.startsWith("```")) {
+            json = json.replace(/^```json?\s*\n?/, "").replace(/\n?```\s*$/, "");
+        }
+        const obj = JSON.parse(json);
+        const arr = obj.segments ?? obj;
+        if (!Array.isArray(arr))
+            return null;
+        for (const item of arr) {
+            if (!item.topic || !item.normalizedText)
+                return null;
+        }
+        return arr;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================
+// v5.4 文件级编译（简化版：不要求 segments，只要求 1 个文件的 4 字段）
+// ============================================================
+/** v5.4 文件级 System Prompt（极简版） */
+export const FILE_LLM_SYSTEM_PROMPT = `你是一个"知识语义编译器"。
+
+你的任务: 将整篇笔记转换为结构化的语义元数据，用于增强语义搜索。
+
+你需要输出的 4 个字段:
+1. topic — 核心主题（一句话概括全文）
+2. normalizedText — 规范化文本（补全省略主语、统一术语、保留所有技术细节）
+3. concepts — 技术概念列表（3-8 个核心概念）
+4. aliases — 同义表达（格式 "中文 ↔ English"，2-5 组）
+
+核心原则:
+- 保留所有技术细节（API 名、参数、错误信息、缩写、版本号）
+- 不改变原意，只规范化表达
+- concepts 提取技术关键词，不是摘要
+- aliases 覆盖中英对照和缩写展开
+
+禁止: 过度总结、删除原文、改写逻辑、主观推断、引入不存在的信息。`;
+/**
+ * v5.4 构建简化文件级编译 prompt
+ */
+export function buildFileLLMPrompt(relPath, fullText) {
+    return `请分析以下笔记文件，提取语义元数据。
+
+文件: ${relPath}
+
+输出一个 JSON 对象:
+
+{
+  "topic": "核心主题（一句话）",
+  "normalizedText": "规范化文本",
+  "concepts": ["技术概念1", "技术概念2"],
+  "aliases": ["中文 ↔ English"]
+}
+
+不要 markdown 代码块包裹，直接输出 JSON。
+
+=== 文件全文 ===
+
+${fullText}`;
+}
+/**
+ * v5.4 解析文件级 LLM 响应（单对象，非 segments 数组）
+ */
+export function parseFileLLMResult(text) {
+    try {
+        let json = text.trim();
+        if (json.startsWith("```")) {
+            json = json.replace(/^```json?\s*\n?/, "").replace(/\n?```\s*$/, "");
+        }
+        const obj = JSON.parse(json);
+        // 兼容 v5.2 segments 格式 → 取第一个 segment
+        if (obj.segments && Array.isArray(obj.segments) && obj.segments.length > 0) {
+            const s = obj.segments[0];
+            return { topic: s.topic, normalizedText: s.normalizedText, concepts: s.concepts || [], aliases: s.aliases || [] };
+        }
+        // v5.4 新格式
+        if (obj.topic && obj.normalizedText) {
+            return {
+                topic: obj.topic,
+                normalizedText: obj.normalizedText,
+                concepts: obj.concepts || [],
+                aliases: obj.aliases || [],
+            };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * v5.4 构建文件级 LLM 向量的 embedding 文本
+ */
+export function buildFileLLMEmbeddingText(data, relPath, maxEmbedLen = 2000) {
+    const parts = [];
+    // 路径语义注入
+    if (relPath) {
+        const pathContext = relPath.replace(/\\/g, "/").replace(/\//g, " > ").replace(/\.md$/i, "");
+        parts.push(`[PATH] ${pathContext}`);
+    }
+    if (data.topic)
+        parts.push(`[TOPIC] ${data.topic}`);
+    if (data.concepts?.length)
+        parts.push(`[CONCEPTS] ${data.concepts.join("; ")}`);
+    if (data.aliases?.length)
+        parts.push(`[ALIASES] ${data.aliases.join("; ")}`);
+    if (data.normalizedText)
+        parts.push(`[NORMALIZED] ${data.normalizedText.slice(0, maxEmbedLen)}`);
+    return parts.join("\n");
+}
+//# sourceMappingURL=semantic-compiler.js.map

package/dist/semantic-compiler.js.map

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

package/dist/semantic-search.d.ts

@@ -0,0 +1,11 @@
+import type { SearchHit } from "./types.js";
+/** 纯语义搜索 */
+export declare function semanticSearch(query: string): Promise<SearchHit[]>;
+/** 混合搜索：关键词 + 语义并行 → RRF 融合排序
+ *
+ * RRF (Reciprocal Rank Fusion):
+ *   RRF(d) = Σ 1/(k + rank_i(d))
+ *   各列表取 Top-N 参与融合，未出现在某列表中的项 rank = RRF_K*2
+ */
+export declare function hybridSearch(query: string): Promise<SearchHit[]>;
+//# sourceMappingURL=semantic-search.d.ts.map

package/dist/semantic-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../src/semantic-search.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA0C5C,YAAY;AACZ,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA6FxE;AA+CD;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAkEtE"}

package/dist/semantic-search.js

@@ -0,0 +1,217 @@
+// semantic-search.ts — 语义搜索 & 混合搜索 (v5.1)
+//
+// semanticSearch:   query → embed → 余弦相似度 → 同文件多块聚合加分
+// hybridSearch:     关键词 + 语义并行 → RRF 融合排序 (k=60, Top-50)
+//
+// 策略:
+//   高阈值 0.50 — 只有置信度 ≥50% 的语义匹配才视为有效
+//   兜底 — 高阈值结果不足 3 条时，追加 ≤3 条低分结果（标记"弱匹配"）
+//   同文件合并 — 一个文件多个块命中时，取最高块相似度 + (块数-1)*0.05 加分（上限 0.25）
+//   RRF 融合 — 替代简单线性加权，对异构分数尺度不敏感
+import { getEmbeddings, getSemanticEnabled, getChunkInfo } from "./store.js";
+import { getIndex } from "./store.js";
+import { embed, initialize, isAvailable, cosineSimilarity } from "./embedder.js";
+import { keywordSearch } from "./search.js";
+/** 高置信度阈值 — ≥50% 视为强匹配 */
+const HIGH_SIMILARITY_THRESHOLD = 0.50;
+/** 最低阈值 — 低于此值不展示（即使兜底） */
+const MIN_SIMILARITY_THRESHOLD = 0.20;
+/** 兜底条数 — 强匹配不足时最多追加几条弱匹配 */
+const FALLBACK_COUNT = 3;
+/** 多块加分：每额外一个命中块 +0.05，上限 0.25 */
+const MULTI_CHUNK_BONUS = 0.05;
+const MAX_MULTI_CHUNK_BONUS = 0.25;
+/** RRF 融合常数 (标准值 60) */
+const RRF_K = 60;
+/** 各列表参与 RRF 融合的 Top-N 上限 */
+const RRF_TOPN = 50;
+/** 纯语义搜索 */
+export async function semanticSearch(query) {
+    if (!getSemanticEnabled())
+        return [];
+    if (!isAvailable()) {
+        const ok = await initialize();
+        if (!ok)
+            return [];
+    }
+    const embeddings = getEmbeddings();
+    if (Object.keys(embeddings).length === 0)
+        return [];
+    const idx = getIndex();
+    const chunkInfo = getChunkInfo();
+    let queryVec;
+    try {
+        queryVec = await embed(query);
+    }
+    catch {
+        return [];
+    }
+    // 1. 计算所有块的相似度
+    const allChunks = [];
+    for (const [key, vec] of Object.entries(embeddings)) {
+        const chunkMatch = key.match(/^(.*)###(\d+|llm)$/);
+        const relPath = chunkMatch ? chunkMatch[1] : key;
+        const rawIdx = chunkMatch ? parseInt(chunkMatch[2], 10) : NaN;
+        const chunkIdx = isNaN(rawIdx) ? undefined : rawIdx;
+        if (!idx[relPath])
+            continue;
+        const similarity = cosineSimilarity(queryVec, vec);
+        if (similarity < MIN_SIMILARITY_THRESHOLD)
+            continue;
+        const ci = chunkIdx !== undefined ? chunkInfo[key] : undefined;
+        allChunks.push({
+            key,
+            relPath,
+            similarity,
+            chunkIndex: chunkIdx,
+            chunkHeading: ci ? ci.heading.replace(/^#+\s*/, "") : undefined,
+        });
+    }
+    // 2. 同文件聚合：取最高块 + 多块加分
+    const fileMap = new Map();
+    for (const ch of allChunks) {
+        const existing = fileMap.get(ch.relPath);
+        if (!existing) {
+            fileMap.set(ch.relPath, {
+                relPath: ch.relPath,
+                semanticScore: ch.similarity,
+                bestChunk: ch,
+                chunkCount: 1,
+                chunkHeadings: ch.chunkHeading ? [ch.chunkHeading] : [],
+            });
+        }
+        else {
+            // 追踪最高分块
+            if (ch.similarity > existing.bestChunk.similarity) {
+                existing.bestChunk = ch;
+            }
+            existing.chunkCount++;
+            if (ch.chunkHeading && !existing.chunkHeadings.includes(ch.chunkHeading)) {
+                existing.chunkHeadings.push(ch.chunkHeading);
+            }
+        }
+    }
+    // 计算最终分数：最高块相似度 + 多块加分
+    for (const fm of fileMap.values()) {
+        const bonus = Math.min((fm.chunkCount - 1) * MULTI_CHUNK_BONUS, MAX_MULTI_CHUNK_BONUS);
+        fm.semanticScore = fm.bestChunk.similarity + bonus;
+    }
+    const files = [...fileMap.values()].sort((a, b) => b.semanticScore - a.semanticScore);
+    // 3. 强匹配（聚合后 ≥50%）/ 弱匹配兜底
+    const strong = files.filter(f => f.semanticScore >= HIGH_SIMILARITY_THRESHOLD);
+    const ci = getChunkInfo();
+    const strongHits = strong.map(f => makeFileHit(f, idx, ci));
+    if (strongHits.length < FALLBACK_COUNT) {
+        const weak = files
+            .filter(f => f.semanticScore < HIGH_SIMILARITY_THRESHOLD)
+            .slice(0, FALLBACK_COUNT);
+        const weakHits = weak.map(f => {
+            const hit = makeFileHit(f, idx, ci);
+            hit.snippet = `⚠️ 弱匹配 (${Math.round(f.semanticScore * 100)}%)`;
+            return hit;
+        });
+        return [...strongHits, ...weakHits];
+    }
+    return strongHits;
+}
+function makeFileHit(f, idx, chunkInfo) {
+    const entry = idx[f.relPath];
+    // 优先展示 LLM 编译结果（summary / topic），其次 AST 块标题
+    let snippet = "";
+    const llmKey = `${f.relPath}###llm`;
+    const llm = chunkInfo?.[llmKey];
+    if (llm?.summary) {
+        snippet = `💡 ${llm.summary}`;
+        if (llm.topic)
+            snippet += ` [${llm.topic}]`;
+    }
+    else if (llm?.topic) {
+        snippet = `💡 ${llm.topic}`;
+    }
+    else if (f.bestChunk.chunkHeading) {
+        snippet = `▸ ${f.bestChunk.chunkHeading}`;
+    }
+    // 多块命中展示（最多 5 个附加标题）
+    if (f.chunkCount > 1) {
+        const others = f.chunkHeadings
+            .filter(h => h !== f.bestChunk.chunkHeading)
+            .slice(0, 5);
+        if (others.length > 0) {
+            snippet += ` | +${f.chunkCount - 1}块: ${others.join(", ")}`;
+        }
+        else {
+            snippet += ` | +${f.chunkCount - 1}块命中`;
+        }
+    }
+    return {
+        relPath: entry.relPath,
+        sourceDir: entry.sourceDir,
+        title: entry.title,
+        tags: entry.tags,
+        snippet,
+        score: Math.round(f.semanticScore * 100),
+        semanticScore: f.semanticScore,
+        chunkIndex: f.bestChunk.chunkIndex,
+        chunkHeading: f.bestChunk.chunkHeading,
+    };
+}
+/** 混合搜索：关键词 + 语义并行 → RRF 融合排序
+ *
+ * RRF (Reciprocal Rank Fusion):
+ *   RRF(d) = Σ 1/(k + rank_i(d))
+ *   各列表取 Top-N 参与融合，未出现在某列表中的项 rank = RRF_K*2
+ */
+export async function hybridSearch(query) {
+    const keywordHits = keywordSearch(query);
+    const semanticHits = await semanticSearch(query);
+    // 按分数排序并取 Top-N
+    const kwSorted = [...keywordHits]
+        .sort((a, b) => b.score - a.score)
+        .slice(0, RRF_TOPN);
+    const semSorted = [...semanticHits]
+        .sort((a, b) => b.score - a.score)
+        .slice(0, RRF_TOPN);
+    // 构建 rank 映射 (1-based)
+    const kwRank = new Map();
+    kwSorted.forEach((h, i) => kwRank.set(h.relPath, i + 1));
+    const semRank = new Map();
+    semSorted.forEach((h, i) => semRank.set(h.relPath, i + 1));
+    // 收集所有唯一文件
+    const allPaths = new Set([
+        ...kwSorted.map(h => h.relPath),
+        ...semSorted.map(h => h.relPath),
+    ]);
+    // 构建查找表
+    const kwMap = new Map(kwSorted.map(h => [h.relPath, h]));
+    const semMap = new Map(semSorted.map(h => [h.relPath, h]));
+    // RRF 缺省排名（未出现在某列表中的项用此值）
+    const missingRank = RRF_K * 2;
+    const merged = [];
+    for (const relPath of allPaths) {
+        const kw = kwMap.get(relPath);
+        const sem = semMap.get(relPath);
+        const kwR = kwRank.get(relPath) ?? missingRank;
+        const semR = semRank.get(relPath) ?? missingRank;
+        const rrf = 1 / (RRF_K + kwR) + 1 / (RRF_K + semR);
+        // 取最佳信息源构建结果
+        const base = sem || kw;
+        // 优先语义结果 snippet（含 LLM 编译内容），其次关键词 snippet
+        let snippet = sem?.snippet || "";
+        if (!snippet && kw?.snippet) {
+            snippet = kw.snippet.replace(/\n/g, " | ");
+        }
+        merged.push({
+            relPath: base.relPath,
+            sourceDir: base.sourceDir,
+            title: base.title,
+            tags: base.tags,
+            snippet,
+            score: Math.round(rrf * 10000),
+            semanticScore: sem?.semanticScore,
+            chunkIndex: sem?.chunkIndex,
+            chunkHeading: sem?.chunkHeading,
+        });
+    }
+    return merged.sort((a, b) => b.score - a.score);
+}
+//# sourceMappingURL=semantic-search.js.map

package/dist/semantic-search.js.map

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

package/dist/store-settings.d.ts

@@ -0,0 +1,32 @@
+import type { FileEntry } from "./types.js";
+export declare function setWikiHome(path: string): void;
+interface WikiSettings {
+    sources: string[];
+    index: Record<string, FileEntry>;
+    lastScan: string;
+    semanticEnabled?: boolean;
+    currentModelId?: string;
+}
+export declare function readAll(): WikiSettings;
+export declare function writeAll(s: WikiSettings): void;
+export declare function getSources(): string[];
+export declare function addSource(absPath: string): boolean;
+/** 移除数据源并清理关联索引和语义向量 */
+export declare function removeSource(target: string): string | null;
+export declare function getIndex(): Record<string, FileEntry>;
+export declare function mergeIndex(entries: FileEntry[]): void;
+export declare function removeEntry(relPath: string): boolean;
+export declare function updateEntryPath(oldRelPath: string, newRelPath: string, entry: FileEntry): boolean;
+export declare function getEntry(relPath: string): FileEntry | null;
+export declare function getWikiModel(): string;
+export declare function readModelId(): string | undefined;
+export declare function writeModelId(id: string): void;
+export declare function getSemanticEnabled(): boolean;
+export declare function setSemanticEnabled(enabled: boolean): void;
+export declare function sourcesStats(): {
+    sources: number;
+    files: number;
+    lastScan: string;
+};
+export {};
+//# sourceMappingURL=store-settings.d.ts.map