@lorrylurui/code-intelligence-mcp 1.0.2 → 1.0.3

package/README.md

@@ -156,11 +156,11 @@ npm run index
 
 可选环境变量（见 `.env.example`）：
 
-| 变量           | 含义                                    |
-| -------------- | --------------------------------------- |
-| `INDEX_ROOT`   | 工程根目录，默认当前工作目录            |
-| `INDEX_GLOB`   | 逗号分隔 glob，默认 `src/**/*.{ts,tsx}` |
-| `INDEX_IGNORE` | 额外忽略的 glob 片段（逗号分隔）        |
+| 变量           | 含义                                             |
+| -------------- | ------------------------------------------------ |
+| `INDEX_ROOT`   | 工程根目录，默认当前工作目录                     |
+| `INDEX_GLOB`   | 空格分隔 glob，默认 `src/**/*.{ts,tsx}`         |
+| `INDEX_IGNORE` | 额外忽略的 glob 片段（空格分隔）                 |
 
 **分类规则（首版启发式）**：`interface` / `type` → `type`；`.tsx` 且函数体含 JSX → `component`；路径或导出名含 `selector` → `selector`；其余导出函数 → `util`；`class` → `util`（可后续细化）。
 

package/dist/cli/index-codebase.js

@@ -2,9 +2,9 @@
 /**
  * Phase 2 CLI：扫描代码库并写入 MySQL `symbols`（需 `MYSQL_ENABLED=true`）。
  */
