tt-help-cli-ycl 1.4.169 → 1.4.172

package/scripts/test-clash-multichannel.mjs

@@ -1,120 +0,0 @@
-#!/usr/bin/env node
-/**
- * clash 多控制端多通道 — 验证脚本
- * 用法: node scripts/test-clash-multichannel.mjs
- */
-import { discoverAll, getSystemProxyPorts } from "../src/clash/discover.js";
-import * as ipc from "../src/clash/ipc.js";
-
-let failed = 0;
-function check(name, cond, extra = "") {
-  console.log(`${cond ? "✓" : "✗"} ${name}${extra ? ` — ${extra}` : ""}`);
-  if (!cond) failed++;
-}
-
-// ── 1. discoverAll：多控制端发现 ──
-const all = await discoverAll();
-console.log(`  发现 ${all.length} 个控制端:`);
-for (const c of all) {
-  console.log(
-    `    - [${c.proxyPort}] ${c.clientName} @${c.port}（${c.source}${c.fallback ? "，回退默认值" : ""}）`,
-  );
-}
-check("discoverAll 返回数组", Array.isArray(all) && all.length > 0);
-check(
-  "每个控制端含 proxyPort/proxyUrl",
-  all.every((c) => c.proxyPort > 0 && c.proxyUrl?.startsWith("http://")),
-);
-const sysPorts = getSystemProxyPorts();
-if (sysPorts.length && all.length > 1) {
-  check(
-    "system-proxy 命中者排第一（主控制端）",
-    sysPorts.includes(all[0].proxyPort),
-    `主控制端 proxyPort=${all[0].proxyPort}, 系统代理=[${sysPorts.join(",")}]`,
-  );
-} else {
-  console.log(
-    `○ 跳过主控制端排序断言（系统代理=[${sysPorts.join(",")}] 或单控制端）`,
-  );
-}
-
-// ── 2. IPC 多通道读写 ──
-const TEST_PORT = 7890;
-ipc.writeCommand(
-  { action: "failover", reason: "multichannel-test", proxyPort: TEST_PORT },
-  TEST_PORT,
-);
-const readBack = ipc.readCommand(TEST_PORT);
-check(
-  "按端口写读命令通道",
-  Array.isArray(readBack) &&
-    readBack[0]?.action === "failover" &&
-    readBack[0]?.proxyPort === TEST_PORT,
-);
-
-ipc.writeHealth({ node: "test", healthy: true }, TEST_PORT);
-const hBack = ipc.readHealth(TEST_PORT);
-check(
-  "按端口写读健康通道",
-  !!hBack && hBack.node === "test" && hBack.healthy === true,
-);
-
-// 默认通道与端口通道互不影响
-const legacyCmd = ipc.readCommand(0);
-check(
-  "默认通道独立（未被端口通道污染）",
-  !legacyCmd || legacyCmd[0]?.action !== "failover" || !legacyCmd[0]?.proxyPort,
-);
-
-const channels = ipc.listCommandChannels();
-check(
-  "listCommandChannels 含测试通道",
-  channels.includes(TEST_PORT),
-  `channels=[${channels.join(",")}]`,
-);
-
-ipc.clearCommand(TEST_PORT);
-check("clearCommand 清空端口通道", ipc.readCommand(TEST_PORT) === null);
-
-// ── 3. 路由逻辑（用 daemon 实例验证，不启动守护） ──
-import { ClashDaemon } from "../src/clash/daemon.js";
-const d = new ClashDaemon({ dryRun: true });
-d._controllers = all;
-d._primary = all[0];
-const routed = d._routeController({
-  action: "failover",
-  proxyPort: all[0].proxyPort,
-});
-check(
-  "命令按 proxyPort 路由到对应控制端",
-  !!routed && routed.proxyPort === all[0].proxyPort,
-);
-const routedMiss = d._routeController({ action: "failover", proxyPort: 59999 });
-check("未知端口回退主控制端", !!routedMiss && routedMiss === d._primary);
-
-// 多控制端时：第二个控制端也能被路由命中
-if (all.length > 1) {
-  const routed2 = d._routeController({
-    action: "switchNode",
-    node: "x",
-    proxyPort: all[1].proxyPort,
-  });
-  check(
-    "第二个控制端按端口路由命中",
-    !!routed2 && routed2.proxyPort === all[1].proxyPort,
-    `${routed2?.clientName} @${routed2?.port}`,
-  );
-} else {
-  console.log("○ 单控制端，跳过第二控制端路由断言");
-}
-
-// 清理测试产生的健康文件
-try {
-  const { rmSync } = await import("fs");
-  const { tmpdir } = await import("os");
-  const { join } = await import("path");
-  rmSync(join(tmpdir(), `clash-health-${TEST_PORT}.json`), { force: true });
-} catch {}
-
-console.log(failed ? `\n✗ ${failed} 项失败` : "\n✓ 全部通过");
-process.exit(failed ? 1 : 0);

package/scripts/test-client-error-monitor.mjs

