mihomo-cli 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+## [1.0.3] - 2026-04-05
+
+### 文档修复
+
+- **数据目录路径**：修正 README 中的用户数据存储位置
+  - `~/Library/Application Support/mihomo-cli/` → `~/.mihomo-cli/`
+  - 修正目录结构：`runtime/` → `.runtime/`，删除不存在的 `config/` 子目录
+- **CLI 帮助文档**：修正 `log`、`logs`、`kernel` 命令的语法和描述
+  - `logs` 命令明确 `0`=当前日志，`1+`=归档日志
+  - 补充 `-o` 选项说明
+
+## [1.0.2] - 2026-04-05
+
+### 修复
+
+- **版本号同步**：`index.js` 不再硬编码版本号，改为从 `package.json` 读取
+  - 修复 `1.0.1` 发布后 `--version` 仍显示 `1.0.0-alpha.1` 的问题
+
+## [1.0.1] - 2026-04-05
+
+### 新增功能
+
+#### 订阅管理增强
+- **订阅信息解析**：自动解析 `subscription-userinfo` 响应头
+  - 显示已用流量 / 总流量 / 到期时间
+  - 从 `content-disposition` 提取用户名
+  - 保存 `profile-update-interval`、`profile-web-page-url`
+
+- **数据分离存储**：
+  - 静态配置（name, url, updatedAt）→ `settings.json`
+  - 动态数据（流量、用户名、页面URL）→ `subs-cache.json`
+
+- **自动更新过期订阅**：
+  - 默认间隔 12 小时（或订阅服务端指定的 `profile-update-interval`）
+  - `start` 命令、`sub list` 命令时自动触发检查
+  - 并行更新所有过期订阅，失败时使用本地缓存
+
+- **订阅命令增强**：
+  - `sub use <name>`：设置默认订阅（支持模糊匹配）
+  - `sub web [name]`：打开订阅页面（无参打开默认）
+  - `sub update`：无参时更新所有订阅
+  - **模糊匹配**：精确匹配 → 前缀匹配 → 包含匹配，多匹配时提示
+
+#### 日志管理
+- **日志轮转**：每次启动前自动归档当前日志
+  - 命名格式：`mihomo.YYYY-MM-DD_HH-MM-SS.log`
+- **自动清理**：默认保留 7 天日志
+- **新命令**：
+  - `logs`：列出当前和归档日志（按时间排序）
+  - `logs <编号>`：查看指定归档日志
+    - `-n N`：指定显示行数（默认 100）
+    - `-o`：用系统默认编辑器打开
+  - `log -o`：用系统编辑器打开当前日志
+
+#### 内核更新增强
+- **镜像参数支持**：
+  - `kernel hk.gh-proxy.org`：使用指定镜像
+  - `kernel --mirror <url>`：显式指定镜像
+  - `kernel --no-mirror` / `--direct`：直连，不使用镜像
+- **镜像配置持久化**：
+  - `getGitHubMirror()` / `setGitHubMirror()`
+  - 默认：`https://v6.gh-proxy.org/`
+  - 可用镜像列表在命令中列出
+  - 空字符串 `""` 或 `false` 表示禁用镜像
+
+#### 命令别名
+新增以下命令别名，任意一个均可调用：
+- `mihomo`
+- `mmc`
+- `mh`
+
+#### 启动流程改进
+- `start` 命令现在包含完整的重启/切换逻辑：
+  - 先检查并自动更新过期订阅
+  - 再完全停止现有进程（即使没进程也清理运行时文件）
+  - 最后启动新进程
+- **移除** `restart` 命令（`start` 已包含）
+- **移除** `clean` 命令（`stop` 已包含清理）
+
+### 改进
+- 配置模块 `parseYamlOrJson()`：统一的 YAML/JSON 解析
+- 订阅列表 `sub list` 显示：
+  - 默认订阅标记 `[默认]`
+  - 更新时间 / 更新间隔
+  - 用户名（如有）
+  - 流量使用：已用 / 总量 + 百分比
+  - 到期时间
+  - 订阅页面 URL
+- `rmrf()` 改用原生 `fs.rmSync(recursive: true, force: true)`
+- 启动脚本日志改为追加模式 (`>>`) 而非覆盖
+
+### 移除
+- 移除 `geodata` 相关功能：
+  - `GEODATA_REPO`、`GEODATA_FILES` 常量
+  - `downloadGeodata()` 函数
+  - `downloadFile()` 内联函数
+
+## [1.0.0-alpha.1] - 2026-04-05
+
+- 初始版本发布
+- 基础功能：启动/停止、订阅管理、内核更新、Web UI

package/README.md

