tt-help-cli-ycl 1.4.79 → 1.4.80

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tt-help-cli-ycl",
-  "version": "1.4.79",
+  "version": "1.4.80",
   "description": "TikTok user & video data scraper - extract ttSeller, verified, locationCreated from HTML source",
   "type": "module",
   "bin": {

package/src/clash/api.js

@@ -101,6 +101,23 @@ export async function getNodes() {
 export async function getConfigs() {
   return request("/configs");
 }
+
+/**
+ * 从 Clash API 自动发现代理端口（mixed-port）
+ * 无需依赖任何配置文件，直接问 Clash 自己
+ * @returns {Promise<string>} 代理 URL，如 "http://127.0.0.1:7897"
+ */
+export async function resolveProxyUrl() {
+  try {
+    const configs = await getConfigs();
+    const port = configs?.["mixed-port"] || 7897;
+    return `http://127.0.0.1:${port}`;
+  } catch {
+    // Clash API 不可达，回退到默认值
+    return "http://127.0.0.1:7897";
+  }
+}
+
 export async function patchConfigs(patch) {
   return request("/configs", { method: "PATCH", body: JSON.stringify(patch) });
 }

package/src/clash/checker.js

@@ -1,16 +1,24 @@
 /**
- * 节点健康检测 — 纯函数模块
+ * Clash 节点健康检测 — 统一模块
  *
- * 职责：
- *   1. 检测 Clash Verge 进程存活（跨平台 mac/win）
- *   2. 检测当前代理节点对目标 URL 的健康状态
- *   3. 健康节点列表持久化
- *   4. 故障切换候选节点选取
+ * 职责:
+ *   1. 检测 Clash Verge 进程/API 存活（跨平台 mac/win）
+ *   2. 自动发现代理端口（GET /configs → mixed-port）
+ *   3. 节点健康检测（curl 穿透代理请求 TikTok）
+ *   4. 国家过滤（按节点名 emoji 匹配）
+ *   5. 健康节点列表持久化 + 故障切换
+ *   6. CLI 入口硬门控预检
  */
+
 import { spawnSync } from "child_process";
 import { readFileSync, writeFileSync, existsSync } from "fs";
 import { join } from "path";
 import { tmpdir } from "os";
+import * as api from "./api.js";
+
+// ══════════════════════════════════════════════
+// 常量 & 配置
+// ══════════════════════════════════════════════
 
 const IS_WIN = process.platform === "win32";
 const HEALTHY_FILE = join(tmpdir(), "clash-healthy-nodes.json");
@@ -22,145 +30,261 @@ export const CONFIG = {
   groupName: "GLOBAL",
   curlTimeout: 12,
   minPageSize: 50 * 1024,
+  nodeCountryFilter: null,
 };
 
-// ---- 进程检测 ----
+const CURL_UA =
+  "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36";
+
+const COUNTRY_PATTERNS = {
+  US: /[🇺🇸]\s*(美国|US|USA|United\s*States)/i,
+  GB: /[🇬🇧]\s*(英国|UK|GB|United\s*Kingdom)/i,
+  DE: /[🇩🇪]\s*(德国|DE|Germany)/i,
+  FR: /[🇫🇷]\s*(法国|FR|France)/i,
+  JP: /[🇯🇵]\s*(日本|JP|Japan)/i,
+  KR: /[🇰🇷]\s*(韩国|KR|Korea)/i,
+  SG: /[🇸🇬]\s*(新加坡|SG|Singapore)/i,
+  HK: /[🇭🇰]\s*(香港|HK|Hong\s*Kong)/i,
+  TW: /[🇹🇼]\s*(台湾|TW|Taiwan)/i,
+  RU: /[🇷🇺]\s*(俄罗斯|RU|Russia)/i,
+  NL: /[🇳🇱]\s*(荷兰|NL|Netherlands)/i,
+  IN: /[🇮🇳]\s*(印度|IN|India)/i,
+  CA: /[🇨🇦]\s*(加拿大|CA|Canada)/i,
+  AU: /[🇦🇺]\s*(澳大利亚|AU|Australia)/i,
+  MY: /[🇲🇾]\s*(马来西亚|MY|Malaysia)/i,
+};
+
+let _proxyResolved = false;
+
+// ══════════════════════════════════════════════
+// 1. 代理端口自动发现
+// ══════════════════════════════════════════════
+
+export async function resolveAndSetProxyUrl() {
+  if (_proxyResolved) return CONFIG.proxyUrl;
+  try { CONFIG.proxyUrl = await api.resolveProxyUrl(); } catch {}
+  _proxyResolved = true;
+  return CONFIG.proxyUrl;
+}
+
+export function resetProxyUrlCache() { _proxyResolved = false; }
+
+// ══════════════════════════════════════════════
+// 2. 进程 / API 可达性检测
+// ══════════════════════════════════════════════
 
 export function checkClashAlive() {
+  return checkClashAliveWithReason().alive;
+}
+
+export function checkClashAliveWithReason() {
+  if (_detectProcess()) return { alive: true, reason: "verge-mihomo 进程已运行" };
+  if (_detectApi())    return { alive: true, reason: `API 端口 ${CONFIG.apiPort} 可达` };
+  return {
+    alive: false,
+    reason: `Clash Verge 未运行，或 API 端口 ${CONFIG.apiPort} 未开启（请在 Clash Verge 设置中开启"允许局域网连接"或"RESTful API"）`,
+  };
+}
+
+function _detectProcess() {
   try {
     if (IS_WIN) {
-      const r = spawnSync(
-        "tasklist",
-        ["/FI", "IMAGENAME eq verge-mihomo.exe", "/NH"],
-        {
-          encoding: "utf-8",
-          timeout: 5000,
-          stdio: ["pipe", "pipe", "pipe"],
-        },
-      );
-      if (r.stdout?.includes("verge-mihomo.exe")) return true;
-    } else {
-      const r = spawnSync("pgrep", ["-x", "verge-mihomo"], {
-        encoding: "utf-8",
-        timeout: 5000,
-        stdio: ["pipe", "pipe", "pipe"],
-      });
-      if (r.status === 0 && r.stdout.trim()) return true;
+      const r = spawnSync("tasklist", ["/FI", "IMAGENAME eq verge-mihomo.exe", "/NH"],
+        { encoding: "utf-8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+      return r.stdout?.includes("verge-mihomo.exe");
     }
-  } catch {
-    /* fallthrough */
-  }
+    const r = spawnSync("pgrep", ["-x", "verge-mihomo"],
+      { encoding: "utf-8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+    return r.status === 0 && !!r.stdout.trim();
+  } catch { return false; }
+}
 
+function _detectApi() {
   try {
     const exe = IS_WIN ? "curl.exe" : "curl";
-    const r = spawnSync(
-      exe,
-      ["-s", "--max-time", "3", `http://127.0.0.1:${CONFIG.apiPort}/version`],
-      {
-        encoding: "utf-8",
-        timeout: 5000,
-        stdio: ["pipe", "pipe", "pipe"],
-      },
-    );
+    const r = spawnSync(exe, ["-s", "--max-time", "3",
+      `http://127.0.0.1:${CONFIG.apiPort}/version`],
+      { encoding: "utf-8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
     return r.stdout.includes('"version"');
-  } catch {
-    return false;
+  } catch { return false; }
+}
+
+export async function requireClashOrExit(label = "") {
+  const { alive, reason } = checkClashAliveWithReason();
+  if (!alive) {
+    const pf = label ? `[${label}] ` : "";
+    console.error(`\n${pf}⚠ 代理不可用：${reason}`);
+    console.error(`${pf}请先启动 Clash Verge 并确保：`);
+    console.error(`  1. Clash Verge 正在运行（verge-mihomo 进程存活）`);
+    console.error(`  2. API 端口 ${CONFIG.apiPort} 已开启（设置 → 允许局域网连接 / RESTful API）`);
+    console.error(`  3. 代理端口 ${CONFIG.proxyUrl.replace("http://", "")} 正在监听\n`);
+    process.exit(1);
   }
+  return resolveAndSetProxyUrl();
 }
 
-// ---- 节点健康检测 ----
+// ══════════════════════════════════════════════
+// 3. 节点健康检测（同步 curl）
+// ══════════════════════════════════════════════
 
 export function checkNodeHealth(url = CONFIG.testUrl) {
+  const { body, metaLine, error } = _curlViaProxy(url);
+  const { httpCode, timeTotal, sizeDownload } = _parseCurlMeta(metaLine);
+  const title = _extractTitle(body);
+  return {
+    healthy: _isHealthyPage(error, httpCode, sizeDownload, title, body),
+    httpCode, timeTotal, sizeDownload, title, error,
+  };
+}
+
+function _curlViaProxy(url) {
   const args = [
-    "-s",
-    "-w",
-    "\n__CURL_META__%{http_code}|%{time_total}|%{size_download}",
-    "--proxy",
-    CONFIG.proxyUrl,
-    "--max-time",
-    String(CONFIG.curlTimeout),
-    "-L",
-    "-A",
-    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
-    url,
+    "-s", "-w", "\n__CURL_META__%{http_code}|%{time_total}|%{size_download}",
+    "--proxy", CONFIG.proxyUrl,
+    "--max-time", String(CONFIG.curlTimeout),
+    "-L", "-A", CURL_UA, url,
   ];
-  const result = spawnSync("curl", args, {
+  const r = spawnSync("curl", args, {
     encoding: "utf-8",
     timeout: (CONFIG.curlTimeout + 5) * 1000,
     stdio: ["pipe", "pipe", "pipe"],
     maxBuffer: 10 * 1024 * 1024,
   });
+  const out = r.stdout || "";
+  const idx = out.lastIndexOf("__CURL_META__");
+  return {
+    body:     idx >= 0 ? out.substring(0, idx).trimEnd() : "",
+    metaLine: idx >= 0 ? out.substring(idx + 13).trim() : "",
+    error:    r.error ? r.error.message : r.status !== 0 ? `curl exit ${r.status}` : null,
+  };
+}
 
-  const stdout = result.stdout || "";
-  const idx = stdout.lastIndexOf("__CURL_META__");
-  let body = "",
-    metaLine = "";
-  if (idx >= 0) {
-    body = stdout.substring(0, idx).trimEnd();
-    metaLine = stdout.substring(idx + 13).trim();
-  }
-  const parts = metaLine.split("|");
-  const httpCode = parseInt(parts[0]) || 0;
-  const timeTotal = parseFloat(parts[1]) || 0;
-  const sizeDownload = parseInt(parts[2]) || 0;
+function _parseCurlMeta(line) {
+  const p = line.split("|");
+  return { httpCode: parseInt(p[0]) || 0, timeTotal: parseFloat(p[1]) || 0, sizeDownload: parseInt(p[2]) || 0 };
+}
 
-  let title = "";
+function _extractTitle(body) {
   const m = body.match(/<title>([^<]*)<\/title>/i);
-  if (m) title = m[1].trim();
+  return m ? m[1].trim() : "";
+}
 
-  let error = null;
-  if (result.error) error = result.error.message;
-  else if (result.status !== 0) error = `curl exit ${result.status}`;
+function _isHealthyPage(error, httpCode, size, title, body) {
+  return !error && httpCode === 200 && size >= CONFIG.minPageSize &&
+    title.includes("TikTok") && !title.startsWith("About |") &&
+    !body.includes("SlardarWAF") && !body.includes("_wafchallengeid");
+}
 
-  const healthy =
-    !error &&
-    httpCode === 200 &&
-    sizeDownload >= CONFIG.minPageSize &&
-    title.includes("TikTok") &&
-    !title.startsWith("About |") &&
-    !body.includes("SlardarWAF") &&
-    !body.includes("_wafchallengeid");
+// ══════════════════════════════════════════════
+// 4. 国家过滤
+// ══════════════════════════════════════════════
 
-  return { healthy, httpCode, timeTotal, sizeDownload, title, error };
+export function filterNodesByCountry(nodes, country) {
+  if (!country || !COUNTRY_PATTERNS[country]) return { filtered: nodes, excluded: 0 };
+  const filtered = nodes.filter(n => COUNTRY_PATTERNS[country].test(n));
+  return { filtered, excluded: nodes.length - filtered.length };
 }
 
-// ---- 健康节点列表持久化 ----
+export function getSupportedCountries() {
+  return Object.keys(COUNTRY_PATTERNS);
+}
+
+// ══════════════════════════════════════════════
+// 5. 健康节点列表持久化
+// ══════════════════════════════════════════════
 
-export function loadHealthyList() {
+export function loadHealthyList(country = null) {
   try {
-    if (existsSync(HEALTHY_FILE)) {
-      const d = JSON.parse(readFileSync(HEALTHY_FILE, "utf-8"));
-      return {
-        updated: d.updated || "",
-        nodes: Array.isArray(d.nodes) ? d.nodes : [],
-      };
-    }
+    if (!existsSync(HEALTHY_FILE)) return _emptyList();
+    const d = JSON.parse(readFileSync(HEALTHY_FILE, "utf-8"));
+    const allNodes = Array.isArray(d.nodes) ? d.nodes : [];
+    const filter = country || CONFIG.nodeCountryFilter;
+    const { filtered, excluded } = filterNodesByCountry(allNodes, filter);
+    return { updated: d.updated || "", nodes: filtered, totalNodes: allNodes.length, excluded, countryFilter: filter || null };
   } catch (e) {
     console.error(`[checker] 读取健康列表失败: ${e.message}`);
   }
-  return { updated: "", nodes: [] };
+  return _emptyList();
 }
 
 export function saveHealthyList(nodes) {
   try {
-    writeFileSync(
-      HEALTHY_FILE,
-      JSON.stringify({ updated: new Date().toISOString(), nodes }, null, 2),
-      "utf-8",
-    );
+    writeFileSync(HEALTHY_FILE,
+      JSON.stringify({ updated: new Date().toISOString(), nodes }, null, 2), "utf-8");
   } catch (e) {
     console.error(`[checker] 保存健康列表失败: ${e.message}`);
   }
 }
 
-// ---- 故障切换候选选取 ----
+function _emptyList() {
+  return { updated: "", nodes: [], totalNodes: 0, excluded: 0, countryFilter: null };
+}
+
+// ══════════════════════════════════════════════
+// 6. 故障切换
+// ══════════════════════════════════════════════
 
 export function pickFailoverNode(currentNode, healthyNodes) {
   if (!healthyNodes?.length) return null;
-  const candidates = healthyNodes.filter((n) => n !== currentNode);
+  const candidates = healthyNodes.filter(n => n !== currentNode);
   if (!candidates.length) {
     console.error(`[checker] 无可用候选节点（共${healthyNodes.length}个）`);
     return null;
   }
   return candidates[Math.floor(Math.random() * candidates.length)];
 }
+
+export async function switchToNode(nodeName) {
+  try {
+    await api.switchProxy(CONFIG.groupName, nodeName);
+    await new Promise(r => setTimeout(r, 600));
+    const current = await api.getCurrentNode(CONFIG.groupName);
+    if (current !== nodeName) {
+      console.error(`[checker] 切换验证失败: 期望 ${nodeName}, 实际 ${current}`);
+      return false;
+    }
+    return true;
+  } catch (e) {
+    console.error(`[checker] 切换节点失败: ${e.message}`);
+    return false;
+  }
+}
+
+// ══════════════════════════════════════════════
+// 7. 一站式巡检
+// ══════════════════════════════════════════════
+
+export async function runHealthCheck() {
+  if (!checkClashAlive()) return { action: "skipped", detail: "Clash Verge 未运行" };
+  await resolveAndSetProxyUrl();
+
+  const health = checkNodeHealth();
+  if (health.healthy) {
+    return { action: "ok", detail: `${health.timeTotal.toFixed(1)}s ${(health.sizeDownload / 1024).toFixed(0)}KB` };
+  }
+
+  const reason = health.error
+    ? `错误: ${health.error}`
+    : `HTTP ${health.httpCode} ${(health.sizeDownload / 1024).toFixed(0)}KB "${health.title}"`;
+
+  let currentNode;
+  try { currentNode = await api.getCurrentNode(CONFIG.groupName); }
+  catch (e) { return { action: "failed", detail: `无法获取当前节点: ${e.message}` }; }
+
+  const { nodes } = loadHealthyList();
+  if (!nodes.length) return { action: "failed", detail: `${reason} — 健康列表为空` };
+
+  const target = pickFailoverNode(currentNode, nodes);
+  if (!target) return { action: "failed", detail: `${reason} — 无可用候选节点` };
+
+  if (!(await switchToNode(target))) {
+    return { action: "failed", detail: `${reason} → 切换到 ${target} 失败` };
+  }
+
+  const newHealth = checkNodeHealth();
+  const detail = newHealth.healthy
+    ? `${currentNode} → ${target} (${newHealth.timeTotal.toFixed(1)}s ${(newHealth.sizeDownload / 1024).toFixed(0)}KB)`
+    : `${currentNode} → ${target} (切换后仍异常: ${newHealth.httpCode} ${(newHealth.sizeDownload / 1024).toFixed(0)}KB)`;
+
+  return { action: "switched", detail };
+}