-import { resolve } from "node:path";
-import dotenv from "dotenv";
-import { runReindex } from "../services/reindex.js";
+import { resolve } from 'node:path';
+import dotenv from 'dotenv';
+import { runReindex } from '../services/reindex.js';
 dotenv.config();
 /**
  * 入口：校验环境 → 连接池 → 按 `INDEX_*` 调用 `indexProject` → `upsertSymbols`。
@@ -14,30 +14,35 @@ dotenv.config();
 async function main() {
     const projectRoot = resolve(process.env.INDEX_ROOT ?? process.cwd());
     const globPatterns = process.env.INDEX_GLOB
-        ? process.env.INDEX_GLOB.split(",").map((s) => s.trim())
+        ? process.env.INDEX_GLOB.split(/\s+/).map((s) => s.trim()).filter(Boolean)
         : undefined;
     const ignore = process.env.INDEX_IGNORE
-        ? process.env.INDEX_IGNORE.split(",").map((s) => s.trim())
+        ? process.env.INDEX_IGNORE.split(',').map((s) => s.trim())
         : undefined;
     console.error(`[index] projectRoot=${projectRoot}`);
-    const result = await runReindex({ projectRoot, globPatterns, ignore, dryRun: false });
+    const result = await runReindex({
+        projectRoot,
+        globPatterns,
+        ignore,
+        dryRun: false,
+    });
     console.error(`[index] extracted ${result.extractedCount} symbol(s)`);
     console.error(`[index] embeddings computed: ${result.embeddingsComputed}`);
-    console.error("[index] upserted into MySQL");
+    console.error('[index] upserted into MySQL, success:', result.upserted);
 }
 main().catch((err) => {
-    console.error("[index] failed:", err);
+    console.error('[index] failed:', err);
     const anyErr = err;
-    if (anyErr.code === "ECONNREFUSED") {
-        const host = process.env.MYSQL_HOST ?? "127.0.0.1";
-        const port = process.env.MYSQL_PORT ?? "3306";
+    if (anyErr.code === 'ECONNREFUSED') {
+        const host = process.env.MYSQL_HOST ?? '127.0.0.1';
+        const port = process.env.MYSQL_PORT ?? '3306';
         console.error(`[index] 原因: 无法连接 ${host}:${port}（连接被拒绝）。请先在本机启动 MySQL/MariaDB，或把 .env 里的 MYSQL_HOST / MYSQL_PORT 改成实际地址。macOS 可用 brew services start mysql 等方式启动。`);
     }
-    else if (anyErr.code === "ER_ACCESS_DENIED_ERROR") {
-        console.error("[index] 原因: 用户名或密码错误，请检查 MYSQL_USER / MYSQL_PASSWORD。");
+    else if (anyErr.code === 'ER_ACCESS_DENIED_ERROR') {
+        console.error('[index] 原因: 用户名或密码错误，请检查 MYSQL_USER / MYSQL_PASSWORD。');
     }
-    else if (anyErr.code === "ENOTFOUND" || anyErr.code === "ETIMEDOUT") {
-        console.error("[index] 原因: 网络不可达或超时，请检查 MYSQL_HOST 是否可解析、防火墙与安全组。");
+    else if (anyErr.code === 'ENOTFOUND' || anyErr.code === 'ETIMEDOUT') {
+        console.error('[index] 原因: 网络不可达或超时，请检查 MYSQL_HOST 是否可解析、防火墙与安全组。');
     }
     process.exit(1);
 });

package/dist/config/env.js

@@ -1,17 +1,57 @@
-import dotenv from "dotenv";
-dotenv.config();
-const requiredWhenEnabled = ["MYSQL_HOST", "MYSQL_USER", "MYSQL_DATABASE"];
+import dotenv from 'dotenv';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.resolve(__dirname, '../../');
+// 解析命令行参数 --key=value 格式，注入到 process.env
+for (const arg of process.argv) {
+    const match = arg.match(/^--([A-Z_][A-Z0-9_]*)=(.+)$/);
+    if (match) {
+        process.env[match[1]] = match[2];
+    }
+}
+// 加载本地 .env（外部传入的 env 已经在 process.env 中，override: false 不会覆盖它们）
+dotenv.config({
+    path: path.resolve(projectRoot, '.env'),
+    override: false,
+});
+// 尝试从第三方项目目录加载 .env（INDEX_ROOT 或 cwd）
+const clientProjectRoot = process.env.INDEX_ROOT || process.cwd();
+console.error(`[Config] Loading .env from client project root: ${clientProjectRoot}`);
+dotenv.config({
+    path: path.resolve(clientProjectRoot, '.env'),
+    override: true,
+});
+// 外部传入的 env 已在上一步保留，这里确保环境变量已正确设置
+for (const arg of process.argv) {
+    const match = arg.match(/^--([A-Z_][A-Z0-9_]*)=(.+)$/);
+    if (match) {
+        process.env[match[1]] = match[2];
+    }
+}
+const requiredWhenEnabled = [
+    'MYSQL_HOST',
+    'MYSQL_USER',
+    'MYSQL_DATABASE',
+];
+console.error(`[Config] MYSQL_ENABLED: ${process.env.MYSQL_ENABLED},
+    MYSQL_HOST: ${process.env.MYSQL_HOST},
+    MYSQL_USER: ${process.env.MYSQL_USER},
+    MYSQL_DATABASE: ${process.env.MYSQL_DATABASE},
+    EMBEDDING_SERVICE_URL: ${process.env.EMBEDDING_SERVICE_URL},
+    MYSQL_SYMBOLS_TABLE: ${process.env.MYSQL_SYMBOLS_TABLE}
+    `);
 export const env = {
-    mysqlEnabled: process.env.MYSQL_ENABLED === "true",
-    mysqlHost: process.env.MYSQL_HOST ?? "127.0.0.1",
-    mysqlPort: Number(process.env.MYSQL_PORT ?? "3306"),
-    mysqlUser: process.env.MYSQL_USER ?? "root",
-    mysqlPassword: process.env.MYSQL_PASSWORD ?? "",
-    mysqlDatabase: process.env.MYSQL_DATABASE ?? "code_intelligence",
+    mysqlEnabled: process.env.MYSQL_ENABLED === 'true',
+    mysqlHost: process.env.MYSQL_HOST ?? '127.0.0.1',
+    mysqlPort: Number(process.env.MYSQL_PORT ?? '3306'),
+    mysqlUser: process.env.MYSQL_USER ?? 'root',
+    mysqlPassword: process.env.MYSQL_PASSWORD ?? '',
+    mysqlDatabase: process.env.MYSQL_DATABASE ?? 'code_intelligence',
     /** symbols 表名，可通过 MYSQL_SYMBOLS_TABLE 环境变量配置 */
