@chiway/contextweaver 1.4.0 → 1.5.0

package/dist/{chunk-EMSMLPMK.js → chunk-V3K4YVAR.js}

@@ -1,14 +1,15 @@
+import {
+  checkEnvOrRespond,
+  ensureIndexed
+} from "./chunk-VWBKZ6QL.js";
 import {
   generateProjectId
-} from "./chunk-RGJSXUFS.js";
+} from "./chunk-PPLFJGO3.js";
 import {
   logger
 } from "./chunk-JVKVSTQ3.js";
 
 // src/mcp/tools/codebaseRetrieval.ts
-import fs from "fs";
-import os from "os";
-import path from "path";
 import { z } from "zod";
 var codebaseRetrievalSchema = z.object({
   repo_path: z.string().describe(
@@ -21,80 +22,6 @@ var codebaseRetrievalSchema = z.object({
     "HARD FILTERS. Precise identifiers to narrow down results. Only use symbols KNOWN to exist to avoid false negatives."
   )
 });
-var BASE_DIR = path.join(os.homedir(), ".contextweaver");
-var INDEX_LOCK_TIMEOUT_MS = 10 * 60 * 1e3;
-async function ensureDefaultEnvFile() {
-  const configDir = BASE_DIR;
-  const envFile = path.join(configDir, ".env");
-  if (fs.existsSync(envFile)) {
-    return;
-  }
-  if (!fs.existsSync(configDir)) {
-    fs.mkdirSync(configDir, { recursive: true });
-    logger.info({ configDir }, "\u521B\u5EFA\u914D\u7F6E\u76EE\u5F55");
-  }
-  const defaultEnvContent = `# ContextWeaver \u793A\u4F8B\u73AF\u5883\u53D8\u91CF\u914D\u7F6E\u6587\u4EF6
-
-# Embedding API \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
-EMBEDDINGS_API_KEY=your-api-key-here
-EMBEDDINGS_BASE_URL=https://api.siliconflow.cn/v1/embeddings
-EMBEDDINGS_MODEL=BAAI/bge-m3
-EMBEDDINGS_MAX_CONCURRENCY=10
-EMBEDDINGS_DIMENSIONS=1024
-
-# Reranker \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
-RERANK_API_KEY=your-api-key-here
-RERANK_BASE_URL=https://api.siliconflow.cn/v1/rerank
-RERANK_MODEL=BAAI/bge-reranker-v2-m3
-RERANK_TOP_N=20
-
-# \u7D22\u5F15\u5FFD\u7565\u6A21\u5F0F\uFF08\u53EF\u9009\uFF0C\u9017\u53F7\u5206\u9694\uFF0C\u9ED8\u8BA4\u5DF2\u5305\u542B\u5E38\u89C1\u5FFD\u7565\u9879\uFF09
-# IGNORE_PATTERNS=.venv,node_modules
-`;
-  fs.writeFileSync(envFile, defaultEnvContent);
-  logger.info({ envFile }, "\u5DF2\u521B\u5EFA\u9ED8\u8BA4 .env \u914D\u7F6E\u6587\u4EF6");
-}
-function isProjectIndexed(projectId) {
-  const dbPath = path.join(BASE_DIR, projectId, "index.db");
-  return fs.existsSync(dbPath);
-}
-async function ensureIndexed(repoPath, projectId, onProgress) {
-  const { withLock } = await import("./lock-FL54LIQL.js");
-  const { scan } = await import("./scanner-2XGJWYHR.js");
-  await withLock(
-    projectId,
-    "index",
-    async () => {
-      const wasIndexed = isProjectIndexed(projectId);
-      if (!wasIndexed) {
-        logger.info(
-          { repoPath, projectId: projectId.slice(0, 10) },
-          "\u4EE3\u7801\u5E93\u672A\u521D\u59CB\u5316\uFF0C\u5F00\u59CB\u9996\u6B21\u7D22\u5F15..."
-        );
-        onProgress?.(0, 100, "\u4EE3\u7801\u5E93\u672A\u7D22\u5F15\uFF0C\u5F00\u59CB\u9996\u6B21\u7D22\u5F15...");
-      } else {
-        logger.debug({ projectId: projectId.slice(0, 10) }, "\u6267\u884C\u589E\u91CF\u7D22\u5F15...");
-      }
-      const startTime = Date.now();
-      const stats = await scan(repoPath, { vectorIndex: true, onProgress });
-      const elapsed = Date.now() - startTime;
-      logger.info(
-        {
-          projectId: projectId.slice(0, 10),
-          isFirstTime: !wasIndexed,
-          totalFiles: stats.totalFiles,
-          added: stats.added,
-          modified: stats.modified,
-          deleted: stats.deleted,
-          vectorIndex: stats.vectorIndex,
-          elapsedMs: elapsed
-        },
-        "\u7D22\u5F15\u5B8C\u6210"
-      );
-    },
-    INDEX_LOCK_TIMEOUT_MS
-  );
-}
 async function handleCodebaseRetrieval(args, onProgress) {
   const { repo_path, information_request, technical_terms } = args;
   logger.info(
@@ -111,11 +38,10 @@ async function handleCodebaseRetrieval(args, onProgress) {
   const allMissingVars = [...embeddingCheck.missingVars, ...rerankerCheck.missingVars];
   if (allMissingVars.length > 0) {
     logger.warn({ missingVars: allMissingVars }, "MCP \u73AF\u5883\u53D8\u91CF\u672A\u914D\u7F6E");
-    await ensureDefaultEnvFile();
-    return formatEnvMissingResponse(allMissingVars);
+    return await checkEnvOrRespond(allMissingVars);
   }
   const projectId = generateProjectId(repo_path);
-  await ensureIndexed(repo_path, projectId, onProgress);
+  await ensureIndexed(repo_path, projectId, { onProgress });
   const query = [information_request, ...technical_terms || []].filter(Boolean).join(" ");
   logger.info(
     {
@@ -124,8 +50,9 @@ async function handleCodebaseRetrieval(args, onProgress) {
     },
     "MCP \u67E5\u8BE2\u6784\u5EFA"
   );
-  const { SearchService } = await import("./SearchService-OS7CYHNJ.js");
-  const service = new SearchService(projectId, repo_path);
+  const { SearchService } = await import("./SearchService-WVD6THR3.js");
+  const { getSearchConfigOverrides } = await import("./loadConfig-XTVT2OWW.js");
+  const service = new SearchService(projectId, repo_path, getSearchConfigOverrides());
   await service.init();
   logger.debug("SearchService \u521D\u59CB\u5316\u5B8C\u6210");
   const contextPack = await service.buildContextPack(query);
@@ -244,40 +171,6 @@ function detectLanguage(filePath) {
   };
   return langMap[ext] || ext || "plaintext";
 }
-function formatEnvMissingResponse(missingVars) {
-  const configPath = "~/.contextweaver/.env";
-  const text = `## \u26A0\uFE0F \u914D\u7F6E\u7F3A\u5931
-
-ContextWeaver \u9700\u8981\u914D\u7F6E Embedding API \u624D\u80FD\u5DE5\u4F5C\u3002
-
-### \u7F3A\u5931\u7684\u73AF\u5883\u53D8\u91CF
-${missingVars.map((v) => `- \`${v}\``).join("\n")}
-
-### \u914D\u7F6E\u6B65\u9AA4
-
-\u5DF2\u81EA\u52A8\u521B\u5EFA\u914D\u7F6E\u6587\u4EF6\uFF1A\`${configPath}\`
-
-\u8BF7\u7F16\u8F91\u8BE5\u6587\u4EF6\uFF0C\u586B\u5199\u4F60\u7684 API Key\uFF1A
-
-\`\`\`bash
-# Embedding API \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
-EMBEDDINGS_API_KEY=your-api-key-here  # \u2190 \u66FF\u6362\u4E3A\u4F60\u7684 API Key
-
-# Reranker \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
-RERANK_API_KEY=your-api-key-here      # \u2190 \u66FF\u6362\u4E3A\u4F60\u7684 API Key
-\`\`\`
-
-\u4FDD\u5B58\u6587\u4EF6\u540E\u91CD\u65B0\u8C03\u7528\u6B64\u5DE5\u5177\u5373\u53EF\u3002
-`;
-  return {
-    content: [
-      {
-        type: "text",
-        text
-      }
-    ]
-  };
-}
 
 export {
   codebaseRetrievalSchema,

package/dist/chunk-VWBKZ6QL.js

@@ -0,0 +1,115 @@
+import {
+  getDefaultEnvFileContent
+} from "./chunk-TPM6YP43.js";
+import {
+  logger
+} from "./chunk-JVKVSTQ3.js";
+
+// src/mcp/tools/shared.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+var BASE_DIR = path.join(os.homedir(), ".contextweaver");
+var INDEX_LOCK_TIMEOUT_MS = 10 * 60 * 1e3;
+function isProjectIndexed(projectId) {
+  const dbPath = path.join(BASE_DIR, projectId, "index.db");
+  return fs.existsSync(dbPath);
+}
+async function ensureDefaultEnvFile() {
+  const configDir = BASE_DIR;
+  const envFile = path.join(configDir, ".env");
+  if (fs.existsSync(envFile)) {
+    return;
+  }
+  if (!fs.existsSync(configDir)) {
+    fs.mkdirSync(configDir, { recursive: true });
+    logger.info({ configDir }, "\u521B\u5EFA\u914D\u7F6E\u76EE\u5F55");
+  }
+  fs.writeFileSync(envFile, getDefaultEnvFileContent());
+  logger.info({ envFile }, "\u5DF2\u521B\u5EFA\u9ED8\u8BA4 .env \u914D\u7F6E\u6587\u4EF6");
+}
+async function ensureIndexed(repoPath, projectId, options = {}) {
+  const { onProgress, vectorIndex = true } = options;
+  const { withLock } = await import("./lock-HNKQ6X5B.js");
+  const { scan } = await import("./scanner-QDFZJLP7.js");
+  await withLock(
+    projectId,
+    "index",
+    async () => {
+      const wasIndexed = isProjectIndexed(projectId);
+      if (!wasIndexed) {
+        logger.info(
+          { repoPath, projectId: projectId.slice(0, 10), vectorIndex },
+          "\u4EE3\u7801\u5E93\u672A\u521D\u59CB\u5316\uFF0C\u5F00\u59CB\u9996\u6B21\u7D22\u5F15..."
+        );
+        onProgress?.(0, 100, "\u4EE3\u7801\u5E93\u672A\u7D22\u5F15\uFF0C\u5F00\u59CB\u9996\u6B21\u7D22\u5F15...");
+      } else {
+        logger.debug({ projectId: projectId.slice(0, 10), vectorIndex }, "\u6267\u884C\u589E\u91CF\u7D22\u5F15...");
+      }
+      const startTime = Date.now();
+      const stats = await scan(repoPath, { vectorIndex, onProgress });
+      const elapsed = Date.now() - startTime;
+      logger.info(
+        {
+          projectId: projectId.slice(0, 10),
+          isFirstTime: !wasIndexed,
+          totalFiles: stats.totalFiles,
+          added: stats.added,
+          modified: stats.modified,
+          deleted: stats.deleted,
+          vectorIndex: stats.vectorIndex,
+          elapsedMs: elapsed
+        },
+        "\u7D22\u5F15\u5B8C\u6210"
+      );
+    },
+    INDEX_LOCK_TIMEOUT_MS
+  );
+}
+function formatTextResponse(text) {
+  return {
+    content: [
+      {
+        type: "text",
+        text
+      }
+    ]
+  };
+}
+function formatEnvMissingResponse(missingVars) {
+  const configPath = "~/.contextweaver/.env";
+  const text = `## \u26A0\uFE0F \u914D\u7F6E\u7F3A\u5931
+
+ContextWeaver \u9700\u8981\u914D\u7F6E Embedding API \u624D\u80FD\u5DE5\u4F5C\u3002
+
+### \u7F3A\u5931\u7684\u73AF\u5883\u53D8\u91CF
+${missingVars.map((v) => `- \`${v}\``).join("\n")}
+
+### \u914D\u7F6E\u6B65\u9AA4
+
+\u5DF2\u81EA\u52A8\u521B\u5EFA\u914D\u7F6E\u6587\u4EF6\uFF1A\`${configPath}\`
+
+\u8BF7\u7F16\u8F91\u8BE5\u6587\u4EF6\uFF0C\u586B\u5199\u4F60\u7684 API Key\uFF1A
+
+\`\`\`bash
+# Embedding API \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
+EMBEDDINGS_API_KEY=your-api-key-here  # \u2190 \u66FF\u6362\u4E3A\u4F60\u7684 API Key
+
+# Reranker \u914D\u7F6E\uFF08\u5FC5\u9700\uFF09
+RERANK_API_KEY=your-api-key-here      # \u2190 \u66FF\u6362\u4E3A\u4F60\u7684 API Key
+\`\`\`
+
+\u4FDD\u5B58\u6587\u4EF6\u540E\u91CD\u65B0\u8C03\u7528\u6B64\u5DE5\u5177\u5373\u53EF\u3002
+`;
+  return formatTextResponse(text);
+}
+async function checkEnvOrRespond(missingVars) {
+  await ensureDefaultEnvFile();
+  return formatEnvMissingResponse(missingVars);
+}
+
+export {
+  ensureIndexed,
+  formatTextResponse,
+  checkEnvOrRespond
+};

package/dist/chunk-XFIM2T6S.js

@@ -0,0 +1,57 @@
+// src/search/ChunkContentLoader.ts
+var ChunkContentLoader = class _ChunkContentLoader {
+  constructor(db) {
+    this.db = db;
+  }
+  /**
+   * 生成 cache key
+   */
+  static key(slice) {
+    return `${slice.filePath}#${slice.start_index}#${slice.end_index}`;
+  }
+  /**
+   * 批量加载 chunk 正文
+   *
+   * @returns Map<key, code>，key 由 ChunkContentLoader.key 生成
+   */
+  loadMany(slices) {
+    const result = /* @__PURE__ */ new Map();
+    if (slices.length === 0) return result;
+    const byPath = /* @__PURE__ */ new Map();
+    for (const s of slices) {
+      let arr = byPath.get(s.filePath);
+      if (!arr) {
+        arr = [];
+        byPath.set(s.filePath, arr);
+      }
+      arr.push(s);
+    }
+    const stmt = this.db.prepare("SELECT content FROM files WHERE path = ?");
+    for (const [path, spans] of byPath) {
+      const row = stmt.get(path);
+      const content = row?.content ?? null;
+      for (const s of spans) {
+        const k = _ChunkContentLoader.key(s);
+        if (content === null) {
+          result.set(k, "");
+          continue;
+        }
+        const safeStart = Math.max(0, Math.min(s.start_index, content.length));
+        const safeEnd = Math.max(safeStart, Math.min(s.end_index, content.length));
+        result.set(k, content.slice(safeStart, safeEnd));
+      }
+    }
+    return result;
+  }
+  /**
+   * 加载单个 chunk 正文（便捷方法，不推荐在批量场景使用）
+   */
+  loadOne(slice) {
+    const map = this.loadMany([slice]);
+    return map.get(_ChunkContentLoader.key(slice)) ?? "";
+  }
+};
+
+export {
+  ChunkContentLoader
+};

package/dist/{chunk-AB24E3Z7.js → chunk-XMZZZKG7.js}

@@ -1,7 +1,13 @@
+import {
+  commonPrefixLength
+} from "./chunk-LB42CZEB.js";
+import {
+  ChunkContentLoader
+} from "./chunk-XFIM2T6S.js";
 import {
   getVectorStore,
   sampleCheckDisplayCode
-} from "./chunk-ZOMGPIU6.js";
+} from "./chunk-3BNHQV5W.js";
 import {
   batchDeleteFileChunksFts,
   batchUpdateVectorIndexHash,
@@ -17,7 +23,7 @@ import {
   replayPendingMarks,
   setLanceDbMigrationState,
   tryAcquireLanceDbMigrationLock
-} from "./chunk-RGJSXUFS.js";
+} from "./chunk-PPLFJGO3.js";
 import {
   logger
 } from "./chunk-JVKVSTQ3.js";
@@ -606,10 +612,7 @@ var Indexer = class {
         stats.deleted = toDelete.length;
       } catch (err) {
         const error = err;
-        logger.error(
-          { error: error.message, count: toDelete.length },
-          "\u5220\u9664\u9636\u6BB5\u5931\u8D25\uFF0C\u5DF2\u6807\u8BB0\u91CD\u8BD5"
-        );
+        logger.error({ error: error.message, count: toDelete.length }, "\u5220\u9664\u9636\u6BB5\u5931\u8D25\uFF0C\u5DF2\u6807\u8BB0\u91CD\u8BD5");
         stats.errors += toDelete.length;
       }
     }
