mihomo-cli 1.0.2 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # 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
 
 ### 修复

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

@@ -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.2",
+  "version": "1.0.3",
   "description": "A terminal-based mihomo (Clash.Meta) client for macOS",
   "main": "index.js",
   "bin": {