clash-verge-rev/src/utils/traffic-diagnostics.ts

/**
 * 流量统计诊断工具
 * 用于帮助开发者和用户诊断流量统计系统的性能和状态
 */

interface IDiagnosticReport {
  timestamp: string;
  referenceCount: number;
  samplerStats: {
    rawBufferSize: number;
    compressedBufferSize: number;
    compressionQueueSize: number;
    totalMemoryPoints: number;
  };
  performance: {
    memoryUsage: number; // MB
    lastDataFreshness: boolean;
    errorCount: number;
  };
  recommendations: string[];
}

// 全局错误计数器
let globalErrorCount = 0;

/**
 * 记录错误
 */
export function recordTrafficError(error: Error, component: string) {
  globalErrorCount++;
  console.error(
    `[TrafficDiagnostics] ${component} 错误 (#${globalErrorCount}):`,
    error,
  );
}

/**
 * 获取内存使用情况（近似值）
 */
function getMemoryUsage(): number {
  if ("memory" in performance) {
    // @@ts-expect-error - 某些浏览器支持
    const memory = (performance as any).memory;
    if (memory && memory.usedJSHeapSize) {
      return memory.usedJSHeapSize / 1024 / 1024; // 转换为MB
    }
  }
  return 0;
}

/**
 * 生成诊断报告
 */
export function generateDiagnosticReport(
  referenceCount: number,
  samplerStats: any,
  isDataFresh: boolean,
): IDiagnosticReport {
  const memoryUsage = getMemoryUsage();
  const recommendations: string[] = [];

  // 分析引用计数
  if (referenceCount === 0) {
    recommendations.push("✅ 没有组件在使用流量数据，数据收集已暂停");
  } else if (referenceCount > 3) {
    recommendations.push("⚠️ 有较多组件在使用流量数据，考虑优化组件数量");
  }

  // 分析内存使用
  const totalPoints = samplerStats.totalMemoryPoints || 0;
  if (totalPoints > 1000) {
    recommendations.push("⚠️ 缓存的数据点过多，可能影响性能");
  } else if (totalPoints < 100) {
    recommendations.push("ℹ️ 数据点较少，这是正常情况");
  }

  // 分析压缩效率
  const compressionRatio =
    samplerStats.rawBufferSize > 0
      ? samplerStats.compressedBufferSize / samplerStats.rawBufferSize
      : 0;
  if (compressionRatio > 0.5) {
    recommendations.push("⚠️ 数据压缩效率较低，可能需要调整压缩策略");
  } else if (compressionRatio > 0) {
    recommendations.push("✅ 数据压缩效率良好");
  }

  // 分析数据新鲜度
  if (!isDataFresh) {
    recommendations.push("⚠️ 数据不新鲜，可能存在网络问题或后端异常");
  }

  // 分析错误频率
  if (globalErrorCount > 10) {
    recommendations.push("🚨 错误频率过高，建议检查网络连接和后端服务");
  } else if (globalErrorCount > 0) {
    recommendations.push("ℹ️ 存在少量错误，这在网络波动时是正常的");
  }

  // 内存使用建议
  if (memoryUsage > 100) {
    recommendations.push("⚠️ JavaScript堆内存使用较高，可能影响性能");
  }

  return {
    timestamp: new Date().toISOString(),
    referenceCount,
    samplerStats,
    performance: {
      memoryUsage,
      lastDataFreshness: isDataFresh,
      errorCount: globalErrorCount,
    },
    recommendations,
  };
}

/**
 * 格式化诊断报告为可读字符串
 */
export function formatDiagnosticReport(report: IDiagnosticReport): string {
  return `
🔍 流量统计系统诊断报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 基本信息:
  • 生成时间: ${report.timestamp}
  • 活跃引用: ${report.referenceCount} 个组件
  • 数据新鲜度: ${report.performance.lastDataFreshness ? "✅ 新鲜" : "❌ 过期"}

💾 数据缓存状态:
  • 原始数据点: ${report.samplerStats.rawBufferSize}
  • 压缩数据点: ${report.samplerStats.compressedBufferSize}  
  • 压缩队列: ${report.samplerStats.compressionQueueSize}
  • 总内存点数: ${report.samplerStats.totalMemoryPoints}

⚡ 性能指标:
  • JS堆内存: ${report.performance.memoryUsage.toFixed(2)} MB
  • 累计错误: ${report.performance.errorCount} 次

💡 优化建议:
${report.recommendations.map((rec) => `  ${rec}`).join("\n")}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  `.trim();
}

/**
 * 自动诊断并打印报告
 */
export function runTrafficDiagnostics(
  referenceCount: number,
  samplerStats: any,
  isDataFresh: boolean,
): void {
  const report = generateDiagnosticReport(
    referenceCount,
    samplerStats,
    isDataFresh,
  );
  console.log(formatDiagnosticReport(report));
}

/**
 * 重置错误计数器
 */
export function resetErrorCount(): void {
  globalErrorCount = 0;
  console.log("[TrafficDiagnostics] 错误计数器已重置");
}

// 导出到全局对象，方便在控制台调试
if (typeof window !== "undefined") {
  (window as any).trafficDiagnostics = {
    generateDiagnosticReport,
    formatDiagnosticReport,
    runTrafficDiagnostics,
    resetErrorCount,
    recordTrafficError,
  };
}