@@ -83,8 +83,8 @@ mihomo ui yacd     # YACD
 | `mihomo stop` | 停止代理 |
 | `mihomo status` | 查看运行状态 |
 | `mihomo log` | 实时查看日志 (`-o` 用系统编辑器打开) |
-| `mihomo logs` | 列出历史日志归档 |
-| `mihomo logs <编号>` | 查看指定归档日志 (`-n N` 指定行数, `-o` 打开) |
+| `mihomo logs` | 列出所有日志（当前 + 历史归档） |
+| `mihomo logs <编号>` | 查看指定日志（`0`=当前日志，`1+`=归档日志，支持 `-n N` 指定行数、`-o` 打开） |
 
 ### 订阅管理
 
@@ -160,23 +160,24 @@ mihomo kernel --no-mirror
 用户数据存储位置（与安装位置分离，更新不丢失）：
 
 ```
-~/Library/Application Support/mihomo-cli/
-├── config/
-│   ├── config.yaml      # 当前运行配置
-│   ├── settings.json    # 用户设置（订阅列表、内核版本）
-│   └── subs-cache.json  # 订阅动态缓存（流量、到期时间等）
-├── runtime/
-│   ├── pid              # 进程 PID
-│   └── config.yaml      # mihomo 运行时配置
+~/.mihomo-cli/
+├── settings.json        # 用户设置（订阅列表、内核版本）
+├── subs-cache.json      # 订阅动态缓存（流量、到期时间等）
+├── core/
+│   └── mihomo           # mihomo 内核二进制
+├── subs/
+│   └── <name>.yaml      # 订阅原始配置
 ├── logs/
 │   ├── mihomo.log       # 当前日志
 │   └── mihomo.YYYY-MM-DD_HH-MM-SS.log  # 归档日志
-├── subs/
-│   └── <name>.yaml      # 订阅原始配置
-└── core/
-    └── mihomo           # mihomo 内核二进制
+├── data/                # mihomo 运行数据（GeoIP 等，由内核自行管理）
+└── .runtime/            # 运行时临时文件（stop 自动清除）
+    ├── pid              # 进程 PID
+    └── config.yaml      # 运行时生成的配置
 ```
 
+可通过环境变量 `MIHOMO_CLI_DIR` 自定义数据目录位置。
+
 ## Web UI
 
 内置三个常用 Web UI：

package/index.js

@@ -7,7 +7,7 @@ const kernel = require('./src/kernel');
 const subscription = require('./src/subscription');
 const processMgr = require('./src/process');
 
-const VERSION = '1.0.0-alpha.1';
+const VERSION = require('./package.json').version;
 
 const UI_URLS = {
   zash: 'https://board.zash.run.place',
@@ -52,8 +52,8 @@ function printShortHelp() {
     '  start [tun|mixed]  启动/切换代理（重复执行可切换模式）\n' +
     '  stop               停止代理\n' +
     '  status             查看状态\n' +
-    '  log                实时日志\n' +
-    '  logs               历史日志\n' +
+    '  log                实时日志（-o 打开文件）\n' +
+    '  logs               日志列表（当前 + 历史归档）\n' +
     '  ui [zash|dash|yacd]  Web 界面\n' +
     '  kernel             更新内核\n' +
     '  sub add <url> [name]   添加订阅\n' +
@@ -78,10 +78,10 @@ function printHelp() {
     '  start [tun|mixed]  启动/切换代理 (默认 mixed, 重复执行可重启/切换模式)\n' +
     '  stop               停止代理\n' +
     '  status             查看状态\n' +
-    '  log                实时日志\n' +
-    '  logs [name] [-n N]  列出/查看历史日志 (默认 100 行)\n' +
+    '  log [-o]           实时日志（-o 用系统编辑器打开）\n' +
+    '  logs [编号] [-n N] [-o]  列出/查看日志（0=当前，1+=归档，-n 指定行数，-o 打开）\n' +
     '  ui [zash|dash|yacd]  打开 Web UI (默认 zash)\n' +
-    '  kernel [镜像]       更新内核 (可指定镜像: hk.gh-proxy.org 或 --no-mirror)\n' +
+    '  kernel [镜像|--no-mirror]  更新内核（指定镜像或 --no-mirror 直连）\n' +
     '  sub add <url> [name]   添加订阅\n' +
     '  sub update [name]      更新订阅 (无参更新所有)\n' +
     '  sub use <name>         设置默认订阅 (支持模糊匹配)\n' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mihomo-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A terminal-based mihomo (Clash.Meta) client for macOS",
   "main": "index.js",
   "bin": {
@@ -11,7 +11,8 @@
   },
   "files": [
     "index.js",
-    "src/**/*.js"
+    "src/**/*.js",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "start": "node index.js"