@aipanel/core 1.2.26 → 1.2.28

package/es/node/diagnostics.d.ts

@@ -51,8 +51,20 @@ export declare function findTsconfigDir(filePath: string): string | null;
 export declare function findAllTsconfigDirs(workspace: string): string[];
 /** 运行 TypeScript 类型检查（tsc / vue-tsc 按项目自动选择）--build --noEmit，返回原始输出 */
 export declare function runTypeCheck(filePath: string | undefined, cwd: string): Promise<TscResult>;
+/**
+ * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只跑一次 `--build --noEmit`，
+ * 再把项目输出切分回各文件（与单文件路径共用 filterTscOutputForFile）。
+ * 一次编辑批次里的 N 个文件因此从 N 次项目构建降到 1 次。
+ */
+export declare function runTypeChecksForFiles(files: string[], cwd: string): Promise<Map<string, TscResult>>;
 /** 并行运行 ESLint + 类型检查（单文件或 glob） */
 export declare function runAllChecks(pattern: string, cwd: string): Promise<DiagnosticsResult>;
+/**
+ * 批量运行 ESLint + 类型检查：Lint 逐文件（ESLint 进程内、oxlint 单次 CLI），
+ * 类型检查按 tsconfig 项目合并为一次（见 runTypeChecksForFiles）。
+ * 返回"文件绝对路径 → 诊断结果"，供 step 边界的一次性收尾诊断使用。
+ */
+export declare function runAllChecksForFiles(files: string[], cwd: string): Promise<Map<string, DiagnosticsResult>>;
 /**
  * 全量项目诊断：优先从根 tsconfig 运行一次类型检查 --build，
  * 根无 tsconfig 时回退到逐个子目录 build；ESLint 以 "." 全量扫描。
@@ -62,5 +74,17 @@ export declare function runProjectDiagnostics(workspace: string): Promise<Diagno
 export declare function tscSectionTitle(tscOutput: TscResult): string;
 /** Lint 分区标题（单一来源：跟随实际运行的引擎组合，如 "ESLint + oxlint"） */
 export declare function lintSectionTitle(lintOutput: EslintOutput): string;
-/** 组装统一的分区诊断文本（Lint / 类型检查，空结果显示占位文案） */
-export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult): string;
+/** 分区发现被条数上限折叠时的提示（自动诊断摘要与 run_diagnostics 完整输出的分界） */
+export declare function omittedFindingsHint(omitted: number): string;
+/**
+ * 组装统一的分区诊断文本（Lint / 类型检查）。
+ * 默认保留空分区的占位文案（run_diagnostics 要正面回答"有没有问题"）；
+ * `onlyFindings: true` 只输出有发现的分区、全空返回空串（编辑后自动诊断不刷占位噪音）；
+ * `maxFindingsPerSection` 把每个分区的发现折叠成有界摘要——编辑后自动诊断每个 step 都会投递，
+ * 因此用条数上限控制重复成本，完整结果仍由不带上限的 run_diagnostics 给出。
+ * `title` 允许为空串，此时直接返回分区正文（追加式投递场景无需标题）。
+ */
+export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult, options?: {
+    onlyFindings?: boolean;
+    maxFindingsPerSection?: number;
+}): string;

package/es/node/diagnostics.mjs

@@ -1,6 +1,6 @@
 import fs from "node:fs";
 import path from "node:path";
-import { exec } from "node:child_process";
+import { execa } from "execa";
 import { createRequire } from "node:module";
 import { SEVERITY_ERROR, SEVERITY_WARN } from "../common/constants.mjs";
 import { createLogger } from "./node-logger.mjs";
