@aipanel/core 1.2.27 → 1.3.0

package/es/common/constants.d.ts

@@ -155,8 +155,40 @@ export declare const VUE_DEVTOOLS_ACTIONS: {
     readonly GET_APPS: "getApps";
     readonly TOGGLE_APP: "toggleApp";
     readonly GET_ROUTER_INFO: "getRouterInfo";
+    readonly GET_TIMELINE: "getTimeline";
+    readonly MARK_TIMELINE: "markTimeline";
+    readonly CLEAR_TIMELINE: "clearTimeline";
 };
 export type VueDevtoolsAction = (typeof VUE_DEVTOOLS_ACTIONS)[keyof typeof VUE_DEVTOOLS_ACTIONS];
+/**
+ * 时间线层名（工具 schema 的 layer 枚举与页面侧采集器共用）。
+ * lifecycle 只累计计数、不产生明细记录；其余层都是明细记录。
+ */
+export declare const VUE_DEVTOOLS_TIMELINE_LAYERS: readonly ["perf", "lifecycle", "emit", "navigate", "agent"];
+export type VueDevtoolsTimelineLayer = (typeof VUE_DEVTOOLS_TIMELINE_LAYERS)[number];
+/** 时间线明细档位（唯一来源）：数组、类型与页面侧的分支比较都引用这里，避免散落字面量 */
+export declare const VUE_DEVTOOLS_TIMELINE_INCLUDE: {
+    readonly SUMMARY: "summary";
+    readonly SLOW: "slow";
+    readonly ALL: "all";
+};
+export declare const VUE_DEVTOOLS_TIMELINE_INCLUDES: readonly ["summary", "slow", "all"];
+export type VueDevtoolsTimelineInclude = (typeof VUE_DEVTOOLS_TIMELINE_INCLUDES)[number];
+/** 时间线查询默认值（MCP 工具 schema 与页面侧采集器共用，避免两处漂移） */
+export declare const VUE_DEVTOOLS_TIMELINE_DEFAULTS: {
+    /** 默认回溯窗口（毫秒） */
+    readonly windowMs: 5000;
+    /** 默认只返回耗时 ≥ 该值的组件渲染记录（毫秒） */
+    readonly minDurationMs: 4;
+    /** 默认明细档位 */
+    readonly include: "slow";
+    /** 默认明细条数上限 */
+    readonly limit: 30;
+    /** 明细条数上限的硬上限 */
+    readonly maxLimit: 200;
+    /** 页面侧环形缓冲容量（条） */
+    readonly capacity: 1000;
+};
 /** ==================== 写类工具名单 ==================== */
 /** 会修改文件的工具名（host 插件与编辑后自动诊断共用的单一来源） */
 export declare const MUTATING_TOOLS: ReadonlySet<string>;

package/es/common/constants.mjs

@@ -85,7 +85,42 @@ const VUE_DEVTOOLS_ACTIONS = {
   GET_COMPONENT_RENDER_CODE: "getComponentRenderCode",
   GET_APPS: "getApps",
   TOGGLE_APP: "toggleApp",
-  GET_ROUTER_INFO: "getRouterInfo"
+  GET_ROUTER_INFO: "getRouterInfo",
+  GET_TIMELINE: "getTimeline",
+  MARK_TIMELINE: "markTimeline",
+  CLEAR_TIMELINE: "clearTimeline"
+};
+const VUE_DEVTOOLS_TIMELINE_LAYERS = [
+  "perf",
+  "lifecycle",
+  "emit",
+  "navigate",
+  "agent"
+];
+const VUE_DEVTOOLS_TIMELINE_INCLUDE = {
+  SUMMARY: "summary",
+  SLOW: "slow",
+  ALL: "all"
+};
+const VUE_DEVTOOLS_TIMELINE_INCLUDES = [
+  VUE_DEVTOOLS_TIMELINE_INCLUDE.SUMMARY,
+  VUE_DEVTOOLS_TIMELINE_INCLUDE.SLOW,
+  VUE_DEVTOOLS_TIMELINE_INCLUDE.ALL
+];
+const DEFAULT_TIMELINE_INCLUDE = VUE_DEVTOOLS_TIMELINE_INCLUDE.SLOW;
+const VUE_DEVTOOLS_TIMELINE_DEFAULTS = {
+  /** 默认回溯窗口（毫秒） */
+  windowMs: 5e3,
+  /** 默认只返回耗时 ≥ 该值的组件渲染记录（毫秒） */
+  minDurationMs: 4,
+  /** 默认明细档位 */
+  include: DEFAULT_TIMELINE_INCLUDE,
+  /** 默认明细条数上限 */
+  limit: 30,
+  /** 明细条数上限的硬上限 */
+  maxLimit: 200,
+  /** 页面侧环形缓冲容量（条） */
+  capacity: 1e3
 };
 const MUTATING_TOOLS = /* @__PURE__ */ new Set(["write", "edit", "apply_patch"]);
 const WIDGET_THEME_MODES = ["auto", "light", "dark"];
