mihomo-cli 2.8.1 → 2.9.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.9.0] - 2026-05-13
+
+### 新功能
+
+- **跳过自动更新** - `start -s` 跳过启动时的订阅自动更新
+- **自动更新超时** - `start -u <ms>` 设置自动更新超时时间（默认 10 秒），超时后使用缓存配置继续启动
+- **通用 Promise 超时工具** - 新增 `withTimeout` / `TimeoutError` 工具函数
+
+### 变更
+
+- **命令别名调整** - 移除 `mmc`，新增 `mhm` 作为命令别名
+
+---
+
 ## [2.8.1] - 2026-05-07
 
 ### 修复

package/README.md

@@ -83,7 +83,7 @@ mihomo ui yacd     # YACD
 
 | 命令                        | 说明                                                                         |
 | --------------------------- | ---------------------------------------------------------------------------- |
-| `mihomo start [tun\|mixed]` | 启动/重启/切换代理模式（`-r` 清理轮次，`-t` 超时，`-j` 并发）               |
+| `mihomo start [tun\|mixed]` | 启动/重启/切换代理模式（`-s` 跳过更新，`-u` 更新超时，`-r` 清理轮次，`-t` 超时，`-j` 并发） |
 | `mihomo stop`               | 停止代理                                                                     |
 | `mihomo status`             | 查看运行状态                                                                 |
 | `mihomo log`                | 实时查看日志 (`-o` 用系统编辑器打开)                                         |
@@ -142,7 +142,7 @@ mihomo ui yacd     # YACD
 
 | 快捷命令               | 等效于                     |
 | ---------------------- | -------------------------- |
-| `mihomo up`            | `mihomo start`（同样支持 `-r`/`-t`/`-j`）|
+| `mihomo up`            | `mihomo start`（同样支持 `-s`/`-u`/`-r`/`-t`/`-j`）|
 | `mihomo down`          | `mihomo stop`              |
 | `mihomo tun`           | `mihomo start tun`         |
 | `mihomo use <name>`    | `mihomo sub use <name>`    |
@@ -197,6 +197,7 @@ mihomo kernel --mirror-all hk.gh-proxy.org
 - 默认更新间隔：GitHub 订阅 6 小时，其他订阅 12 小时（订阅服务端可通过 `profile-update-interval` 覆盖）
 - 触发时机：`start` 命令、`sub list` 命令
 - 更新失败时继续使用本地缓存，不影响使用
+- 自动更新默认超时 10 秒，可通过 `-u <ms>` 调整；使用 `-s` 可完全跳过自动更新
 
 ## 数据目录
 

package/dist/index.js