@@ -189,41 +189,35 @@ function parseOxlintOutput(stdout, cwd) {
 async function runOxlintFiles(pattern, cwd, warnLimit) {
   const bin = resolveOxlintBin(cwd);
   if (!bin) return {};
-  return new Promise((resolve) => {
-    exec(
-      // 与 ESLint 默认行为对齐：忽略 node_modules（oxlint 默认不排除）
-      `node "${bin}" --format=json --ignore-pattern node_modules "${pattern}"`,
-      { cwd, timeout: 6e4, maxBuffer: 50 * 1024 * 1024 },
-      (error, stdout, stderr) => {
-        const killed = error?.killed;
-        if (killed) {
-          log.warn("oxlint timed out", { pattern });
-          resolve({
-            text: "[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A\u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u3002",
-            diagnostics: [],
-            engines: ["oxlint"]
-          });
-          return;
-        }
-        try {
-          const messages = parseOxlintOutput(stdout, cwd);
-          log.debug("oxlint lint", {
-            pattern,
-            messageCount: messages.length,
-            stderr: stderr || void 0
-          });
-          resolve(formatLintMessages(messages, { label: "oxlint", source: "oxlint" }, warnLimit));
-        } catch (e) {
-          log.warn("oxlint failed", { pattern, error: e.message });
-          resolve({
-            text: `[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A${e.message}`,
-            diagnostics: [],
-            engines: ["oxlint"]
-          });
-        }
-      }
-    );
-  });
+  const result = await execa(
+    "node",
+    [bin, "--format=json", "--ignore-pattern", "node_modules", pattern],
+    { cwd, timeout: 6e4, maxBuffer: 50 * 1024 * 1024, reject: false }
+  );
+  if (result.timedOut || result.isTerminated || result.isMaxBuffer) {
+    log.warn("oxlint timed out", { pattern });
+    return {
+      text: "[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A\u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u3002",
+      diagnostics: [],
+      engines: ["oxlint"]
+    };
+  }
+  try {
+    const messages = parseOxlintOutput(result.stdout, cwd);
+    log.debug("oxlint lint", {
+      pattern,
+      messageCount: messages.length,
+      stderr: result.stderr || void 0
+    });
+    return formatLintMessages(messages, { label: "oxlint", source: "oxlint" }, warnLimit);
+  } catch (e) {
+    log.warn("oxlint failed", { pattern, error: e.message });
+    return {
+      text: `[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A${e.message}`,
+      diagnostics: [],
+      engines: ["oxlint"]
+    };
+  }
 }
 let _vueTscBin;
 function resolveVueTscBin() {
@@ -348,6 +342,22 @@ function parseTscDiags(rawOutput, filePath, projectDir, source = "tsc") {
   }
   return diags;
 }
+function filterTscOutputForFile(rawOutput, filePath, projectDir) {
+  const resolved = path.resolve(filePath);
+  const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
+  const filtered = [];
+  let keep = false;
+  for (const line of rawOutput.split("\n")) {
+    const m = errorLinePat.exec(line);
+    if (m) {
+      keep = path.resolve(projectDir, m[1]) === resolved;
+    } else if (!/^\s/.test(line)) {
+      keep = false;
+    }
+    if (keep) filtered.push(line);
+  }
+  return filtered.join("\n");
+}
 async function runTypeCheck(filePath, cwd) {
   const dir = cwd;
   const projectDir = filePath ? findTsconfigDir(filePath) ?? dir : dir;
@@ -364,45 +374,55 @@ async function runTypeCheck(filePath, cwd) {
   }
   const timeout = filePath ? 6e4 : 12e4;
   const maxBuffer = filePath ? 10 * 1024 * 1024 : 50 * 1024 * 1024;
-  return new Promise((resolve) => {
-    exec(
-      `node "${engine.bin}" --build --noEmit --pretty false`,
-      { cwd: projectDir, timeout, maxBuffer },
-      (error, stdout, stderr) => {
-        let rawOutput = stdout + stderr;
-        const killed = error?.killed;
-        const exitCode = typeof error?.code === "number" ? error.code : killed ? 1 : 0;
-        if (killed && !rawOutput) {
-          rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
-        }
-        const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
-        if (filePath) {
-          const resolved = path.resolve(filePath);
-          const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
-          const lines = rawOutput.split("\n");
-          const filtered = [];
-          let keep = false;
-          for (const line of lines) {
-            const m = errorLinePat.exec(line);
-            if (m) {
-              keep = path.resolve(projectDir, m[1]) === resolved;
-            } else if (!/^\s/.test(line)) {
-              keep = false;
-            }
-            if (keep) filtered.push(line);
-          }
-          rawOutput = filtered.join("\n");
-        }
-        log.debug("type-check finished", {
-          engine: engine.source,
-          filePath: filePath || "(all)",
-          exitCode,
-          outputLength: rawOutput.length
-        });
-        resolve({ rawOutput, exitCode, diagnostics, source: engine.source });
-      }
-    );
+  const result = await execa("node", [engine.bin, "--build", "--noEmit", "--pretty", "false"], {
+    cwd: projectDir,
+    timeout,
+    maxBuffer,
+    reject: false
   });
+  let rawOutput = result.stdout + result.stderr;
+  const killed = result.timedOut || result.isTerminated || result.isMaxBuffer;
+  const exitCode = typeof result.exitCode === "number" ? result.exitCode : killed ? 1 : 0;
+  if (killed && !rawOutput) {
+    rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
+  }
+  const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
+  if (filePath) {
+    rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
+  }
+  log.debug("type-check finished", {
+    engine: engine.source,
+    filePath: filePath || "(all)",
+    exitCode,
+    outputLength: rawOutput.length
+  });
+  return { rawOutput, exitCode, diagnostics, source: engine.source };
+}
+async function runTypeChecksForFiles(files, cwd) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const resolved = path.resolve(file);
+    const projectDir = findTsconfigDir(resolved) ?? cwd;
+    const group = groups.get(projectDir);
+    if (group) group.push(resolved);
+    else groups.set(projectDir, [resolved]);
+  }
+  const results = /* @__PURE__ */ new Map();
+  for (const [projectDir, group] of groups) {
+    const whole = await runTypeCheck(void 0, projectDir).catch(() => ({
+      rawOutput: "",
+      exitCode: 0
+    }));
+    for (const file of group) {
+      results.set(file, {
+        rawOutput: filterTscOutputForFile(whole.rawOutput, file, projectDir),
+        exitCode: whole.exitCode,
+        diagnostics: (whole.diagnostics ?? []).filter((d) => d.file === file),
+        source: whole.source
+      });
+    }
+  }
+  return results;
 }
 async function runAllChecks(pattern, cwd) {
   log.debug("runAllChecks", { pattern, cwd });
@@ -412,6 +432,18 @@ async function runAllChecks(pattern, cwd) {
   ]);
   return { eslintOutput, tscOutput };
 }
