Proxy Checker, headless, and aggregators

- headless checks/screenshots with pooled workers + cleanup
- aggregator parsing and error handling improvements
- proxy UI/i18n/export updates

Author: nbox

README.es.md

@@ -56,6 +56,20 @@ xattr -dr com.apple.quarantine "/Applications/API Key Health Checker.app"
 - Exportar informes a CSV/JSON (enmascarado o completo)
 - Idiomas de la UI: Inglés (por defecto), Ruso, Español
 
+## Proxy Checker
+
+- Tipos: HTTP, HTTPS, SOCKS4, SOCKS5; el esquema en la línea (`http://`, `https://`, `socks4://`, `socks5://`) fija el tipo.
+- Fuentes: lista manual, importación de archivo y URLs de agregadores (una por línea; se permiten comentarios con `#`).
+- Formatos: `ip:port` o `user:pass@ip:port`; normalización y deduplicación.
+- Modos: validez o acceso a URL con URL objetivo configurable.
+- Búsqueda HTML: uno o varios textos (OR). Sin headless lee solo los primeros N KB.
+- Navegador headless: carga completa con JS; capturas opcionales (carpeta, máx. archivos, autoeliminar, incluir fallidas).
+- Headless y capturas están disponibles solo en modo URL con búsqueda HTML activada.
+- Controles: el límite de velocidad es un umbral suave; el timeout es un corte duro por solicitud. Además reintentos, concurrencia, RPS máx, retraso aleatorio + jitter, máx. proxies por ejecución.
+- Resultados: cada proxy se comprueba por cada tipo seleccionado; logs/exportes incluyen tipo, modo y URL; resumen con listas por tipo y copiar/mover a la lista.
+- Resumen: separación por tipo y botón "Mover a la lista de proxies" para filtrar rápido y luego revalidar en modo más estricto (primero validez, luego URL objetivo).
+- Agregadores preinstalados en `src/renderer/lib/proxyAggregators` (son ejemplos; algunos pueden estar caídos o bloqueados por región).
+
 ## Seguridad y privacidad
 
 - Las claves se envían solo al endpoint API seleccionado

README.md

@@ -54,6 +54,20 @@ xattr -dr com.apple.quarantine "/Applications/API Key Health Checker.app"
 - Export reports to CSV/JSON (masked or full)
 - UI languages: English (default), Russian, Spanish
 
+## Proxy Checker
+
+- Types: HTTP, HTTPS, SOCKS4, SOCKS5; per-line scheme (`http://`, `https://`, `socks4://`, `socks5://`) forces the type.
+- Inputs: manual list, file import, and aggregator URLs (one per line; `#` comments allowed).
+- Formats: `ip:port` or `user:pass@ip:port`; auto-normalize and dedupe.
+- Check modes: validity or URL access with a configurable target URL.
+- HTML search: one or multiple texts (OR). Non-headless reads only the first N KB.
+- Headless browser: full page load with JS; optional screenshots (folder, max files, auto-delete, include failed).
+- Headless + screenshots are available only in URL mode with HTML search enabled.
+- Controls: speed limit is a soft latency threshold; timeout is a hard per-request cutoff. Plus retries, concurrency, max RPS, random delay + jitter, max proxies per run.
+- Results: each proxy is checked per selected type; logs/exports include proxy type, check mode, target URL; summary includes per-type lists with copy/move-to-list.
+- Summary workflow: split by proxy type, plus "Move to Proxy list" to re-check valid proxies under stricter settings (first run validity, then target URL).
+- Bundled aggregator presets live in `src/renderer/lib/proxyAggregators` (examples; some URLs may be dead or region-blocked).
+
 ## Security and privacy
 
 - Keys are sent only to the selected API endpoint

README.ru.md

@@ -56,6 +56,20 @@ xattr -dr com.apple.quarantine "/Applications/API Key Health Checker.app"
 - Экспорт отчетов в CSV/JSON (маскированный или полный)
 - Языки UI: English (по умолчанию), Русский, Español
 
+## Проверка прокси
+
+- Типы: HTTP, HTTPS, SOCKS4, SOCKS5; схема в строке (`http://`, `https://`, `socks4://`, `socks5://`) фиксирует тип.
+- Источники: ручной ввод, импорт файла и URL агрегаторов (по одному в строке; поддерживаются `#` комментарии).
+- Форматы: `ip:port` или `user:pass@ip:port`; автонормализация и дедупликация.
+- Режимы: валидность или доступ к URL с настраиваемым целевым URL.
+- Поиск в HTML: один или несколько текстов (ИЛИ). Без headless читаются только первые N КБ.
+- Headless браузер: полная загрузка страницы с JS; скриншоты по желанию (папка, лимит, автоудаление, сохранять невалидные).
+- Headless и скриншоты доступны только в режиме URL и при включённом поиске в HTML.
+- Контроль: speed limit — мягкий порог задержки, timeout — жёсткий стоп на запрос. Плюс ретраи, параллельность, лимит RPS, задержка + джиттер, лимит прокси за запуск.
+- Результаты: каждый прокси проверяется по каждому выбранному типу; в логах/экспорте есть тип, режим, URL; в сводке — списки по типам с копированием/переносом.
+- Сводка: разделение по типам и кнопка "Переместить в Proxy list", чтобы быстро отсечь валидные и затем перепроверить их в более жестком режиме (сначала доступность, потом целевой сайт).
+- Предустановленные агрегаторы лежат в `src/renderer/lib/proxyAggregators` (это примеры; ссылки могут быть недоступны из-за региональных блокировок или потому что источники умерли).
+
 ## Безопасность и приватность
 
 - Ключи отправляются только в выбранный API

