frontend-guardian-core 3.0.0 → 3.4.0

package/bin/fg-core.js

@@ -46,6 +46,9 @@ import {
     formatWorkspaceJson,
     AIFixSuggester,
     detectAIConfig,
+    compareHistoryReports,
+    formatHistoryCompare,
+    formatHistoryCompareJson,
 } from "../dist/index.js";
 import pc from "picocolors";
 import { runWatchMode } from "./watch-mode.js";
@@ -78,12 +81,13 @@ const MODULE_RULES = {
 
 function showHelp() {
     console.log(`
-Frontend Guardian Core v3.0.0
+Frontend Guardian Core v3.4.0
 
 Usage:
   fg-core <project-dir> [options]
 
 Options:
+  --scan               全量扫描（等价于 --module all）
   --module <name>      扫描模块: i18n | performance | a11y | security | naming | cross-file | component | hooks | platform | svelte | all
   --severity <level>   最低严重级别: critical | warning | suggestion (默认: suggestion)
   --files <pattern>    仅扫描匹配的文件
@@ -120,6 +124,7 @@ Options:
   --history            查看历史扫描记录
   --history-module <m> 历史记录按模块过滤（配合 --history）
   --history-limit <n>  历史记录显示条数限制（默认 20）
+  --history-compare [c] [p] 对比历史报告：不指定则对比最近两次；指定一个则与该报告对比最近一次；指定两个则对比指定报告
   --generate-dashboard 生成团队趋势看板 HTML 页面
   --monorepo           启用 Monorepo 模式：自动检测 workspace 并扫描所有子包
   --workspace <name>   仅扫描指定 workspace 包（可多次使用，配合 --monorepo）
@@ -185,6 +190,8 @@ async function main() {
         history: false,
         historyModule: undefined,
         historyLimit: 20,
+        historyCompare: false,
+        historyCompareArgs: [],
         generateDashboard: false,
         monorepo: false,
         workspace: [],
@@ -196,6 +203,9 @@ async function main() {
 
     for (let i = 0; i < args.length; i++) {
         switch (args[i]) {
+            case "--scan":
+                options.module = "all";
+                break;
             case "--module":
                 options.module = args[++i];
                 break;
@@ -307,6 +317,13 @@ async function main() {
             case "--history-limit":
                 options.historyLimit = parseInt(args[++i], 10) || 20;
                 break;
+            case "--history-compare":
+                options.historyCompare = true;
+                // 收集后续非 -- 开头的参数作为对比报告引用
+                while (i + 1 < args.length && !args[i + 1].startsWith("-")) {
+                    options.historyCompareArgs.push(args[++i]);
+                }
+                break;
             case "--generate-dashboard":
                 options.generateDashboard = true;
                 break;
@@ -421,6 +438,28 @@ async function main() {
         process.exit(0);
     }
 
+    // v3.1.0: 历史报告对比
+    if (options.historyCompare) {
+        const [currentRef, previousRef] = options.historyCompareArgs;
+        const result = compareHistoryReports({
+            projectDir: options.projectDir,
+            current: currentRef,
+            previous: previousRef,
+        });
+
+        if (!result) {
+            console.log(pc.yellow("⚠️  暂无历史报告可供对比。请先运行 --save-report 生成历史数据。"));
+            process.exit(1);
+        }
+
+        if (options.json) {
+            console.log(JSON.stringify(formatHistoryCompareJson(result), null, 2));
+        } else {
+            console.log(formatHistoryCompare(result));
+        }
+        process.exit(0);
+    }
+
     // v2.8.0: 生成趋势看板
     if (options.generateDashboard) {
         const hr = new HistoryReport(options.projectDir);

package/bin/fg-lsp.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/**
+ * Frontend Guardian LSP Server
+ * Usage: fg-lsp --stdio [--project-dir <dir>] [--config <file>]
+ *
+ * v3.3.0: Language Server Protocol 实现，为 IDE 提供实时诊断和快速修复。
+ */
+
+import { runLSPServer } from "../dist/ide/lsp-server.js";
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+
+const args = process.argv.slice(2);
+
+// 解析参数
+let projectDir = process.cwd();
+let configFile;
+let minSeverity = "suggestion";
+
+for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--project-dir" || arg === "-p") {
+        projectDir = resolve(args[++i] ?? process.cwd());
+    } else if (arg === "--config" || arg === "-c") {
+        configFile = resolve(args[++i] ?? "");
+    } else if (arg === "--severity" || arg === "-s") {
+        minSeverity = args[++i] ?? "suggestion";
+    } else if (arg === "--help" || arg === "-h") {
+        console.log(`Frontend Guardian LSP Server v3.3.0
+
+Usage: fg-lsp [options]
+
+Options:
+  --project-dir, -p <dir>   项目根目录（默认当前目录）
+  --config, -c <file>       配置文件路径
+  --severity, -s <level>    最低严重级别: critical|warning|suggestion（默认 suggestion）
+  --help, -h                显示帮助
+
+Environment:
+  FG_PROJECT_DIR            项目根目录（优先级低于 --project-dir）
+
+Examples:
+  fg-lsp --stdio
+  fg-lsp --project-dir ./my-project --config .frontend-guardian.yml
+`);
+        process.exit(0);
+    }
+}
+
+// 环境变量回退
+if (process.env.FG_PROJECT_DIR && !args.includes("--project-dir") && !args.includes("-p")) {
+    projectDir = resolve(process.env.FG_PROJECT_DIR);
+}
+
+// 验证项目目录
+if (!existsSync(projectDir)) {
+    console.error(`Error: Project directory does not exist: ${projectDir}`);
+    process.exit(1);
+}
+
+// 启动 LSP 服务器
+runLSPServer({
+    projectDir,
+    configFile,
+    minSeverity,
+    debounceMs: 300,
+});

package/dist/engine/cache.d.ts

@@ -6,6 +6,7 @@
  * 2. 缓存持久化到 .frontend-guardian/cache.json
  * 3. 自动过期策略（默认 7 天）
  * 4. 兼容 --staged / --diff 增量模式
+ * 5. v3.2.0: AST 内存缓存 LRU 淘汰策略，防止大项目 OOM
  */
 import type { Issue } from "../types.js";
 export interface CacheEntry {
@@ -35,7 +36,9 @@ export declare class SmartCache {
     private ttl;
     /** v2.1.0: 内存级 AST 缓存（无需持久化，进程内复用） */
     private astCache;
-    constructor(projectDir: string, ttl?: number);
+    /** v3.2.0: AST 缓存最大条目数 */
+    private maxAstCacheSize;
+    constructor(projectDir: string, ttl?: number, maxAstCacheSize?: number);
     /** 计算文件内容哈希 */
     static computeHash(content: string): string;
     /** 检查文件是否已缓存且未过期 */
@@ -56,10 +59,14 @@ export declare class SmartCache {
         valid: number;
         expired: number;
     };
-    /** 获取缓存的 AST（内存级，不持久化） */
+    /** 获取缓存的 AST（内存级，不持久化）— v3.2.0 增加 LRU 淘汰 */
     getAst(filePath: string, content: string): unknown | undefined;
-    /** 缓存 AST 解析结果 */
+    /** 缓存 AST 解析结果 — v3.2.0 增加 LRU 淘汰 */
     setAst(filePath: string, content: string, ast: unknown): void;
+    /** v3.2.0: 获取 AST 缓存当前大小 */
+    getAstCacheSize(): number;
+    /** v3.2.0: 获取 AST 缓存上限 */
+    getAstCacheLimit(): number;
     /** 清理过期缓存 */
     gc(): number;
     /** 加载缓存 manifest */

package/dist/engine/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/engine/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,UAAU;IACvB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,eAAe;IACf,YAAY,EAAE,MAAM,CAAC;CACxB;AAOD,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,GAAG,CAAS;IACpB,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAqD;gBAEzD,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAoB;IAOzD,eAAe;IACf,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAkBpD,kBAAkB;IAClB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,SAAS;IAK1C,eAAe;IACf,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAS7D,aAAa;IACb,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC,uBAAuB;IACvB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASxC,cAAc;IACd,IAAI,IAAI,IAAI;IAWZ,aAAa;IACb,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAkB7D,0BAA0B;IAC1B,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAW9D,kBAAkB;IAClB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IAO7D,aAAa;IACb,EAAE,IAAI,MAAM;IAcZ,oBAAoB;IACpB,OAAO,CAAC,YAAY;CAoBvB"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/engine/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,UAAU;IACvB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,eAAe;IACf,YAAY,EAAE,MAAM,CAAC;CACxB;AASD,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,GAAG,CAAS;IACpB,sCAAsC;IACtC,OAAO,CAAC,QAAQ,CAAqD;IACrE,0BAA0B;IAC1B,OAAO,CAAC,eAAe,CAAS;gBAEpB,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAoB,EAAE,eAAe,CAAC,EAAE,MAAM;IAQnF,eAAe;IACf,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI3C,oBAAoB;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAkBpD,kBAAkB;IAClB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,SAAS;IAK1C,eAAe;IACf,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAS7D,aAAa;IACb,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC,uBAAuB;IACvB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASxC,cAAc;IACd,IAAI,IAAI,IAAI;IAWZ,aAAa;IACb,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAkB7D,4CAA4C;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAiB9D,qCAAqC;IACrC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IAiB7D,4BAA4B;IAC5B,eAAe,IAAI,MAAM;IAIzB,0BAA0B;IAC1B,gBAAgB,IAAI,MAAM;IAI1B,aAAa;IACb,EAAE,IAAI,MAAM;IAcZ,oBAAoB;IACpB,OAAO,CAAC,YAAY;CAoBvB"}

package/dist/engine/cache.js

@@ -7,6 +7,7 @@
  * 2. 缓存持久化到 .frontend-guardian/cache.json
  * 3. 自动过期策略（默认 7 天）
  * 4. 兼容 --staged / --diff 增量模式
+ * 5. v3.2.0: AST 内存缓存 LRU 淘汰策略，防止大项目 OOM
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SmartCache = void 0;
@@ -16,7 +17,9 @@ const node_path_1 = require("node:path");
 /** 缓存默认存活时间（7 天） */
 const DEFAULT_TTL = 7 * 24 * 60 * 60 * 1000;
 /** 引擎版本，规则变更时递增使缓存失效 */
-const ENGINE_VERSION = "2.0.0";
+const ENGINE_VERSION = "3.2.0";
+/** v3.2.0: AST 内存缓存默认最大条目数 */
+const DEFAULT_AST_CACHE_SIZE = 200;
 class SmartCache {
     manifest;
     cacheDir;
@@ -24,10 +27,13 @@ class SmartCache {
     ttl;
     /** v2.1.0: 内存级 AST 缓存（无需持久化，进程内复用） */
     astCache = new Map();
-    constructor(projectDir, ttl = DEFAULT_TTL) {
+    /** v3.2.0: AST 缓存最大条目数 */
+    maxAstCacheSize;
+    constructor(projectDir, ttl = DEFAULT_TTL, maxAstCacheSize) {
         this.cacheDir = (0, node_path_1.resolve)(projectDir, ".frontend-guardian");
         this.cacheFile = (0, node_path_1.resolve)(this.cacheDir, "cache.json");
         this.ttl = ttl;
+        this.maxAstCacheSize = maxAstCacheSize ?? DEFAULT_AST_CACHE_SIZE;
         this.manifest = this.loadManifest();
     }
     /** 计算文件内容哈希 */
@@ -107,7 +113,7 @@ class SmartCache {
         return { total: Object.keys(this.manifest.entries).length, valid, expired };
     }
     // ── v2.1.0: AST 内存缓存 ──────────────────────────────────────────────
-    /** 获取缓存的 AST（内存级，不持久化） */
+    /** 获取缓存的 AST（内存级，不持久化）— v3.2.0 增加 LRU 淘汰 */
     getAst(filePath, content) {
         const cached = this.astCache.get(filePath);
         if (!cached)
@@ -117,15 +123,35 @@ class SmartCache {
             this.astCache.delete(filePath);
             return undefined;
         }
+        // v3.2.0: LRU — 访问后移到末尾（最新）
+        this.astCache.delete(filePath);
+        this.astCache.set(filePath, cached);
         return cached.ast;
     }
-    /** 缓存 AST 解析结果 */
+    /** 缓存 AST 解析结果 — v3.2.0 增加 LRU 淘汰 */
     setAst(filePath, content, ast) {
+        // v3.2.0: 超出上限时淘汰最久未访问的条目（Map 头部）
+        if (this.astCache.size >= this.maxAstCacheSize && !this.astCache.has(filePath)) {
+            const firstKey = this.astCache.keys().next().value;
+            if (firstKey) {
+                this.astCache.delete(firstKey);
+            }
+        }
+        // 删除旧条目（如果存在），然后重新插入到末尾（最新）
+        this.astCache.delete(filePath);
         this.astCache.set(filePath, {
             hash: SmartCache.computeHash(content),
             ast,
         });
     }
+    /** v3.2.0: 获取 AST 缓存当前大小 */
+    getAstCacheSize() {
+        return this.astCache.size;
+    }
+    /** v3.2.0: 获取 AST 缓存上限 */
+    getAstCacheLimit() {
+        return this.maxAstCacheSize;
+    }
     /** 清理过期缓存 */
     gc() {
         const now = Date.now();

package/dist/engine/cache.js.map

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

package/dist/engine/rule-engine.d.ts

@@ -44,6 +44,8 @@ export interface EngineOptions {
     skipLargeFilesThreshold?: number;
     /** v2.6.0: 外部传入的 SmartCache 实例（用于 Watch 模式复用缓存） */
     cacheInstance?: SmartCache;
+    /** v3.2.0: 增量扫描时通过 import 图分析扩展扫描范围（变更文件及其依赖方） */
+    incrementalImportGraph?: boolean;
 }
 export declare class RuleEngine {
     private registry;
@@ -74,6 +76,14 @@ export declare class RuleEngine {
     private moduleToCategory;
     /** 执行扫描 */
     scan(module: string): Promise<ScanResult>;
+    /**
+     * v3.3.0: 公共单文件扫描方法（用于 IDE 增量诊断）
+     * 快速扫描单个文件，返回所有匹配的 issues
+     * @param filePath 文件绝对路径
+     * @param module 模块名（可选，用于规则过滤）
+     * @returns 扫描发现的 issues
+     */
+    scanSingleFile(filePath: string, module?: string): Promise<Issue[]>;
     /** 扫描单个文件（带智能缓存 + 大文件跳过） */
     private scanFile;
     /** 获取扫描文件列表 */
@@ -82,6 +92,26 @@ export declare class RuleEngine {
     private getDiffFiles;
     /** 智能推断扫描范围：未提交修改 → 最近 5 次提交 → 全量 */
     private getAutoScopeFiles;
+    /**
+     * 构建项目的 import 图（简化版）
+     * 对于每个文件，解析其 import 语句，建立双向映射：
+     * - importMap: file → 它导入的文件集合
+     * - reverseMap: file → 导入它的文件集合
+     *
+     * 简化策略：只解析相对路径 import（./ 或 ../），不解析 node_modules。
+     * 因为增量扫描的核心场景是：修改一个内部模块后，哪些文件会受影响。
+     */
+    private buildImportGraph;
+    /**
+     * 基于 import 图扩展增量扫描文件列表
+     * 除变更文件本身外，还扫描所有导入这些文件的文件（上游依赖方）。
+     *
+     * 原理：如果 A 被 B import，A 修改后 B 的语义可能变化（如 A 导出的类型、常量变更）。
+     * 因此 B 也需要重新扫描。
+     */
+    private expandIncrementalFiles;
+    /** 同步获取项目内所有源文件（用于 import 图构建） */
+    private getAllSourceFilesSync;
     /** 创建 RuleUtils */
     private createUtils;
     /** 计算每行起始偏移 */

package/dist/engine/rule-engine.d.ts.map

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

package/dist/engine/rule-engine.js

@@ -136,8 +136,8 @@ class RuleEngine {
         const files = await this.getScanFiles();
         let filesWithIssues = 0;
         console.log(picocolors_1.default.blue(`🔍 [${module}] 扫描 ${files.length} 个文件，${activeRules.length} 条规则...`));
-        // v2.1.0: 受控并发并行扫描
-        const concurrency = this.options.concurrency ?? (0, concurrent_js_1.getDefaultConcurrency)();
+        // v3.2.0: 自适应并发 — 根据文件数、规则数和 CPU 动态调整
+        const concurrency = this.options.concurrency ?? (0, concurrent_js_1.getAdaptiveConcurrency)(files.length, activeRules.length);
         const fileResults = await (0, concurrent_js_1.concurrentMap)(files, concurrency, (file) => this.scanFile(file, activeRules));
         let filesSkipped = 0;
         for (const { issues: fileIssues, skipped } of fileResults) {
@@ -189,6 +189,28 @@ class RuleEngine {
         }
         return result;
     }
+    /**
+     * v3.3.0: 公共单文件扫描方法（用于 IDE 增量诊断）
+     * 快速扫描单个文件，返回所有匹配的 issues
+     * @param filePath 文件绝对路径
+     * @param module 模块名（可选，用于规则过滤）
+     * @returns 扫描发现的 issues
+     */
+    async scanSingleFile(filePath, module) {
+        const category = module ? this.moduleToCategory(module) : undefined;
+        const activeRules = category
+            ? this.filterRules({
+                category,
+                framework: this.projectMeta.framework,
+                platform: this.projectMeta.platforms[0],
+                componentLib: this.projectMeta.componentLib,
+            })
+            : this.getRules();
+        if (activeRules.length === 0)
+            return [];
+        const result = await this.scanFile(filePath, activeRules);
+        return result.issues;
+    }
     /** 扫描单个文件（带智能缓存 + 大文件跳过） */
     async scanFile(filePath, rules) {
         try {
@@ -264,7 +286,15 @@ class RuleEngine {
             }
             // 过滤出符合扩展名的文件
             const include = this.config.scan?.includeExtensions || [".js", ".ts", ".jsx", ".tsx", ".vue"];
-            const filtered = diffFiles.filter((f) => include.some((ext) => f.endsWith(ext)));
+            let filtered = diffFiles.filter((f) => include.some((ext) => f.endsWith(ext)));
+            // v3.2.0: 通过 import 图分析扩展扫描范围
+            if (this.options.incrementalImportGraph !== false && filtered.length > 0 && filtered.length < 500) {
+                const expanded = this.expandIncrementalFiles(filtered, include);
+                if (expanded.length > filtered.length) {
+                    console.log(picocolors_1.default.cyan(`   📎 import 图扩展: ${filtered.length} → ${expanded.length} 个文件`));
+                    filtered = expanded;
+                }
+            }
             if (this.options.autoScope && filtered.length > 0) {
                 console.log(picocolors_1.default.cyan(`🔍 智能扫描范围: ${filtered.length} 个文件`));
             }
@@ -367,6 +397,132 @@ class RuleEngine {
             return [];
         }
     }
+    // ──────────────────────────────────────────────────────────────────────────
+    // v3.2.0: 增量扫描 import 图分析
+    // ──────────────────────────────────────────────────────────────────────────
+    /**
+     * 构建项目的 import 图（简化版）
+     * 对于每个文件，解析其 import 语句，建立双向映射：
+     * - importMap: file → 它导入的文件集合
+     * - reverseMap: file → 导入它的文件集合
+     *
+     * 简化策略：只解析相对路径 import（./ 或 ../），不解析 node_modules。
+     * 因为增量扫描的核心场景是：修改一个内部模块后，哪些文件会受影响。
+     */
+    buildImportGraph(files) {
+        const importMap = new Map();
+        const reverseMap = new Map();
+        for (const file of files) {
+            importMap.set(file, new Set());
+        }
+        for (const file of files) {
+            try {
+                const source = (0, node_fs_1.readFileSync)(file, "utf-8");
+                // 简单正则提取相对路径 import（不依赖 AST，速度更快）
+                const importRegex = /import\s+.*?\s+from\s+['"](\.\.?\/[^'"]+)['"]|import\s*\(\s*['"](\.\.?\/[^'"]+)['"]\s*\)/g;
+                let match;
+                while ((match = importRegex.exec(source)) !== null) {
+                    const importPath = match[1] || match[2];
+                    if (!importPath)
+                        continue;
+                    // 解析相对路径为绝对路径
+                    const { resolve: pathResolve, dirname } = require("node:path");
+                    let resolved = pathResolve(dirname(file), importPath);
+                    // 尝试补充扩展名
+                    const exts = [".ts", ".tsx", ".js", ".jsx", ".vue"];
+                    let found = false;
+                    for (const ext of exts) {
+                        if (files.includes(resolved + ext)) {
+                            resolved = resolved + ext;
+                            found = true;
+                            break;
+                        }
+                        // 支持目录下的 index 文件
+                        if (files.includes(pathResolve(resolved, "index" + ext))) {
+                            resolved = pathResolve(resolved, "index" + ext);
+                            found = true;
+                            break;
+                        }
+                    }
+                    if (found) {
+                        importMap.get(file)?.add(resolved);
+                        if (!reverseMap.has(resolved)) {
+                            reverseMap.set(resolved, new Set());
+                        }
+                        reverseMap.get(resolved).add(file);
+                    }
+                }
+            }
+            catch {
+                // 读取失败则跳过
+            }
+        }
+        return { importMap, reverseMap };
+    }
+    /**
+     * 基于 import 图扩展增量扫描文件列表
+     * 除变更文件本身外，还扫描所有导入这些文件的文件（上游依赖方）。
+     *
+     * 原理：如果 A 被 B import，A 修改后 B 的语义可能变化（如 A 导出的类型、常量变更）。
+     * 因此 B 也需要重新扫描。
+     */
+    expandIncrementalFiles(changedFiles, includeExts) {
+        try {
+            // 1. 获取项目内所有候选文件（用于构建 import 图）
+            const allFiles = this.getAllSourceFilesSync(includeExts);
+            if (allFiles.length > 5000) {
+                // 超大项目：import 图构建成本高，跳过扩展
+                return changedFiles;
+            }
+            // 2. 构建 import 图
+            const { reverseMap } = this.buildImportGraph(allFiles);
+            // 3. 收集变更文件及其所有导入方
+            const expanded = new Set(changedFiles);
+            const queue = [...changedFiles];
+            const visited = new Set(changedFiles);
+            while (queue.length > 0) {
+                const current = queue.shift();
+                const importers = reverseMap.get(current);
+                if (!importers)
+                    continue;
+                for (const importer of importers) {
+                    if (!visited.has(importer)) {
+                        visited.add(importer);
+                        expanded.add(importer);
+                        queue.push(importer);
+                    }
+                }
+            }
+            return Array.from(expanded);
+        }
+        catch {
+            return changedFiles;
+        }
+    }
+    /** 同步获取项目内所有源文件（用于 import 图构建） */
+    getAllSourceFilesSync(includeExts) {
+        try {
+            const { globbySync } = require("globby");
+            const patterns = includeExts.map((ext) => `**/*${ext}`);
+            const exclude = [
+                "**/node_modules/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/.git/**",
+                "**/coverage/**",
+                ...(this.options.exclude || []),
+                ...(this.config.scan?.excludeDirs?.map((d) => `**/${d}/**`) || []),
+            ];
+            return globbySync(patterns, {
+                cwd: this.options.projectDir,
+                ignore: exclude,
+                absolute: true,
+            });
+        }
+        catch {
+            return [];
+        }
+    }
     /** 创建 RuleUtils */
     createUtils(filePath, source) {
         const lineOffsets = this.computeLineOffsets(source);