+async function runAllChecksForFiles(files, cwd) {
+  const targets = [...new Set(files.map((file) => path.resolve(file)))];
+  const tscByFile = await runTypeChecksForFiles(targets, cwd);
+  const results = /* @__PURE__ */ new Map();
+  for (const file of targets) {
+    results.set(file, {
+      eslintOutput: await lintFiles(file, cwd),
+      tscOutput: tscByFile.get(file) ?? { rawOutput: "", exitCode: 0 }
+    });
+  }
+  return results;
+}
 async function runProjectDiagnostics(workspace) {
   const tscDirs = fs.existsSync(path.join(workspace, "tsconfig.json")) ? [workspace] : findAllTsconfigDirs(workspace);
   log.debug("Tsc dirs to check", { count: tscDirs.length, dirs: tscDirs });
@@ -433,18 +465,36 @@ function tscSectionTitle(tscOutput) {
 function lintSectionTitle(lintOutput) {
   return lintOutput.engines?.length ? lintOutput.engines.join(" + ") : "ESLint";
 }
-function formatDiagnosticsSections(title, eslintOutput, tscOutput) {
+function omittedFindingsHint(omitted) {
+  return `\u2026\u8FD8\u6709 ${omitted} \u6761\uFF0C\u5B8C\u6574\u7ED3\u679C\u8BF7\u8C03\u7528 run_diagnostics`;
+}
+function boundFindings(text, maxFindings) {
+  if (!maxFindings || !text) return text;
+  const lines = text.split("\n").filter((line) => line.trim() !== "");
+  if (lines.length <= maxFindings) return text;
+  return [...lines.slice(0, maxFindings), omittedFindingsHint(lines.length - maxFindings)].join(
+    "\n"
+  );
+}
+function formatDiagnosticsSections(title, eslintOutput, tscOutput, options = {}) {
+  const lintLines = boundFindings(eslintOutput.text, options.maxFindingsPerSection);
+  const tscLines = boundFindings(tscOutput.rawOutput.trim(), options.maxFindingsPerSection);
   const parts = [];
-  parts.push(`## ${lintSectionTitle(eslintOutput)}
+  if (!options.onlyFindings || lintLines) {
+    parts.push(`## ${lintSectionTitle(eslintOutput)}
 
-` + (eslintOutput.text || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
-  const tscLines = tscOutput.rawOutput.trim();
-  parts.push(`## ${tscSectionTitle(tscOutput)}
+` + (lintLines || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
+  }
+  if (!options.onlyFindings || tscLines) {
+    parts.push(`## ${tscSectionTitle(tscOutput)}
 
 ` + (tscLines || "\u6CA1\u6709\u53D1\u73B0\u7C7B\u578B\u9519\u8BEF"));
-  return `${title}
+  }
+  if (parts.length === 0) return "";
+  const body = parts.join("\n\n");
+  return title ? `${title}
 
-` + parts.join("\n\n");
+${body}` : body;
 }
 export {
   DIAGNOSTICS_TOOL_DESCRIPTION,
@@ -454,8 +504,11 @@ export {
   isJsFile,
   lintFiles,
   lintSectionTitle,
+  omittedFindingsHint,
   runAllChecks,
+  runAllChecksForFiles,
   runProjectDiagnostics,
   runTypeCheck,
+  runTypeChecksForFiles,
   tscSectionTitle
 };

package/es/node/node-utils.mjs

@@ -1,4 +1,5 @@
 import { spawn } from "node:child_process";
+import { execa } from "execa";
 import { createRequire } from "node:module";
 import fs from "node:fs";
 import http from "node:http";
@@ -124,40 +125,18 @@ function findGitRoot(startDir, maxDepth = 10) {
 }
 async function checkCliInstalled(bin) {
   const timer = new PerformanceTimer(`checkCliInstalled:${bin}`);
-  return new Promise((resolve) => {
-    const proc = spawn(bin, ["--version"], { stdio: "ignore", shell: true });
-    proc.on("close", (code) => {
-      const installed = code === 0;
-      timer.end(installed ? `\u2713 ${bin} is installed` : `\u2716 ${bin} not found`);
-      resolve(installed);
-    });
-    proc.on("error", (err) => {
-      log.debug(`Failed to check ${bin} installation`, { error: err.message });
-      timer.end("\u2716 Check failed");
-      resolve(false);
-    });
-  });
+  const result = await execa(bin, ["--version"], { reject: false, stdio: "ignore" });
+  const installed = result.exitCode === 0;
+  if (!installed && result.exitCode === void 0) {
+    log.debug(`Failed to check ${bin} installation`, { error: result.message });
+  }
+  timer.end(installed ? `\u2713 ${bin} is installed` : `\u2716 ${bin} not found`);
+  return installed;
 }
-function getCliVersion(bin) {
-  return new Promise((resolve) => {
-    const proc = spawn(bin, ["--version"], { stdio: "pipe", shell: true });
-    let stdout = "";
-    let stderr = "";
-    proc.stdout?.on("data", (data) => {
-      stdout += data.toString();
-    });
-    proc.stderr?.on("data", (data) => {
-      stderr += data.toString();
-    });
-    proc.on("close", (code) => {
-      if (code !== 0) {
-        resolve(null);
-        return;
-      }
-      resolve(stdout.trim() || stderr.trim() || null);
-    });
-    proc.on("error", () => resolve(null));
-  });
+async function getCliVersion(bin) {
+  const result = await execa(bin, ["--version"], { reject: false });
+  if (result.exitCode !== 0) return null;
+  return result.stdout.trim() || result.stderr.trim() || null;
 }
 function killOrphanCliProcesses(bin, options) {
   const label = options.label ?? bin;

package/lib/node/diagnostics.cjs

@@ -34,15 +34,18 @@ __export(diagnostics_exports, {
   isJsFile: () => isJsFile,
   lintFiles: () => lintFiles,
   lintSectionTitle: () => lintSectionTitle,
+  omittedFindingsHint: () => omittedFindingsHint,
   runAllChecks: () => runAllChecks,
+  runAllChecksForFiles: () => runAllChecksForFiles,
   runProjectDiagnostics: () => runProjectDiagnostics,
   runTypeCheck: () => runTypeCheck,
+  runTypeChecksForFiles: () => runTypeChecksForFiles,
   tscSectionTitle: () => tscSectionTitle
 });
 module.exports = __toCommonJS(diagnostics_exports);
 var import_node_fs = __toESM(require("node:fs"));
 var import_node_path = __toESM(require("node:path"));
-var import_node_child_process = require("node:child_process");
+var import_execa = require("execa");
 var import_node_module = require("node:module");
 var import_constants = require("../common/constants.cjs");
 var import_node_logger = require("./node-logger.cjs");
@@ -232,41 +235,35 @@ function parseOxlintOutput(stdout, cwd) {
 async function runOxlintFiles(pattern, cwd, warnLimit) {
   const bin = resolveOxlintBin(cwd);
   if (!bin) return {};
-  return new Promise((resolve) => {
-    (0, import_node_child_process.exec)(
-      // 与 ESLint 默认行为对齐：忽略 node_modules（oxlint 默认不排除）
-      `node "${bin}" --format=json --ignore-pattern node_modules "${pattern}"`,
-      { cwd, timeout: 6e4, maxBuffer: 50 * 1024 * 1024 },
-      (error, stdout, stderr) => {
-        const killed = error?.killed;
-        if (killed) {
-          log.warn("oxlint timed out", { pattern });
-          resolve({
-            text: "[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A\u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u3002",
-            diagnostics: [],
-            engines: ["oxlint"]
-          });
-          return;
-        }
-        try {
-          const messages = parseOxlintOutput(stdout, cwd);
-          log.debug("oxlint lint", {
-            pattern,
-            messageCount: messages.length,
-            stderr: stderr || void 0
-          });
-          resolve(formatLintMessages(messages, { label: "oxlint", source: "oxlint" }, warnLimit));
-        } catch (e) {
-          log.warn("oxlint failed", { pattern, error: e.message });
-          resolve({
-            text: `[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A${e.message}`,
-            diagnostics: [],
-            engines: ["oxlint"]
-          });
-        }
-      }
-    );
-  });
+  const result = await (0, import_execa.execa)(
+    "node",
+    [bin, "--format=json", "--ignore-pattern", "node_modules", pattern],
+    { cwd, timeout: 6e4, maxBuffer: 50 * 1024 * 1024, reject: false }
+  );
+  if (result.timedOut || result.isTerminated || result.isMaxBuffer) {
+    log.warn("oxlint timed out", { pattern });
+    return {
+      text: "[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A\u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u3002",
+      diagnostics: [],
+      engines: ["oxlint"]
+    };
+  }
+  try {
+    const messages = parseOxlintOutput(result.stdout, cwd);
+    log.debug("oxlint lint", {
+      pattern,
+      messageCount: messages.length,
+      stderr: result.stderr || void 0
+    });
+    return formatLintMessages(messages, { label: "oxlint", source: "oxlint" }, warnLimit);
+  } catch (e) {
+    log.warn("oxlint failed", { pattern, error: e.message });
+    return {
+      text: `[oxlint] \u8FD0\u884C\u5931\u8D25\uFF1A${e.message}`,
+      diagnostics: [],
+      engines: ["oxlint"]
+    };
+  }
 }
 let _vueTscBin;
 function resolveVueTscBin() {
@@ -391,6 +388,22 @@ function parseTscDiags(rawOutput, filePath, projectDir, source = "tsc") {
   }
   return diags;
 }
+function filterTscOutputForFile(rawOutput, filePath, projectDir) {
+  const resolved = import_node_path.default.resolve(filePath);
+  const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
+  const filtered = [];
+  let keep = false;
+  for (const line of rawOutput.split("\n")) {
+    const m = errorLinePat.exec(line);
+    if (m) {
+      keep = import_node_path.default.resolve(projectDir, m[1]) === resolved;
+    } else if (!/^\s/.test(line)) {
+      keep = false;
+    }
+    if (keep) filtered.push(line);
+  }
+  return filtered.join("\n");
+}
 async function runTypeCheck(filePath, cwd) {
   const dir = cwd;
   const projectDir = filePath ? findTsconfigDir(filePath) ?? dir : dir;
@@ -407,45 +420,55 @@ async function runTypeCheck(filePath, cwd) {
   }
   const timeout = filePath ? 6e4 : 12e4;
   const maxBuffer = filePath ? 10 * 1024 * 1024 : 50 * 1024 * 1024;
-  return new Promise((resolve) => {
-    (0, import_node_child_process.exec)(
-      `node "${engine.bin}" --build --noEmit --pretty false`,
-      { cwd: projectDir, timeout, maxBuffer },
-      (error, stdout, stderr) => {
-        let rawOutput = stdout + stderr;
-        const killed = error?.killed;
-        const exitCode = typeof error?.code === "number" ? error.code : killed ? 1 : 0;
-        if (killed && !rawOutput) {
-          rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
-        }
-        const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
-        if (filePath) {
-          const resolved = import_node_path.default.resolve(filePath);
-          const errorLinePat = /^(.+?)\((\d+),(\d+)\):\s+(error|warning)\s+TS\d+:/;
-          const lines = rawOutput.split("\n");
-          const filtered = [];
-          let keep = false;
-          for (const line of lines) {
-            const m = errorLinePat.exec(line);
-            if (m) {
-              keep = import_node_path.default.resolve(projectDir, m[1]) === resolved;
-            } else if (!/^\s/.test(line)) {
-              keep = false;
-            }
-            if (keep) filtered.push(line);
-          }
-          rawOutput = filtered.join("\n");
-        }
-        log.debug("type-check finished", {
-          engine: engine.source,
-          filePath: filePath || "(all)",
-          exitCode,
-          outputLength: rawOutput.length
-        });
-        resolve({ rawOutput, exitCode, diagnostics, source: engine.source });
-      }
-    );
+  const result = await (0, import_execa.execa)("node", [engine.bin, "--build", "--noEmit", "--pretty", "false"], {
+    cwd: projectDir,
+    timeout,
+    maxBuffer,
+    reject: false
   });
+  let rawOutput = result.stdout + result.stderr;
+  const killed = result.timedOut || result.isTerminated || result.isMaxBuffer;
+  const exitCode = typeof result.exitCode === "number" ? result.exitCode : killed ? 1 : 0;
+  if (killed && !rawOutput) {
+    rawOutput = `${engine.source} \u68C0\u67E5\u8D85\u65F6\uFF0C\u8BF7\u5C1D\u8BD5\u7F29\u5C0F\u68C0\u67E5\u8303\u56F4\u6216\u4F18\u5316\u9879\u76EE\u914D\u7F6E\u3002`;
+  }
+  const diagnostics = parseTscDiags(rawOutput, filePath, projectDir, engine.source);
+  if (filePath) {
+    rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
+  }
+  log.debug("type-check finished", {
+    engine: engine.source,
+    filePath: filePath || "(all)",
+    exitCode,
+    outputLength: rawOutput.length
+  });
+  return { rawOutput, exitCode, diagnostics, source: engine.source };
+}
+async function runTypeChecksForFiles(files, cwd) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    const resolved = import_node_path.default.resolve(file);
+    const projectDir = findTsconfigDir(resolved) ?? cwd;
+    const group = groups.get(projectDir);
+    if (group) group.push(resolved);
+    else groups.set(projectDir, [resolved]);
+  }
+  const results = /* @__PURE__ */ new Map();
+  for (const [projectDir, group] of groups) {
+    const whole = await runTypeCheck(void 0, projectDir).catch(() => ({
+      rawOutput: "",
+      exitCode: 0
+    }));
+    for (const file of group) {
+      results.set(file, {
+        rawOutput: filterTscOutputForFile(whole.rawOutput, file, projectDir),
+        exitCode: whole.exitCode,
+        diagnostics: (whole.diagnostics ?? []).filter((d) => d.file === file),
+        source: whole.source
+      });
+    }
+  }
+  return results;
 }
 async function runAllChecks(pattern, cwd) {
   log.debug("runAllChecks", { pattern, cwd });
@@ -455,6 +478,18 @@ async function runAllChecks(pattern, cwd) {
   ]);
   return { eslintOutput, tscOutput };
 }
+async function runAllChecksForFiles(files, cwd) {
+  const targets = [...new Set(files.map((file) => import_node_path.default.resolve(file)))];
+  const tscByFile = await runTypeChecksForFiles(targets, cwd);
+  const results = /* @__PURE__ */ new Map();
+  for (const file of targets) {
+    results.set(file, {
+      eslintOutput: await lintFiles(file, cwd),
+      tscOutput: tscByFile.get(file) ?? { rawOutput: "", exitCode: 0 }
+    });
+  }
+  return results;
+}
 async function runProjectDiagnostics(workspace) {
   const tscDirs = import_node_fs.default.existsSync(import_node_path.default.join(workspace, "tsconfig.json")) ? [workspace] : findAllTsconfigDirs(workspace);
   log.debug("Tsc dirs to check", { count: tscDirs.length, dirs: tscDirs });
@@ -476,18 +511,36 @@ function tscSectionTitle(tscOutput) {
 function lintSectionTitle(lintOutput) {
   return lintOutput.engines?.length ? lintOutput.engines.join(" + ") : "ESLint";
 }
-function formatDiagnosticsSections(title, eslintOutput, tscOutput) {
+function omittedFindingsHint(omitted) {
+  return `\u2026\u8FD8\u6709 ${omitted} \u6761\uFF0C\u5B8C\u6574\u7ED3\u679C\u8BF7\u8C03\u7528 run_diagnostics`;
+}
+function boundFindings(text, maxFindings) {
+  if (!maxFindings || !text) return text;
+  const lines = text.split("\n").filter((line) => line.trim() !== "");
+  if (lines.length <= maxFindings) return text;
+  return [...lines.slice(0, maxFindings), omittedFindingsHint(lines.length - maxFindings)].join(
+    "\n"
+  );
+}
+function formatDiagnosticsSections(title, eslintOutput, tscOutput, options = {}) {
+  const lintLines = boundFindings(eslintOutput.text, options.maxFindingsPerSection);
+  const tscLines = boundFindings(tscOutput.rawOutput.trim(), options.maxFindingsPerSection);
   const parts = [];
-  parts.push(`## ${lintSectionTitle(eslintOutput)}
+  if (!options.onlyFindings || lintLines) {
+    parts.push(`## ${lintSectionTitle(eslintOutput)}
 
-` + (eslintOutput.text || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
-  const tscLines = tscOutput.rawOutput.trim();
-  parts.push(`## ${tscSectionTitle(tscOutput)}
+` + (lintLines || "\u6CA1\u6709\u53D1\u73B0\u95EE\u9898"));
+  }
+  if (!options.onlyFindings || tscLines) {
+    parts.push(`## ${tscSectionTitle(tscOutput)}
 
 ` + (tscLines || "\u6CA1\u6709\u53D1\u73B0\u7C7B\u578B\u9519\u8BEF"));
-  return `${title}
+  }
+  if (parts.length === 0) return "";
+  const body = parts.join("\n\n");
+  return title ? `${title}
 
-` + parts.join("\n\n");
+${body}` : body;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -498,8 +551,11 @@ function formatDiagnosticsSections(title, eslintOutput, tscOutput) {
   isJsFile,
   lintFiles,
   lintSectionTitle,
+  omittedFindingsHint,
   runAllChecks,
+  runAllChecksForFiles,
   runProjectDiagnostics,
   runTypeCheck,
+  runTypeChecksForFiles,
   tscSectionTitle
 });

package/lib/node/diagnostics.d.ts

@@ -51,8 +51,20 @@ export declare function findTsconfigDir(filePath: string): string | null;
 export declare function findAllTsconfigDirs(workspace: string): string[];
 /** 运行 TypeScript 类型检查（tsc / vue-tsc 按项目自动选择）--build --noEmit，返回原始输出 */
 export declare function runTypeCheck(filePath: string | undefined, cwd: string): Promise<TscResult>;
+/**
+ * 多文件类型检查：按最近的 tsconfig 项目分组，每个项目只跑一次 `--build --noEmit`，
+ * 再把项目输出切分回各文件（与单文件路径共用 filterTscOutputForFile）。
+ * 一次编辑批次里的 N 个文件因此从 N 次项目构建降到 1 次。
+ */
+export declare function runTypeChecksForFiles(files: string[], cwd: string): Promise<Map<string, TscResult>>;
 /** 并行运行 ESLint + 类型检查（单文件或 glob） */
 export declare function runAllChecks(pattern: string, cwd: string): Promise<DiagnosticsResult>;
+/**
+ * 批量运行 ESLint + 类型检查：Lint 逐文件（ESLint 进程内、oxlint 单次 CLI），
+ * 类型检查按 tsconfig 项目合并为一次（见 runTypeChecksForFiles）。
+ * 返回"文件绝对路径 → 诊断结果"，供 step 边界的一次性收尾诊断使用。
+ */
+export declare function runAllChecksForFiles(files: string[], cwd: string): Promise<Map<string, DiagnosticsResult>>;
 /**
  * 全量项目诊断：优先从根 tsconfig 运行一次类型检查 --build，
  * 根无 tsconfig 时回退到逐个子目录 build；ESLint 以 "." 全量扫描。
@@ -62,5 +74,17 @@ export declare function runProjectDiagnostics(workspace: string): Promise<Diagno
 export declare function tscSectionTitle(tscOutput: TscResult): string;
 /** Lint 分区标题（单一来源：跟随实际运行的引擎组合，如 "ESLint + oxlint"） */
 export declare function lintSectionTitle(lintOutput: EslintOutput): string;
-/** 组装统一的分区诊断文本（Lint / 类型检查，空结果显示占位文案） */
-export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult): string;
+/** 分区发现被条数上限折叠时的提示（自动诊断摘要与 run_diagnostics 完整输出的分界） */
+export declare function omittedFindingsHint(omitted: number): string;
+/**
+ * 组装统一的分区诊断文本（Lint / 类型检查）。
+ * 默认保留空分区的占位文案（run_diagnostics 要正面回答"有没有问题"）；
+ * `onlyFindings: true` 只输出有发现的分区、全空返回空串（编辑后自动诊断不刷占位噪音）；
+ * `maxFindingsPerSection` 把每个分区的发现折叠成有界摘要——编辑后自动诊断每个 step 都会投递，
+ * 因此用条数上限控制重复成本，完整结果仍由不带上限的 run_diagnostics 给出。
+ * `title` 允许为空串，此时直接返回分区正文（追加式投递场景无需标题）。
+ */
+export declare function formatDiagnosticsSections(title: string, eslintOutput: EslintOutput, tscOutput: TscResult, options?: {
+    onlyFindings?: boolean;
+    maxFindingsPerSection?: number;
+}): string;

package/lib/node/node-utils.cjs

@@ -40,6 +40,7 @@ __export(node_utils_exports, {
 });
 module.exports = __toCommonJS(node_utils_exports);
 var import_node_child_process = require("node:child_process");
+var import_execa = require("execa");
 var import_node_module = require("node:module");
 var import_node_fs = __toESM(require("node:fs"));
 var import_node_http = __toESM(require("node:http"));
@@ -161,40 +162,18 @@ function findGitRoot(startDir, maxDepth = 10) {
 }
 async function checkCliInstalled(bin) {
   const timer = new import_node_logger.PerformanceTimer(`checkCliInstalled:${bin}`);
-  return new Promise((resolve) => {
-    const proc = (0, import_node_child_process.spawn)(bin, ["--version"], { stdio: "ignore", shell: true });
-    proc.on("close", (code) => {
-      const installed = code === 0;
-      timer.end(installed ? `\u2713 ${bin} is installed` : `\u2716 ${bin} not found`);
-      resolve(installed);
-    });
-    proc.on("error", (err) => {
-      log.debug(`Failed to check ${bin} installation`, { error: err.message });
-      timer.end("\u2716 Check failed");
-      resolve(false);
-    });
-  });
+  const result = await (0, import_execa.execa)(bin, ["--version"], { reject: false, stdio: "ignore" });
+  const installed = result.exitCode === 0;
+  if (!installed && result.exitCode === void 0) {
+    log.debug(`Failed to check ${bin} installation`, { error: result.message });
+  }
+  timer.end(installed ? `\u2713 ${bin} is installed` : `\u2716 ${bin} not found`);
+  return installed;
 }
-function getCliVersion(bin) {
-  return new Promise((resolve) => {
-    const proc = (0, import_node_child_process.spawn)(bin, ["--version"], { stdio: "pipe", shell: true });
-    let stdout = "";
-    let stderr = "";
-    proc.stdout?.on("data", (data) => {
-      stdout += data.toString();
-    });
-    proc.stderr?.on("data", (data) => {
-      stderr += data.toString();
-    });
-    proc.on("close", (code) => {
-      if (code !== 0) {
-        resolve(null);
-        return;
-      }
-      resolve(stdout.trim() || stderr.trim() || null);
-    });
-    proc.on("error", () => resolve(null));
-  });
+async function getCliVersion(bin) {
+  const result = await (0, import_execa.execa)(bin, ["--version"], { reject: false });
+  if (result.exitCode !== 0) return null;
+  return result.stdout.trim() || result.stderr.trim() || null;
 }
 function killOrphanCliProcesses(bin, options) {
   const label = options.label ?? bin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.2.26",
+  "version": "1.2.28",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",
@@ -32,6 +32,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
+    "execa": "^9.6.1",
     "vue-tsc": "^3.3.9"
   },
   "scripts": {