src/main/engine/processManager.ts

@@ -10,6 +10,9 @@ import type {
 import { ProcessRun } from "./processRun";
 import { RateLimiter } from "./rateLimiter";
 import { HistoryStore } from "../history";
+import { registerHeadlessProcess, unregisterHeadlessProcess } from "../services/proxy";
+
+const MAX_LATENCY_SAMPLES = 2000;
 
 export interface StartProcessPayload {
   name: string;
@@ -28,6 +31,8 @@ interface StatsTracker {
   network: number;
   unknown: number;
   latencies: number[];
+  latencyCount: number;
+  latencyTotal: number;
 }
 
 function emptyStats(total: number): StatsTracker {
@@ -39,12 +44,23 @@ function emptyStats(total: number): StatsTracker {
     rateLimited: 0,
     network: 0,
     unknown: 0,
-    latencies: []
+    latencies: [],
+    latencyCount: 0,
+    latencyTotal: 0
   };
 }
 
 function updateStats(stats: StatsTracker, status: CheckStatus, latencyMs: number) {
-  stats.latencies.push(latencyMs);
+  stats.latencyCount += 1;
+  stats.latencyTotal += latencyMs;
+  if (stats.latencies.length < MAX_LATENCY_SAMPLES) {
+    stats.latencies.push(latencyMs);
+  } else {
+    const replaceIndex = Math.floor(Math.random() * stats.latencyCount);
+    if (replaceIndex < MAX_LATENCY_SAMPLES) {
+      stats.latencies[replaceIndex] = latencyMs;
+    }
+  }
   if (status === "OK") {
     stats.success += 1;
   } else if (status === "INVALID") {
@@ -61,8 +77,9 @@ function updateStats(stats: StatsTracker, status: CheckStatus, latencyMs: number
 }
 
 function finalizeSummary(stats: StatsTracker): ReportSummary {
-  const totalLatency = stats.latencies.reduce((sum, val) => sum + val, 0);
-  const avgLatencyMs = stats.latencies.length ? Math.round(totalLatency / stats.latencies.length) : 0;
+  const avgLatencyMs = stats.latencyCount
+    ? Math.round(stats.latencyTotal / stats.latencyCount)
+    : 0;
   const sorted = [...stats.latencies].sort((a, b) => a - b);
   const mid = Math.floor(sorted.length / 2);
   const medianLatencyMs =
@@ -126,6 +143,11 @@ export class ProcessManager {
     });
     this.stats.set(processId, emptyStats(payload.keys.length));
 
+    if (payload.serviceId === "proxy" && payload.settings.proxy?.headlessBrowser) {
+      const poolSize = payload.settings.proxy.headlessPoolSize ?? 0;
+      registerHeadlessProcess(processId, poolSize);
+    }
+
     const run = new ProcessRun({
       id: processId,
       name: payload.name,
@@ -167,6 +189,10 @@ export class ProcessManager {
               summary
             });
           }
+          const serviceId = meta?.serviceId ?? payload.serviceId;
+          if (serviceId === "proxy") {
+            unregisterHeadlessProcess(event.processId);
+          }
           this.sendEvent("process-completed", event);
           this.runs.delete(event.processId);
           this.stats.delete(event.processId);

src/main/main.ts

@@ -121,6 +121,27 @@ function registerIpcHandlers() {
     }
   });
 
+  ipcMain.handle("select-directory", async (_event, payload: { title?: string }) => {
+    const options = {
+      title: payload.title || "Select folder",
+      properties: ["openDirectory", "createDirectory"]
+    } satisfies Electron.OpenDialogOptions;
+
+    const parentWindow = BrowserWindow.getFocusedWindow() ?? mainWindow;
+    if (parentWindow && !parentWindow.isDestroyed()) {
+      parentWindow.focus();
+    }
+    const { canceled, filePaths } = parentWindow
+      ? await dialog.showOpenDialog(parentWindow, options)
+      : await dialog.showOpenDialog(options);
+
+    if (canceled || filePaths.length === 0) {
+      return { canceled: true };
+    }
+
+    return { canceled: false, path: filePaths[0] };
+  });
+
   ipcMain.handle("start-check", (_event, payload) => {
     return requireManager().startProcess(payload);
   });

src/main/preload.ts

@@ -4,6 +4,8 @@ import type { ExportFormat, ReportPayload } from "../shared/types";
 contextBridge.exposeInMainWorld("api", {
   getAppVersion: () => ipcRenderer.invoke("get-app-version"),
   openKeyFile: (payload: { encoding: string }) => ipcRenderer.invoke("open-key-file", payload),
+  selectDirectory: (payload: { title?: string }) =>
+    ipcRenderer.invoke("select-directory", payload),
   fetchProxyAggregators: (payload: {
     urls: string[];
     timeoutMs?: number;