AiI18nDiagnosticsOptions#

从 @ai-i18n/vite 导入：

import type { AiI18nDiagnosticsOptions } from '@ai-i18n/vite';

#定义

interface AiI18nDiagnosticsOptions {
  buildSummary?: boolean;
  timing?: boolean | AiI18nTimingDiagnosticsOptions;
  performance?: boolean | AiI18nPerformanceDiagnosticsOptions;
}

省略 diagnostics 时，构建汇总仍默认开启；耗时日志和性能报告默认关闭，仅在排障时启用。

#字段

timing: true 使用 50ms 默认阈值；需要调整阈值时传入 AiI18nTimingDiagnosticsOptions。 timing 只写入 Dev 终端，不写项目文件，也不在 Build 中输出。

performance: true 使用默认报告目录和样本上限，也可传入 AiI18nPerformanceDiagnosticsOptions。 两种诊断独立开启，性能报告的统计不受慢日志阈值过滤。详见性能诊断。

#构建文案汇总

默认在成功 Build 结束后输出一次，等待本轮 Provider 工作与持久化完成；Build Watch 每轮刷新。 未配置 Provider 或 Provider 未能补齐时，仍会如实显示未翻译数量，汇总本身不会触发翻译。 关闭汇总不影响独立的 failOnMissingTranslations 构建门禁。

文案按原文与 comment 的身份去重，文件数只包含有文案的文件。每个目标语言分别统计， 不计源语言；同一条消息只有在全部使用位置都具备有效译文时才算已翻译。有效译文包含自动 译文与全局、文件、位置级人工覆盖，空字符串也算译文。统计范围是本轮构建收集的模块， 不代表仓库内所有文件；失败构建不输出成功覆盖率。

aiI18n({
  sourceLang: 'zh-CN',
  locales,
  diagnostics: { buildSummary: false },
});

开启 performance 后，Build 的性能摘要与文案汇总合并输出；阶段耗时仍可能嵌套，不能相加作为 构建总耗时。buildSummary: false 不会关闭单独启用的性能报告。汇总遵循 Vite 的日志级别， 提示语言沿用插件的中英文诊断设置。