@lorrylurui/code-intelligence-mcp 1.1.0 → 1.1.2

package/dist/cli/detect-duplicates.js

@@ -5,22 +5,20 @@
  * 策略：
  * - 只分析 changed files 中可索引的导出代码块
  * - 与库内同 type 的存量代码块做语义相似度（cosine）匹配
- * - 对 component：要求 newProps 是 oldProps 的超集（或至少覆盖大部分）才判定为“重复/可合并”
+ * - 对 component：要求 newProps 是 oldProps 的超集（或至少覆盖大部分）才判定为"重复/可合并"
  *
  * 输出：
  * - duplicate-report.json
  * - duplicate-report.md（中文，适合 PR 评论）
  */
-import { readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import dotenv from 'dotenv';
-import { env, validateEnv } from '../config/env.js';
+import { env, loadProjectDotenv, validateEnv } from '../config/env.js';
 import { getMySqlPool } from '../db/mysql.js';
 import { indexedRowToEmbedText } from '../indexer/embedText.js';
 import { indexProject } from '../indexer/indexProject.js';
 import { createEmbeddingClient, embedAll, } from '../services/embeddingClient.js';
 import { cosineSimilarity } from '../services/vectorMath.js';
-dotenv.config();
 function parseArgs(argv) {
     const args = new Map();
     for (let i = 0; i < argv.length; i++) {
@@ -89,6 +87,31 @@ function escapeMd(text) {
     return text.replace(/\|/g, '\\|');
 }
 async function main() {
+    // 1️ 确定项目根目录
+    const projectRoot = resolve(process.env.INDEX_ROOT ?? process.cwd());
+    // 2️ 加载环境变量：先本地默认值，再第三方覆盖
+    const localEnvPath = resolve(process.cwd(), '.env');
+    if (existsSync(localEnvPath)) {
+        const content = readFileSync(localEnvPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx === -1)
+                continue;
+            const key = trimmed.slice(0, eqIdx).trim();
+            let value = trimmed.slice(eqIdx + 1).trim();
+            value = value.replace(/^["']|["']$/g, '');
+            if (key && process.env[key] === undefined) {
+                process.env[key] = value;
+            }
+        }
+    }
+    loadProjectDotenv(projectRoot);
+    console.error(`[duplicate-check] projectRoot=${projectRoot}, ` +
+        `MYSQL_ENABLED=${process.env.MYSQL_ENABLED}`);
+    // 3️ 解析命令行参数
     const args = parseArgs(process.argv.slice(2));
     const changedFilesPath = args.get('changed-files') ?? 'changed_files.txt';
     const outJson = args.get('out-json') ?? 'duplicate-report.json';
@@ -118,7 +141,6 @@ async function main() {
     }
     // Type narrowing for TS (pool is guaranteed non-null after guards above)
     const mysqlPool = isMockMode ? null : getMySqlPool();
-    const projectRoot = resolve(process.cwd());
     const changed = readLines(changedFilesPath)
         .filter((p) => p.endsWith('.ts') || p.endsWith('.tsx'))
         .filter((p) => !p.includes('/node_modules/') && !p.includes('/dist/'));

package/dist/cli/index-codebase.js

@@ -1,25 +1,53 @@
 #!/usr/bin/env node
 /**
  * Phase 2 CLI：扫描代码库并写入 MySQL `symbols`（需 `MYSQL_ENABLED=true`）。
+ *
+ * 环境变量加载顺序：
+ * 1. 命令行参数（最高优先级）
+ * 2. INDEX_ROOT 指向的第三方项目 .env（中等优先级，优先使用第三方显式设置的值）
+ * 3. 本地的 .env（最低优先级，提供默认值）
  */
 import { resolve } from 'node:path';
-import dotenv from 'dotenv';
+import { existsSync, readFileSync } from 'node:fs';
+import { loadProjectDotenv } from '../config/env.js';
 import { runReindex } from '../services/reindex.js';
-dotenv.config();
 /**
- * 入口：校验环境 → 连接池 → 按 `INDEX_*` 调用 `indexProject` → `upsertSymbols`。
- * 进度与统计输出到 **stderr**，避免占用 stdout（与 MCP 混用时更安全）。
+ * 入口：加载第三方 .env → 校验环境 → 调用 runReindex。
+ * 进度与统计输出到 **stderr**，避免占用 stdout。
  * 进程退出码：成功 `0`，无 MySQL 或异常 `1`。
  */
 async function main() {
+    // 1️ 先加载本地 .env（提供默认值）
+    const localEnvPath = resolve(process.cwd(), '.env');
+    if (existsSync(localEnvPath)) {
+        const content = readFileSync(localEnvPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx === -1)
+                continue;
+            const key = trimmed.slice(0, eqIdx).trim();
+            let value = trimmed.slice(eqIdx + 1).trim();
+            value = value.replace(/^["']|["']$/g, '');
+            if (key && process.env[key] === undefined) {
+                process.env[key] = value;
+            }
+        }
+    }
+    // 2️ 确定项目根目录并加载第三方 .env（仅覆盖未定义的变量）
     const projectRoot = resolve(process.env.INDEX_ROOT ?? process.cwd());
+    loadProjectDotenv(projectRoot);
+    console.error(`[index] projectRoot=${projectRoot}`);
+    console.error(`[index] MYSQL_ENABLED=${process.env.MYSQL_ENABLED}, ` +
+        `MYSQL_HOST=${process.env.MYSQL_HOST}`);
     const globPatterns = process.env.INDEX_GLOB
         ? 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())
         : undefined;
-    console.error(`[index] projectRoot=${projectRoot}`);
     const result = await runReindex({
         projectRoot,
         globPatterns,

package/dist/config/env.js

@@ -16,14 +16,32 @@ dotenv.config({
     path: path.resolve(projectRoot, '.env'),
     override: false,
 });
-// 尝试从第三方项目目录加载 .env，按变量维度覆盖（只覆盖第三方明确配置的变量）
-const clientProjectRoot = process.env.INDEX_ROOT || process.cwd();
-const clientEnvPath = path.resolve(clientProjectRoot, '.env');
-if (existsSync(clientEnvPath)) {
-    console.error(`[Config] Merging .env from client project root: ${clientProjectRoot}`);
-    // 手动解析第三方 .env，只覆盖其明确配置的变量
-    const clientEnvContent = readFileSync(clientEnvPath, 'utf-8');
-    for (const line of clientEnvContent.split('\n')) {
+/**
+ * 从指定项目根目录加载 .env 到 process.env
+ * 行为：优先使用第三方显式设置的值，否则保留 MCP Server 本地配置
+ */
+export function loadProjectDotenv(projectRoot) {
+    const envPath = path.resolve(projectRoot, '.env');
+    if (!existsSync(envPath)) {
+        return;
+    }
+    const content = readFileSync(envPath, 'utf-8');
+    // 第一步：收集第三方 .env 中所有显式定义的 key
+    const thirdPartyKeys = new Set();
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        if (!key)
+            continue;
+        thirdPartyKeys.add(key);
+    }
+    // 第二步：如果某个 key 是第三方显式定义的，则覆盖（不管值是什么）
+    for (const line of content.split('\n')) {
         const trimmed = line.trim();
         if (!trimmed || trimmed.startsWith('#'))
             continue;
@@ -31,14 +49,19 @@ if (existsSync(clientEnvPath)) {
         if (eqIdx === -1)
             continue;
         const key = trimmed.slice(0, eqIdx).trim();
-        const value = trimmed.slice(eqIdx + 1).trim();
-        // 移除引号
-        const cleanValue = value.replace(/^["']|["']$/g, '');
-        if (key) {
-            process.env[key] = cleanValue;
+        let value = trimmed.slice(eqIdx + 1).trim();
+        value = value.replace(/^["']|["']$/g, '');
+        if (!key)
+            continue;
+        // 只有当第三方显式定义了这个 key 时才覆盖
+        if (thirdPartyKeys.has(key)) {
+            process.env[key] = value;
         }
     }
 }
+// 尝试从第三方项目目录加载 .env，按变量维度覆盖（只覆盖第三方明确配置的变量）
+const clientProjectRoot = process.env.INDEX_ROOT || process.cwd();
+loadProjectDotenv(clientProjectRoot);
 // 外部传入的 env 已在上一步保留，这里确保环境变量已正确设置
 for (const arg of process.argv) {
     const match = arg.match(/^--([A-Z_][A-Z0-9_]*)=(.+)$/);

package/dist/services/reindex.js

@@ -1,21 +1,34 @@
 import { resolve } from 'node:path';
-import { env, validateEnv } from '../config/env.js';
+import { loadProjectDotenv, 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) {
-        console.error('[reindex] pool', pool, env.mysqlEnabled);
-        throw new Error('执行 reindex 前必须开启 MYSQL_ENABLED=true。');
-    }
-    await pool.query('SELECT 1'); // 测试连接，提前捕获常见的连接错误（如拒绝、认证失败、超时等），并给出更友好的提示。
-    console.error('[reindex] MySQL connection successful');
     const projectRoot = resolve(options.projectRoot ?? process.cwd());
+    const { dryRun = false } = options;
+    // 1️ 加载第三方 .env：只覆盖未定义的变量 → 保留 MCP Server 自身配置
+    loadProjectDotenv(projectRoot);
+    // 2️ 打印生效的环境变量（便于调试）
+    console.error(`[reindex] projectRoot=${projectRoot}, dryRun=${dryRun}, ` +
+        `MYSQL_ENABLED=${process.env.MYSQL_ENABLED}, ` +
+        `MYSQL_HOST=${process.env.MYSQL_HOST}`);
+    // 3️⃣ 只有需要写入数据库时才检查 MySQL 并建立连接
+    // 注意：直接检查 process.env，因为 env.mysqlEnabled 是模块加载时计算的，不会反映 loadProjectDotenv 的更新
+    const mysqlEnabled = process.env.MYSQL_ENABLED === 'true';
+    const embeddingServiceUrl = process.env.EMBEDDING_SERVICE_URL;
+    let pool = null;
+    if (!dryRun) {
+        if (!mysqlEnabled) {
+            throw new Error('执行 reindex 写入数据库需要 MYSQL_ENABLED=true。' +
+                '第三方项目可在 .env 中配置此变量（未配置则使用 MCP Server 本地配置）。');
+        }
+        validateEnv();
+        pool = getMySqlPool();
+        await pool.query('SELECT 1'); // 测试连接
+        console.error('[reindex] MySQL connection successful');
+    }
     const rows = await indexProject({
         projectRoot,
         globPatterns: options.globPatterns,
@@ -24,9 +37,9 @@ export async function runReindex(options = {}) {
     console.error(`[reindex] extracted ${rows.length} symbol(s) from ${projectRoot}`);
     let embeddingsComputed = false;
     let embeddingPayload;
-    if (!options.dryRun && rows.length > 0 && env.embeddingServiceUrl) {
+    if (!options.dryRun && rows.length > 0 && embeddingServiceUrl) {
         try {
-            const client = createEmbeddingClient(env.embeddingServiceUrl);
+            const client = createEmbeddingClient(embeddingServiceUrl);
             const texts = rows.map(indexedRowToEmbedText);
             const vecs = await embedAll(client, texts);
             embeddingPayload = vecs;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lorrylurui/code-intelligence-mcp",
-    "version": "1.1.0",
+    "version": "1.1.2",
     "private": false,
     "description": "MCP server 提供仓库内可复用代码块（ts/tsx/js/jsx/css/less）的索引和查询能力，支持基于代码上下文的智能推荐。",
     "type": "module",