@@ -154,6 +189,10 @@ export {
   START_API_PATH,
   VUE_DEVTOOLS_ACTIONS,
   VUE_DEVTOOLS_API_PATH,
+  VUE_DEVTOOLS_TIMELINE_DEFAULTS,
+  VUE_DEVTOOLS_TIMELINE_INCLUDE,
+  VUE_DEVTOOLS_TIMELINE_INCLUDES,
+  VUE_DEVTOOLS_TIMELINE_LAYERS,
   WARMUP_API_PATH,
   WIDGET_MSG,
   WIDGET_SCRIPT_PATH,

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

@@ -342,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;
@@ -372,21 +388,7 @@ async function runTypeCheck(filePath, cwd) {
   }
   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");
+    rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
   }
   log.debug("type-check finished", {
     engine: engine.source,
@@ -396,6 +398,32 @@ async function runTypeCheck(filePath, cwd) {
   });
   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 });
   const [eslintOutput, tscOutput] = await Promise.all([
@@ -404,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 });
@@ -425,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,
@@ -446,8 +504,11 @@ export {
   isJsFile,
   lintFiles,
   lintSectionTitle,
+  omittedFindingsHint,
   runAllChecks,
+  runAllChecksForFiles,
   runProjectDiagnostics,
   runTypeCheck,
+  runTypeChecksForFiles,
   tscSectionTitle
 };

package/lib/common/constants.cjs

