mihomo-cli 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.2.0] - 2026-05-01
+
+### 新增
+
+- **节点测速**：`sub test [name]` 测试订阅节点连通性，支持 `-t` 超时和 `-j` 并发参数
+- **节点清理**：`sub clean [name]` 测速后自动清理不可用节点，移除空分组
+- **启动自动清理**：`start` / `start tun` 启动时，节点数超过 100 自动执行清理
+
+### 安全
+
+- **强制端口配置**：HTTP 端口固定 7890，SOCKS5 端口固定 7891，忽略订阅中的 `mixed-port` 配置
+
+---
+
 ## [2.1.0] - 2026-05-01
 
 ### 新增

package/README.md

@@ -7,6 +7,7 @@
 - 🌐 **订阅管理** - 添加/更新订阅，支持流量统计和到期时间显示
 - 🔄 **自动更新** - 启动时自动检查并更新过期订阅
 - 🔍 **模糊匹配** - `sub use` / `sub web` 支持订阅名称模糊匹配
+- 🧹 **节点测速清理** - `sub test` 测试连通性，`sub clean` 自动清理失败节点，启动时超过 100 节点自动清理
 - 📝 **覆写配置** - 在订阅基础上进行自定义覆写，支持强制覆盖、数组合并
 - 🔄 **智能重启** - `sub use` 切换订阅、`ow on/off` 切换覆写后自动重启
 - 🚀 **进程管理** - 启动/停止/切换模式，自动清理残留进程
@@ -100,6 +101,8 @@ mihomo ui yacd     # YACD
 | `mihomo sub update <name>`    | 更新指定订阅（支持模糊匹配）           |
 | `mihomo sub remove <name>`    | 删除订阅（支持模糊匹配）               |
 | `mihomo sub web [name]`       | 打开订阅页面（无参打开默认）           |
+| `mihomo sub test [name]`      | 测试节点连通性（`-t` 超时，`-j` 并发） |
+| `mihomo sub clean [name]`     | 测速并清理失败节点                     |
 
 ### 覆写配置
 
@@ -290,9 +293,10 @@ sudo pkill -9 mihomo
 
 ### 端口被占用
 
-默认端口（取决于订阅配置）：
+默认端口（系统强制，不受订阅配置影响）：
 
-- Mixed 端口: `7890`
+- HTTP 端口: `7890`
+- SOCKS5 端口: `7891`
 - 外部控制器: `127.0.0.1:9090`
 
 ## 安全特性

package/dist/index.js

