spectra-cli 4.1.1 → 4.2.0

package/dist/cli/commands/index.js

@@ -0,0 +1,274 @@
+/**
+ * Feature 156 — `spectra index` 子命令 handler。
+ *
+ * 三种运行模式（W3 阶段全部实装）：
+ *   spectra index               → 全量索引：扫描全部源文件 → buildUnifiedGraph →
+ *                                  写入 .spectra/unified-graph.json（FR-11 / AC-9）
+ *   spectra index --incremental → 一次性增量更新（FR-30 + buildIncremental 路径）
+ *   spectra index --watch       → 持续监听模式（FR-12 + FileWatcher + buildIncremental 批量路径）
+ *   spectra index --caller-depth N → 默认 1，clarify Q3 决议（接口预留 N）
+ *
+ * 进度输出（FR-14 SHOULD）：每个阶段输出一行机器可读 JSON（`scan` / `build` /
+ * `save` / `done` / `diff` / `caller-expand` / `watch` / `fallback`），方便上游脚本用 `jq` 提取关键字段。
+ *
+ * --watch 与 --incremental 互斥（FR-30）：两个 flag 同时传入 → 错误 + exit 1。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { scanFiles } from '../../utils/file-scanner.js';
+import { LanguageAdapterRegistry } from '../../adapters/language-adapter-registry.js';
+import { analyzeFile } from '../../core/ast-analyzer.js';
+import { buildUnifiedGraph } from '../../knowledge-graph/index.js';
+import { buildSnapshotWrapper, computeAllFileHashes, saveSnapshot, snapshotPath, } from '../../knowledge-graph/persistence.js';
+import { buildIncremental } from '../../knowledge-graph/incremental.js';
+import { FileWatcher } from '../../watcher/file-watcher.js';
+const INDEX_HELP = `spectra index — 构建并持久化 UnifiedGraph snapshot
+
+用法:
+  spectra index                       全量索引（扫描所有源文件 + 写 .spectra/unified-graph.json）
+  spectra index --incremental         一次性增量更新（基于 git diff + caller expansion）
+  spectra index --watch               持续监听模式（chokidar + 批量 incremental，进程不退出）
+  spectra index --caller-depth <N>    增量 caller 扩展深度（默认 1，接口预留 N）
+  spectra index --git-range <ref>     post-commit hook 上下文的 git ref 范围（默认 'HEAD'，
+                                       仅 --incremental 时生效；仅允许预设格式如 'ORIG_HEAD HEAD'）
+  spectra index --project-root <dir>  指定项目根目录（默认 cwd）
+
+说明:
+  --watch 与 --incremental 互斥；同时传入将导致 exit 1。
+  --watch 模式监听 .gitignore 之外的源码文件（chokidar v4 + .gitignore 过滤）。
+  --incremental 在无 snapshot / shallow clone 等场景自动降级为全量索引（仍 exit 0）。
+
+输出:
+  {project-root}/.spectra/unified-graph.json    (pretty JSON，含 SnapshotWrapperSchema)
+
+退出码:
+  0  成功（含 --watch 用户 Ctrl+C / --incremental 降级 full）
+  1  --watch 与 --incremental 互斥参数冲突，或 --project-root 不存在
+  2  索引失败（文件读写 / AST 解析错误）`;
+/** 输出一行机器可读 JSON 进度（FR-14） */
+function emit(line) {
+    process.stdout.write(`${JSON.stringify(line)}\n`);
+}
+/**
+ * 执行 spectra index 子命令。
+ *
+ * @param command 已解析的 CLICommand
+ */
+export async function runIndexCommand(command) {
+    if (command.help) {
+        console.log(INDEX_HELP);
+        return;
+    }
+    // FR-30：--watch 与 --incremental 互斥
+    if (command.indexWatch && command.indexIncremental) {
+        console.error('[index] --watch 与 --incremental 互斥，不能同时传入');
+        process.exitCode = 1;
+        return;
+    }
+    // 默认值 = 1（FR-7 / clarify Q3）
+    const callerDepth = command.indexCallerDepth ?? 1;
+    const projectRoot = path.resolve(command.projectRoot ?? process.cwd());
+    if (!fs.existsSync(projectRoot)) {
+        console.error(`[index] 项目目录不存在: ${projectRoot}`);
+        process.exitCode = 2;
+        return;
+    }
+    // ── --watch 模式（持续监听）──
+    if (command.indexWatch) {
+        await runWatchMode(projectRoot, callerDepth);
+        return;
+    }
+    // ── --incremental 模式（一次性增量）──
+    if (command.indexIncremental) {
+        await runIncrementalOnce(projectRoot, callerDepth, command.indexGitRange);
+        return;
+    }
+    // ── 默认：全量索引 ──
+    await runFullIndex(projectRoot);
+}
+// ───────────────────────────────────────────────────────────
+// 全量索引（保持 W2 行为不变）
+// ───────────────────────────────────────────────────────────
+async function runFullIndex(projectRoot) {
+    const t0 = Date.now();
+    try {
+        const registry = LanguageAdapterRegistry.getInstance();
+        const supportedExts = registry.getSupportedExtensions();
+        const scanResult = scanFiles(projectRoot, {
+            projectRoot,
+            extensions: supportedExts,
+        });
+        const absFiles = scanResult.files.map((rel) => path.isAbsolute(rel) ? rel : path.join(projectRoot, rel));
+        emit({ phase: 'scan', files: absFiles.length });
+        if (absFiles.length === 0) {
+            emit({ phase: 'skip', reason: 'no-source-files' });
+        }
+        const tBuild0 = Date.now();
+        const codeSkeletons = new Map();
+        for (const absFile of absFiles) {
+            try {
+                const sk = await analyzeFile(absFile, { projectRoot });
+                if (sk)
+                    codeSkeletons.set(absFile, sk);
+            }
+            catch (err) {
+                console.error(`[index] analyzeFile 失败 (${absFile}): ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        const graph = buildUnifiedGraph({ projectRoot, codeSkeletons });
+        emit({
+            phase: 'build',
+            duration_ms: Date.now() - tBuild0,
+            nodes: graph.nodes.length,
+            edges: graph.edges.length,
+        });
+        const fileHashes = await computeAllFileHashes(projectRoot, absFiles);
+        const tSave0 = Date.now();
+        const snapshot = buildSnapshotWrapper(graph, fileHashes);
+        await saveSnapshot(snapshot, projectRoot);
+        const targetPath = snapshotPath(projectRoot);
+        let sizeBytes = 0;
+        try {
+            sizeBytes = fs.statSync(targetPath).size;
+        }
+        catch {
+            /* 文件应该存在，仅统计用 */
+        }
+        emit({
+            phase: 'save',
+            path: path.relative(projectRoot, targetPath),
+            size_bytes: sizeBytes,
+            duration_ms: Date.now() - tSave0,
+        });
+        emit({
+            phase: 'done',
+            mode: 'full',
+            total_ms: Date.now() - t0,
+            changedFiles: -1,
+        });
+    }
+    catch (err) {
+        console.error(`[index] 索引失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 2;
+    }
+}
+// ───────────────────────────────────────────────────────────
+// --incremental 一次性增量
+// ───────────────────────────────────────────────────────────
+async function runIncrementalOnce(projectRoot, callerDepth, gitRange) {
+    const t0 = Date.now();
+    try {
+        const tBuild0 = Date.now();
+        const result = await buildIncremental({ projectRoot, callerDepth, gitRange });
+        if (result.fallbackToFull) {
+            // 输出 fallback 信号，但保持 exit 0（git hook 兼容）
+            emit({ phase: 'fallback', reason: result.fallbackReason ?? 'unknown' });
+        }
+        else {
+            // W3 WARN-3：'diff' 输出原始 git diff 数；'caller-expand' 输出"扩展数"（差值）
+            emit({ phase: 'diff', changedFiles: result.origChangedFilesCount });
+            emit({
+                phase: 'caller-expand',
+                expanded: Math.max(0, result.changedFiles.length - result.origChangedFilesCount),
+            });
+        }
+        emit({
+            phase: 'build',
+            duration_ms: Date.now() - tBuild0,
+            nodes: result.snapshot.graph.nodes.length,
+            edges: result.snapshot.graph.edges.length,
+        });
+        const targetPath = snapshotPath(projectRoot);
+        let sizeBytes = 0;
+        try {
+            sizeBytes = fs.statSync(targetPath).size;
+        }
+        catch {
+            /* 空 diff 短路时未触发写盘也算正常 */
+        }
+        emit({
+            phase: 'save',
+            path: path.relative(projectRoot, targetPath),
+            size_bytes: sizeBytes,
+        });
+        // spec AC-4：第二次无变更时输出 skippedReason: 'no-diff' 让消费方区分"真无变更"vs "fallback"
+        const isNoDiff = !result.fallbackToFull && result.changedFiles.length === 0;
+        emit({
+            phase: 'done',
+            mode: 'incremental',
+            total_ms: Date.now() - t0,
+            changedFiles: result.changedFiles.length,
+            fallbackToFull: result.fallbackToFull,
+            ...(isNoDiff ? { skippedReason: 'no-diff' } : {}),
+        });
+    }
+    catch (err) {
+        console.error(`[index] 增量索引失败: ${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 2;
+    }
+}
+// ───────────────────────────────────────────────────────────
+// --watch 持续监听
+// ───────────────────────────────────────────────────────────
+async function runWatchMode(projectRoot, callerDepth) {
+    // 启动前先确保有一份 baseline snapshot：若不存在则跑一次全量
+    const baselinePath = snapshotPath(projectRoot);
+    if (!fs.existsSync(baselinePath)) {
+        emit({ phase: 'watch', event: 'baseline-missing-running-full' });
+        await runFullIndex(projectRoot);
+    }
+    // FileWatcher 内部处理 debounce + .gitignore 过滤；W3 用 200ms（clarify Q-D1 决议）
+    const watcher = new FileWatcher({
+        projectRoot,
+        debounceMs: 200,
+        verbose: false,
+    }, async (events) => {
+        // WARN-1 关闭：events 是批量数组，需聚合 path 并过滤 category === 'code'
+        const changedPaths = new Set(events.filter((e) => e.category === 'code').map((e) => e.path));
+        if (changedPaths.size === 0)
+            return;
+        const tInc0 = Date.now();
+        try {
+            const result = await buildIncremental({
+                projectRoot,
+                callerDepth,
+                changedFilesOverride: Array.from(changedPaths),
+            });
+            if (result.fallbackToFull) {
+                emit({
+                    phase: 'fallback',
+                    reason: result.fallbackReason ?? 'unknown',
+                    context: 'watch',
+                });
+            }
+            emit({
+                phase: 'watch',
+                changedFiles: changedPaths.size,
+                expandedFiles: result.changedFiles.length,
+                duration_ms: Date.now() - tInc0,
+            });
+        }
+        catch (err) {
+            console.error(`[index] watch incremental 失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+    await watcher.start();
+    emit({ phase: 'watch-ready', projectRoot });
+    // SIGINT / SIGTERM 优雅退出
+    await new Promise((resolve) => {
+        const shutdown = async (signal) => {
+            emit({ phase: 'watch', event: 'shutdown', signal });
+            try {
+                await watcher.stop();
+            }
+            catch {
+                /* 忽略关闭错误 */
+            }
+            resolve();
+        };
+        process.once('SIGINT', () => void shutdown('SIGINT'));
+        process.once('SIGTERM', () => void shutdown('SIGTERM'));
+    });
+    // exit code = 0（用户主动 Ctrl+C 视为正常退出）
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/index.js.map

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

package/dist/cli/commands/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA4BzD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDxE"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA4BzD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDxE"}

package/dist/cli/commands/query.js

@@ -57,9 +57,11 @@ export async function runQueryCommand(command) {
         return;
     }
     // 加载图谱并执行查询
+    // F170e：透传 process.cwd() 作为 projectRoot（与 graphPath 同源），
+    // 让 engine 内部文件定位与 CLI 运行目录一致。
     let engine;
     try {
-        engine = GraphQueryEngine.loadFromFile(graphPath);
+        engine = GraphQueryEngine.loadFromFile(graphPath, process.cwd());
     }
     catch (err) {
         console.error(`[query] 加载图谱失败：${err instanceof Error ? err.message : String(err)}`);

package/dist/cli/commands/query.js.map

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

package/dist/cli/index.js

@@ -24,9 +24,8 @@ import { runQueryCommand } from './commands/query.js';
 import { runInstall } from './commands/install.js';
 import { runExportCommand } from './commands/export.js';
 import { runDirectionAuditCommand } from './commands/direction-audit.js';
-import { bootstrapAdapters } from '../adapters/index.js';
-import { bootstrapGenerators } from '../panoramic/generator-registry.js';
-import { bootstrapParsers } from '../panoramic/parser-registry.js';
+import { runIndexCommand } from './commands/index.js';
+import { bootstrapRuntime } from '../runtime-bootstrap.js';
 // 读取 package.json 版本号
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkgPath = resolve(__dirname, '..', '..', 'package.json');
@@ -53,6 +52,7 @@ const HELP_TEXT = `spectra — 代码逆向工程 Spec 生成工具 v${version}
   spectra direction-audit [--graph <path>] [--output <path>] [--format json|text]
   spectra direction-audit --snapshot <path>
   spectra direction-audit --compare-snapshot <path>
+  spectra index [--watch] [--incremental] [--caller-depth <N>] [--project-root <dir>]
   spectra mcp-server
   spectra --version / --help
 
@@ -72,6 +72,7 @@ const HELP_TEXT = `spectra — 代码逆向工程 Spec 生成工具 v${version}
   install       安装/卸载 Claude Code PreToolUse hook 和 git post-commit hook（≠ init：init = skill 安装，install = hook 安装）
   export        将知识图谱导出为 Obsidian Vault 或 HTML 交互式可视化
   direction-audit 依赖方向自查工具（SC-006 CI regression guard）
+  index         构建并持久化 UnifiedGraph snapshot 到 .spectra/unified-graph.json（Feature 156）
   mcp-server    启动 MCP stdio server（供 Claude Code 插件调用）
 
 认证:
@@ -112,12 +113,8 @@ const HELP_TEXT = `spectra — 代码逆向工程 Spec 生成工具 v${version}
   --version, -v  显示版本号
   --help, -h     显示帮助信息`;
 async function main() {
-    // 注册所有语言适配器（在命令调度前执行）
-    bootstrapAdapters();
-    // 注册所有文档生成器
-    bootstrapGenerators();
-    // 注册所有制品解析器
-    bootstrapParsers();
+    // 单一 runtime 初始化（FR-10）：在命令调度前注册全部 registry
+    bootstrapRuntime();
     const result = parseArgs(process.argv.slice(2));
     if (!result.ok) {
         printError(result.error.message);
@@ -181,6 +178,9 @@ async function main() {
         case 'direction-audit':
             await runDirectionAuditCommand(command);
             break;
+        case 'index':
+            await runIndexCommand(command);
+            break;
         case 'mcp-server':
             await runMcpServer(command);
             break;

package/dist/cli/index.js.map

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

package/dist/cli/utils/parse-args.d.ts

@@ -4,7 +4,7 @@
  */
 /** CLI 命令结构 */
 export interface CLICommand {
-    subcommand: 'generate' | 'batch' | 'diff' | 'init' | 'prepare' | 'auth-status' | 'mcp-server' | 'panoramic' | 'cache' | 'watch' | 'graph' | 'community' | 'query' | 'install' | 'export' | 'direction-audit';
+    subcommand: 'generate' | 'batch' | 'diff' | 'init' | 'prepare' | 'auth-status' | 'mcp-server' | 'panoramic' | 'cache' | 'watch' | 'graph' | 'community' | 'query' | 'install' | 'export' | 'direction-audit' | 'index';
     target?: string;
     specFile?: string;
     deep: boolean;
@@ -89,6 +89,18 @@ export interface CLICommand {
     hyperedgesEnabled?: boolean;
     /** Feature 135 Bug 1：是否显式启用 ADR pipeline（v4.0.1 临时禁用，用 --enable-adr 显式开启） */
     enableAdr?: boolean;
+    /** Feature 156：spectra index 持续监听模式（FR-12） */
+    indexWatch?: boolean;
+    /** Feature 156：spectra index 单次增量更新（FR-30） */
+    indexIncremental?: boolean;
+    /** Feature 156：spectra index caller 扩展深度（OQ-2 / clarify Q3，默认 1） */
+    indexCallerDepth?: number;
+    /**
+     * Feature 156 W4：spectra index --git-range，post-commit hook 上下文使用。
+     * 仅在 --incremental 模式生效；white-list 校验仅允许预设格式（防注入）：
+     *   'HEAD' / 'ORIG_HEAD HEAD' / 'HEAD~1 HEAD' 或 SHA-like
+     */
+    indexGitRange?: string;
 }
 /** 解析错误 */
 export interface ParseError {

package/dist/cli/utils/parse-args.d.ts.map

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

package/dist/cli/utils/parse-args.js

@@ -442,6 +442,83 @@ export function parseArgs(argv) {
             },
         };
     }
+    // index 子命令（Feature 156 — spectra index）
+    if (sub === 'index') {
+        if (argv.includes('--help') || argv.includes('-h')) {
+            return {
+                ok: true,
+                command: {
+                    subcommand: 'index',
+                    deep: false, force: false, version: false, help: true,
+                    global: false, remove: false, skillTarget: defaultSkillTarget(),
+                },
+            };
+        }
+        const indexWatch = argv.includes('--watch');
+        const indexIncremental = argv.includes('--incremental');
+        if (indexWatch && indexIncremental) {
+            return {
+                ok: false,
+                error: {
+                    type: 'invalid_option',
+                    message: '--watch 与 --incremental 互斥，不能同时使用',
+                },
+            };
+        }
+        const callerDepthIdx = argv.indexOf('--caller-depth');
+        let indexCallerDepth;
+        if (callerDepthIdx !== -1 && argv[callerDepthIdx + 1] !== undefined) {
+            const parsed = parseInt(argv[callerDepthIdx + 1], 10);
+            if (isNaN(parsed) || parsed < 0) {
+                return {
+                    ok: false,
+                    error: {
+                        type: 'invalid_option',
+                        message: `--caller-depth 必须为非负整数，收到: ${argv[callerDepthIdx + 1]}`,
+                    },
+                };
+            }
+            indexCallerDepth = parsed;
+        }
+        const projectRootIdx = argv.indexOf('--project-root');
+        const projectRoot = projectRootIdx !== -1 ? argv[projectRootIdx + 1] : undefined;
+        // --git-range（W4 T-036 / WARN-2 加固）：仅在 --incremental 时有效，并做 white-list 校验
+        const gitRangeIdx = argv.indexOf('--git-range');
+        let indexGitRange;
+        if (gitRangeIdx !== -1 && argv[gitRangeIdx + 1] !== undefined) {
+            const raw = argv[gitRangeIdx + 1];
+            // 白名单：仅允许 SHA-like / HEAD 系列引用 + 单空格组合
+            // 形式：<ref> 或 <ref> <ref>；ref ∈ /^[A-Za-z0-9_~^@/.-]+$/（且至少 1 字符）
+            const REF_PATTERN = /^[A-Za-z0-9_~^@/.-]+$/;
+            const parts = raw.trim().split(/\s+/);
+            const valid = parts.length >= 1 &&
+                parts.length <= 2 &&
+                parts.every((p) => p.length > 0 && p.length <= 100 && REF_PATTERN.test(p));
+            if (!valid) {
+                return {
+                    ok: false,
+                    error: {
+                        type: 'invalid_option',
+                        message: `--git-range 格式不合法（仅允许 1~2 个 git ref，如 'HEAD' / 'ORIG_HEAD HEAD'），收到: ${raw}`,
+                    },
+                };
+            }
+            indexGitRange = parts.join(' ');
+        }
+        return {
+            ok: true,
+            command: {
+                subcommand: 'index',
+                indexWatch,
+                indexIncremental,
+                indexCallerDepth,
+                indexGitRange,
+                projectRoot,
+                deep: false, force: false, version: false, help: false,
+                global: false, remove: false, skillTarget: defaultSkillTarget(),
+            },
+        };
+    }
     // --global/--remove/--target 仅在 init 子命令下有效
     if (argv.includes('--global') || argv.includes('-g')) {
         return {
@@ -479,7 +556,7 @@ export function parseArgs(argv) {
             },
         };
     }
-    if (sub !== 'generate' && sub !== 'batch' && sub !== 'diff' && sub !== 'prepare' && sub !== 'auth-status' && sub !== 'mcp-server' && sub !== 'panoramic' && sub !== 'cache' && sub !== 'watch' && sub !== 'graph' && sub !== 'community' && sub !== 'query' && sub !== 'install' && sub !== 'export' && sub !== 'direction-audit') {
+    if (sub !== 'generate' && sub !== 'batch' && sub !== 'diff' && sub !== 'prepare' && sub !== 'auth-status' && sub !== 'mcp-server' && sub !== 'panoramic' && sub !== 'cache' && sub !== 'watch' && sub !== 'graph' && sub !== 'community' && sub !== 'query' && sub !== 'install' && sub !== 'export' && sub !== 'direction-audit' && sub !== 'index') {
         return {
             ok: false,
             error: {
@@ -714,7 +791,7 @@ function extractPositionalArgs(args) {
     for (let i = 0; i < args.length; i++) {
         if (args[i].startsWith('--')) {
             // 跳过带值的选项（如 --output-dir <dir>, --target <value>）
-            if (args[i] === '--output-dir' || args[i] === '--target' || args[i] === '--languages' || args[i] === '--project-root' || args[i] === '--generator' || args[i] === '--debounce' || args[i] === '--min-size' || args[i] === '--budget' || args[i] === '--format' || args[i] === '--concurrency' || args[i] === '--on-over-budget' || args[i] === '--graph' || args[i] === '--output' || args[i] === '--snapshot' || args[i] === '--compare-snapshot' || args[i] === '--mode') {
+            if (args[i] === '--output-dir' || args[i] === '--target' || args[i] === '--languages' || args[i] === '--project-root' || args[i] === '--generator' || args[i] === '--debounce' || args[i] === '--min-size' || args[i] === '--budget' || args[i] === '--format' || args[i] === '--concurrency' || args[i] === '--on-over-budget' || args[i] === '--graph' || args[i] === '--output' || args[i] === '--snapshot' || args[i] === '--compare-snapshot' || args[i] === '--mode' || args[i] === '--caller-depth' || args[i] === '--git-range') {
                 i++; // 跳过选项值
             }
             continue;