@@ -60,6 +60,10 @@ __export(constants_exports, {
   START_API_PATH: () => START_API_PATH,
   VUE_DEVTOOLS_ACTIONS: () => VUE_DEVTOOLS_ACTIONS,
   VUE_DEVTOOLS_API_PATH: () => VUE_DEVTOOLS_API_PATH,
+  VUE_DEVTOOLS_TIMELINE_DEFAULTS: () => VUE_DEVTOOLS_TIMELINE_DEFAULTS,
+  VUE_DEVTOOLS_TIMELINE_INCLUDE: () => VUE_DEVTOOLS_TIMELINE_INCLUDE,
+  VUE_DEVTOOLS_TIMELINE_INCLUDES: () => VUE_DEVTOOLS_TIMELINE_INCLUDES,
+  VUE_DEVTOOLS_TIMELINE_LAYERS: () => VUE_DEVTOOLS_TIMELINE_LAYERS,
   WARMUP_API_PATH: () => WARMUP_API_PATH,
   WIDGET_MSG: () => WIDGET_MSG,
   WIDGET_SCRIPT_PATH: () => WIDGET_SCRIPT_PATH,
@@ -154,7 +158,42 @@ const VUE_DEVTOOLS_ACTIONS = {
   GET_COMPONENT_RENDER_CODE: "getComponentRenderCode",
   GET_APPS: "getApps",
   TOGGLE_APP: "toggleApp",
-  GET_ROUTER_INFO: "getRouterInfo"
+  GET_ROUTER_INFO: "getRouterInfo",
+  GET_TIMELINE: "getTimeline",
+  MARK_TIMELINE: "markTimeline",
+  CLEAR_TIMELINE: "clearTimeline"
+};
+const VUE_DEVTOOLS_TIMELINE_LAYERS = [
+  "perf",
+  "lifecycle",
+  "emit",
+  "navigate",
+  "agent"
+];
+const VUE_DEVTOOLS_TIMELINE_INCLUDE = {
+  SUMMARY: "summary",
+  SLOW: "slow",
+  ALL: "all"
+};
+const VUE_DEVTOOLS_TIMELINE_INCLUDES = [
+  VUE_DEVTOOLS_TIMELINE_INCLUDE.SUMMARY,
+  VUE_DEVTOOLS_TIMELINE_INCLUDE.SLOW,
+  VUE_DEVTOOLS_TIMELINE_INCLUDE.ALL
+];
+const DEFAULT_TIMELINE_INCLUDE = VUE_DEVTOOLS_TIMELINE_INCLUDE.SLOW;
+const VUE_DEVTOOLS_TIMELINE_DEFAULTS = {
+  /** 默认回溯窗口（毫秒） */
+  windowMs: 5e3,
+  /** 默认只返回耗时 ≥ 该值的组件渲染记录（毫秒） */
+  minDurationMs: 4,
+  /** 默认明细档位 */
+  include: DEFAULT_TIMELINE_INCLUDE,
+  /** 默认明细条数上限 */
+  limit: 30,
+  /** 明细条数上限的硬上限 */
+  maxLimit: 200,
+  /** 页面侧环形缓冲容量（条） */
+  capacity: 1e3
 };
 const MUTATING_TOOLS = /* @__PURE__ */ new Set(["write", "edit", "apply_patch"]);
 const WIDGET_THEME_MODES = ["auto", "light", "dark"];
@@ -224,6 +263,10 @@ const INSPECTOR_ADAPTER_IDS = {
   START_API_PATH,
   VUE_DEVTOOLS_ACTIONS,
   VUE_DEVTOOLS_API_PATH,
+  VUE_DEVTOOLS_TIMELINE_DEFAULTS,
+  VUE_DEVTOOLS_TIMELINE_INCLUDE,
+  VUE_DEVTOOLS_TIMELINE_INCLUDES,
+  VUE_DEVTOOLS_TIMELINE_LAYERS,
   WARMUP_API_PATH,
   WIDGET_MSG,
   WIDGET_SCRIPT_PATH,

package/lib/common/constants.d.ts

@@ -155,8 +155,40 @@ export declare const VUE_DEVTOOLS_ACTIONS: {
     readonly GET_APPS: "getApps";
     readonly TOGGLE_APP: "toggleApp";
     readonly GET_ROUTER_INFO: "getRouterInfo";
+    readonly GET_TIMELINE: "getTimeline";
+    readonly MARK_TIMELINE: "markTimeline";
+    readonly CLEAR_TIMELINE: "clearTimeline";
 };
 export type VueDevtoolsAction = (typeof VUE_DEVTOOLS_ACTIONS)[keyof typeof VUE_DEVTOOLS_ACTIONS];
+/**
+ * 时间线层名（工具 schema 的 layer 枚举与页面侧采集器共用）。
+ * lifecycle 只累计计数、不产生明细记录；其余层都是明细记录。
+ */
+export declare const VUE_DEVTOOLS_TIMELINE_LAYERS: readonly ["perf", "lifecycle", "emit", "navigate", "agent"];
+export type VueDevtoolsTimelineLayer = (typeof VUE_DEVTOOLS_TIMELINE_LAYERS)[number];
+/** 时间线明细档位（唯一来源）：数组、类型与页面侧的分支比较都引用这里，避免散落字面量 */
+export declare const VUE_DEVTOOLS_TIMELINE_INCLUDE: {
+    readonly SUMMARY: "summary";
+    readonly SLOW: "slow";
+    readonly ALL: "all";
+};
+export declare const VUE_DEVTOOLS_TIMELINE_INCLUDES: readonly ["summary", "slow", "all"];
+export type VueDevtoolsTimelineInclude = (typeof VUE_DEVTOOLS_TIMELINE_INCLUDES)[number];
+/** 时间线查询默认值（MCP 工具 schema 与页面侧采集器共用，避免两处漂移） */
+export declare const VUE_DEVTOOLS_TIMELINE_DEFAULTS: {
+    /** 默认回溯窗口（毫秒） */
+    readonly windowMs: 5000;
+    /** 默认只返回耗时 ≥ 该值的组件渲染记录（毫秒） */
+    readonly minDurationMs: 4;
+    /** 默认明细档位 */
+    readonly include: "slow";
+    /** 默认明细条数上限 */
+    readonly limit: 30;
+    /** 明细条数上限的硬上限 */
+    readonly maxLimit: 200;
+    /** 页面侧环形缓冲容量（条） */
+    readonly capacity: 1000;
+};
 /** ==================== 写类工具名单 ==================== */
 /** 会修改文件的工具名（host 插件与编辑后自动诊断共用的单一来源） */
 export declare const MUTATING_TOOLS: ReadonlySet<string>;

package/lib/node/diagnostics.cjs

@@ -34,9 +34,12 @@ __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);
@@ -385,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;
@@ -415,21 +434,7 @@ async function runTypeCheck(filePath, cwd) {
   }
   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");
+    rawOutput = filterTscOutputForFile(rawOutput, filePath, projectDir);
   }
   log.debug("type-check finished", {
     engine: engine.source,
@@ -439,6 +444,32 @@ async function runTypeCheck(filePath, cwd) {
   });
   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 });
   const [eslintOutput, tscOutput] = await Promise.all([
@@ -447,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 });
@@ -468,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 = {
@@ -490,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipanel/core",
-  "version": "1.2.27",
+  "version": "1.3.0",
   "type": "module",
   "sideEffects": false,
   "main": "lib/index.cjs",