@@ -3294,6 +3294,27 @@ function sleepSync(ms) {
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+var TimeoutError = class extends Error {
+  constructor() {
+    super("timeout");
+    this.name = "TimeoutError";
+  }
+};
+function withTimeout(promise, ms) {
+  return new Promise((resolve, reject) => {
+    const timer = setTimeout(() => reject(new TimeoutError()), ms);
+    promise.then(
+      (v) => {
+        clearTimeout(timer);
+        resolve(v);
+      },
+      (e) => {
+        clearTimeout(timer);
+        reject(e);
+      }
+    );
+  });
+}
 function formatBytes(bytes) {
   if (bytes === void 0 || bytes === null) return "\u672A\u77E5";
   const num = Number(bytes);
@@ -4012,7 +4033,8 @@ ${colors.cyan(colors.bold(`mihomo-cli v${VERSION}`))}
   mihomo <\u547D\u4EE4> [\u9009\u9879]
 
 ${colors.cyan("\u63A7\u5236:")}
-  ${colors.bold("start")} [tun|mixed] [-r N] [-t ms] [-j N]  \u542F\u52A8/\u5207\u6362\u4EE3\u7406 (\u9ED8\u8BA4 mixed)
+  ${colors.bold("start")} [tun|mixed] [-s] [-u ms]     \u542F\u52A8/\u5207\u6362\u4EE3\u7406 (\u9ED8\u8BA4 mixed)
+        [-r N] [-t ms] [-j N]
   ${colors.bold("stop")}                         \u505C\u6B62\u4EE3\u7406
   ${colors.bold("status")}                       \u67E5\u770B\u72B6\u6001
 
@@ -4049,6 +4071,8 @@ ${colors.cyan("\u7CFB\u7EDF:")}
 ${colors.cyan("\u793A\u4F8B:")}
   mihomo start              # \u542F\u52A8/\u91CD\u542F Mixed \u6A21\u5F0F
   mihomo start tun          # \u5207\u6362\u5230 TUN \u900F\u660E\u4EE3\u7406\u6A21\u5F0F
+  mihomo start -s           # \u8DF3\u8FC7\u81EA\u52A8\u66F4\u65B0\u8BA2\u9605
+  mihomo start -u 30000     # \u81EA\u52A8\u66F4\u65B0\u8D85\u65F6 30 \u79D2 (\u9ED8\u8BA4 10s)
   mihomo sub add <url>      # \u6DFB\u52A0\u8BA2\u9605 (sub \u662F subscription \u522B\u540D)
   mihomo ui                 # \u6253\u5F00 Web UI
 
@@ -4694,7 +4718,8 @@ async function tryUpdateOne(sub) {
     return { name: sub.name, success: false, error: e.message };
   }
 }
-async function autoUpdateStaleSubscription() {
+var DEFAULT_AUTO_UPDATE_TIMEOUT = 1e4;
+async function autoUpdateStaleSubscription(options = {}) {
   const allSubs = getSubscriptionsWithCache();
   const staleSubs = allSubs.filter(needsAutoUpdate);
   if (staleSubs.length === 0) {
@@ -4707,7 +4732,17 @@ async function autoUpdateStaleSubscription() {
   } else {
     console.log(`\u68C0\u67E5\u5230 ${staleSubs.length} \u4E2A\u8BA2\u9605\u9700\u8981\u66F4\u65B0\uFF0C\u6B63\u5728\u5E76\u884C\u66F4\u65B0...`);
   }
-  const results = await Promise.all(staleSubs.map(tryUpdateOne));
+  const timeoutMs = options.timeout ?? DEFAULT_AUTO_UPDATE_TIMEOUT;
+  let results;
+  try {
+    results = await withTimeout(Promise.all(staleSubs.map(tryUpdateOne)), timeoutMs);
+  } catch (e) {
+    if (e instanceof TimeoutError) {
+      console.log(colors.yellow(`\u81EA\u52A8\u66F4\u65B0\u8D85\u65F6 (${timeoutMs / 1e3}s)\uFF0C\u8DF3\u8FC7\u66F4\u65B0\uFF0C\u4F7F\u7528\u7F13\u5B58\u914D\u7F6E`));
+      return { total: staleSubs.length, updated: 0, failed: staleSubs.length };
+    }
+    throw e;
+  }
   let updatedCount = 0;
   for (const r of results) {
     if (r.success) {
@@ -5465,12 +5500,16 @@ async function cmdStart(args) {
   const rounds = parseIntArg(args, "-r", "--rounds", DEFAULT_CLEAN_ROUNDS);
   const timeout = parseIntArg(args, "-t", "--timeout", 2e3);
   const concurrency = parseIntArg(args, "-j", "--concurrency", 100);
+  const skipUpdate = hasFlag(args, "-s", "--no-update");
+  const updateTimeout = parseIntArg(args, "-u", "--update-timeout", DEFAULT_AUTO_UPDATE_TIMEOUT);
   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();
+  if (!skipUpdate) {
+    await autoUpdateStaleSubscription({ timeout: updateTimeout });
+  }
   const status = getStatus();
   const hasProcess = status.running || status.allProcesses.length > 0;
   if (hasProcess) {

package/package.json

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