-    mysqlSymbolsTable: process.env.MYSQL_SYMBOLS_TABLE ?? "symbols",
+    mysqlSymbolsTable: process.env.MYSQL_SYMBOLS_TABLE ?? 'symbols',
     /** Phase 5：指向 Python FastAPI 嵌入服务根 URL，如 http://127.0.0.1:8765 */
-    embeddingServiceUrl: (process.env.EMBEDDING_SERVICE_URL ?? "").trim()
+    embeddingServiceUrl: (process.env.EMBEDDING_SERVICE_URL ?? '').trim(),
 };
 export function validateEnv() {
     if (!env.mysqlEnabled) {

package/dist/indexer/babelParser.js

@@ -0,0 +1,296 @@
+/**
+ * 使用 Babel 解析 JS/JSX 文件，提取导出声明以及无导出文件中的所有函数/类
+ */
+import * as babelParser from '@babel/parser';
+import * as bt from '@babel/types';
+import { getRelativePathForDisplay, inferCategoryFromPath } from './heuristics.js';
+/** 从 JS 文件内容解析导出的代码块 */
+export function parseJsFile(filePath, content, projectRoot) {
+    const out = [];
+    const isJsx = filePath.endsWith('.jsx') || filePath.endsWith('.tsx');
+    let ast;
+    try {
+        ast = babelParser.parse(content, {
+            sourceType: 'module',
+            plugins: [
+                'jsx',
+                'typescript',
+                'classPrivateMethods',
+                'classPrivateProperties',
+                'decorators-legacy',
+                'doExpressions',
+                'exportDefaultFrom',
+                'functionBind',
+                'logicalAssignment',
+                'nullishCoalescingOperator',
+                'objectRestSpread',
+                'optionalChaining',
+                'optionalCatchBinding',
+            ],
+            strictMode: false,
+        });
+    }
+    catch (e) {
+        console.error(`[babelParser] Failed to parse ${filePath}:`, e);
+        return [];
+    }
+    // 第一轮：处理所有导出声明
+    for (const stmt of ast.program.body) {
+        const rows = processStatement(stmt, filePath, isJsx, projectRoot);
+        out.push(...rows);
+    }
+    // 第二轮：如果没有任何导出，则扫描所有函数/类
+    if (out.length === 0) {
+        for (const stmt of ast.program.body) {
+            const rows = scanAllDeclarations(stmt, filePath, isJsx, projectRoot);
+            out.push(...rows);
+        }
+    }
+    return out;
+}
+/** 处理导出的声明 */
+function processStatement(stmt, filePath, isJsx, projectRoot) {
+    const out = [];
+    // 处理命名导出: export function Foo() {}
+    if (bt.isExportNamedDeclaration(stmt)) {
+        const decl = stmt.declaration;
+        if (!decl)
+            return out;
+        if (bt.isFunctionDeclaration(decl)) {
+            const name = decl.id?.name;
+            if (name) {
+                out.push(createRowFromFunction(name, decl, filePath, projectRoot, isJsx));
+            }
+        }
+        else if (bt.isClassDeclaration(decl)) {
+            const name = decl.id?.name;
+            if (name) {
+                out.push(createRowFromClass(name, decl, filePath, projectRoot));
+            }
+        }
+        else if (bt.isVariableDeclaration(decl)) {
+            for (const declarator of decl.declarations) {
+                if (bt.isVariableDeclarator(declarator) && declarator.id && bt.isIdentifier(declarator.id)) {
+                    const name = declarator.id.name;
+                    const init = declarator.init;
+                    if (name && (bt.isArrowFunctionExpression(init) || bt.isFunctionExpression(init))) {
+                        const fnDecl = arrowToFunction(name, init);
+                        out.push(createRowFromFunction(name, fnDecl, filePath, projectRoot, isJsx));
+                    }
+                }
+            }
+        }
+    }
+    // 处理 module.exports = xxx
+    else if (bt.isExpressionStatement(stmt)) {
+        const expr = stmt.expression;
+        if (bt.isAssignmentExpression(expr) && bt.isMemberExpression(expr.left)) {
+            const left = expr.left;
+            // module.exports = xxx
+            if (bt.isIdentifier(left.object) && left.object.name === 'module' &&
+                bt.isIdentifier(left.property) && left.property.name === 'exports') {
+                const right = expr.right;
+                if (bt.isObjectExpression(right)) {
+                    for (const prop of right.properties) {
+                        if (bt.isObjectProperty(prop) && bt.isIdentifier(prop.key)) {
+                            const name = prop.key.name;
+                            const value = prop.value;
+                            if (bt.isFunctionExpression(value) || bt.isArrowFunctionExpression(value)) {
+                                const fnDecl = arrowToFunction(name, bt.isArrowFunctionExpression(value) ? value : value);
+                                out.push(createRowFromFunction(name, fnDecl, filePath, projectRoot, isJsx));
+                            }
+                        }
+                    }
+                }
+                else if (bt.isFunctionExpression(right)) {
+                    const fnDecl = arrowToFunction('default', right);
+                    out.push(createRowFromFunction('default', fnDecl, filePath, projectRoot, isJsx));
+                }
+                else if (bt.isArrowFunctionExpression(right)) {
+                    const fnDecl = arrowToFunction('default', right);
+                    out.push(createRowFromFunction('default', fnDecl, filePath, projectRoot, isJsx));
+                }
+            }
+            // exports.xxx = xxx
+            else if (bt.isIdentifier(left.object) && left.object.name === 'exports') {
+                const name = bt.isIdentifier(left.property) ? left.property.name : null;
+                if (name) {
+                    const right = expr.right;
+                    if (bt.isFunctionExpression(right) || bt.isArrowFunctionExpression(right)) {
+                        const fnDecl = arrowToFunction(name, bt.isArrowFunctionExpression(right) ? right : right);
+                        out.push(createRowFromFunction(name, fnDecl, filePath, projectRoot, isJsx));
+                    }
+                }
+            }
+        }
+    }
+    // 处理默认导出
+    else if (bt.isExportDefaultDeclaration(stmt)) {
+        const decl = stmt.declaration;
+        if (bt.isFunctionDeclaration(decl)) {
+            const name = decl.id?.name || 'default';
+            out.push(createRowFromFunction(name, decl, filePath, projectRoot, isJsx));
+        }
+        else if (bt.isClassDeclaration(decl)) {
+            const name = decl.id?.name || 'default';
+            out.push(createRowFromClass(name, decl, filePath, projectRoot));
+        }
+        else if (bt.isArrowFunctionExpression(decl)) {
+            const fnDecl = arrowToFunction('default', decl);
+            out.push(createRowFromFunction('default', fnDecl, filePath, projectRoot, isJsx));
+        }
+        else if (bt.isFunctionExpression(decl)) {
+            const fnDecl = arrowToFunction('default', decl);
+            out.push(createRowFromFunction('default', fnDecl, filePath, projectRoot, isJsx));
+        }
+    }
+    return out;
+}
+/** 扫描无导出文件中的所有声明 */
+function scanAllDeclarations(stmt, filePath, isJsx, projectRoot) {
+    const out = [];
+    // 函数声明: function foo() {}
+    if (bt.isFunctionDeclaration(stmt)) {
+        const name = stmt.id?.name;
+        if (name) {
+            out.push(createRowFromFunction(name, stmt, filePath, projectRoot, isJsx));
+        }
+    }
+    // 类声明: class Foo {}
+    else if (bt.isClassDeclaration(stmt)) {
+        const name = stmt.id?.name;
+        if (name) {
+            out.push(createRowFromClass(name, stmt, filePath, projectRoot));
+        }
+    }
+    // 变量声明: const foo = () => {}, const bar = function() {}
+    else if (bt.isVariableDeclaration(stmt)) {
+        for (const declarator of stmt.declarations) {
+            if (bt.isVariableDeclarator(declarator) && declarator.id && bt.isIdentifier(declarator.id)) {
+                const name = declarator.id.name;
+                const init = declarator.init;
+                if (name && (bt.isArrowFunctionExpression(init) || bt.isFunctionExpression(init))) {
+                    const fnDecl = arrowToFunction(name, init);
+                    out.push(createRowFromFunction(name, fnDecl, filePath, projectRoot, isJsx));
+                }
+            }
+        }
+    }
+    return out;
+}
+/** 将 ArrowFunctionExpression 或 FunctionExpression 转换为 FunctionDeclaration */
+function arrowToFunction(name, arrow) {
+    const body = arrow.body;
+    const blockBody = bt.isBlockStatement(body)
+        ? body
+        : bt.blockStatement([bt.returnStatement(body)]);
+    return {
+        type: 'FunctionDeclaration',
+        id: { type: 'Identifier', name },
+        params: arrow.params,
+        body: blockBody,
+        generator: false,
+        async: arrow.async,
+        returnType: arrow.returnType,
+        typeParameters: arrow.typeParameters,
+    };
+}
+function createRowFromFunction(name, decl, filePath, projectRoot, isJsx) {
+    const relPath = getRelativePathForDisplay(projectRoot, filePath);
+    const category = inferCategoryFromPath(filePath);
+    // 检测是否有 JSX
+    const hasJsx = isJsx || containsJsx(decl);
+    // 判断类型：
+    // 1. 有 JSX = component
+    // 2. 名字包含 selector = selector
+    // 3. 大写开头（JSX 组件约定）= component
+    // 4. 其他 = util
+    const type = hasJsx
+        ? 'component'
+        : name.toLowerCase().includes('selector')
+            ? 'selector'
+            : isJsx && /^[A-Z]/.test(name)
+                ? 'component'
+                : 'util';
+    const params = decl.params
+        .filter((p) => bt.isIdentifier(p))
+        .map((p) => p.name);
+    return {
+        name,
+        type,
+        category,
+        path: relPath,
+        description: null,
+        content: `function ${decl.id?.name || 'anonymous'}(${params.join(', ')}) { ... }`,
+        meta: {
+            params,
+            returnType: getReturnType(decl),
+        },
+    };
+}
+function createRowFromClass(name, _decl, filePath, projectRoot) {
+    const relPath = getRelativePathForDisplay(projectRoot, filePath);
+    const category = inferCategoryFromPath(filePath);
+    // 大写开头的类视为组件
+    const type = /^[A-Z]/.test(name) ? 'component' : 'util';
+    return {
+        name,
+        type,
+        category,
+        path: relPath,
+        description: null,
+        content: null,
+        meta: { kind: 'class' },
+    };
+}
+/** 简单检测是否包含 JSX */
+function containsJsx(node) {
+    const jsxTags = ['JSXElement', 'JSXFragment'];
+    let found = false;
+    const visit = (n) => {
+        if (jsxTags.includes(n.type)) {
+            found = true;
+            return;
+        }
+        // 只遍历常见的包含子节点的属性
+        const keys = ['body', 'declarations', 'arguments', 'callee', 'init', 'left', 'right', 'consequent', 'alternate'];
+        for (const key of keys) {
+            const val = n[key];
+            if (Array.isArray(val)) {
+                for (const v of val) {
+                    if (v && typeof v === 'object' && 'type' in v) {
+                        visit(v);
+                    }
+                }
+            }
+            else if (val && typeof val === 'object' && 'type' in val) {
+                visit(val);
+            }
+        }
+    };
+    visit(node);
+    return found;
+}
+function getReturnType(fn) {
+    if (!fn.returnType)
+        return undefined;
+    const rt = fn.returnType;
+    if (bt.isTSTypeAnnotation(rt)) {
+        const inner = rt.typeAnnotation;
+        if (bt.isTSStringKeyword(inner))
+            return 'string';
+        if (bt.isTSNumberKeyword(inner))
+            return 'number';
+        if (bt.isTSBooleanKeyword(inner))
+            return 'boolean';
+        if (bt.isTSVoidKeyword(inner))
+            return 'void';
+        if (bt.isTSAnyKeyword(inner))
+            return 'any';
+        if (bt.isTSUnknownKeyword(inner))
+            return 'unknown';
+        if (bt.isTSNullKeyword(inner))
+            return 'null';
+    }
+    return undefined;
+}

package/dist/indexer/indexProject.js

@@ -1,11 +1,20 @@
 /**
- * 扫描源码目录，用 ts-morph 解析导出并生成待写入 MySQL 的代码块行。
+ * 扫描源码目录，用 ts-morph 解析 TS/TSX，Babel 解析 JS/JSX，生成待写入 MySQL 的代码块行。
  */
 import fg from 'fast-glob';
 import { join, resolve } from 'node:path';
 import { Node, Project } from 'ts-morph';
+import { readFileSync } from 'node:fs';
 import { extractInterfaceOrTypeMeta, extractMetaFromCallable, } from './extractMeta.js';
 import { getLeadingDocDescription, getRelativePathForDisplay, hasJsxInNode, inferCategoryFromPath, isSelectorLike, isTsxFile, snippetForNode, } from './heuristics.js';
+import { parseJsFile } from './babelParser.js';
+/** 判断文件类型 */
+function isJsFile(filePath) {
+    return filePath.endsWith('.js') || filePath.endsWith('.jsx');
+}
+function isTsFile(filePath) {
+    return filePath.endsWith('.ts') || filePath.endsWith('.tsx');
+}
 /**
  * 将 `extractFunctionMeta` 的 `params` 转为组件用的 `props` 名，或保留为 `params`。
  * @returns 供 `IndexedSymbolRow.meta` 序列化入库。
@@ -147,32 +156,51 @@ export async function indexProject(opts) {
     const projectRoot = resolve(opts.projectRoot);
     const patterns = (opts.globPatterns ?? ['src/**/*.{ts,tsx}']).map((p) => p.startsWith('/') ? p : join(projectRoot, p).replace(/\\/g, '/'));
     const ignore = [...DEFAULT_IGNORE, ...(opts.ignore ?? [])];
+    console.error(`[indexProject] patterns: ${patterns.join(', ')}`);
     const files = await fg(patterns, {
         absolute: true,
         ignore,
         onlyFiles: true,
         dot: false,
     });
+    console.error(`[indexProject] found ${files.length} file(s)`);
     if (files.length === 0) {
         return [];
     }
-    const project = new Project({
-        tsConfigFilePath: join(projectRoot, 'tsconfig.json'),
-        skipAddingFilesFromTsConfig: true,
-        skipFileDependencyResolution: true,
-    });
-    project.addSourceFilesAtPaths(files);
+    // 分离 TS/TSX 文件和 JS/JSX 文件
+    const tsFiles = files.filter(isTsFile);
+    const jsFiles = files.filter(isJsFile);
     const out = [];
-    for (const sf of project.getSourceFiles()) {
-        const exported = sf.getExportedDeclarations();
-        for (const [exportName, decls] of exported) {
-            for (const decl of decls) {
-                const row = processDeclaration(exportName, decl, sf, projectRoot);
-                if (row) {
-                    out.push(row);
+    // 处理 TS/TSX 文件
+    if (tsFiles.length > 0) {
+        const project = new Project({
+            tsConfigFilePath: join(projectRoot, 'tsconfig.json'),
+            skipAddingFilesFromTsConfig: true,
+            skipFileDependencyResolution: true,
+        });
+        project.addSourceFilesAtPaths(tsFiles);
+        for (const sf of project.getSourceFiles()) {
+            const exported = sf.getExportedDeclarations();
+            for (const [exportName, decls] of exported) {
+                for (const decl of decls) {
+                    const row = processDeclaration(exportName, decl, sf, projectRoot);
+                    if (row) {
+                        out.push(row);
+                    }
                 }
             }
         }
     }
+    // 处理 JS/JSX 文件
+    for (const file of jsFiles) {
+        try {
+            const content = readFileSync(file, 'utf-8');
+            const rows = parseJsFile(file, content, projectRoot);
+            out.push(...rows);
+        }
+        catch (e) {
+            console.error(`[indexProject] Failed to parse ${file}:`, e);
+        }
+    }
     return out;
 }

package/dist/services/reindex.js

@@ -1,23 +1,27 @@
-import { resolve } from "node:path";
-import { env, validateEnv } from "../config/env.js";
-import { getMySqlPool } from "../db/mysql.js";
-import { indexedRowToEmbedText } from "../indexer/embedText.js";
-import { indexProject } from "../indexer/indexProject.js";
-import { upsertSymbols } from "../indexer/persistSymbols.js";
-import { createEmbeddingClient, embedAll } from "../services/embeddingClient.js";
+import { resolve } from 'node:path';
+import { env, validateEnv } from '../config/env.js';
+import { getMySqlPool } from '../db/mysql.js';
+import { indexedRowToEmbedText } from '../indexer/embedText.js';
+import { indexProject } from '../indexer/indexProject.js';
+import { upsertSymbols } from '../indexer/persistSymbols.js';
+import { createEmbeddingClient, embedAll, } from '../services/embeddingClient.js';
 export async function runReindex(options = {}) {
     validateEnv();
     const pool = getMySqlPool();
+    console.error('[reindex] pool', 'options:', JSON.stringify(options));
     if (!pool || !env.mysqlEnabled) {
-        throw new Error("执行 reindex 前必须开启 MYSQL_ENABLED=true。");
+        console.error('[reindex] pool', pool, env.mysqlEnabled);
+        throw new Error('执行 reindex 前必须开启 MYSQL_ENABLED=true。');
     }
-    await pool.query("SELECT 1");
+    await pool.query('SELECT 1'); // 测试连接，提前捕获常见的连接错误（如拒绝、认证失败、超时等），并给出更友好的提示。
+    console.error('[reindex] MySQL connection successful');
     const projectRoot = resolve(options.projectRoot ?? process.cwd());
     const rows = await indexProject({
         projectRoot,
         globPatterns: options.globPatterns,
-        ignore: options.ignore
+        ignore: options.ignore,
     });
+    console.error(`[reindex] extracted ${rows.length} symbol(s) from ${projectRoot}`);
     let embeddingsComputed = false;
     let embeddingPayload;
     if (!options.dryRun && rows.length > 0 && env.embeddingServiceUrl) {
@@ -29,7 +33,7 @@ export async function runReindex(options = {}) {
             embeddingsComputed = true;
         }
         catch (err) {
-            console.error("[reindex] embedding skipped (service error):", err);
+            console.error('[reindex] embedding skipped (service error):', err);
             embeddingPayload = rows.map(() => null);
         }
     }
@@ -40,6 +44,6 @@ export async function runReindex(options = {}) {
         projectRoot,
         extractedCount: rows.length,
         upserted: !options.dryRun,
-        embeddingsComputed
+        embeddingsComputed,
     };
 }

package/package.json

@@ -1,8 +1,8 @@
 {
     "name": "@lorrylurui/code-intelligence-mcp",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "private": false,
-    "description": "MCP server for code intelligence with symbol search and reusable code recommendation",
+    "description": "MCP server 提供仓库内可复用代码块（ts/tsx/js/jsx/css/less）的索引和查询能力，支持基于代码上下文的智能推荐。",
     "type": "module",
     "main": "dist/index.js",
     "files": [
@@ -25,6 +25,8 @@
         "docker:logs": "docker compose logs -f mysql"
     },
     "dependencies": {
+        "@babel/parser": "^7.29.2",
+        "@babel/types": "^7.29.0",
         "@modelcontextprotocol/sdk": "^1.12.3",
         "@types/react": "^19.2.14",
         "dotenv": "^16.4.5",