mihomo-cli 1.2.5 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## [1.3.0] - 2026-04-07
+
+### 架构重构
+
+- **代码组织优化**：将 `index.js` 中的业务函数迁移到对应模块，职责更清晰
+  - `getActiveSubscription`, `findSubscriptionFuzzy`, `pickSingleSubscription` → `subscription.js`
+  - `parseMirrorArg`, `normalizeMirrorUrl` → `utils.js`
+  - `openLogFile`, `viewLogWithTail` → `process.js`
+  - `DIRECTORY_TARGETS` → `config.js`
+
+### 代码质量
+
+- **统一 HTTP 客户端**：在 `utils.js` 中添加 `createHttpClient()` 函数，统一 `User-Agent` 为 `mihomo-cli/${VERSION}`
+- **常量提取**：将硬编码的超时、等待时间等提取为命名常量
+  - `PROCESS_WAIT_ATTEMPTS`, `PROCESS_WAIT_INTERVAL`
+  - `STARTUP_WAIT_MS`, `SUDO_TIMEOUT_MS`, `TUN_MODE_POST_WAIT_MS`
+  - `DEFAULT_LOG_RETENTION_DAYS`
+  - `KERNEL_HTTP_TIMEOUT`, `KERNEL_MAX_CONTENT_LENGTH`, `KERNEL_DOWNLOAD_TIMEOUT`
+
+### 开发工具链
+
+- **ESLint**：配置 ESLint v10 + `@eslint/js` + `globals`，自动检测未使用变量/导入
+- **Husky**：配置 Git hooks
+- **lint-staged**：提交前自动运行 `eslint --fix` + `prettier --write`
+- **Import 风格统一**：所有文件统一使用「内置模块 → 第三方模块 → 本地模块」的分组顺序和空行
+
+### 清理
+
+- 移除未使用的变量导入
+- 未使用的 catch 错误变量统一使用 `_e` 前缀
+
+---
+
 ## [1.2.5] - 2026-04-07
 
 ### 新增功能
@@ -82,6 +115,7 @@
 ### 新增功能
 
 #### 配置变更自动重启
+
 - **sub use 自动重启**：切换默认订阅后，如果 mihomo 正在运行则自动重启
 - **ow on/off 自动重启**：启用/禁用覆写配置后，如果 mihomo 正在运行则自动重启
 - **状态检查**：操作前检查是否已是目标状态，避免重复操作
@@ -89,6 +123,7 @@
 ### 重构
 
 #### 命名规范统一
+
 - **函数重命名**：统一使用全称单数
   - `findSubsFuzzy` → `findSubscriptionFuzzy`
   - `pickSingleSub` → `pickSingleSubscription`
@@ -111,6 +146,7 @@
 ### 新增功能
 
 #### 覆写配置
+
 - **覆写配置功能**：支持在订阅配置基础上进行自定义覆写
   - `ow` / `overwrite` 命令：
     - `ow` / `ow list`：查看覆写配置状态和文件列表
@@ -126,17 +162,20 @@
 ### 优化
 
 #### 输出格式
+
 - 统一输出格式，移除操作提示开头的 2 空格缩进
 - 操作结果和列表之间自动添加空行分隔
 - `start` 命令启动后自动显示完整状态信息
 - `sub` / `ow` 操作后自动刷新列表显示
 
 #### 文案统一
+
 - 节点显示统一为「组在前，节点在后」的格式：`16 组, 89 节点`
 - 统一「部分进程未终止」文案
 - 优化状态显示对齐（`PID` 单独多 1 空格对齐）
 
 #### 命令改进
+
 - `ow` 无参数时等同于 `ow list`
 - `sub` 无参数时等同于 `sub list`
 - 帮助文档中移除 `list` 子命令展示（无参即 list）
@@ -164,6 +203,7 @@
 ### 新增功能
 
 #### 订阅管理增强
+
 - **订阅信息解析**：自动解析 `subscription-userinfo` 响应头
   - 显示已用流量 / 总流量 / 到期时间
   - 从 `content-disposition` 提取用户名
@@ -185,6 +225,7 @@
   - **模糊匹配**：精确匹配 → 前缀匹配 → 包含匹配，多匹配时提示
 
 #### 日志管理
+
 - **日志轮转**：每次启动前自动归档当前日志
   - 命名格式：`mihomo.YYYY-MM-DD_HH-MM-SS.log`
 - **自动清理**：默认保留 7 天日志
@@ -196,6 +237,7 @@
   - `log -o`：用系统编辑器打开当前日志
 
 #### 内核更新增强
+
 - **镜像参数支持**：
   - `kernel hk.gh-proxy.org`：使用指定镜像
   - `kernel --mirror <url>`：显式指定镜像
@@ -207,12 +249,15 @@
   - 空字符串 `""` 或 `false` 表示禁用镜像
 
 #### 命令别名
+
 新增以下命令别名，任意一个均可调用：
+
 - `mihomo`
 - `mmc`
 - `mh`
 
 #### 启动流程改进
+
 - `start` 命令现在包含完整的重启/切换逻辑：
   - 先检查并自动更新过期订阅
   - 再完全停止现有进程（即使没进程也清理运行时文件）
@@ -221,6 +266,7 @@
 - **移除** `clean` 命令（`stop` 已包含清理）
 
 ### 改进
+
 - 配置模块 `parseYamlOrJson()`：统一的 YAML/JSON 解析
 - 订阅列表 `sub list` 显示：
   - 默认订阅标记 `[默认]`
@@ -233,6 +279,7 @@
 - 启动脚本日志改为追加模式 (`>>`) 而非覆盖
 
 ### 移除
+
 - 移除 `geodata` 相关功能：
   - `GEODATA_REPO`、`GEODATA_FILES` 常量
   - `downloadGeodata()` 函数

package/README.md

@@ -112,7 +112,7 @@ mihomo ui yacd     # YACD
 | 命令                                | 说明                                                    |
 | ----------------------------------- | ------------------------------------------------------- |
 | `mihomo kernel [镜像\|--no-mirror]` | 更新内核                                                |
-| `mihomo update`                      | 更新 mihomo-cli (npm install -g)                       |
+| `mihomo update`                     | 更新 mihomo-cli (npm install -g)                        |
 | `mihomo ui [zash\|dash\|yacd]`      | 打开 Web UI                                             |
 | `mihomo dir`                        | 显示数据目录位置                                        |
 | `mihomo dir open [target]`          | 打开指定目录（`root`, `subs`, `logs`, `overwrites` 等） |