@llangtop/pwiki-core 1.0.8 → 1.2.0

package/dist/lib/search.js

@@ -1,30 +1,119 @@
-// search.ts — 关键词搜索
-// 适配自 extensions/wiki/lib/search.ts — 导入改为 store-index + content-cache
-import { getIndex } from "./store-index.js";
+// search.ts — 关键词搜索 (BM25)
+//
+// BM25 模式下:
+//   正文 = BM25 评分 × 10 缩放
+//   title/path/tags = token 命中额外加分（不参与 BM25 公式）
+//   降级: bm25_stats.json 不存在时，fallback 到旧算法
+import { getIndex, readBm25Stats } from "./store-index.js";
 import { getContent } from "./content-cache.js";
+import { tokenize } from "./tokenizer.js";
+import { bm25Score, getDocTokens } from "./bm25.js";
 import { resolve } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
-function lineContext(content, query, maxLen = 100) {
+/** BM25 得分缩放因子（使分值落在和旧算法相近的范围） */
+const BM25_SCALE = 10;
+/** 字段 boost 权重 */
+const TITLE_WEIGHT = 10;
+const PATH_WEIGHT = 5;
+const TAG_WEIGHT = 3;
+/** 上下文摘取最大行长度 */
+const MAX_LINE_LEN = 100;
+/**
+ * 从文档内容中摘取包含查询 token 的上下文行
+ */
+function bm25Snippet(content, queryTokens, maxLen = MAX_LINE_LEN) {
     const lower = content.toLowerCase();
-    const q = query.toLowerCase();
-    const pos = lower.indexOf(q);
-    if (pos < 0)
-        return "";
-    const before = content.slice(0, pos);
-    const lineNum = before.split("\n").length;
     const lines = content.split("\n");
-    const prev = lineNum > 1 ? lines[lineNum - 2].trim() : "";
-    const curr = lines[lineNum - 1].trim();
-    const next = lineNum < lines.length ? lines[lineNum].trim() : "";
     const parts = [];
-    if (prev)
-        parts.push(`L${lineNum - 1}: ${prev.slice(0, maxLen)}`);
-    parts.push(`L${lineNum}: ${curr.slice(0, maxLen)}`);
-    if (next)
-        parts.push(`L${lineNum + 1}: ${next.slice(0, maxLen)}`);
+    // 找到第一个命中任意 query token 的行
+    for (let li = 0; li < lines.length; li++) {
+        const lineLower = lines[li].toLowerCase();
+        const matched = queryTokens.some(tok => lineLower.includes(tok));
+        if (!matched)
+            continue;
+        const prev = li > 0 ? `L${li}: ${lines[li - 1].trim().slice(0, maxLen)}` : null;
+        const curr = `L${li + 1}: ${lines[li].trim().slice(0, maxLen)}`;
+        const next = li < lines.length - 1 ? `L${li + 2}: ${lines[li + 1].trim().slice(0, maxLen)}` : null;
+        if (prev && !parts.includes(prev))
+            parts.push(prev);
+        if (!parts.includes(curr))
+            parts.push(curr);
+        if (next && !parts.includes(next))
+            parts.push(next);
+        if (parts.length >= 5)
+            break; // 最多 5 行上下文
+        li++; // 跳过 next 行，避免重复命中
+    }
     return parts.join("\n");
 }
+/** 获取文档内容（缓存优先，磁盘 fallback） */
+function getDocContent(entry) {
+    let content = getContent(entry.relPath);
+    if (content)
+        return content;
+    const fullPath = resolve(entry.sourceDir, entry.relPath);
+    if (!existsSync(fullPath))
+        return null;
+    try {
+        return readFileSync(fullPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * BM25 关键词搜索
+ */
 export function keywordSearch(query) {
+    const stats = readBm25Stats();
+    return stats ? keywordSearchBm25(query, stats) : keywordSearchLegacy(query);
+}
+/**
+ * BM25 模式搜索
+ */
+function keywordSearchBm25(query, stats) {
+    const idx = getIndex();
+    const queryTokens = tokenize(query);
+    const hits = [];
+    for (const [relPath, entry] of Object.entries(idx)) {
+        let score = 0;
+        // 字段 boost：改用 token 匹配
+        const titleLower = entry.title.toLowerCase();
+        const tagsLower = entry.tags.map(t => t.toLowerCase());
+        for (const tok of queryTokens) {
+            if (titleLower.includes(tok))
+                score += TITLE_WEIGHT;
+            if (relPath.toLowerCase().includes(tok))
+                score += PATH_WEIGHT / queryTokens.length; // 拆分权重
+            if (tagsLower.some(t => t.includes(tok)))
+                score += TAG_WEIGHT;
+        }
+        // 正文 BM25 评分
+        const docTokens = getDocTokens(entry); // 含路径前缀，与 stats 构建对齐
+        if (docTokens) {
+            const bm = bm25Score(queryTokens, docTokens, stats);
+            score += bm * BM25_SCALE;
+        }
+        if (score <= 0)
+            continue;
+        // 摘取上下文
+        let snippet = "";
+        const rawContent = getDocContent(entry);
+        if (rawContent) {
+            snippet = bm25Snippet(rawContent, queryTokens);
+        }
+        hits.push({
+            relPath: entry.relPath, sourceDir: entry.sourceDir,
+            title: entry.title, tags: entry.tags,
+            snippet, score: Math.round(score),
+        });
+    }
+    return hits.sort((a, b) => b.score - a.score);
+}
+/**
+ * 旧版降级搜索（bm25_stats.json 不存在时使用）
+ */
+function keywordSearchLegacy(query) {
     const idx = getIndex();
     const q = query.toLowerCase();
     const hits = [];
@@ -38,7 +127,6 @@ export function keywordSearch(query) {
         if (entry.tags.some(t => t.toLowerCase().includes(q)))
             score += 3;
         let content = getContent(relPath);
-        // Fallback: read from disk if not in cache (CLI/MCP separate process)
         if (!content) {
             const fullPath = resolve(entry.sourceDir, relPath);
             if (existsSync(fullPath)) {
@@ -55,7 +143,7 @@ export function keywordSearch(query) {
                 count++;
                 if (count === 1)
                     score += 1;
-                const ctx = lineContext(content, query);
+                const ctx = legacyContext(content, query);
                 if (ctx && !parts.some(pp => pp.includes(ctx.slice(0, 30)))) {
                     parts.push(ctx);
                 }
@@ -73,5 +161,25 @@ export function keywordSearch(query) {
     }
     return hits.sort((a, b) => b.score - a.score);
 }
+function legacyContext(content, query, maxLen = 100) {
+    const lower = content.toLowerCase();
+    const q = query.toLowerCase();
+    const pos = lower.indexOf(q);
+    if (pos < 0)
+        return "";
+    const before = content.slice(0, pos);
+    const lineNum = before.split("\n").length;
+    const lines = content.split("\n");
+    const prev = lineNum > 1 ? lines[lineNum - 2].trim() : "";
+    const curr = lines[lineNum - 1].trim();
+    const next = lineNum < lines.length ? lines[lineNum].trim() : "";
+    const parts = [];
+    if (prev)
+        parts.push(`L${lineNum - 1}: ${prev.slice(0, maxLen)}`);
+    parts.push(`L${lineNum}: ${curr.slice(0, maxLen)}`);
+    if (next)
+        parts.push(`L${lineNum + 1}: ${next.slice(0, maxLen)}`);
+    return parts.join("\n");
+}
 export const search = keywordSearch;
 //# sourceMappingURL=search.js.map

package/dist/lib/search.js.map

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

package/dist/lib/semantic-compiler.js

@@ -13,31 +13,31 @@ 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. 引入不存在的信息
-
+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)
@@ -75,67 +75,67 @@ export function buildCompilePrompt(chunks) {
         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 数组。
-
+    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}`;
 }
 // ============================================================
@@ -198,22 +198,22 @@ export function parseCompiledResult(text) {
 // 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
-
+export const FILE_COMPILE_SYSTEM_PROMPT = `你是一个"知识语义编译器"。
+
+你的任务: 将整篇笔记转换为结构化的语义知识单元。
+
+你需要做的 4 件事:
+1. 自行判断语义边界 — 将文件分成若干连续的语义片段（segments）
+2. 为每个片段写出 topic（核心主题，一句话）
+3. 为每个片段写出 normalizedText（规范化文本：补全省略、统一术语、保留所有技术细节）
+4. 为每个片段提取 concepts（技术概念）和 aliases（同义表达，格式 "中文 ↔ English"）
+
+核心原则:
+- 保留原始信息 — 不删技术细节（API 名、参数、错误信息、缩写）
+- 不改变原意 — 只规范化表达
+- 语义边界 = 同一认知主题的自然段或连续段落
+- 如果整个文件是单一主题，只输出 1 个 segment
+
 禁止: 过度总结、删除原文、改写逻辑、主观推断、引入不存在的信息。`;
 /**
  * 为文件级编译构建 prompt
@@ -226,36 +226,36 @@ export function buildFileCompilePrompt(relPath, fullText, 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
-
-=== 文件全文 ===
-
+    return `请分析以下笔记文件。
+
+文件: ${relPath}
+程序预分析（仅供参考，你不需填写这些字段）:
+${preSummary}
+
+你需要输出一个 JSON 对象:
+
+{
+  "segments": [
+    {
+      "text": "片段原文（从文件中截取）",
+      "topic": "核心主题（一句话）",
+      "normalizedText": "规范化文本",
+      "concepts": ["技术概念"],
+      "aliases": ["同义表达 (格式: 中文 ↔ English)"]
+    }
+  ]
+}
+
+注意事项:
+- segments 按文件顺序排列
+- 语义边界你自己判断: 同一认知主题归为一个 segment
+- 一个 segment 可以包含多个自然段
+- 至少输出 1 个 segment
+- normalizedText 必须保留 ALL 技术细节
+- 不要 markdown 代码块包裹，直接输出 JSON
+
+=== 文件全文 ===
+
 ${fullText}`;
 }
 /** 从 LLM 响应中提取 FileSegment 数组 */
@@ -283,44 +283,44 @@ export function parseFileSegments(text) {
 // 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 覆盖中英对照和缩写展开
-
+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。
-
-=== 文件全文 ===
-
+    return `请分析以下笔记文件，提取语义元数据。
+
+文件: ${relPath}
+
+输出一个 JSON 对象:
+
+{
+  "topic": "核心主题（一句话）",
+  "normalizedText": "规范化文本",
+  "concepts": ["技术概念1", "技术概念2"],
+  "aliases": ["中文 ↔ English"]
+}
+
+不要 markdown 代码块包裹，直接输出 JSON。
+
+=== 文件全文 ===
+
 ${fullText}`;
 }
 /**

package/dist/lib/store-index.d.ts

@@ -1,4 +1,5 @@
 import type { FileEntry } from "./types.js";
+import type { Bm25Stats } from "./bm25.js";
 export declare function readIndex(): Record<string, FileEntry>;
 export declare function writeIndex(idx: Record<string, FileEntry>): void;
 export declare function getIndex(): Record<string, FileEntry>;
@@ -11,4 +12,6 @@ export declare function removeEntriesBySource(sourceDir: string): number;
 export declare function indexStats(): {
     files: number;
 };
+export declare function readBm25Stats(): Bm25Stats | null;
+export declare function writeBm25Stats(stats: Bm25Stats): void;
 //# sourceMappingURL=store-index.d.ts.map

package/dist/lib/store-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-index.d.ts","sourceRoot":"","sources":["../../src/lib/store-index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,wBAAgB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAMrD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAE/D;AAID,wBAAgB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAEpD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE1D;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAOrD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,GACf,OAAO,CAOT;AAED,2BAA2B;AAC3B,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAW/D;AAID,wBAAgB,UAAU,IAAI;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAE9C"}
+{"version":3,"file":"store-index.d.ts","sourceRoot":"","sources":["../../src/lib/store-index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK3C,wBAAgB,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAMrD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAE/D;AAID,wBAAgB,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAEpD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE1D;AAID,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAOrD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,GACf,OAAO,CAOT;AAED,2BAA2B;AAC3B,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAW/D;AAID,wBAAgB,UAAU,IAAI;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAE9C;AAID,wBAAgB,aAAa,IAAI,SAAS,GAAG,IAAI,CAMhD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAErD"}

package/dist/lib/store-index.js

@@ -3,7 +3,7 @@
 // 管理: 文件索引 Record<relPath, FileEntry>
 // 拆自�?store-settings.ts，索引不再嵌�?config.json
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { indexFile } from "../config.js";
+import { indexFile, bm25StatsFile } from "../config.js";
 import { setLastScan } from "./store-config.js";
 // ---- 核心读写 ----
 export function readIndex() {
@@ -69,4 +69,17 @@ export function removeEntriesBySource(sourceDir) {
 export function indexStats() {
     return { files: Object.keys(readIndex()).length };
 }
+// ---- BM25 统计持久化 ----
+export function readBm25Stats() {
+    try {
+        const p = bm25StatsFile();
+        if (existsSync(p))
+            return JSON.parse(readFileSync(p, "utf-8"));
+    }
+    catch { /* ignore */ }
+    return null;
+}
+export function writeBm25Stats(stats) {
+    writeFileSync(bm25StatsFile(), JSON.stringify(stats, null, 2), "utf-8");
+}
 //# sourceMappingURL=store-index.js.map

package/dist/lib/store-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"store-index.js","sourceRoot":"","sources":["../../src/lib/store-index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,sCAAsC;AACtC,2CAA2C;AAE3C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,iBAAiB;AAEjB,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;QACtB,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAA8B;IACvD,aAAa,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACpE,CAAC;AAED,eAAe;AAEf,MAAM,UAAU,QAAQ;IACtB,OAAO,SAAS,EAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,SAAS,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC;AAED,eAAe;AAEf,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,UAAkB,EAClB,KAAgB;IAEhB,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;IACvB,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC;IACxB,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,IAAI,KAAK;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,eAAe;AAEf,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACpD,CAAC"}
+{"version":3,"file":"store-index.js","sourceRoot":"","sources":["../../src/lib/store-index.ts"],"names":[],"mappings":"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"}

package/dist/lib/store.d.ts

@@ -1,5 +1,5 @@
 export { getSources, addSource, removeSource, getSemanticEnabled, setSemanticEnabled, readModelId, writeModelId, getWikiModel, configStats, } from "./store-config.js";
-export { getIndex, mergeIndex, removeEntry, updateEntryPath, getEntry, removeEntriesBySource, indexStats, } from "./store-index.js";
+export { getIndex, mergeIndex, removeEntry, updateEntryPath, getEntry, removeEntriesBySource, indexStats, readBm25Stats, writeBm25Stats, } from "./store-index.js";
 export { getEmbeddings, setEmbeddings, getChunkInfo, setChunkInfo, removeEmbedding, getEmbeddingModel, getEmbeddingDim, vectorsStats, } from "./store-vectors.js";
 export declare function stats(): {
     sources: number;