@@ -678,16 +681,27 @@ var Indexer = class {
         continue;
       }
       logger.info(
-        { batch: `${batchNum}/${totalBatches}`, texts: batchTexts.length, files: batchFiles.length },
+        {
+          batch: `${batchNum}/${totalBatches}`,
+          texts: batchTexts.length,
+          files: batchFiles.length
+        },
         "\u6279\u6B21 Embedding \u5F00\u59CB"
       );
       let embeddings;
       const EMBED_BATCH_SIZE = 10;
       try {
         const batchOnProgress = onProgress ? (_completed, _total) => {
-          onProgress(completedChunks + Math.min(_completed * EMBED_BATCH_SIZE, batchTexts.length), totalChunks);
+          onProgress(
+            completedChunks + Math.min(_completed * EMBED_BATCH_SIZE, batchTexts.length),
+            totalChunks
+          );
         } : void 0;
-        const results = await this.embeddingClient.embedBatch(batchTexts, EMBED_BATCH_SIZE, batchOnProgress);
+        const results = await this.embeddingClient.embedBatch(
+          batchTexts,
+          EMBED_BATCH_SIZE,
+          batchOnProgress
+        );
         embeddings = results.map((r) => r.embedding);
       } catch (err) {
         const error = err;
@@ -1007,75 +1021,6 @@ function scoreChunkTokenOverlap(chunk, code, queryTokens) {
   return score;
 }
 
-// src/search/ChunkContentLoader.ts
-var ChunkContentLoader = class _ChunkContentLoader {
-  constructor(db) {
-    this.db = db;
-  }
-  /**
-   * 生成 cache key
-   */
-  static key(slice) {
-    return `${slice.filePath}#${slice.start_index}#${slice.end_index}`;
-  }
-  /**
-   * 批量加载 chunk 正文
-   *
-   * @returns Map<key, code>，key 由 ChunkContentLoader.key 生成
-   */
-  loadMany(slices) {
-    const result = /* @__PURE__ */ new Map();
-    if (slices.length === 0) return result;
-    const byPath = /* @__PURE__ */ new Map();
-    for (const s of slices) {
-      let arr = byPath.get(s.filePath);
-      if (!arr) {
-        arr = [];
-        byPath.set(s.filePath, arr);
-      }
-      arr.push(s);
-    }
-    const stmt = this.db.prepare("SELECT content FROM files WHERE path = ?");
-    for (const [path, spans] of byPath) {
-      const row = stmt.get(path);
-      const content = row?.content ?? null;
-      for (const s of spans) {
-        const k = _ChunkContentLoader.key(s);
-        if (content === null) {
-          result.set(k, "");
-          continue;
-        }
-        const safeStart = Math.max(0, Math.min(s.start_index, content.length));
-        const safeEnd = Math.max(safeStart, Math.min(s.end_index, content.length));
-        result.set(k, content.slice(safeStart, safeEnd));
-      }
-    }
-    return result;
-  }
-  /**
-   * 加载单个 chunk 正文（便捷方法，不推荐在批量场景使用）
-   */
-  loadOne(slice) {
-    const map = this.loadMany([slice]);
-    return map.get(_ChunkContentLoader.key(slice)) ?? "";
-  }
-};
-
-// src/search/resolvers/types.ts
-function commonPrefixLength(path1, path2) {
-  const parts1 = path1.split("/");
-  const parts2 = path2.split("/");
-  let count = 0;
-  for (let i = 0; i < Math.min(parts1.length, parts2.length); i++) {
-    if (parts1[i] === parts2[i]) {
-      count++;
-    } else {
-      break;
-    }
-  }
-  return count;
-}
-
 // src/search/resolvers/CppResolver.ts
 var CPP_EXTENSIONS = /* @__PURE__ */ new Set([".c", ".cpp", ".cc", ".cxx", ".h", ".hpp", ".hh", ".hxx"]);
 var CppResolver = class {
@@ -1876,7 +1821,6 @@ export {
   getIndexer,
   closeAllIndexers,
   scoreChunkTokenOverlap,
-  ChunkContentLoader,
   invalidateAllExpanderCaches,
   getGraphExpander
 };

package/dist/chunk-XTWNT7KP.js

@@ -0,0 +1,156 @@
+import {
+  getVectorStore
+} from "./chunk-3BNHQV5W.js";
+import {
+  closeDb,
+  collectHealthSnapshot,
+  getAllStats,
+  getStatJson,
+  initDb
+} from "./chunk-PPLFJGO3.js";
+import {
+  logger
+} from "./chunk-JVKVSTQ3.js";
+import {
+  getEmbeddingConfig
+} from "./chunk-SKBAE26T.js";
+
+// src/stats/index.ts
+function num(stats, key) {
+  const v = stats[key];
+  if (v === void 0) return 0;
+  const parsed = Number.parseInt(v, 10);
+  return Number.isNaN(parsed) ? 0 : parsed;
+}
+function avg(sum, count) {
+  if (count <= 0) return null;
+  return sum / count;
+}
+async function collectStats(projectId) {
+  const db = initDb(projectId);
+  try {
+    const health = collectHealthSnapshot(db);
+    const stats = getAllStats(db);
+    let lancedbRows = 0;
+    try {
+      const store = await getVectorStore(projectId, getEmbeddingConfig().dimensions);
+      lancedbRows = await store.count();
+    } catch (err) {
+      logger.warn({ error: err.message }, "\u8BFB\u53D6 LanceDB \u884C\u6570\u5931\u8D25");
+    }
+    const computeRuns = num(stats, "stats.search.compute_runs");
+    const totalQueries = num(stats, "stats.search.total_queries");
+    const cacheHits = num(stats, "stats.search.cache_hits");
+    const index = {
+      totalRuns: num(stats, "stats.index.total_runs"),
+      lastRun: getStatJson(db, "stats.index.last_run_json"),
+      lastRunAt: getStatJson(db, "stats.index.last_run_at")
+    };
+    const search = {
+      totalQueries,
+      cacheHits,
+      cacheHitRate: totalQueries > 0 ? cacheHits / totalQueries : null,
+      computeRuns,
+      avgRetrieveMs: avg(num(stats, "stats.search.sum_retrieve_ms"), computeRuns),
+      avgRerankMs: avg(num(stats, "stats.search.sum_rerank_ms"), computeRuns),
+      avgExpandMs: avg(num(stats, "stats.search.sum_expand_ms"), computeRuns),
+      avgPackMs: avg(num(stats, "stats.search.sum_pack_ms"), computeRuns),
+      avgSeedCount: avg(num(stats, "stats.search.sum_seed_count"), computeRuns)
+    };
+    const diagnostics = buildDiagnostics(health, lancedbRows);
+    return { projectId, health, lancedbRows, index, search, diagnostics };
+  } finally {
+    closeDb(db);
+  }
+}
+function buildDiagnostics(health, lancedbRows) {
+  const out = [];
+  if (health.migrationState === "aborted") {
+    out.push(
+      "LanceDB \u8FC1\u79FB\u72B6\u6001\u4E3A aborted\uFF0C\u7D22\u5F15\u5199\u5165\u88AB\u62D2\u7EDD\u3002\u8FD0\u884C `contextweaver migrate --reset` \u89E3\u9664\u3002"
+    );
+  }
+  if (health.migrationState === "pending") {
+    out.push("LanceDB \u8FC1\u79FB\u72B6\u6001\u4E3A pending\uFF0C\u53EF\u80FD\u4E0A\u6B21\u8FC1\u79FB\u672A\u5B8C\u6210\u3002");
+  }
+  if (health.pendingMarks > 0) {
+    out.push(`pending_marks \u79EF\u538B ${health.pendingMarks} \u6761\uFF0C\u4E0B\u6B21\u542F\u52A8\u5C06\u91CD\u653E\u3002\u82E5\u6301\u7EED\u4E0D\u51CF\u9700\u6392\u67E5\u3002`);
+  }
+  if (health.totalFiles > 0 && lancedbRows === 0) {
+    out.push(
+      `\u5DF2\u7D22\u5F15 ${health.totalFiles} \u4E2A\u6587\u4EF6\u4F46 LanceDB \u65E0\u5411\u91CF\u884C\uFF0C\u5411\u91CF\u7D22\u5F15\u53EF\u80FD\u672A\u5EFA\u7ACB\u3002\u8FD0\u884C \`contextweaver index\` \u91CD\u5EFA\u3002`
+    );
+  }
+  if (health.embeddingDimensions === null && health.totalFiles > 0) {
+    out.push("\u672A\u8BB0\u5F55 embedding \u7EF4\u5EA6\uFF0C\u7D22\u5F15\u5143\u6570\u636E\u53EF\u80FD\u4E0D\u5B8C\u6574\u3002");
+  }
+  return out;
+}
+function renderStatsText(report) {
+  const fmt = (v, suffix = "") => v === null ? "\u2014" : `${Number.isInteger(v) ? v : v.toFixed(1)}${suffix}`;
+  const pct = (v) => v === null ? "\u2014" : `${(v * 100).toFixed(1)}%`;
+  const bytes = (n) => {
+    if (n < 1024) return `${n} B`;
+    if (n < 1024 * 1024) return `${(n / 1024).toFixed(1)} KB`;
+    return `${(n / 1024 / 1024).toFixed(1)} MB`;
+  };
+  const lines = [];
+  lines.push(`ContextWeaver \u7EDF\u8BA1  (projectId: ${report.projectId})`);
+  lines.push("");
+  const ix = report.index;
+  lines.push("\u3010\u7D22\u5F15\u8FC7\u7A0B\u3011");
+  lines.push(`  \u7D2F\u8BA1\u7D22\u5F15\u8FD0\u884C: ${ix.totalRuns} \u6B21`);
+  if (ix.lastRunAt) {
+    lines.push(`  \u4E0A\u6B21\u7D22\u5F15\u65F6\u95F4: ${new Date(ix.lastRunAt).toLocaleString()}`);
+  }
+  if (ix.lastRun) {
+    const r = ix.lastRun;
+    lines.push(
+      `  \u4E0A\u6B21\u7ED3\u679C: \u603B\u6570=${r.totalFiles} \u65B0\u589E=${r.added} \u4FEE\u6539=${r.modified} \u672A\u53D8=${r.unchanged} \u5220\u9664=${r.deleted} \u8DF3\u8FC7=${r.skipped} \u9519\u8BEF=${r.errors}`
+    );
+    if (r.vectorIndex) {
+      lines.push(
+        `  \u5411\u91CF\u7D22\u5F15: \u5DF2\u7D22\u5F15=${r.vectorIndex.indexed} \u5220\u9664=${r.vectorIndex.deleted} \u9519\u8BEF=${r.vectorIndex.errors}`
+      );
+    }
+  } else {
+    lines.push("  \u4E0A\u6B21\u7ED3\u679C: \u6682\u65E0\uFF08\u5C1A\u672A\u7D22\u5F15\uFF09");
+  }
+  lines.push("");
+  const s = report.search;
+  lines.push("\u3010\u641C\u7D22\u8D28\u91CF/\u884C\u4E3A\u3011");
+  lines.push(
+    `  \u7D2F\u8BA1\u67E5\u8BE2: ${s.totalQueries} \u6B21  (\u7F13\u5B58\u547D\u4E2D ${s.cacheHits}\uFF0C\u547D\u4E2D\u7387 ${pct(s.cacheHitRate)})`
+  );
+  lines.push(`  \u5B9E\u9645\u8BA1\u7B97: ${s.computeRuns} \u6B21\uFF08\u672A\u547D\u4E2D\u7F13\u5B58\uFF0C\u4F5C\u4E3A\u4E0B\u5217\u5747\u503C\u5206\u6BCD\uFF09`);
+  lines.push(
+    `  \u5E73\u5747\u8017\u65F6: retrieve=${fmt(s.avgRetrieveMs, "ms")} rerank=${fmt(s.avgRerankMs, "ms")} expand=${fmt(s.avgExpandMs, "ms")} pack=${fmt(s.avgPackMs, "ms")}`
+  );
+  lines.push(`  \u5E73\u5747\u53EC\u56DE: ${fmt(s.avgSeedCount)} \u4E2A seed`);
+  lines.push("");
+  const h = report.health;
+  lines.push("\u3010\u5065\u5EB7/\u4E00\u81F4\u6027\u3011");
+  lines.push(`  \u6587\u4EF6: ${h.totalFiles} \u4E2A\uFF0C\u6B63\u6587\u603B\u91CF ${bytes(h.totalBytes)}`);
+  lines.push(`  LanceDB \u5411\u91CF\u884C: ${report.lancedbRows}`);
+  lines.push(
+    `  embedding \u7EF4\u5EA6: ${h.embeddingDimensions ?? "\u2014"}  \u7D22\u5F15\u7248\u672C: ${h.indexVersion}  \u8FC1\u79FB\u72B6\u6001: ${h.migrationState ?? "\u672A\u8BBE\u7F6E"}  pending_marks: ${h.pendingMarks}`
+  );
+  const langs = Object.entries(h.byLanguage).sort((a, b) => b[1] - a[1]);
+  if (langs.length > 0) {
+    const langStr = langs.map(([lang, c]) => `${lang}=${c}`).join("  ");
+    lines.push(`  \u8BED\u8A00\u5360\u6BD4: ${langStr}`);
+  }
+  lines.push("");
+  if (report.diagnostics.length > 0) {
+    lines.push("\u3010\u8BCA\u65AD\u544A\u8B66\u3011");
+    for (const d of report.diagnostics) lines.push(`  \u26A0 ${d}`);
+  } else {
+    lines.push("\u3010\u8BCA\u65AD\u3011\u65E0\u5F02\u5E38");
+  }
+  return lines.join("\n");
+}
+
+export {
+  collectStats,
+  renderStatsText
+};