mihomo-cli 1.0.3 → 1.1.0

package/index.js

@@ -6,6 +6,7 @@ const config = require('./src/config');
 const kernel = require('./src/kernel');
 const subscription = require('./src/subscription');
 const processMgr = require('./src/process');
+const overwrite = require('./src/overwrite');
 
 const VERSION = require('./package.json').version;
 
@@ -19,11 +20,11 @@ let exiting = false;
 
 process.on('SIGINT', () => {
   if (exiting) {
-    console.log('\n  强制退出');
+    console.log('\n强制退出');
     process.exit(1);
   }
   exiting = true;
-  console.log('\n  正在退出...');
+  console.log('\n正在退出...');
   process.exit(0);
 });
 
@@ -32,16 +33,16 @@ process.on('SIGTERM', () => {
 });
 
 process.on('uncaughtException', (e) => {
-  console.error('\n  未捕获的异常: ' + e.message);
+  console.error('\n未捕获的异常: ' + e.message);
   if (e.stack) {
-    console.error('  ' + e.stack.split('\n').slice(1).join('\n  '));
+    console.error(e.stack.split('\n').slice(1).join('\n'));
   }
   process.exit(1);
 });
 
 process.on('unhandledRejection', (reason) => {
   const msg = reason instanceof Error ? reason.message : String(reason);
-  console.error('\n  未处理的 Promise 拒绝: ' + msg);
+  console.error('\n未处理的 Promise 拒绝: ' + msg);
   process.exit(1);
 });
 