@@ -2704,6 +2704,8 @@ var TUN_CONFIG = {
 var BASE_CONFIG = {
   "allow-lan": false,
   "external-controller": "127.0.0.1:9090",
+  port: 7890,
+  "socks-port": 7891,
   "log-level": "warning",
   "geodata-mode": true,
   "geo-update-interval": 24,
@@ -3029,6 +3031,9 @@ function buildConfig(subRawContent, mode) {
   }
   systemConfig["allow-lan"] = false;
   systemConfig["external-controller"] = BASE_CONFIG["external-controller"];
+  systemConfig.port = BASE_CONFIG.port;
+  systemConfig["socks-port"] = BASE_CONFIG["socks-port"];
+  delete withOverwrites["mixed-port"];
   delete withOverwrites["external-ui"];
   delete withOverwrites["external-ui-name"];
   delete withOverwrites["external-ui-url"];
@@ -3145,6 +3150,9 @@ var colors = {
 function sleepSync(ms) {
   Atomics.wait(sleepBuf, 0, 0, ms);
 }
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
 function formatBytes(bytes) {
   if (bytes === void 0 || bytes === null) return "\u672A\u77E5";
   const num = Number(bytes);
@@ -3867,6 +3875,8 @@ ${colors.cyan("\u8BA2\u9605:")}
   ${colors.bold("subscription")} update [name]   \u66F4\u65B0\u8BA2\u9605\uFF08\u65E0\u53C2\u66F4\u65B0\u6240\u6709\uFF09
   ${colors.bold("subscription")} remove <name>   \u5220\u9664\u8BA2\u9605
   ${colors.bold("subscription")} web [name]      \u6253\u5F00\u8BA2\u9605\u9875\u9762
+  ${colors.bold("subscription")} test [name]     \u6D4B\u8BD5\u8282\u70B9\u8FDE\u901A\u6027
+  ${colors.bold("subscription")} clean [name]    \u6D4B\u901F\u5E76\u6E05\u7406\u5931\u8D25\u8282\u70B9
 
 ${colors.cyan("\u914D\u7F6E:")}
   ${colors.bold("overwrite")}                   \u67E5\u770B\u8986\u5199\u72B6\u6001\uFF08\u522B\u540D ow\uFF09
@@ -4268,7 +4278,25 @@ import path5 from "path";
 
 // src/subscription.ts
 var DEFAULT_UPDATE_INTERVAL_HOURS = 12;
+var YAML_DUMP_OPTS = { indent: 2, lineWidth: -1, noCompatMode: true };
 var HTTP_CLIENT2 = createHttpClient({ timeout: 6e4 });
+function loadSubscriptionConfig(subName) {
+  const rawContent = readSubscriptionRawConfig(subName);
+  if (!rawContent) {
+    throw new Error(`\u672A\u627E\u5230\u8BA2\u9605\u914D\u7F6E "${subName}"`);
+  }
+  const raw = parseYamlOrJson(rawContent, "\u8BA2\u9605\u5185\u5BB9");
+  return {
+    raw,
+    proxies: raw.proxies || [],
+    proxyGroups: raw["proxy-groups"] || []
+  };
+}
+function saveSubscriptionConfig(subName, parsed) {
+  parsed.raw.proxies = parsed.proxies;
+  parsed.raw["proxy-groups"] = parsed.proxyGroups;
+  saveSubscriptionRawConfig(subName, jsYaml.dump(parsed.raw, YAML_DUMP_OPTS));
+}
 function parseUserInfo(header) {
   if (!header) return null;
   const info = {};
@@ -4443,6 +4471,122 @@ async function autoUpdateStaleSubscription() {
   }
   return { total: staleSubs.length, updated: updatedCount, failed: staleSubs.length - updatedCount };
 }
+var API_BASE = `http://${BASE_CONFIG["external-controller"]}`;
+var DEFAULT_TEST_URL = "http://www.gstatic.com/generate_204";
+async function testProxyDelay(proxyName, timeout, testUrl, client) {
+  const encodedName = encodeURIComponent(proxyName);
+  const url = `${API_BASE}/proxies/${encodedName}/delay?timeout=${timeout}&url=${encodeURIComponent(testUrl)}`;
+  try {
+    const response = await client.get(url);
+    const data = JSON.parse(response.data);
+    if (data.delay && data.delay > 0) {
+      return { name: proxyName, delay: data.delay };
+    }
+    return { name: proxyName, delay: null, error: data.message || "no delay" };
+  } catch (e) {
+    const err = e;
+    let errorMsg = "timeout";
+    if (err.response?.data?.message) {
+      errorMsg = String(err.response.data.message);
+    } else if (err.message) {
+      errorMsg = err.message;
+    }
+    return { name: proxyName, delay: null, error: errorMsg };
+  }
+}
+async function testSubscriptionProxies(subName, options = {}) {
+  const { timeout = 2e3, concurrency = 100, testUrl = DEFAULT_TEST_URL, onResult } = options;
+  const { proxies } = options.parsed || loadSubscriptionConfig(subName);
+  if (proxies.length === 0) {
+    return { total: 0, alive: 0, dead: 0, results: [] };
+  }
+  const client = createHttpClient({ timeout: timeout + 3e3 });
+  const results = [];
+  let completedCount = 0;
+  for (let i = 0; i < proxies.length; i += concurrency) {
+    const batch = proxies.slice(i, i + concurrency);
+    const batchResults = await Promise.all(batch.map((proxy) => testProxyDelay(proxy.name, timeout, testUrl, client)));
+    for (const result of batchResults) {
+      results.push(result);
+      onResult?.(result, completedCount, proxies.length);
+      completedCount++;
+    }
+  }
+  const alive = results.filter((r) => r.delay !== null).length;
+  return { total: results.length, alive, dead: results.length - alive, results };
+}
+function shortenProxyNames(parsed) {
+  const { proxies, proxyGroups } = parsed;
+  const renameMap = /* @__PURE__ */ new Map();
+  const usedNames = /* @__PURE__ */ new Set();
+  for (const proxy of proxies) {
+    const shortened = proxy.name.replace(/_github\.com\/[^_]+/, "");
+    if (shortened !== proxy.name && !usedNames.has(shortened)) {
+      renameMap.set(proxy.name, shortened);
+      usedNames.add(shortened);
+    } else {
+      usedNames.add(proxy.name);
+    }
+  }
+  if (renameMap.size === 0) return 0;
+  for (const proxy of proxies) {
+    const newName = renameMap.get(proxy.name);
+    if (newName) proxy.name = newName;
+  }
+  for (const group of proxyGroups) {
+    if (Array.isArray(group.proxies)) {
+      group.proxies = group.proxies.map((name) => renameMap.get(name) || name);
+    }
+  }
+  return renameMap.size;
+}
+function cleanDeadProxies(parsed, deadNames) {
+  const { proxies, proxyGroups } = parsed;
+  const originalCount = proxies.length;
+  parsed.proxies = proxies.filter((p) => !deadNames.has(p.name));
+  const removedProxies = originalCount - parsed.proxies.length;
+  let updatedGroups = 0;
+  const removedGroupNames = /* @__PURE__ */ new Set();
+  for (const group of proxyGroups) {
+    if (Array.isArray(group.proxies)) {
+      const before = group.proxies.length;
+      group.proxies = group.proxies.filter((name) => !deadNames.has(name));
+      if (group.proxies.length < before) {
+        updatedGroups++;
+      }
+      if (group.proxies.length === 0) {
+        removedGroupNames.add(group.name);
+      }
+    }
+  }
+  if (removedGroupNames.size > 0) {
+    parsed.proxyGroups = proxyGroups.filter((g) => !removedGroupNames.has(g.name));
+    for (const group of parsed.proxyGroups) {
+      if (Array.isArray(group.proxies)) {
+        group.proxies = group.proxies.filter((name) => !removedGroupNames.has(name));
+      }
+    }
+  }
+  return { removedProxies, updatedGroups, removedGroups: removedGroupNames.size };
+}
+async function autoCleanSubscription(subName, options = {}) {
+  const parsed = loadSubscriptionConfig(subName);
+  shortenProxyNames(parsed);
+  saveSubscriptionConfig(subName, parsed);
+  const summary = await testSubscriptionProxies(subName, { ...options, parsed });
+  let removedProxies = 0;
+  let updatedGroups = 0;
+  let removedGroups = 0;
+  if (summary.dead > 0) {
+    const deadNames = new Set(summary.results.filter((r) => r.delay === null).map((r) => r.name));
+    const cleanResult = cleanDeadProxies(parsed, deadNames);
+    removedProxies = cleanResult.removedProxies;
+    updatedGroups = cleanResult.updatedGroups;
+    removedGroups = cleanResult.removedGroups;
+    saveSubscriptionConfig(subName, parsed);
+  }
+  return { summary, removedProxies, updatedGroups, removedGroups };
+}
 
 // src/commands/status.ts
 function printStatus() {
@@ -4495,124 +4639,456 @@ function printStatus() {
   console.log("");
 }
 
-// src/commands/start.ts
-function handleStopResult(result) {
-  if (result.remaining && result.remaining.length > 0) {
-    console.error(`${colors.red("\u90E8\u5206\u8FDB\u7A0B\u672A\u7EC8\u6B62:")} ${result.remaining.join(", ")}`);
-    console.error("\u8BF7\u624B\u52A8\u8FD0\u884C: sudo pkill -9 mihomo");
-    process.exit(1);
+// src/commands/subscription.ts
+function printTestResult(result, index, total) {
+  const prefix = `[${index + 1}/${total}]`;
+  if (result.delay !== null) {
+    const delayColor = result.delay < 300 ? colors.green : result.delay < 800 ? colors.yellow : colors.red;
+    console.log(`  ${prefix} ${colors.green("\u2713")} ${result.name} ${delayColor(`${result.delay}ms`)}`);
+  } else {
+    console.log(`  ${prefix} ${colors.red("\u2717")} ${result.name} ${colors.gray(result.error || "timeout")}`);
   }
 }
-async function cmdStart(args) {
-  if (!hasKernel()) {
-    console.error('\u9519\u8BEF: \u672A\u627E\u5230\u5185\u6838\uFF0C\u8BF7\u8FD0\u884C "mihomo kernel"');
+function formatCleanSummary(result) {
+  const parts = [`\u79FB\u9664 ${result.removedProxies} \u4E2A\u8282\u70B9`];
+  if (result.removedGroups > 0) parts.push(`\u5220\u9664 ${result.removedGroups} \u4E2A\u7A7A\u5206\u7EC4`);
+  if (result.updatedGroups > 0) parts.push(`\u66F4\u65B0 ${result.updatedGroups} \u4E2A\u5206\u7EC4`);
+  return parts.join(", ");
+}
+function formatTestSummary(summary) {
+  return `\u7ED3\u679C: ${colors.green(`${summary.alive} \u5B58\u6D3B`)} / ${colors.red(`${summary.dead} \u5931\u8D25`)} / ${summary.total} \u603B\u8BA1`;
+}
+function resolveActiveTestTarget(args) {
+  const subs = getSubscriptions();
+  if (subs.length === 0) {
+    console.error("\u9519\u8BEF: \u6CA1\u6709\u8BA2\u9605");
     process.exit(1);
   }
-  const targetMode = args[1] === "tun" ? "tun" : "mixed";
-  const sub = getActiveSubscription();
-  if (!sub) {
-    console.error("\u9519\u8BEF: \u6CA1\u6709\u8BA2\u9605\uFF0C\u8BF7\u5148\u6DFB\u52A0\u8BA2\u9605");
-    process.exit(1);
+  const nameArg = getNonFlagArg(args, 2);
+  const timeout = parseIntArg(args, "-t", "--timeout", 2e3);
+  const concurrency = parseIntArg(args, "-j", "--concurrency", 100);
+  const activeSub = getActiveSubscription();
+  let target;
+  if (nameArg) {
+    const matches = findSubscriptionFuzzy(subs, nameArg);
+    target = pickSingleSubscription(matches, nameArg);
+  } else {
+    if (!activeSub) {
+      console.error("\u9519\u8BEF: \u6CA1\u6709\u6D3B\u8DC3\u8BA2\u9605");
+      process.exit(1);
+    }
+    target = activeSub;
   }
-  await autoUpdateStaleSubscription();
   const status = getStatus();
-  const hasProcess = status.running || status.allProcesses.length > 0;
-  if (hasProcess) {
-    const count = status.allProcesses.length > 0 ? status.allProcesses.length : 1;
-    console.log(`\u505C\u6B62 ${count} \u4E2A\u8FDB\u7A0B...`);
-  }
-  handleStopResult(stop(true));
-  if (hasProcess) {
-    console.log(`${colors.green("\u5DF2\u505C\u6B62\u8FDB\u7A0B")}
-`);
-  }
-  let configInfo;
-  try {
-    configInfo = prepareConfigForStart(targetMode, sub.name);
-  } catch (e) {
-    console.error(`${colors.red("\u914D\u7F6E\u9519\u8BEF:")} ${e.message}`);
+  if (!status.running) {
+    console.error("\u9519\u8BEF: mihomo \u672A\u8FD0\u884C\uFF0C\u8BF7\u5148\u542F\u52A8 (mihomo start)");
     process.exit(1);
   }
-  const modeLabel = targetMode === "tun" ? "TUN" : "Mixed";
-  console.log([colors.cyan(modeLabel), sub.name, formatProxySummary(configInfo)].join(" \xB7 "));
-  try {
-    const result = await start(targetMode);
-    console.log(`${colors.green("\u5DF2\u542F\u52A8")} (PID ${result.pid})`);
-    printStatus();
-  } catch (e) {
-    console.error(`${colors.red("\u542F\u52A8\u5931\u8D25:")} ${e.message.split("\n")[0]}`);
+  if (!activeSub || activeSub.name !== target.name) {
+    console.error(`\u9519\u8BEF: \u5F53\u524D\u4F7F\u7528\u7684\u8BA2\u9605\u662F "${activeSub?.name}"\uFF0C\u4E0D\u662F "${target.name}"`);
+    console.log(`\u8BF7\u5148\u5207\u6362: mihomo sub use ${target.name}`);
     process.exit(1);
   }
+  return { target, timeout, concurrency };
 }
-
-// src/commands/overwrite.ts
-function printOverwriteList() {
-  const info = listOverwriteFile();
-  const statusText = info.enabled ? colors.green("\u5DF2\u542F\u7528") : colors.yellow("\u5DF2\u7981\u7528");
-  console.log(`${colors.gray("\u72B6\u6001: ")}${statusText}`);
-  console.log(`${colors.gray("\u4F4D\u7F6E: ")}${info.dir}`);
-  console.log("");
-  if (info.files.length === 0) {
-    console.log("\u6682\u65E0\u8986\u5199\u6587\u4EF6");
-    console.log("");
-    console.log(`\u7528\u6CD5\u793A\u4F8B: \u521B\u5EFA\u6587\u4EF6 ${path5.join(info.dir, "overwrite.yaml")}`);
-    console.log(`         \u6216        ${path5.join(info.dir, "overwrite.dns.yaml")}`);
-    console.log("");
-  } else {
-    console.log(`${colors.cyan("\u8986\u5199\u6587\u4EF6")} (${info.files.length} \u4E2A\uFF0C\u6309\u987A\u5E8F\u52A0\u8F7D):`);
+async function printSubscriptionList(options) {
+  if (options?.autoUpdate !== false) {
+    const updateResult = await autoUpdateStaleSubscription();
+    if (updateResult.total > 0) console.log("");
+  }
+  const subs = getSubscriptionsWithCache();
+  if (subs.length === 0) {
+    console.log("\u6CA1\u6709\u8BA2\u9605");
     console.log("");
-    info.files.forEach((f, i) => {
-      const num = i < 10 ? ` ${i}` : `${i}`;
-      console.log(`  ${num}. ${f.name}`);
-      if (f.keys.length > 0) {
-        console.log(`    ${colors.gray("\u5B57\u6BB5: ")}${f.keys.join(", ")}`);
-      }
-    });
+    console.log("\u6DFB\u52A0\u8BA2\u9605: mihomo sub add <url> [name]");
     console.log("");
+    return;
   }
-  console.log("\u542F\u7528\u8986\u5199: mihomo ow on");
-  console.log("\u7981\u7528\u8986\u5199: mihomo ow off");
+  const activeSub = getActiveSubscription();
+  console.log(colors.cyan("\u8BA2\u9605\u5217\u8868:"));
+  subs.forEach((s, i) => {
+    const time = formatDate(s.updated_at);
+    const defaultMark = activeSub && s.name === activeSub.name ? colors.green(" [\u4F7F\u7528\u4E2D]") : "";
+    const interval = s.update_interval || DEFAULT_UPDATE_INTERVAL_HOURS;
+    console.log(`  ${i + 1}. ${s.name}${defaultMark}`);
+    console.log(`    ${colors.gray("\u66F4\u65B0: ")}${time} (\u95F4\u9694: ${interval}h)`);
+    if (s.username) {
+      console.log(`    ${colors.gray("\u7528\u6237: ")}${s.username}`);
+    }
+    if (s.download !== void 0 || s.total !== void 0) {
+      const used = (s.upload || 0) + (s.download || 0);
+      const usedStr = formatBytes(used);
+      const totalStr = formatBytes(s.total);
+      let percentStr = "";
+      if (s.total && s.total > 0) {
+        const percent = Math.min(used / s.total * 100, 100);
+        percentStr = ` (${percent.toFixed(1)}%)`;
+      }
+      console.log(`    ${colors.gray("\u6D41\u91CF: ")}${usedStr} / ${totalStr}${percentStr}`);
+    }
+    if (s.expire !== void 0) {
+      console.log(`    ${colors.gray("\u5230\u671F: ")}${formatTimestamp(s.expire)}`);
+    }
+    if (s.web_page_url) {
+      console.log(`    ${colors.gray("\u9875\u9762: ")}${s.web_page_url}`);
+    }
+  });
+  console.log("");
+  console.log("\u5207\u6362\u8BA2\u9605: mihomo sub use <name>");
+  console.log("\u65B0\u589E\u8BA2\u9605: mihomo sub add <url> [name]");
+  console.log("\u66F4\u65B0\u8BA2\u9605: mihomo sub update [name]");
+  console.log("\u5220\u9664\u8BA2\u9605: mihomo sub remove <name>");
+  console.log("\u6D4B\u8BD5\u8282\u70B9: mihomo sub test [name]");
+  console.log("\u6E05\u7406\u8282\u70B9: mihomo sub clean [name]");
+  console.log("\u6253\u5F00\u9875\u9762: mihomo sub web [name]");
   console.log("");
 }
-async function cmdOverwrite(args) {
-  const action = args?.[1];
-  const status = getStatus();
-  const configInfo = getConfigInfo();
-  const currentMode = configInfo?.tun ? "tun" : "mixed";
-  if (action === "on" || action === "enable") {
-    if (isOverwriteEnabled()) {
-      console.log("\u8986\u5199\u914D\u7F6E\u5DF2\u662F\u542F\u7528\u72B6\u6001");
-      console.log("");
-      printOverwriteList();
-      return;
+async function cmdSubscription(args) {
+  const action = args[1];
+  if (!action || action === "list") {
+    await printSubscriptionList();
+    return;
+  }
+  if (action === "add") {
+    const url = args[2];
+    const name = args[3] || "default";
+    if (!url?.startsWith("http")) {
+      console.error("\u9519\u8BEF: \u8BF7\u63D0\u4F9B\u6709\u6548\u7684\u8BA2\u9605 URL");
+      process.exit(1);
     }
-    setOverwriteEnabled(true);
-    console.log("\u5DF2\u542F\u7528\u8986\u5199\u914D\u7F6E");
-    if (status.running) {
+    console.log(`\u6DFB\u52A0\u8BA2\u9605: ${name}`);
+    try {
+      addSubscription(url, name);
+      setDefaultSubscription(name);
+      const info = await downloadSubscription(url, name);
+      console.log(`\u5DF2\u6DFB\u52A0\u5E76\u5207\u6362\u5230 "${name}" (${formatProxySummary(info)})`);
+    } catch (e) {
+      console.error(`\u6DFB\u52A0\u5931\u8D25: ${e.message}`);
+      process.exit(1);
+    }
+    console.log("");
+    await printSubscriptionList();
+    return;
+  }
+  if (action === "update") {
+    const name = args[2];
+    const subs = getSubscriptions();
+    if (subs.length === 0) {
+      console.error("\u9519\u8BEF: \u6CA1\u6709\u8BA2\u9605");
+      process.exit(1);
+    }
+    if (!name) {
+      console.log(`\u66F4\u65B0\u6240\u6709 ${subs.length} \u4E2A\u8BA2\u9605...`);
+      const results = await Promise.all(subs.map(tryUpdateOne));
+      let ok = 0;
+      for (const r of results) {
+        if (r.success) {
+          ok++;
+          console.log(`${colors.green("\u2713")} ${r.name}: ${colors.green("\u5DF2\u66F4\u65B0")} (${formatProxySummary(r)})`);
+        } else {
+          console.log(`${colors.red("\u2717")} ${r.name}: ${colors.red("\u5931\u8D25")} (${(r.error || "").split("\n")[0]})`);
+        }
+      }
+      if (ok === 0) process.exit(1);
       console.log("");
-      await cmdStart(["start", currentMode]);
+      await printSubscriptionList();
       return;
     }
+    const matches = findSubscriptionFuzzy(subs, name);
+    const target = pickSingleSubscription(matches, name);
+    console.log(`\u66F4\u65B0\u8BA2\u9605: ${target.name}`);
+    try {
+      const info = await downloadSubscription(target.url, target.name);
+      console.log(`\u5DF2\u66F4\u65B0 (${formatProxySummary(info)})`);
+    } catch (e) {
+      console.error(`\u66F4\u65B0\u5931\u8D25: ${e.message}`);
+      process.exit(1);
+    }
     console.log("");
-    printOverwriteList();
+    await printSubscriptionList();
     return;
   }
-  if (action === "off" || action === "disable") {
-    if (!isOverwriteEnabled()) {
-      console.log("\u8986\u5199\u914D\u7F6E\u5DF2\u662F\u7981\u7528\u72B6\u6001");
+  if (action === "use") {
+    const name = args[2];
+    const subs = getSubscriptions();
+    if (!name) {
+      console.error("\u9519\u8BEF: \u8BF7\u6307\u5B9A\u8BA2\u9605\u540D\u79F0");
+      if (subs.length > 0) {
+        console.log("\n\u53EF\u7528\u8BA2\u9605:");
+        for (const s of subs) console.log(`  ${s.name}`);
+      }
+      process.exit(1);
+    }
+    const matches = findSubscriptionFuzzy(subs, name);
+    const target = pickSingleSubscription(matches, name);
+    const currentDefault = getActiveSubscription();
+    const isAlreadyDefault = currentDefault && currentDefault.name === target.name;
+    if (isAlreadyDefault) {
+      console.log(`"${target.name}" \u5DF2\u662F\u5F53\u524D\u4F7F\u7528\u7684\u8BA2\u9605`);
       console.log("");
-      printOverwriteList();
+      await printSubscriptionList();
       return;
     }
-    setOverwriteEnabled(false);
-    console.log("\u5DF2\u7981\u7528\u8986\u5199\u914D\u7F6E");
+    const status = getStatus();
+    const configInfo = getConfigInfo();
+    const currentMode = configInfo?.tun ? "tun" : "mixed";
+    const success = setDefaultSubscription(target.name);
+    if (success) {
+      console.log(`\u5DF2\u5207\u6362\u5230 "${target.name}"`);
+    } else {
+      console.error(`\u9519\u8BEF: \u672A\u627E\u5230\u8BA2\u9605 "${name}"`);
+      process.exit(1);
+    }
     if (status.running) {
       console.log("");
       await cmdStart(["start", currentMode]);
       return;
     }
     console.log("");
-    printOverwriteList();
+    await printSubscriptionList();
+    return;
+  }
+  if (action === "web" || action === "open") {
+    const name = args[2];
+    const subs = getSubscriptionsWithCache();
+    if (subs.length === 0) {
+      console.error("\u9519\u8BEF: \u6CA1\u6709\u8BA2\u9605");
+      process.exit(1);
+    }
+    let target;
+    if (name) {
+      const matches = findSubscriptionFuzzy(subs, name);
+      target = pickSingleSubscription(matches, name);
+    } else {
+      target = subs[0];
+    }
+    const cached = getSubscriptionsWithCache().find((s) => s.name === target.name);
+    let webPageUrl = cached?.web_page_url;
+    if (!webPageUrl) {
+      console.log("\u8BA2\u9605\u4FE1\u606F\u4E2D\u7F3A\u5C11\u9875\u9762\u5730\u5740\uFF0C\u6B63\u5728\u66F4\u65B0\u8BA2\u9605...");
+      try {
+        await downloadSubscription(target.url, target.name);
+        const cache = readSubscriptionCache();
+        if (cache[target.name]?.web_page_url) {
+          webPageUrl = cache[target.name].web_page_url;
+        } else {
+          console.error("\u9519\u8BEF: \u8BE5\u8BA2\u9605\u6CA1\u6709\u63D0\u4F9B\u9875\u9762\u5730\u5740");
+          process.exit(1);
+        }
+      } catch (e) {
+        console.error(`\u66F4\u65B0\u5931\u8D25: ${e.message}`);
+        process.exit(1);
+      }
+    }
+    console.log(`\u6253\u5F00\u8BA2\u9605\u9875\u9762: ${webPageUrl}`);
+    const opened = openUrl(webPageUrl);
+    if (!opened) {
+      console.log("\u8BF7\u624B\u52A8\u8BBF\u95EE\u4E0A\u9762\u7684\u5730\u5740");
+    }
+    return;
+  }
+  if (action === "remove" || action === "rm" || action === "delete") {
+    const name = args[2];
+    const subs = getSubscriptions();
+    if (!name) {
+      console.error("\u9519\u8BEF: \u8BF7\u6307\u5B9A\u8981\u5220\u9664\u7684\u8BA2\u9605\u540D\u79F0");
+      if (subs.length > 0) {
+        console.log("\n\u53EF\u7528\u8BA2\u9605:");
+        for (const s of subs) console.log(`  ${s.name}`);
+      }
+      process.exit(1);
+    }
+    const matches = findSubscriptionFuzzy(subs, name);
+    const target = pickSingleSubscription(matches, name);
+    const switchedTo = removeSubscription(target.name);
+    console.log(`\u5DF2\u5220\u9664\u8BA2\u9605 "${target.name}"`);
+    if (switchedTo) {
+      console.log(`\u5DF2\u81EA\u52A8\u5207\u6362\u5230 "${switchedTo}"`);
+    }
+    console.log("");
+    await printSubscriptionList({ autoUpdate: false });
+    return;
+  }
+  if (action === "clean") {
+    const { target, timeout, concurrency } = resolveActiveTestTarget(args);
+    console.log(`\u6E05\u7406\u8BA2\u9605 "${target.name}"...`);
+    console.log(`\u8D85\u65F6: ${timeout}ms  \u5E76\u53D1: ${concurrency}`);
+    console.log("");
+    const result = await autoCleanSubscription(target.name, {
+      timeout,
+      concurrency,
+      onResult: printTestResult
+    });
+    console.log("");
+    console.log(formatTestSummary(result.summary));
+    if (result.removedProxies > 0) {
+      console.log(`${colors.green("\u5DF2\u6E05\u7406")}: ${formatCleanSummary(result)}`);
+    }
+    console.log("");
+    console.log("\u63D0\u793A: \u9700\u8981\u91CD\u542F mihomo \u4F7F\u66F4\u6539\u751F\u6548 (mihomo start)");
+    return;
+  }
+  if (action === "test") {
+    const { target, timeout, concurrency } = resolveActiveTestTarget(args);
+    console.log(`\u6D4B\u8BD5\u8BA2\u9605 "${target.name}" \u7684\u8282\u70B9\u8FDE\u901A\u6027...`);
+    console.log(`\u8D85\u65F6: ${timeout}ms  \u5E76\u53D1: ${concurrency}`);
+    console.log("");
+    const summary = await testSubscriptionProxies(target.name, {
+      timeout,
+      concurrency,
+      onResult: printTestResult
+    });
+    console.log("");
+    console.log(formatTestSummary(summary));
+    return;
+  }
+  console.error("\u9519\u8BEF: \u672A\u77E5\u7684\u8BA2\u9605\u547D\u4EE4");
+  console.log("\u7528\u6CD5: mihomo sub [list|use|add|update|remove|web|test|clean]");
+  process.exit(1);
+}
+
+// src/commands/start.ts
+var AUTO_CLEAN_THRESHOLD = 100;
+function handleStopResult(result) {
+  if (result.remaining && result.remaining.length > 0) {
+    console.error(`${colors.red("\u90E8\u5206\u8FDB\u7A0B\u672A\u7EC8\u6B62:")} ${result.remaining.join(", ")}`);
+    console.error("\u8BF7\u624B\u52A8\u8FD0\u884C: sudo pkill -9 mihomo");
+    process.exit(1);
+  }
+}
+async function cmdStart(args) {
+  if (!hasKernel()) {
+    console.error('\u9519\u8BEF: \u672A\u627E\u5230\u5185\u6838\uFF0C\u8BF7\u8FD0\u884C "mihomo kernel"');
+    process.exit(1);
+  }
+  const targetMode = args[1] === "tun" ? "tun" : "mixed";
+  const sub = getActiveSubscription();
+  if (!sub) {
+    console.error("\u9519\u8BEF: \u6CA1\u6709\u8BA2\u9605\uFF0C\u8BF7\u5148\u6DFB\u52A0\u8BA2\u9605");
+    process.exit(1);
+  }
+  await autoUpdateStaleSubscription();
+  const status = getStatus();
+  const hasProcess = status.running || status.allProcesses.length > 0;
+  if (hasProcess) {
+    const count = status.allProcesses.length > 0 ? status.allProcesses.length : 1;
+    console.log(`\u505C\u6B62 ${count} \u4E2A\u8FDB\u7A0B...`);
+  }
+  handleStopResult(stop(true));
+  if (hasProcess) {
+    console.log(`${colors.green("\u5DF2\u505C\u6B62\u8FDB\u7A0B")}
+`);
+  }
+  let configInfo;
+  try {
+    configInfo = prepareConfigForStart(targetMode, sub.name);
+  } catch (e) {
+    console.error(`${colors.red("\u914D\u7F6E\u9519\u8BEF:")} ${e.message}`);
+    process.exit(1);
+  }
+  const modeLabel = targetMode === "tun" ? "TUN" : "Mixed";
+  console.log([colors.cyan(modeLabel), sub.name, formatProxySummary(configInfo)].join(" \xB7 "));
+  try {
+    const result = await start(targetMode);
+    console.log(`${colors.green("\u5DF2\u542F\u52A8")} (PID ${result.pid})`);
+  } catch (e) {
+    console.error(`${colors.red("\u542F\u52A8\u5931\u8D25:")} ${e.message.split("\n")[0]}`);
+    process.exit(1);
+  }
+  if (configInfo.proxies > AUTO_CLEAN_THRESHOLD) {
+    console.log("");
+    console.log(`\u8282\u70B9\u6570 ${configInfo.proxies} \u8D85\u8FC7 ${AUTO_CLEAN_THRESHOLD}\uFF0C\u81EA\u52A8\u6E05\u7406...`);
+    console.log("");
+    await sleep(1e3);
+    const cleanResult = await autoCleanSubscription(sub.name, { onResult: printTestResult });
+    console.log("");
+    console.log(formatTestSummary(cleanResult.summary));
+    if (cleanResult.removedProxies > 0) {
+      console.log(`${colors.green("\u5DF2\u6E05\u7406")}: ${formatCleanSummary(cleanResult)}`);
+      console.log("");
+      console.log("\u91CD\u65B0\u52A0\u8F7D\u914D\u7F6E...");
+      handleStopResult(stop(true));
+      try {
+        configInfo = prepareConfigForStart(targetMode, sub.name);
+        const result = await start(targetMode);
+        console.log(`${colors.green("\u5DF2\u91CD\u542F")} (PID ${result.pid}) \xB7 ${formatProxySummary(configInfo)}`);
+      } catch (e) {
+        console.error(`${colors.red("\u91CD\u542F\u5931\u8D25:")} ${e.message.split("\n")[0]}`);
+        process.exit(1);
+      }
+    }
+  }
+  printStatus();
+}
+
+// src/commands/overwrite.ts
+function printOverwriteList() {
+  const info = listOverwriteFile();
+  const statusText = info.enabled ? colors.green("\u5DF2\u542F\u7528") : colors.yellow("\u5DF2\u7981\u7528");
+  console.log(`${colors.gray("\u72B6\u6001: ")}${statusText}`);
+  console.log(`${colors.gray("\u4F4D\u7F6E: ")}${info.dir}`);
+  console.log("");
+  if (info.files.length === 0) {
+    console.log("\u6682\u65E0\u8986\u5199\u6587\u4EF6");
+    console.log("");
+    console.log(`\u7528\u6CD5\u793A\u4F8B: \u521B\u5EFA\u6587\u4EF6 ${path5.join(info.dir, "overwrite.yaml")}`);
+    console.log(`         \u6216        ${path5.join(info.dir, "overwrite.dns.yaml")}`);
+    console.log("");
+  } else {
+    console.log(`${colors.cyan("\u8986\u5199\u6587\u4EF6")} (${info.files.length} \u4E2A\uFF0C\u6309\u987A\u5E8F\u52A0\u8F7D):`);
+    console.log("");
+    info.files.forEach((f, i) => {
+      const num = i < 10 ? ` ${i}` : `${i}`;
+      console.log(`  ${num}. ${f.name}`);
+      if (f.keys.length > 0) {
+        console.log(`    ${colors.gray("\u5B57\u6BB5: ")}${f.keys.join(", ")}`);
+      }
+    });
+    console.log("");
+  }
+  console.log("\u542F\u7528\u8986\u5199: mihomo ow on");
+  console.log("\u7981\u7528\u8986\u5199: mihomo ow off");
+  console.log("");
+}
+async function cmdOverwrite(args) {
+  const action = args?.[1];
+  const status = getStatus();
+  const configInfo = getConfigInfo();
+  const currentMode = configInfo?.tun ? "tun" : "mixed";
+  if (action === "on" || action === "enable") {
+    if (isOverwriteEnabled()) {
+      console.log("\u8986\u5199\u914D\u7F6E\u5DF2\u662F\u542F\u7528\u72B6\u6001");
+      console.log("");
+      printOverwriteList();
+      return;
+    }
+    setOverwriteEnabled(true);
+    console.log("\u5DF2\u542F\u7528\u8986\u5199\u914D\u7F6E");
+    if (status.running) {
+      console.log("");
+      await cmdStart(["start", currentMode]);
+      return;
+    }
+    console.log("");
+    printOverwriteList();
+    return;
+  }
+  if (action === "off" || action === "disable") {
+    if (!isOverwriteEnabled()) {
+      console.log("\u8986\u5199\u914D\u7F6E\u5DF2\u662F\u7981\u7528\u72B6\u6001");
+      console.log("");
+      printOverwriteList();
+      return;
+    }
+    setOverwriteEnabled(false);
+    console.log("\u5DF2\u7981\u7528\u8986\u5199\u914D\u7F6E");
+    if (status.running) {
+      console.log("");
+      await cmdStart(["start", currentMode]);
+      return;
+    }
+    console.log("");
+    printOverwriteList();
     return;
   }
   console.log("");
@@ -4792,228 +5268,6 @@ async function cmdStop() {
   console.log(colors.green("\u5DF2\u505C\u6B62\u8FDB\u7A0B"));
 }
 
-// src/commands/subscription.ts
-async function printSubscriptionList(options) {
-  if (options?.autoUpdate !== false) {
-    const updateResult = await autoUpdateStaleSubscription();
-    if (updateResult.total > 0) console.log("");
-  }
-  const subs = getSubscriptionsWithCache();
-  if (subs.length === 0) {
-    console.log("\u6CA1\u6709\u8BA2\u9605");
-    console.log("");
-    console.log("\u6DFB\u52A0\u8BA2\u9605: mihomo sub add <url> [name]");
-    console.log("");
-    return;
-  }
-  const activeSub = getActiveSubscription();
-  console.log(colors.cyan("\u8BA2\u9605\u5217\u8868:"));
-  subs.forEach((s, i) => {
-    const time = formatDate(s.updated_at);
-    const defaultMark = activeSub && s.name === activeSub.name ? colors.green(" [\u4F7F\u7528\u4E2D]") : "";
-    const interval = s.update_interval || DEFAULT_UPDATE_INTERVAL_HOURS;
-    console.log(`  ${i + 1}. ${s.name}${defaultMark}`);
-    console.log(`    ${colors.gray("\u66F4\u65B0: ")}${time} (\u95F4\u9694: ${interval}h)`);
-    if (s.username) {
-      console.log(`    ${colors.gray("\u7528\u6237: ")}${s.username}`);
-    }
-    if (s.download !== void 0 || s.total !== void 0) {
-      const used = (s.upload || 0) + (s.download || 0);
-      const usedStr = formatBytes(used);
-      const totalStr = formatBytes(s.total);
-      let percentStr = "";
-      if (s.total && s.total > 0) {
-        const percent = Math.min(used / s.total * 100, 100);
-        percentStr = ` (${percent.toFixed(1)}%)`;
-      }
-      console.log(`    ${colors.gray("\u6D41\u91CF: ")}${usedStr} / ${totalStr}${percentStr}`);
-    }
-    if (s.expire !== void 0) {
-      console.log(`    ${colors.gray("\u5230\u671F: ")}${formatTimestamp(s.expire)}`);
-    }
-    if (s.web_page_url) {
-      console.log(`    ${colors.gray("\u9875\u9762: ")}${s.web_page_url}`);
-    }
-  });
-  console.log("");
-  console.log("\u5207\u6362\u8BA2\u9605: mihomo sub use <name>");
-  console.log("\u65B0\u589E\u8BA2\u9605: mihomo sub add <url> [name]");
-  console.log("\u66F4\u65B0\u8BA2\u9605: mihomo sub update [name]");
-  console.log("\u5220\u9664\u8BA2\u9605: mihomo sub remove <name>");
-  console.log("\u6253\u5F00\u9875\u9762: mihomo sub web [name]");
-  console.log("");
-}
-async function cmdSubscription(args) {
-  const action = args[1];
-  if (!action || action === "list") {
-    await printSubscriptionList();
-    return;
-  }
-  if (action === "add") {
-    const url = args[2];
-    const name = args[3] || "default";
-    if (!url?.startsWith("http")) {
-      console.error("\u9519\u8BEF: \u8BF7\u63D0\u4F9B\u6709\u6548\u7684\u8BA2\u9605 URL");
-      process.exit(1);
-    }
-    console.log(`\u6DFB\u52A0\u8BA2\u9605: ${name}`);
-    try {
-      addSubscription(url, name);
-      setDefaultSubscription(name);
-      const info = await downloadSubscription(url, name);
-      console.log(`\u5DF2\u6DFB\u52A0\u5E76\u5207\u6362\u5230 "${name}" (${formatProxySummary(info)})`);
-    } catch (e) {
-      console.error(`\u6DFB\u52A0\u5931\u8D25: ${e.message}`);
-      process.exit(1);
-    }
-    console.log("");
-    await printSubscriptionList();
-    return;
-  }
-  if (action === "update") {
-    const name = args[2];
-    const subs = getSubscriptions();
-    if (subs.length === 0) {
-      console.error("\u9519\u8BEF: \u6CA1\u6709\u8BA2\u9605");
-      process.exit(1);
-    }
-    if (!name) {
-      console.log(`\u66F4\u65B0\u6240\u6709 ${subs.length} \u4E2A\u8BA2\u9605...`);
-      const results = await Promise.all(subs.map(tryUpdateOne));
-      let ok = 0;
-      for (const r of results) {
-        if (r.success) {
-          ok++;
-          console.log(`${colors.green("\u2713")} ${r.name}: ${colors.green("\u5DF2\u66F4\u65B0")} (${formatProxySummary(r)})`);
-        } else {
-          console.log(`${colors.red("\u2717")} ${r.name}: ${colors.red("\u5931\u8D25")} (${(r.error || "").split("\n")[0]})`);
-        }
-      }
-      if (ok === 0) process.exit(1);
-      console.log("");
-      await printSubscriptionList();
-      return;
-    }
-    const matches = findSubscriptionFuzzy(subs, name);
-    const target = pickSingleSubscription(matches, name);
-    console.log(`\u66F4\u65B0\u8BA2\u9605: ${target.name}`);
-    try {
-      const info = await downloadSubscription(target.url, target.name);
-      console.log(`\u5DF2\u66F4\u65B0 (${formatProxySummary(info)})`);
-    } catch (e) {
-      console.error(`\u66F4\u65B0\u5931\u8D25: ${e.message}`);
-      process.exit(1);
-    }
-    console.log("");
-    await printSubscriptionList();
-    return;
-  }
-  if (action === "use") {
-    const name = args[2];
-    const subs = getSubscriptions();
-    if (!name) {
-      console.error("\u9519\u8BEF: \u8BF7\u6307\u5B9A\u8BA2\u9605\u540D\u79F0");
-      if (subs.length > 0) {
-        console.log("\n\u53EF\u7528\u8BA2\u9605:");
-        for (const s of subs) console.log(`  ${s.name}`);
-      }
-      process.exit(1);
-    }
-    const matches = findSubscriptionFuzzy(subs, name);
-    const target = pickSingleSubscription(matches, name);
-    const currentDefault = getActiveSubscription();
-    const isAlreadyDefault = currentDefault && currentDefault.name === target.name;
-    if (isAlreadyDefault) {
-      console.log(`"${target.name}" \u5DF2\u662F\u5F53\u524D\u4F7F\u7528\u7684\u8BA2\u9605`);
-      console.log("");
-      await printSubscriptionList();
-      return;
-    }
-    const status = getStatus();
-    const configInfo = getConfigInfo();
-    const currentMode = configInfo?.tun ? "tun" : "mixed";
-    const success = setDefaultSubscription(target.name);
-    if (success) {
-      console.log(`\u5DF2\u5207\u6362\u5230 "${target.name}"`);
-    } else {
-      console.error(`\u9519\u8BEF: \u672A\u627E\u5230\u8BA2\u9605 "${name}"`);
-      process.exit(1);
-    }
-    if (status.running) {
-      console.log("");
-      await cmdStart(["start", currentMode]);
-      return;
-    }
-    console.log("");
-    await printSubscriptionList();
-    return;
-  }
-  if (action === "web" || action === "open") {
-    const name = args[2];
-    const subs = getSubscriptionsWithCache();
-    if (subs.length === 0) {
-      console.error("\u9519\u8BEF: \u6CA1\u6709\u8BA2\u9605");
-      process.exit(1);
-    }
-    let target;
-    if (name) {
-      const matches = findSubscriptionFuzzy(subs, name);
-      target = pickSingleSubscription(matches, name);
-    } else {
-      target = subs[0];
-    }
-    const cached = getSubscriptionsWithCache().find((s) => s.name === target.name);
-    let webPageUrl = cached?.web_page_url;
-    if (!webPageUrl) {
-      console.log("\u8BA2\u9605\u4FE1\u606F\u4E2D\u7F3A\u5C11\u9875\u9762\u5730\u5740\uFF0C\u6B63\u5728\u66F4\u65B0\u8BA2\u9605...");
-      try {
-        await downloadSubscription(target.url, target.name);
-        const cache = readSubscriptionCache();
-        if (cache[target.name]?.web_page_url) {
-          webPageUrl = cache[target.name].web_page_url;
-        } else {
-          console.error("\u9519\u8BEF: \u8BE5\u8BA2\u9605\u6CA1\u6709\u63D0\u4F9B\u9875\u9762\u5730\u5740");
-          process.exit(1);
-        }
-      } catch (e) {
-        console.error(`\u66F4\u65B0\u5931\u8D25: ${e.message}`);
-        process.exit(1);
-      }
-    }
-    console.log(`\u6253\u5F00\u8BA2\u9605\u9875\u9762: ${webPageUrl}`);
-    const opened = openUrl(webPageUrl);
-    if (!opened) {
-      console.log("\u8BF7\u624B\u52A8\u8BBF\u95EE\u4E0A\u9762\u7684\u5730\u5740");
-    }
-    return;
-  }
-  if (action === "remove" || action === "rm" || action === "delete") {
-    const name = args[2];
-    const subs = getSubscriptions();
-    if (!name) {
-      console.error("\u9519\u8BEF: \u8BF7\u6307\u5B9A\u8981\u5220\u9664\u7684\u8BA2\u9605\u540D\u79F0");
-      if (subs.length > 0) {
-        console.log("\n\u53EF\u7528\u8BA2\u9605:");
-        for (const s of subs) console.log(`  ${s.name}`);
-      }
-      process.exit(1);
-    }
-    const matches = findSubscriptionFuzzy(subs, name);
-    const target = pickSingleSubscription(matches, name);
-    const switchedTo = removeSubscription(target.name);
-    console.log(`\u5DF2\u5220\u9664\u8BA2\u9605 "${target.name}"`);
-    if (switchedTo) {
-      console.log(`\u5DF2\u81EA\u52A8\u5207\u6362\u5230 "${switchedTo}"`);
-    }
-    console.log("");
-    await printSubscriptionList({ autoUpdate: false });
-    return;
-  }
-  console.error("\u9519\u8BEF: \u672A\u77E5\u7684\u8BA2\u9605\u547D\u4EE4");
-  console.log("\u7528\u6CD5: mihomo sub [list|use|add|update|remove|web]");
-  process.exit(1);
-}
-
 // src/commands/ui.ts
 function cmdUI(args) {
   const uiName = args[1] || "zash";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mihomo-cli",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "type": "module",
   "description": "A terminal-based mihomo (Clash.Meta) client for macOS",
   "bin": {