mihomo-cli 2.8.1 → 2.9.2

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # Changelog
 
+## [2.9.2] - 2026-07-18
+
+### 修复
+
+- **带值选项被误当参数** - `sub test -t <ms>`、`sub clean -r <轮数>`、`logs -n <行数>` 等命令在不显式指定名称时，选项的值（如 `3000`）会被误认为订阅名/日志编号导致报错。现已正确识别，这些选项可独立使用
+
+### 安全 / 健壮性
+
+- **内核下载后自检** - 下载解压内核后立即运行 `mihomo -v` 校验二进制可执行且未损坏（架构不匹配、下载截断等），失败则删除并报错（mihomo 上游未提供 checksums，故以自检替代哈希校验）
+- **镜像下载来源提示** - 使用 `--mirror` 经第三方中转下载内核时，提示无法验证来源完整性
+- **自动更新超时竞态** - 自动更新订阅超时后，真正中断底层网络请求（此前请求仍会在后台跑完并写盘，与「已用缓存启动」的主流程存在竞态）
+- **清理失败节点同步清理规则** - `clean` 删除空代理组后，同步移除订阅配置中引用这些已删组的规则，避免残留
+
+### 其他
+
+- 清理未使用代码，简化进程信息采集
+
+---
+
+## [2.9.1] - 2026-06-28
+
+### 修复
+
+- **测试实例进程泄漏** - `sub test` / `sub clean` 期间按 Ctrl+C 不再残留测试内核进程（端口 27890）。新增统一的退出清理机制（`lifecycle.ts`），信号退出前同步清理
+- **`clean` 模式降级** - `mihomo clean` 清理后重启时保留当前运行模式，TUN 用户不再被静默切回 Mixed
+- **`sub web` 打开错误订阅** - 无参数时打开当前激活订阅，而非第一个添加的订阅
+- **订阅更新间隔校验** - 机场返回非正数的 `profile-update-interval`（如 -1）时回退默认间隔，不再每次启动都重新下载
+- **内核版本探测超时** - `getKernelVersion` 增加 5 秒超时，损坏的内核二进制不再导致命令永久卡死
+
+### 安全 / 健壮性
+
+- **去除 shell 命令拼接** - 进程管理、内核解压等处的 `execSync` 字符串拼接全部改用 `spawnSync` 参数数组，消除路径注入风险
+- **进程匹配精确化** - `pgrep` / `pkill -f` 的路径模式做正则转义，避免路径中的 `.` 被当作通配符误匹配/误杀其他进程
+- **原子文件写入** - settings、订阅缓存、运行时配置改为「写临时文件 → 重命名」，避免写入中途崩溃导致文件损坏
+- **settings 损坏备份** - `settings.json` 解析失败时自动备份为 `.bak`，避免被默认值覆盖丢失
+- **其他** - `formatBytes` 处理 `Infinity`；`isProxyValid` 兼容 SS2022 base64url 密钥；`ui` / `dir open` 防原型链属性；内核归档目录递归加深度限制
+
+---
+
+## [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` 可完全跳过自动更新
 
 ## 数据目录