@@ -49,21 +50,20 @@ function printShortHelp() {
   console.log('\nmihomo-cli v' + VERSION);
   console.log('别名: mihomo, mmc, mh\n');
   console.log('命令:\n' +
-    '  start [tun|mixed]  启动/切换代理（重复执行可切换模式）\n' +
-    '  stop               停止代理\n' +
-    '  status             查看状态\n' +
-    '  log                实时日志（-o 打开文件）\n' +
-    '  logs               日志列表（当前 + 历史归档）\n' +
-    '  ui [zash|dash|yacd]  Web 界面\n' +
-    '  kernel             更新内核\n' +
-    '  sub add <url> [name]   添加订阅\n' +
-    '  sub update [name]      更新订阅（无参更新所有）\n' +
-    '  sub use <name>         切换默认订阅\n' +
-    '  sub web [name]         打开订阅页面\n' +
-    '  sub list               列出订阅\n' +
-    '  reset              重置配置\n' +
-    '  dirs               数据目录\n' +
-    '  version            版本信息\n');
+    '  start [tun|mixed]        启动/切换代理\n' +
+    '  stop                     停止代理\n' +
+    '  status                   查看状态\n' +
+    '  ui [zash|dash|yacd]      Web 界面\n' +
+    '  log                      实时日志\n' +
+    '  logs                     日志列表\n' +
+    '  subscription add <url>   添加订阅（别名 sub）\n' +
+    '  subscription update      更新订阅\n' +
+    '  subscription use <name>  切换默认订阅\n' +
+    '  overwrite [on|off]       覆写配置（别名 ow）\n' +
+    '  directories              数据目录（别名 dir）\n' +
+    '  kernel                   更新内核\n' +
+    '  reset                    重置配置\n' +
+    '  version                  版本信息\n');
 }
 
 function printHelp() {
@@ -74,30 +74,37 @@ function printHelp() {
     '用法:\n' +
     '  mihomo-cli <命令> [选项]\n' +
     '\n' +
-    '命令:\n' +
-    '  start [tun|mixed]  启动/切换代理 (默认 mixed, 重复执行可重启/切换模式)\n' +
-    '  stop               停止代理\n' +
-    '  status             查看状态\n' +
-    '  log [-o]           实时日志（-o 用系统编辑器打开）\n' +
-    '  logs [编号] [-n N] [-o]  列出/查看日志（0=当前，1+=归档，-n 指定行数，-o 打开）\n' +
-    '  ui [zash|dash|yacd]  打开 Web UI (默认 zash)\n' +
-    '  kernel [镜像|--no-mirror]  更新内核（指定镜像或 --no-mirror 直连）\n' +
-    '  sub add <url> [name]   添加订阅\n' +
-    '  sub update [name]      更新订阅 (无参更新所有)\n' +
-    '  sub use <name>         设置默认订阅 (支持模糊匹配)\n' +
-    '  sub web [name]         打开订阅页面\n' +
-    '  sub list              列出订阅\n' +
-    '  reset [--full]        重置用户数据 (--full 同时删除内核)\n' +
-    '  dirs                 显示数据目录位置\n' +
-    '  help, -h           显示帮助\n' +
-    '  version, -v        显示版本\n' +
+    '控制:\n' +
+    '  start [tun|mixed]            启动/切换代理 (默认 mixed)\n' +
+    '  stop                         停止代理\n' +
+    '  status                       查看状态\n' +
+    '\n' +
+    '界面:\n' +
+    '  ui [zash|dash|yacd]          打开 Web UI (默认 zash)\n' +
+    '  log [-o]                     实时日志（-o 打开文件）\n' +
+    '  logs [编号] [-n N] [-o]      日志列表（0=当前，1+=归档）\n' +
+    '\n' +
+    '订阅:\n' +
+    '  subscription add <url> [name]  添加订阅（别名 sub）\n' +
+    '  subscription update [name]     更新订阅（无参更新所有）\n' +
+    '  subscription use <name>        设置默认订阅\n' +
+    '  subscription web [name]        打开订阅页面\n' +
+    '\n' +
+    '配置:\n' +
+    '  overwrite [on|off]           覆写配置（别名 ow）\n' +
+    '  directories [open]           数据目录（别名 dir）\n' +
+    '\n' +
+    '系统:\n' +
+    '  kernel [镜像|--no-mirror]    更新内核\n' +
+    '  reset [--full]               重置用户数据 (--full 同时删除内核)\n' +
+    '  help, -h                     显示帮助\n' +
+    '  version, -v                  显示版本\n' +
     '\n' +
     '示例:\n' +
-    '  mihomo-cli start           # 启动/重启 Mixed 模式\n' +
-    '  mihomo-cli start tun       # 启动/切换到 TUN 模式 (透明代理)\n' +
-    '  mihomo-cli ui              # 打开默认 UI (zash)\n' +
-    '  mihomo-cli ui dash         # 打开 metacubexd\n' +
-    '  mihomo-cli ui yacd         # 打开 YACD\n' +
+    '  mihomo-cli start              # 启动/重启 Mixed 模式\n' +
+    '  mihomo-cli start tun          # 切换到 TUN 透明代理模式\n' +
+    '  mihomo-cli sub add <url>      # 添加订阅 (sub 是 subscription 别名)\n' +
+    '  mihomo-cli ui                 # 打开 Web UI\n' +
     '\n' +
     '模式说明:\n' +
     '  mixed  HTTP + SOCKS5 混合端口 (默认)\n' +
@@ -118,24 +125,59 @@ function printVersion() {
 function printStatus() {
   const status = processMgr.getStatus();
   const info = subscription.getConfigInfo();
+  const owEnabled = overwrite.isOverwriteEnabled();
+  const owFiles = overwrite.listOverwriteFiles().files;
+  const activeSub = getActiveSubscription();
 
   console.log('');
-  console.log('  状态: ' + (status.running ? '运行中' : '已停止'));
+  let modeLabel = '';
+  if (info && status.running) {
+    modeLabel = info.tun ? ' (TUN)' : ' (Mixed)';
+  }
+  console.log('状态: ' + (status.running ? '运行中' : '已停止') + modeLabel);
+  console.log('内核: ' + (status.kernelVersion || '未安装'));
+
   if (status.pid) {
-    console.log('  PID:  ' + status.pid);
+    console.log('PID:  ' + status.pid);
     if (status.processInfo) {
-      console.log('  内存: ' + status.processInfo.memory);
-      if (status.processInfo.cpu) {
-        console.log('  CPU:  ' + status.processInfo.cpu);
-      }
+      console.log('内存: ' + status.processInfo.memory);
     }
   }
+
   if (info) {
-    console.log('  节点: ' + info.proxies);
-    console.log('  端口: ' + info.port);
-    console.log('  TUN:  ' + (info.tun ? '启用' : '未启用'));
+    if (info.mixedPort) {
+      console.log('端口: ' + info.mixedPort);
+    } else {
+      let ports = [];
+      if (info.httpPort) ports.push('HTTP:' + info.httpPort);
+      if (info.socksPort) ports.push('SOCKS:' + info.socksPort);
+      console.log('端口: ' + (ports.length > 0 ? ports.join(', ') : '未知'));
+    }
+  }
+
+  if (activeSub) {
+    let subLine = '订阅: ' + activeSub.name;
+    if (info) {
+      let parts = [];
+      if (info.proxyGroups && info.proxyGroups > 0) {
+        parts.push(info.proxyGroups + ' 组');
+      }
+      parts.push(info.proxies + ' 节点');
+      subLine += ' (' + parts.join(', ') + ')';
+    }
+    console.log(subLine);
+  } else {
+    console.log('订阅: 未配置');
+  }
+
+  if (owEnabled && owFiles.length > 0) {
+    const names = owFiles.map(f => f.name).join(', ');
+    console.log('覆写: 已启用 (' + names + ')');
+  } else if (owEnabled) {
+    console.log('覆写: 已启用 (无文件)');
+  } else {
+    console.log('覆写: 已禁用');
   }
-  console.log('  内核: ' + (status.kernelVersion || '未安装'));
   console.log('');
 }
 
@@ -171,15 +213,15 @@ function findSubsFuzzy(subs, pattern) {
 
 function pickSingleSub(subs, pattern, actionName) {
   if (subs.length === 0) {
-    console.error('  错误: 未找到匹配 "' + pattern + '" 的订阅');
+    console.error('错误: 未找到匹配 "' + pattern + '" 的订阅');
     process.exit(1);
   }
   if (subs.length === 1) {
     return subs[0];
   }
-  console.error('  错误: 匹配到多个订阅，请更精确指定');
-  console.log('\n  匹配的订阅:');
-  subs.forEach(s => console.log('    ' + s.name));
+  console.error('错误: 匹配到多个订阅，请更精确指定');
+  console.log('\n匹配的订阅:');
+  subs.forEach(s => console.log('  ' + s.name));
   process.exit(1);
 }
 
@@ -212,10 +254,19 @@ function getNonFlagArg(args, startIdx) {
 
 function openLogFile(logPath, label) {
   const displayLabel = label || logPath;
-  console.log('  用系统默认程序打开: ' + displayLabel);
+  console.log('用系统默认程序打开: ' + displayLabel);
   const success = processMgr.openUrl(logPath);
   if (!success) {
-    console.log('  请手动打开: ' + logPath);
+    console.log('请手动打开: ' + logPath);
+  }
+}
+
+function openDir(dirPath, label) {
+  const displayLabel = label || dirPath;
+  console.log('正在打开: ' + displayLabel);
+  const success = processMgr.openUrl(dirPath);
+  if (!success) {
+    console.log('请手动打开: ' + dirPath);
   }
 }
 
@@ -223,11 +274,11 @@ function viewLogWithTail(logPath, options) {
   const follow = options && options.follow;
   const lines = (options && options.lines) || 100;
 
-  console.log('  日志: ' + logPath);
+  console.log('日志: ' + logPath);
   if (follow) {
-    console.log('  按 Ctrl+C 退出\n');
+    console.log('按 Ctrl+C 退出\n');
   } else {
-    console.log('  显示最后 ' + lines + ' 行\n');
+    console.log('显示最后 ' + lines + ' 行\n');
   }
 
   const tailArgs = [];
@@ -239,14 +290,14 @@ function viewLogWithTail(logPath, options) {
 
   tail.on('close', () => process.exit(0));
   tail.on('error', (e) => {
-    console.error('  无法读取日志: ' + e.message);
+    console.error('无法读取日志: ' + e.message);
     process.exit(1);
   });
 }
 
 async function cmdStart(args) {
   if (!config.hasKernel()) {
-    console.error('  错误: 未找到内核，请运行 \'mihomo-cli kernel\'');
+    console.error('错误: 未找到内核，请运行 \'mihomo-cli kernel\'');
     process.exit(1);
   }
 
@@ -254,7 +305,7 @@ async function cmdStart(args) {
 
   const sub = getActiveSubscription();
   if (!sub) {
-    console.error('  错误: 没有订阅，请先添加订阅');
+    console.error('错误: 没有订阅，请先添加订阅');
     process.exit(1);
   }
 
@@ -266,40 +317,42 @@ async function cmdStart(args) {
 
   if (hasProcess) {
     const count = status.allProcesses.length > 0 ? status.allProcesses.length : 1;
-    console.log('  停止 ' + count + ' 个进程...');
+    console.log('停止 ' + count + ' 个进程...');
   }
 
   // 总是调用 stop（即使没进程也会清理 PID 文件和运行时目录）
   const stopResult = processMgr.stop(true);
 
   if (stopResult.remaining && stopResult.remaining.length > 0) {
-    console.error('  部分进程无法终止: ' + stopResult.remaining.join(', '));
-    console.error('  请手动运行: sudo pkill -9 mihomo');
+    console.error('部分进程未终止: ' + stopResult.remaining.join(', '));
+    console.error('请手动运行: sudo pkill -9 mihomo');
     process.exit(1);
   }
 
   if (hasProcess) {
-    console.log('  已停止\n');
+    console.log('已停止\n');
   }
 
   let cfgInfo;
   try {
     cfgInfo = subscription.prepareConfigForStart(targetMode, sub.name);
   } catch (e) {
-    console.error('  配置错误: ' + e.message);
+    console.error('配置错误: ' + e.message);
     process.exit(1);
   }
 
   const modeLabel = targetMode === 'tun' ? 'TUN' : 'Mixed';
-  const groupsLabel = cfgInfo.proxyGroups ? cfgInfo.proxyGroups + ' 组' : '';
-  const countLabel = groupsLabel ? (groupsLabel + ' ' + cfgInfo.proxies + ' 节点') : (cfgInfo.proxies + ' 节点');
-  console.log('  ' + [modeLabel, sub.name, countLabel].join(' · '));
+  const parts = [];
+  if (cfgInfo.proxyGroups && cfgInfo.proxyGroups > 0) parts.push(cfgInfo.proxyGroups + ' 组');
+  parts.push(cfgInfo.proxies + ' 节点');
+  console.log([modeLabel, sub.name, parts.join(', ')].join(' · '));
 
   try {
     const result = await processMgr.start(targetMode);
-    console.log('  已启动 (PID ' + result.pid + ')');
+    console.log('已启动 (PID ' + result.pid + ')');
+    printStatus();
   } catch (e) {
-    console.error('  启动失败: ' + e.message.split('\n')[0]);
+    console.error('启动失败: ' + e.message.split('\n')[0]);
     process.exit(1);
   }
 }
@@ -307,19 +360,19 @@ async function cmdStart(args) {
 async function cmdStop() {
   const pids = processMgr.getAllMihomoPids();
   if (pids.length === 0) {
-    console.log('  未在运行');
+    console.log('未在运行');
     return;
   }
 
-  console.log('  停止 ' + pids.length + ' 个进程...');
+  console.log('停止 ' + pids.length + ' 个进程...');
   const result = processMgr.stop(true);
 
   if (result.remaining && result.remaining.length > 0) {
-    console.error('  部分进程未终止: ' + result.remaining.join(', '));
-    console.error('  请手动运行: sudo pkill -9 mihomo');
+    console.error('部分进程未终止: ' + result.remaining.join(', '));
+    console.error('请手动运行: sudo pkill -9 mihomo');
     process.exit(1);
   }
-  console.log('  已停止');
+  console.log('已停止');
 }
 
 function cmdUi(args) {
@@ -327,17 +380,17 @@ function cmdUi(args) {
   const url = UI_URLS[uiName];
 
   if (!url) {
-    console.error('  错误: 未知的 UI "' + uiName + '"');
-    console.error('  可用 UI: zash (默认), dash, yacd');
+    console.error('错误: 未知的 UI "' + uiName + '"');
+    console.error('可用 UI: zash (默认), dash, yacd');
     process.exit(1);
   }
 
-  console.log('  打开 Web UI: ' + uiName);
-  console.log('  地址: ' + url);
+  console.log('打开 Web UI: ' + uiName);
+  console.log('地址: ' + url);
 
   const success = processMgr.openUrl(url);
   if (!success) {
-    console.log('  请手动访问上面的地址');
+    console.log('请手动访问上面的地址');
   }
 }
 
@@ -368,8 +421,8 @@ function cmdLogs(args) {
     }
 
     if (!logPath) {
-      console.error('  错误: 未找到日志 "' + targetName + '"');
-      console.log('  使用 "mihomo-cli logs" 查看可用日志列表');
+      console.error('错误: 未找到日志 "' + targetName + '"');
+      console.log('使用 "mihomo-cli logs" 查看可用日志列表');
       process.exit(1);
     }
 
@@ -391,12 +444,12 @@ function cmdLogs(args) {
   all.push(...logs.archives);
 
   if (all.length === 0) {
-    console.log('  暂无日志');
+    console.log('暂无日志');
     return;
   }
 
   console.log('');
-  console.log('  日志列表:');
+  console.log('日志列表:');
   console.log('');
 
   all.forEach((log, idx) => {
@@ -405,19 +458,19 @@ function cmdLogs(args) {
     const size = subscription.formatBytes(log.size);
     const name = log.isCurrent ? 'mihomo.log (当前运行中)' : log.name;
 
-    console.log('  ' + num + '. ' + name);
-    console.log('      时间: ' + time + '  大小: ' + size);
+    console.log(' ' + num + '. ' + name);
+    console.log('    时间: ' + time + '  大小: ' + size);
     if (!log.isCurrent) {
-      console.log('      查看: mihomo-cli logs ' + idx + '  或  mihomo-cli logs -o ' + idx);
+      console.log('    查看: mihomo-cli logs ' + idx + '  或  mihomo-cli logs -o ' + idx);
     }
     console.log('');
   });
 
-  console.log('  用法:');
-  console.log('    mihomo-cli logs 0          # 查看当前日志 (最后 100 行)');
-  console.log('    mihomo-cli logs 1          # 查看第 1 个归档日志');
-  console.log('    mihomo-cli logs 1 -n 200   # 查看 200 行');
-  console.log('    mihomo-cli logs 1 -o        # 用系统默认程序打开');
+  console.log('用法:');
+  console.log('  mihomo-cli logs 0          # 查看当前日志 (最后 100 行)');
+  console.log('  mihomo-cli logs 1          # 查看第 1 个归档日志');
+  console.log('  mihomo-cli logs 1 -n 200   # 查看 200 行');
+  console.log('  mihomo-cli logs 1 -o        # 用系统默认程序打开');
   console.log('');
 }
 
@@ -473,107 +526,111 @@ async function cmdKernel(args) {
   const effectiveMirror = mirrorInfo.isOverride ? mirrorInfo.mirror : config.getGitHubMirror();
   const isDefault = !mirrorInfo.isOverride && effectiveMirror === config.DEFAULT_GITHUB_MIRROR;
 
-  console.log('  检查内核更新...');
+  console.log('检查内核更新...');
 
   if (mirrorInfo.isOverride) {
     if (effectiveMirror === null) {
-      console.log('  镜像: 直连（命令行指定 --no-mirror）');
+      console.log('镜像: 直连（命令行指定 --no-mirror）');
     } else {
-      console.log('  镜像: ' + effectiveMirror + ' (命令行指定)');
+      console.log('镜像: ' + effectiveMirror + ' (命令行指定)');
     }
   } else {
-    console.log('  镜像: ' + (effectiveMirror || '直连（无镜像）') + (isDefault && effectiveMirror ? ' (默认)' : ''));
+    console.log('镜像: ' + (effectiveMirror || '直连（无镜像）') + (isDefault && effectiveMirror ? ' (默认)' : ''));
   }
 
-  console.log('\n  可用镜像:');
+  console.log('\n可用镜像:');
   config.AVAILABLE_MIRRORS.forEach(m => {
     const isCurrent = effectiveMirror && (
       effectiveMirror.includes('//' + m + '/') ||
       effectiveMirror.includes('//' + m + ':') ||
       effectiveMirror.endsWith('//' + m)
     );
-    console.log('    ' + m + (isCurrent ? ' (当前)' : ''));
+    console.log('  ' + m + (isCurrent ? ' (当前)' : ''));
   });
 
-  console.log('\n  用法:');
-  console.log('    mihomo-cli kernel                    # 使用默认镜像');
-  console.log('    mihomo-cli kernel hk.gh-proxy.org    # 使用指定镜像');
-  console.log('    mihomo-cli kernel --mirror hk.gh-proxy.org');
-  console.log('    mihomo-cli kernel --no-mirror         # 直连，不使用镜像');
+  console.log('\n用法:');
+  console.log('  mihomo-cli kernel                    # 使用默认镜像');
+  console.log('  mihomo-cli kernel hk.gh-proxy.org    # 使用指定镜像');
+  console.log('  mihomo-cli kernel --mirror hk.gh-proxy.org');
+  console.log('  mihomo-cli kernel --no-mirror         # 直连，不使用镜像');
   console.log('');
 
   try {
     const info = await kernel.checkUpdate();
-    console.log('  当前: ' + info.current);
-    console.log('  最新: ' + info.latest);
+    console.log('当前: ' + info.current);
+    console.log('最新: ' + info.latest);
 
     if (!info.needsUpdate) {
-      console.log('  已是最新版本');
+      console.log('已是最新版本');
       return;
     }
 
-    console.log('\n  正在下载...');
+    console.log('\n正在下载...');
     const result = await kernel.downloadKernel((msg) => {
-      console.log('  ' + msg);
+      console.log(msg);
     }, mirrorInfo.mirror);  // 传递镜像参数（undefined = 用配置，null = 禁用）
-    console.log('  已更新到 ' + result.version);
+    console.log('已更新到 ' + result.version);
   } catch (e) {
-    console.error('  更新失败: ' + e.message);
+    console.error('更新失败: ' + e.message);
     process.exit(1);
   }
 }
 
-async function cmdSub(args) {
-  const action = args[1];
+async function printSubList() {
+  const updateResult = await subscription.autoUpdateStaleSubscriptions();
+  if (updateResult.total > 0) {
+    console.log('');
+  }
 
-  if (!action || action === 'list') {
-    const updateResult = await subscription.autoUpdateStaleSubscriptions();
-    if (updateResult.total > 0) {
-      console.log('');
+  const subs = config.getSubscriptionsWithCache();
+  if (subs.length === 0) {
+    console.log('没有订阅');
+    console.log('');
+    console.log('添加订阅: mihomo-cli sub add <url> [name]');
+    console.log('');
+    return;
+  }
+  console.log('订阅列表:');
+  subs.forEach((s, i) => {
+    const time = subscription.formatDate(s.updated_at);
+    const defaultMark = i === 0 ? ' [默认]' : '';
+    const interval = s.update_interval || subscription.DEFAULT_UPDATE_INTERVAL_HOURS;
+    console.log('  ' + (i + 1) + '. ' + s.name + defaultMark);
+    console.log('    更新: ' + time + ' (间隔: ' + interval + 'h)');
+
+    if (s.username) {
+      console.log('    用户: ' + s.username);
     }
-
-    const subs = config.getSubscriptionsWithCache();
-    if (subs.length === 0) {
-      console.log('  没有订阅');
-      console.log('\n  添加订阅:');
-      console.log('    mihomo-cli sub add <url> [name]');
-      return;
+    if (s.download !== undefined || s.total !== undefined) {
+      const used = (s.upload || 0) + (s.download || 0);
+      const usedStr = subscription.formatBytes(used);
+      const totalStr = subscription.formatBytes(s.total);
+      let percentStr = '';
+      if (s.total && s.total > 0) {
+        const percent = Math.min((used / s.total) * 100, 100);
+        percentStr = ' (' + percent.toFixed(1) + '%)';
+      }
+      console.log('    流量: ' + usedStr + ' / ' + totalStr + percentStr);
+    }
+    if (s.expire !== undefined) {
+      console.log('    到期: ' + subscription.formatTimestamp(s.expire));
     }
-    console.log('  订阅列表:');
-    subs.forEach((s, i) => {
-      const time = subscription.formatDate(s.updatedAt);
-      const defaultMark = i === 0 ? ' [默认]' : '';
-      const interval = s.updateInterval || subscription.DEFAULT_UPDATE_INTERVAL_HOURS;
-      console.log('    ' + (i + 1) + '. ' + s.name + defaultMark);
-      console.log('       更新: ' + time + ' (间隔: ' + interval + 'h)');
+    if (s.web_page_url) {
+      console.log('    页面: ' + s.web_page_url);
+    }
+  });
+  console.log('');
+  console.log('切换默认: sub use <name>');
+  console.log('更新订阅: sub update [name]');
+  console.log('打开页面: sub web [name]');
+  console.log('');
+}
 
-      if (s.username) {
-        console.log('       用户: ' + s.username);
-      }
-      if (s.download !== undefined || s.total !== undefined) {
-        const used = (s.upload || 0) + (s.download || 0);
-        const usedStr = subscription.formatBytes(used);
-        const totalStr = subscription.formatBytes(s.total);
-        let percentStr = '';
-        if (s.total && s.total > 0) {
-          const percent = Math.min((used / s.total) * 100, 100);
-          percentStr = ' (' + percent.toFixed(1) + '%)';
-        }
-        console.log('       流量: ' + usedStr + ' / ' + totalStr + percentStr);
-      }
-      if (s.expire !== undefined) {
-        console.log('       到期: ' + subscription.formatTimestamp(s.expire));
-      }
-      if (s.webPageUrl) {
-        console.log('       页面: ' + s.webPageUrl);
-      }
-    });
-    console.log('\n  切换默认订阅:');
-    console.log('    mihomo-cli sub use <name>');
-    console.log('  更新订阅:');
-    console.log('    mihomo-cli sub update [name]');
-    console.log('  打开订阅页面:');
-    console.log('    mihomo-cli sub web [name]');
+async function cmdSub(args) {
+  const action = args[1];
+
+  if (!action || action === 'list') {
+    await printSubList();
     return;
   }
 
@@ -582,19 +639,24 @@ async function cmdSub(args) {
     const name = args[3] || 'default';
 
     if (!url || !url.startsWith('http')) {
-      console.error('  错误: 请提供有效的订阅 URL');
+      console.error('错误: 请提供有效的订阅 URL');
       process.exit(1);
     }
 
-    console.log('  添加订阅: ' + name);
+    console.log('添加订阅: ' + name);
     try {
       config.addSubscription(url, name);
       const info = await subscription.downloadSubscription(url, name);
-      console.log('  已添加 (节点: ' + info.proxies + ')');
+      const parts = [];
+      if (info.proxyGroups && info.proxyGroups > 0) parts.push(info.proxyGroups + ' 组');
+      parts.push(info.proxies + ' 节点');
+      console.log('已添加 (' + parts.join(', ') + ')');
     } catch (e) {
-      console.error('  添加失败: ' + e.message);
+      console.error('添加失败: ' + e.message);
       process.exit(1);
     }
+    console.log('');
+    await printSubList();
     return;
   }
 
@@ -603,37 +665,47 @@ async function cmdSub(args) {
     const subs = config.getSubscriptions();
 
     if (subs.length === 0) {
-      console.error('  错误: 没有订阅');
+      console.error('错误: 没有订阅');
       process.exit(1);
     }
 
     if (!name) {
-      console.log('  更新所有 ' + subs.length + ' 个订阅...');
+      console.log('更新所有 ' + subs.length + ' 个订阅...');
       const results = await Promise.all(subs.map(subscription.tryUpdateOne));
       let ok = 0;
       results.forEach(r => {
         if (r.success) {
           ok++;
-          console.log('  ✓ ' + r.name + ': ' + r.proxies + ' 节点');
+          const parts = [];
+          if (r.proxyGroups && r.proxyGroups > 0) parts.push(r.proxyGroups + ' 组');
+          parts.push(r.proxies + ' 节点');
+          console.log('✓ ' + r.name + ': 已更新 (' + parts.join(', ') + ')');
         } else {
-          console.log('  ✗ ' + r.name + ': 失败 (' + r.error.split('\n')[0] + ')');
+          console.log('✗ ' + r.name + ': 失败 (' + r.error.split('\n')[0] + ')');
         }
       });
       if (ok === 0) process.exit(1);
+      console.log('');
+      await printSubList();
       return;
     }
 
     const matches = findSubsFuzzy(subs, name);
     const target = pickSingleSub(matches, name, '更新');
 
-    console.log('  更新订阅: ' + target.name);
+    console.log('更新订阅: ' + target.name);
     try {
       const info = await subscription.downloadSubscription(target.url, target.name);
-      console.log('  已更新 (节点: ' + info.proxies + ')');
+      const parts = [];
+      if (info.proxyGroups && info.proxyGroups > 0) parts.push(info.proxyGroups + ' 组');
+      parts.push(info.proxies + ' 节点');
+      console.log('已更新 (' + parts.join(', ') + ')');
     } catch (e) {
-      console.error('  更新失败: ' + e.message);
+      console.error('更新失败: ' + e.message);
       process.exit(1);
     }
+    console.log('');
+    await printSubList();
     return;
   }
 
@@ -642,10 +714,10 @@ async function cmdSub(args) {
     const subs = config.getSubscriptions();
 
     if (!name) {
-      console.error('  错误: 请指定订阅名称');
+      console.error('错误: 请指定订阅名称');
       if (subs.length > 0) {
-        console.log('\n  可用订阅:');
-        subs.forEach(s => console.log('    ' + s.name));
+        console.log('\n可用订阅:');
+        subs.forEach(s => console.log('  ' + s.name));
       }
       process.exit(1);
     }
@@ -655,11 +727,13 @@ async function cmdSub(args) {
 
     const success = config.setDefaultSubscription(target.name);
     if (success) {
-      console.log('  已设置 "' + target.name + '" 为默认订阅');
+      console.log('已设置 "' + target.name + '" 为默认订阅');
     } else {
-      console.error('  错误: 未找到订阅 "' + name + '"');
+      console.error('错误: 未找到订阅 "' + name + '"');
       process.exit(1);
     }
+    console.log('');
+    await printSubList();
     return;
   }
 
@@ -668,7 +742,7 @@ async function cmdSub(args) {
     const subs = config.getSubscriptionsWithCache();
 
     if (subs.length === 0) {
-      console.error('  错误: 没有订阅');
+      console.error('错误: 没有订阅');
       process.exit(1);
     }
 
@@ -680,33 +754,35 @@ async function cmdSub(args) {
       target = subs[0];
     }
 
-    let webPageUrl = target.webPageUrl;
+    let webPageUrl = target.web_page_url;
     if (!webPageUrl) {
-      console.log('  订阅信息中缺少页面地址，正在更新订阅...');
+      console.log('订阅信息中缺少页面地址，正在更新订阅...');
       try {
         const info = await subscription.downloadSubscription(target.url, target.name);
-        if (info.webPageUrl) {
-          webPageUrl = info.webPageUrl;
+        // 重新读取缓存获取 web_page_url
+        const cache = config.readSubscriptionsCache();
+        if (cache[target.name] && cache[target.name].web_page_url) {
+          webPageUrl = cache[target.name].web_page_url;
         } else {
-          console.error('  错误: 该订阅没有提供页面地址');
+          console.error('错误: 该订阅没有提供页面地址');
           process.exit(1);
         }
       } catch (e) {
-        console.error('  更新失败: ' + e.message);
+        console.error('更新失败: ' + e.message);
         process.exit(1);
       }
     }
 
-    console.log('  打开订阅页面: ' + webPageUrl);
+    console.log('打开订阅页面: ' + webPageUrl);
     const opened = processMgr.openUrl(webPageUrl);
     if (!opened) {
-      console.log('  请手动访问上面的地址');
+      console.log('请手动访问上面的地址');
     }
     return;
   }
 
-  console.error('  错误: 未知的订阅命令');
-  console.log('  用法: mihomo-cli sub [list|add|update|use|web]');
+  console.error('错误: 未知的订阅命令');
+  console.log('用法: mihomo-cli sub [list|add|update|use|web]');
   process.exit(1);
 }
 
@@ -716,7 +792,7 @@ async function cmdReset(args) {
 
   const pids = processMgr.getAllMihomoPids();
   if (pids.length > 0) {
-    console.log('  停止 ' + pids.length + ' 个进程...');
+    console.log('停止 ' + pids.length + ' 个进程...');
     processMgr.cleanupAll(true);
     for (let i = 0; i < 50; i++) {
       if (processMgr.getAllMihomoPids().length === 0) break;
@@ -725,7 +801,7 @@ async function cmdReset(args) {
   }
 
   const mode = fullReset ? '完整重置 (含内核)' : '重置配置';
-  console.log('  ' + mode);
+  console.log(mode);
 
   if (!skipConfirm) {
     const readline = require('readline');
@@ -735,39 +811,143 @@ async function cmdReset(args) {
     });
 
     const answer = await new Promise(resolve => {
-      rl.question('  确认? (y/N) ', (a) => {
+      rl.question('确认? (y/N) ', (a) => {
         rl.close();
         resolve(a);
       });
     });
 
     if (answer.toLowerCase() !== 'y' && answer.toLowerCase() !== 'yes') {
-      console.log('  已取消');
+      console.log('已取消');
       return;
     }
   }
 
   const count = config.resetUserData({ keepKernel: !fullReset });
-  console.log('  已重置 ' + count + ' 项');
+  console.log('已重置 ' + count + ' 项');
 }
 
-function cmdDirs() {
+function printOverwriteList() {
+  const info = overwrite.listOverwriteFiles();
   console.log('');
-  console.log('  数据目录位置:');
-  console.log('    根目录:      ' + config.USER_DATA_DIR);
-  console.log('    全局设置:    ' + config.PATHS.settingsFile);
-  console.log('    内核文件:    ' + config.PATHS.mihomoBinary);
-  console.log('    订阅目录:    ' + config.DIRS.subs);
-  console.log('      - xxx.yaml (订阅原始配置，不修改)');
-  console.log('    运行时目录:  ' + config.DIRS.runtime);
-  console.log('      - config.yaml (启动时生成，stop 自动清除)');
-  console.log('      - pid (PID 文件，stop 自动清除)');
-  console.log('    日志文件:    ' + config.PATHS.logFile);
-  console.log('    mihomo 数据: ' + config.DIRS.data);
-  console.log('      - cache.db, Geo*.dat 等 (mihomo 自行管理)');
+  console.log('状态: ' + (info.enabled ? '已启用' : '已禁用'));
+  console.log('目录: ' + info.dir);
   console.log('');
-  console.log('  环境变量:');
-  console.log('    MIHOMO_CLI_DIR: 自定义根目录位置');
+  if (info.files.length === 0) {
+    console.log('暂无覆写文件');
+    console.log('');
+    console.log('用法示例: 创建文件 ' + path.join(info.dir, '01-custom.yaml'));
+    console.log('');
+  } else {
+    console.log('覆写文件 (' + info.files.length + ' 个，按顺序加载):');
+    console.log('');
+    info.files.forEach((f, i) => {
+      const num = i < 10 ? ' ' + i : '' + i;
+      console.log('  ' + num + '. ' + f.name);
+      if (f.keys.length > 0) {
+        console.log('    字段: ' + f.keys.join(', '));
+      }
+    });
+    console.log('');
+  }
+  console.log('启用覆写: ow on');
+  console.log('禁用覆写: ow off');
+  console.log('');
+}
+
+function cmdOverwrite(args) {
+  const action = args && args[1];
+
+  if (action === 'on' || action === 'enable') {
+    overwrite.setOverwriteEnabled(true);
+    console.log('已启用覆写配置');
+    console.log('');
+    printOverwriteList();
+    return;
+  }
+
+  if (action === 'off' || action === 'disable') {
+    overwrite.setOverwriteEnabled(false);
+    console.log('已禁用覆写配置');
+    console.log('');
+    printOverwriteList();
+    return;
+  }
+
+  // 无参数、list、ls 都显示文件列表
+  printOverwriteList();
+}
+
+function cmdDirs(args) {
+  const action = args && args[1];
+
+  // dirs open [root|subs|logs|data|runtime|config|kernel]
+  if (action === 'open') {
+    const target = args[2];
+
+    if (!target || target === 'root') {
+      openDir(config.USER_DATA_DIR, '根目录');
+      return;
+    }
+
+    const dirMap = {
+      'subs': { path: config.DIRS.subscriptions, label: '订阅目录' },
+      'subscriptions': { path: config.DIRS.subscriptions, label: '订阅目录' },
+      'logs': { path: config.DIRS.logs, label: '日志目录' },
+      'data': { path: config.DIRS.data, label: 'mihomo 数据目录' },
+      'runtime': { path: config.DIRS.runtime, label: '运行时目录' },
+    };
+
+    const fileMap = {
+      'config': { path: config.PATHS.settingsFile, label: '设置文件' },
+      'settings': { path: config.PATHS.settingsFile, label: '设置文件' },
+      'kernel': { path: config.DIRS.core, label: '内核目录' },
+    };
+
+    const targetInfo = dirMap[target] || fileMap[target];
+    if (targetInfo) {
+      openDir(targetInfo.path, targetInfo.label);
+      return;
+    }
+
+    console.error('错误: 未知的目录目标 "' + target + '"');
+    console.log('');
+    console.log('可用目标:');
+    console.log('  root (默认)   根目录');
+    console.log('  subs          订阅目录');
+    console.log('  logs          日志目录');
+    console.log('  data          mihomo 数据目录');
+    console.log('  runtime       运行时目录');
+    console.log('  config        设置文件 (settings.json)');
+    console.log('  kernel        内核目录');
+    console.log('');
+    process.exit(1);
+  }
+
+  // 无参数或未知参数：显示目录列表
+  console.log('');
+  console.log('数据目录位置:');
+  console.log('  根目录: ' + config.USER_DATA_DIR);
+  console.log('  全局设置: ' + config.PATHS.settingsFile);
+  console.log('  内核文件: ' + config.PATHS.mihomoBinary);
+  console.log('  订阅目录: ' + config.DIRS.subscriptions);
+  console.log('    - cache.json (订阅缓存：更新时间、流量等)');
+  console.log('    - xxx.yaml (订阅原始配置)');
+  console.log('  运行时目录: ' + config.DIRS.runtime);
+  console.log('    - config.yaml (启动时生成，stop 自动清除)');
+  console.log('    - pid (PID 文件，stop 自动清除)');
+  console.log('  日志文件: ' + config.PATHS.logFile);
+  console.log('  mihomo 数据: ' + config.DIRS.data);
+  console.log('    - cache.db, Geo*.dat 等 (mihomo 自行管理)');
+  console.log('');
+  console.log('打开目录:');
+  console.log('  mihomo-cli dirs open               打开根目录');
+  console.log('  mihomo-cli dirs open subscriptions 打开订阅目录');
+  console.log('  mihomo-cli dirs open logs          打开日志目录');
+  console.log('  mihomo-cli dirs open config        打开设置文件');
+  console.log('');
+  console.log('环境变量:');
+  console.log('  MIHOMO_CLI_DIR: 自定义根目录位置');
   console.log('');
 }
 
@@ -817,22 +997,30 @@ async function main() {
       break;
     case 'sub':
     case 'subscription':
+    case 'subscriptions':
       await cmdSub(args);
       break;
+    case 'dir':
     case 'dirs':
-      cmdDirs();
+    case 'directory':
+    case 'directories':
+      cmdDirs(args);
       break;
     case 'reset':
       await cmdReset(args);
       break;
+    case 'overwrite':
+    case 'ow':
+      cmdOverwrite(args);
+      break;
     default:
-      console.error('  未知命令: ' + cmd);
-      console.error('  使用 "mihomo-cli help" 查看帮助');
+      console.error('未知命令: ' + cmd);
+      console.error('使用 "mihomo-cli help" 查看帮助');
       process.exit(1);
   }
 }
 
 main().catch(e => {
-  console.error('  错误:', e.message);
+  console.error('错误:', e.message);
   process.exit(1);
 });