@@ -1,261 +0,0 @@
-/**
- * 客户端异常监控单测（2026-08-28，2026-09-28 增补验证码路径，
- * 2026-09-29 改为 clientId 本机关联 —— 克隆机 hostname 撞名修复）
- *
- * 验证：
- *   - detectClientError 检测函数：
- *     A. reportCount > 8 且最近一次上报在 2 分钟内
- *     B. captchaCount ≥ 3（webserver 验证码上报，10 分钟过期窗口内累计）
- *   - 按 clientId 过滤本机条目（每台唯一）；hostname 撞名的兄弟机条目、
- *     无 clientId 的旧条目均不参与关联
- *   - 命中 → onAlert 收到本机全部条目与命中列表；未命中 → 不回调
- *   - removeErrors 逐条 DELETE 并计数
- *
- * 运行: node --test scripts/test-client-error-monitor.mjs
- */
-import { test, mock } from "node:test";
-import assert from "node:assert/strict";
-import {
-  detectClientError,
-  ClientErrorMonitor,
-} from "../src/watchdog/client-error-monitor.js";
-
-// 模拟克隆机群：hostname 全部相同（事故现场），clientId 每台唯一
-const CLONED_HOST = "WIN-AADJ1HTCCAQ";
-const CLIENT_ID = `F-9@${CLONED_HOST}`;
-const BROTHER_CLIENT_ID = `F-10@${CLONED_HOST}`;
-
-function makeErr(overrides = {}) {
-  return {
-    userId: "u1",
-    hostname: CLONED_HOST,
-    clientId: CLIENT_ID,
-    errorType: "consecutive_blocked",
-    reportCount: 10,
-    timestamp: Date.now() - 30_000,
-    ...overrides,
-  };
-}
-
-function makeMonitor(opts = {}) {
-  let received = null;
-  let alerted = false;
-  const m = new ClientErrorMonitor({
-    serverUrl: "http://127.0.0.1:3000",
-    hostname: CLONED_HOST, // 仅展示用；关联只认 clientId
-    clientId: CLIENT_ID,
-    onAlert: async (mine, hit) => {
-      alerted = true;
-      received = { mine, hit };
-    },
-    ...opts,
-  });
-  return { m, isAlerted: () => alerted, getReceived: () => received };
-}
-
-// ── 检测函数 ──
-
-test("D1 detectClientError：累计>8 且 2 分钟内 → 命中", () => {
-  assert.equal(
-    detectClientError(makeErr({ reportCount: 9 }), Date.now()),
-    true,
-  );
-});
-
-test("D2 detectClientError：reportCount=8 不命中（阈值是 >8）", () => {
-  assert.equal(
-    detectClientError(makeErr({ reportCount: 8 }), Date.now()),
-    false,
-  );
-});
-
-test("D3 detectClientError：最近上报超过 2 分钟 → 不命中", () => {
-  assert.equal(
-    detectClientError(
-      makeErr({ timestamp: Date.now() - 2 * 60_000 - 1 }),
-      Date.now(),
-    ),
-    false,
-  );
-});
-
-test("D4 detectClientError：缺 reportCount → 不命中", () => {
-  assert.equal(detectClientError({ timestamp: Date.now() }, Date.now()), false);
-});
-
-// ── 验证码路径（captchaCount ≥ 3） ──
-
-test("C1 detectClientError：captchaCount=3 → 命中", () => {
-  assert.equal(
-    detectClientError(makeErr({ reportCount: 0, captchaCount: 3 }), Date.now()),
-    true,
-  );
-});
-
-test("C2 detectClientError：captchaCount=2 不命中（阈值是 ≥3）", () => {
-  assert.equal(
-    detectClientError(makeErr({ reportCount: 0, captchaCount: 2 }), Date.now()),
-    false,
-  );
-});
-
-test("C3 detectClientError：captchaCount=3 但最近上报超 2 分钟 → 不命中", () => {
-  assert.equal(
-    detectClientError(
-      makeErr({
-        reportCount: 0,
-        captchaCount: 3,
-        timestamp: Date.now() - 2 * 60_000 - 1,
-      }),
-      Date.now(),
-    ),
-    false,
-  );
-});
-
-test("C4 detectClientError：reportCount 未达标 + captchaCount 达标 → 命中", () => {
-  assert.equal(
-    detectClientError(makeErr({ reportCount: 1, captchaCount: 5 }), Date.now()),
-    true,
-  );
-});
-
-test("C5 监控器：验证码条目命中 → onAlert 收到命中列表", async () => {
-  const captchaHit = makeErr({
-    userId: "webserver-host",
-    reportCount: 0,
-    captchaCount: 3,
-  });
-  const businessMiss = makeErr({ userId: "u-task", reportCount: 2 });
-  mock.method(globalThis, "fetch", async () => ({
-    ok: true,
-    json: async () => ({ clients: [captchaHit, businessMiss] }),
-  }));
-  const { m, getReceived } = makeMonitor();
-  const hit = await m._poll();
-  assert.equal(hit.length, 1, "仅验证码条目命中");
-  assert.equal(hit[0].userId, "webserver-host");
-  assert.equal(getReceived().hit.length, 1);
-  assert.equal(getReceived().mine.length, 2, "回调同时携带本机未命中条目");
-  mock.restoreAll();
-});
-
-// ── 监控器：本机关联（clientId） ──
-
-test("M1 按 clientId 过滤：撞名兄弟机条目不触发本机回调", async () => {
-  // 克隆机事故回归：F-10 与 F-9 hostname 完全相同，仅 clientId 不同
-  mock.method(globalThis, "fetch", async () => ({
-    ok: true,
-    json: async () => ({
-      clients: [
-        makeErr({
-          userId: "F-10-8222-1",
-          clientId: BROTHER_CLIENT_ID,
-          captchaCount: 3,
-          reportCount: 0,
-        }),
-      ],
-    }),
-  }));
-  const { m, isAlerted } = makeMonitor();
-  const hit = await m._poll();
-  assert.equal(isAlerted(), false, "兄弟机异常不应触发本机回调/强切");
-  assert.equal(hit, null, "无本机条目应返回 null");
-  mock.restoreAll();
-});
-
-test("M2 命中：onAlert 收到本机全部条目（含未命中条目）", async () => {
-  const mineHit = makeErr({ userId: "u-hit", reportCount: 10 });
-  const mineMiss = makeErr({ userId: "u-miss", reportCount: 2 });
-  const other = makeErr({
-    userId: "u-other",
-    clientId: BROTHER_CLIENT_ID, // hostname 相同，clientId 不同
-  });
-  mock.method(globalThis, "fetch", async () => ({
-    ok: true,
-    json: async () => ({ clients: [mineHit, mineMiss, other] }),
-  }));
-  const { m, getReceived } = makeMonitor();
-  const hit = await m._poll();
-  assert.equal(hit.length, 1, "命中 1 条");
-  assert.equal(hit[0].userId, "u-hit");
-  assert.equal(getReceived().mine.length, 2, "回调收到本机全部 2 条");
-  assert.deepEqual(
-    getReceived()
-      .mine.map((e) => e.userId)
-      .sort(),
-    ["u-hit", "u-miss"],
-    "回调含命中与未命中的本机条目",
-  );
-  mock.restoreAll();
-});
-
-test("M3 无 clientId 的旧条目不参与本机关联（宁漏不误）", async () => {
-  mock.method(globalThis, "fetch", async () => ({
-    ok: true,
-    json: async () => ({
-      clients: [makeErr({ clientId: "", reportCount: 99 })],
-    }),
-  }));
-  const { m, isAlerted } = makeMonitor();
-  const hit = await m._poll();
-  assert.equal(isAlerted(), false, "旧版上报条目不应触发强切");
-  assert.equal(hit, null);
-  mock.restoreAll();
-});
-
-test("M4 未配置 clientId 的监控器：不匹配任何条目", async () => {
-  mock.method(globalThis, "fetch", async () => ({
-    ok: true,
-    json: async () => ({ clients: [makeErr({ reportCount: 99 })] }),
-  }));
-  let alerted = false;
-  const m = new ClientErrorMonitor({
-    serverUrl: "http://127.0.0.1:3000",
-    onAlert: async () => {
-      alerted = true;
-    },
-  });
-  const hit = await m._poll();
-  assert.equal(alerted, false, "clientId 未配置时监控不生效");
-  assert.equal(hit, null);
-  mock.restoreAll();
-});
-
-test("M5 removeErrors：逐条 DELETE 并计数", async () => {
-  const deleted = [];
-  mock.method(globalThis, "fetch", async (url, opts) => {
-    if (opts && opts.method === "DELETE") {
-      deleted.push(String(url));
-      return { ok: true };
-    }
-    return { ok: true, json: async () => ({ clients: [] }) };
-  });
-  const m = new ClientErrorMonitor({ serverUrl: "http://127.0.0.1:3000" });
-  const removed = await m.removeErrors([
-    { userId: "a" },
-    { userId: "b" },
-    { userId: "" },
-    null,
-  ]);
-  assert.equal(removed, 2, "有效 userId 各删一条");
-  assert.equal(deleted.length, 2, "共 2 次 DELETE");
-  assert.ok(
-    deleted.every((u) =>
-      ["a", "b"].some((id) => u.endsWith(`/api/client-error/${id}`)),
-    ),
-    "DELETE 路径正确",
-  );
-  mock.restoreAll();
-});
-
-test("M6 拉取失败静默：fetch 抛错不回调不崩溃", async () => {
-  mock.method(globalThis, "fetch", async () => {
-    throw new Error("ECONNREFUSED");
-  });
-  const { m, isAlerted } = makeMonitor();
-  const hit = await m._poll();
-  assert.equal(isAlerted(), false);
-  assert.equal(hit, null);
-  mock.restoreAll();
-});