mihomo-cli 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # Changelog
 
+## [1.5.0] - 2026-04-10
+
+### 新增功能
+
+- **快捷命令**：新增顶层命令快捷方式，减少输入
+  - `mihomo up` = `mihomo start`
+  - `mihomo down` = `mihomo stop`
+  - `mihomo tun` = `mihomo start tun`
+  - `mihomo use <name>` = `mihomo sub use <name>`
+  - `mihomo on` / `mihomo off` = `mihomo ow on` / `mihomo ow off`
+  - `mihomo open <target>` = `mihomo dir open <target>`
+- **订阅选择机制**：使用 `active_subscription` 字段标识当前订阅，不再依赖数组顺序
+- **配置构建调试**：运行时目录生成 3 阶段中间文件，方便排查配置问题
+  - `1.subscription.yaml` — 订阅原始配置
+  - `2.overwrite.yaml` — 覆写合并内容
+  - `3.system.yaml` — 系统补充值（BASE_CONFIG + TUN）
+
+### 重构
+
+- **目录结构调整**：
+  - `core/` → `kernel/`（内核目录）
+  - `.runtime/` → `runtime/`（运行时目录）
+  - `overwrites/` 目录 → 根目录 `overwrite.yaml` + `overwrite.*.yaml`（覆写文件扁平化）
+- **配置合并逻辑**：BASE_CONFIG / TUN_CONFIG 改为只补充订阅中缺失的字段，不再强制覆盖已有值
+- **TUN 模式**：移除 `ipv6: false` 硬编码，交由订阅或覆写控制
+- **`dir open` 目标精简**：移除 `overwrites` 和 `settings`，保留 `root|subs|logs|data|runtime|kernel`
+
+### 优化
+
+- **文案调整**：
+  - "默认订阅" → "当前订阅" / "使用中"
+  - 覆写文件名显示去除 `overwrite.` 前缀
+  - 覆写配置 "目录" → "位置"
+- **dir 信息**：新增显示内核目录路径
+
+---
+
+## [1.4.1] - 2026-04-08
+
+### 优化
+
+- **状态显示文案**：
+  - `○ 已停止` → `不在运行`（移除符号，更简洁明确）
+  - `未在运行` → `不在运行`（统一措辞）
+- **代码风格统一**：标签输出格式统一为 `colors.gray('标签: ')`
+
+---
+
 ## [1.4.0] - 2026-04-07
 
 ### 新增功能

package/README.md

@@ -96,7 +96,7 @@ mihomo ui yacd     # YACD
 | `mihomo sub add <url> [name]` | 添加订阅                               |
 | `mihomo sub update`           | 更新所有订阅                           |
 | `mihomo sub update <name>`    | 更新指定订阅（支持模糊匹配）           |
-| `mihomo sub use <name>`       | 设置默认订阅（支持模糊匹配，自动重启） |
+| `mihomo sub use <name>`       | 切换当前订阅（支持模糊匹配，自动重启） |
 | `mihomo sub web [name]`       | 打开订阅页面（无参打开默认）           |
 
 ### 覆写配置
@@ -115,7 +115,7 @@ mihomo ui yacd     # YACD
 | `mihomo update`                   | 更新 mihomo-cli (npm install -g)                                    |
 | `mihomo ui [zash\|dash\|yacd]`    | 打开 Web UI                                                         |
 | `mihomo dir`                      | 显示数据目录位置                                                    |
-| `mihomo dir open [target]`        | 打开指定目录（`root`, `subs`, `logs`, `overwrites` 等）             |
+| `mihomo dir open [target]`        | 打开指定目录（`root`, `subs`, `logs`, `kernel` 等）                 |
 | `mihomo reset [目标...] [--full]` | 重置用户数据（可用目标：`subs`, `logs`, `kernel`, `overwrites` 等） |
 | `mihomo version`                  | 显示版本信息                                                        |
 | `mihomo help`                     | 显示帮助信息                                                        |
@@ -129,6 +129,19 @@ mihomo ui yacd     # YACD
 - `mmc`
 - `mh`
 
+### 快捷命令
+
+常用操作的快捷方式：
+
+| 快捷命令               | 等效于                     |
+| ---------------------- | -------------------------- |
+| `mihomo up`            | `mihomo start`             |
+| `mihomo down`          | `mihomo stop`              |
+| `mihomo tun`           | `mihomo start tun`         |
+| `mihomo use <name>`    | `mihomo sub use <name>`    |
+| `mihomo on` / `off`    | `mihomo ow on` / `ow off`  |
+| `mihomo open <target>` | `mihomo dir open <target>` |
+
 ## 模式说明
 
 ### Mixed 模式（默认）
@@ -185,17 +198,18 @@ mihomo kernel --mirror-all hk.gh-proxy.org
 ```
 ~/.mihomo-cli/
 ├── settings.json         # 用户设置（订阅列表等）
+├── overwrite.yaml        # 覆写配置（主文件，可选）
+├── overwrite.*.yaml      # 覆写配置（扩展文件，如 overwrite.dns.yaml）
 ├── subscriptions/
 │   ├── cache.json        # 订阅动态缓存（更新时间、流量、到期时间等）
 │   └── <name>.yaml       # 订阅原始配置
-├── overwrites/           # 覆写配置（按文件名排序加载）
-├── core/
+├── kernel/
 │   └── mihomo            # mihomo 内核二进制
 ├── logs/
 │   ├── mihomo.log        # 当前日志
 │   └── mihomo.YYYY-MM-DD_HH-MM-SS.log  # 归档日志
 ├── data/                 # mihomo 运行数据（GeoIP 等，由内核自行管理）
-└── .runtime/             # 运行时临时文件（stop 自动清除）
+└── runtime/              # 运行时临时文件（stop 自动清除）
     ├── pid               # 进程 PID
     └── config.yaml       # 运行时生成的配置
 ```
@@ -208,8 +222,10 @@ mihomo kernel --mirror-all hk.gh-proxy.org
 
 ### 使用方法
 
-1. 在 `~/.mihomo-cli/overwrites/` 目录下创建 `.yaml` 或 `.yml` 文件
-2. 文件按**文件名顺序**加载，后面的文件会覆盖前面的配置
+1. 在 `~/.mihomo-cli/` 目录下创建覆写文件：
+   - `overwrite.yaml` — 主覆写文件
+   - `overwrite.dns.yaml` — 按功能拆分的扩展文件（`overwrite.*.yaml` 格式）
+2. `overwrite.yaml` 始终最先加载，扩展文件按文件名排序加载
 3. 使用 `mihomo ow on` 启用覆写配置（会自动重启）
 
 ### 特殊语法
@@ -226,7 +242,7 @@ mihomo kernel --mirror-all hk.gh-proxy.org
 ### 示例
 
 ```yaml
-# ~/.mihomo-cli/overwrites/01-custom.yaml
+# ~/.mihomo-cli/overwrite.yaml
 
 # 强制覆盖 dns 配置
 dns!:

package/index.js

@@ -124,7 +124,7 @@ function printHelp() {
       ' update [name]   更新订阅（无参更新所有）\n' +
       '  ' +
       colors.bold('subscription') +
-      ' use <name>      切换默认订阅\n' +
+      ' use <name>      切换当前订阅\n' +
       '  ' +
       colors.bold('subscription') +
       ' web [name]      打开订阅页面\n' +
@@ -142,7 +142,7 @@ function printHelp() {
       '                   显示数据目录位置（别名 dir）\n' +
       '  ' +
       colors.bold('directory') +
-      ' open [target]     打开目录: root|subs|logs|overwrites|...\n' +
+      ' open [target]     打开目录: root|subs|logs|runtime|...\n' +
       '\n' +
       colors.cyan('系统:') +
       '\n' +
@@ -202,7 +202,7 @@ function printStatus() {
   if (info && status.running) {
     modeLabel = colors.cyan(info.tun ? ' (TUN)' : ' (Mixed)');
   }
-  const statusText = status.running ? colors.green('● 运行中') : colors.yellow('○ 已停止');
+  const statusText = status.running ? colors.green('● 运行中') : colors.yellow('不在运行');
   console.log(colors.gray('状态: ') + statusText + modeLabel);
   console.log(colors.gray('内核: ') + (status.kernelVersion || '未安装'));
 
@@ -235,7 +235,7 @@ function printStatus() {
   }
 
   if (overwriteEnabled && overwriteFiles.length > 0) {
-    const names = overwriteFiles.map(f => f.name).join(', ');
+    const names = overwriteFiles.map(f => f.name.replace(/^overwrite\.?/, '')).join(', ');
     console.log(colors.gray('覆写: ') + colors.green('已启用') + ' (' + names + ')');
   } else if (overwriteEnabled) {
     console.log(colors.gray('覆写: ') + colors.green('已启用') + ' (无文件)');
@@ -307,7 +307,7 @@ async function cmdStart(args) {
 async function cmdStop() {
   const pids = processManager.getAllMihomoPids();
   if (pids.length === 0) {
-    console.log(colors.yellow('未在运行'));
+    console.log(colors.yellow('不在运行'));
     return;
   }
 
@@ -507,16 +507,17 @@ async function printSubscriptionList() {
     console.log('');
     return;
   }
+  const activeSub = subscription.getActiveSubscription();
   console.log(colors.cyan('订阅列表:'));
   subs.forEach((s, i) => {
     const time = utils.formatDate(s.updated_at);
-    const defaultMark = i === 0 ? colors.green(' [默认]') : '';
+    const defaultMark = activeSub && s.name === activeSub.name ? colors.green(' [使用中]') : '';
     const interval = s.update_interval || subscription.DEFAULT_UPDATE_INTERVAL_HOURS;
     console.log('  ' + (i + 1) + '. ' + s.name + defaultMark);
-    console.log('    ' + colors.gray('更新:') + ' ' + time + ' (间隔: ' + interval + 'h)');
+    console.log('    ' + colors.gray('更新: ') + time + ' (间隔: ' + interval + 'h)');
 
     if (s.username) {
-      console.log('    ' + colors.gray('用户:') + ' ' + s.username);
+      console.log('    ' + colors.gray('用户: ') + s.username);
     }
     if (s.download !== undefined || s.total !== undefined) {
       const used = (s.upload || 0) + (s.download || 0);
@@ -527,17 +528,17 @@ async function printSubscriptionList() {
         const percent = Math.min((used / s.total) * 100, 100);
         percentStr = ' (' + percent.toFixed(1) + '%)';
       }
-      console.log('    ' + colors.gray('流量:') + ' ' + usedStr + ' / ' + totalStr + percentStr);
+      console.log('    ' + colors.gray('流量: ') + usedStr + ' / ' + totalStr + percentStr);
     }
     if (s.expire !== undefined) {
-      console.log('    ' + colors.gray('到期:') + ' ' + utils.formatTimestamp(s.expire));
+      console.log('    ' + colors.gray('到期: ') + utils.formatTimestamp(s.expire));
     }
     if (s.web_page_url) {
-      console.log('    ' + colors.gray('页面:') + ' ' + s.web_page_url);
+      console.log('    ' + colors.gray('页面: ') + s.web_page_url);
     }
   });
   console.log('');
-  console.log('切换默认: mihomo sub use <name>');
+  console.log('切换订阅: mihomo sub use <name>');
   console.log('更新订阅: mihomo sub update [name]');
   console.log('打开页面: mihomo sub web [name]');
   console.log('新增订阅: mihomo sub add <url> [name]');
@@ -638,7 +639,7 @@ async function cmdSubscription(args) {
     const isAlreadyDefault = currentDefault && currentDefault.name === target.name;
 
     if (isAlreadyDefault) {
-      console.log('"' + target.name + '" 已是当前默认订阅');
+      console.log('"' + target.name + '" 已是当前使用的订阅');
       console.log('');
       await printSubscriptionList();
       return;
@@ -650,7 +651,7 @@ async function cmdSubscription(args) {
 
     const success = config.setDefaultSubscription(target.name);
     if (success) {
-      console.log('已设置 "' + target.name + '" 为默认订阅');
+      console.log('已切换到 "' + target.name + '"');
     } else {
       console.error('错误: 未找到订阅 "' + name + '"');
       process.exit(1);
@@ -806,7 +807,7 @@ const RESET_TARGETS = [
     id: 'kernel',
     aliases: ['kernel', 'core'],
     label: '内核',
-    paths: () => [config.DIRS.core],
+    paths: () => [config.DIRS.kernel],
     needsStop: false,
     onAfter: () => config.clearKernelVersionCache(),
     checkEmpty: () => !config.hasKernel(),
@@ -817,7 +818,15 @@ const RESET_TARGETS = [
     id: 'overwrites',
     aliases: ['overwrite', 'overwrites', 'ow'],
     label: '覆写',
-    paths: () => [config.DIRS.overwrites],
+    paths: () => {
+      const fs = require('fs');
+      const dir = config.USER_DATA_DIR;
+      if (!fs.existsSync(dir)) return [];
+      return fs
+        .readdirSync(dir)
+        .filter(f => f === 'overwrite.yaml' || /^overwrite\..+\.ya?ml$/.test(f))
+        .map(f => require('path').join(dir, f));
+    },
     needsStop: false,
   },
 ];
@@ -921,13 +930,14 @@ async function cmdReset(args) {
 function printOverwriteList() {
   const info = overwrite.listOverwriteFile();
   const statusText = info.enabled ? colors.green('已启用') : colors.yellow('已禁用');
-  console.log(colors.gray('状态:') + ' ' + statusText);
-  console.log(colors.gray('目录:') + ' ' + info.dir);
+  console.log(colors.gray('状态: ') + statusText);
+  console.log(colors.gray('位置: ') + info.dir);
   console.log('');
   if (info.files.length === 0) {
     console.log('暂无覆写文件');
     console.log('');
-    console.log('用法示例: 创建文件 ' + path.join(info.dir, '01-custom.yaml'));
+    console.log('用法示例: 创建文件 ' + path.join(info.dir, 'overwrite.yaml'));
+    console.log('         或        ' + path.join(info.dir, 'overwrite.dns.yaml'));
     console.log('');
   } else {
     console.log(colors.cyan('覆写文件') + ' (' + info.files.length + ' 个，按顺序加载):');
@@ -936,7 +946,7 @@ function printOverwriteList() {
       const num = i < 10 ? ' ' + i : '' + i;
       console.log('  ' + num + '. ' + f.name);
       if (f.keys.length > 0) {
-        console.log('    ' + colors.gray('字段:') + ' ' + f.keys.join(', '));
+        console.log('    ' + colors.gray('字段: ') + f.keys.join(', '));
       }
     });
     console.log('');
@@ -1045,6 +1055,7 @@ function cmdDirectory(args) {
   console.log('数据目录位置:');
   console.log('  根目录: ' + config.USER_DATA_DIR);
   console.log('  全局设置: ' + config.PATHS.settingsFile);
+  console.log('  内核目录: ' + config.DIRS.kernel);
   console.log('  内核文件: ' + config.PATHS.mihomoBinary);
   console.log('  订阅目录: ' + config.DIRS.subscriptions);
   console.log('    - cache.json (订阅缓存：更新时间、流量等)');
@@ -1061,8 +1072,6 @@ function cmdDirectory(args) {
   console.log('  mihomo dir open subs           打开订阅目录');
   console.log('  mihomo dir open logs           打开日志目录');
   console.log('  mihomo dir open runtime        打开运行时目录');
-  console.log('  mihomo dir open overwrites     打开覆写目录');
-  console.log('  mihomo dir open settings       打开设置文件');
   console.log('  mihomo dir open kernel         打开内核目录');
   console.log('');
   console.log('环境变量:');
@@ -1093,9 +1102,14 @@ async function main() {
   }
 
   switch (cmd) {
+    case 'up':
     case 'start':
       await cmdStart(args);
       break;
+    case 'tun':
+      await cmdStart(['start', 'tun']);
+      break;
+    case 'down':
     case 'stop':
       await cmdStop();
       break;
@@ -1108,6 +1122,9 @@ async function main() {
     case 'logs':
       cmdLogs(args);
       break;
+    case 'open':
+      cmdDirectory(['dir', 'open', ...args.slice(1)]);
+      break;
     case 'ui':
       cmdUI(args);
       break;
@@ -1119,6 +1136,9 @@ async function main() {
     case 'upgrade':
       await cmdUpdate();
       break;
+    case 'use':
+      await cmdSubscription(['sub', 'use', ...args.slice(1)]);
+      break;
     case 'sub':
     case 'subscription':
     case 'subscriptions':
@@ -1133,6 +1153,12 @@ async function main() {
     case 'reset':
       await cmdReset(args);
       break;
+    case 'on':
+      await cmdOverwrite(['ow', 'on']);
+      break;
+    case 'off':
+      await cmdOverwrite(['ow', 'off']);
+      break;
     case 'ow':
     case 'overwrite':
       await cmdOverwrite(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mihomo-cli",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "A terminal-based mihomo (Clash.Meta) client for macOS",
   "bin": {
     "mihomo-cli": "index.js",

package/src/config.js

@@ -30,22 +30,24 @@ const USER_DATA_DIR = getUserDataDir();
 
 const DIRS = {
   root: PROJECT_ROOT,
-  core: path.join(USER_DATA_DIR, 'core'),
+  kernel: path.join(USER_DATA_DIR, 'kernel'),
   subscriptions: path.join(USER_DATA_DIR, 'subscriptions'),
   logs: path.join(USER_DATA_DIR, 'logs'),
   data: path.join(USER_DATA_DIR, 'data'),
-  runtime: path.join(USER_DATA_DIR, '.runtime'),
-  overwrites: path.join(USER_DATA_DIR, 'overwrites'),
+  runtime: path.join(USER_DATA_DIR, 'runtime'),
 };
 
 const PATHS = {
   root: DIRS.root,
-  mihomoBinary: path.join(DIRS.core, 'mihomo'),
+  mihomoBinary: path.join(DIRS.kernel, 'mihomo'),
   settingsFile: path.join(USER_DATA_DIR, 'settings.json'),
   subscriptionsCacheFile: path.join(DIRS.subscriptions, 'cache.json'),
   configFile: path.join(DIRS.runtime, 'config.yaml'),
   logFile: path.join(DIRS.logs, 'mihomo.log'),
   pidFile: path.join(DIRS.runtime, 'pid'),
+  configStage1Subscription: path.join(DIRS.runtime, '1.subscription.yaml'),
+  configStage2Overwrite: path.join(DIRS.runtime, '2.overwrite.yaml'),
+  configStage3System: path.join(DIRS.runtime, '3.system.yaml'),
 };
 
 function ensureDirs() {
@@ -206,7 +208,11 @@ function addSubscription(url, name) {
   } else {
     subs.push({ name, url });
   }
-  writeSettings({ subscriptions: subs });
+  const updates = { subscriptions: subs };
+  if (!settings.active_subscription && subs.length === 1) {
+    updates.active_subscription = name;
+  }
+  writeSettings(updates);
 }
 
 function setDefaultSubscription(name) {
@@ -216,12 +222,7 @@ function setDefaultSubscription(name) {
   if (idx < 0) {
     return false;
   }
-  if (idx === 0) {
-    return true; // 已经是第一个
-  }
-  const [sub] = subs.splice(idx, 1);
-  subs.unshift(sub);
-  writeSettings({ subscriptions: subs });
+  writeSettings({ active_subscription: name });
   return true;
 }
 
@@ -283,7 +284,6 @@ const TUN_CONFIG = {
     'auto-detect-interface': true,
     'strict-route': true,
   },
-  ipv6: false,
 };
 
 const BASE_CONFIG = {
@@ -314,9 +314,9 @@ function parseYamlOrJson(content, errorMsg) {
 }
 
 function buildConfig(subRawContent, mode) {
-  const baseConfig = parseYamlOrJson(subRawContent, '订阅内容');
+  const subscriptionConfig = parseYamlOrJson(subRawContent, '订阅内容');
 
-  if (!baseConfig) {
+  if (!subscriptionConfig) {
     throw new Error('订阅内容为空');
   }
 
@@ -324,24 +324,48 @@ function buildConfig(subRawContent, mode) {
   const overwrite = require('./overwrite');
 
   // 应用覆写配置
-  const withOverwrites = overwrite.applyOverwrite(baseConfig);
-
-  // 合并 BASE_CONFIG（优先级高于覆写）
-  const merged = { ...withOverwrites, ...BASE_CONFIG };
+  const overwriteEnabled = overwrite.isOverwriteEnabled();
+  const withOverwrites = overwrite.applyOverwrite(subscriptionConfig);
+  const overwriteFiles = overwriteEnabled ? overwrite.loadOverwriteFile() : [];
+
+  // 构建系统覆盖值（BASE_CONFIG + 可选 TUN）
+  // 只补充订阅中缺失的字段，不覆盖已有值
+  const systemConfig = {};
+  for (const [key, value] of Object.entries(BASE_CONFIG)) {
+    if (!(key in withOverwrites)) {
+      systemConfig[key] = value;
+    }
+  }
 
   if (mode === 'tun') {
-    // 合并 TUN 配置
-    merged.tun = TUN_CONFIG.tun;
-    merged.ipv6 = TUN_CONFIG.ipv6;
-
-    // 确保 DNS 配置与 TUN 模式兼容（保留订阅的 DNS 服务器）
-    merged.dns = merged.dns || {};
-    merged.dns.enable = true;
-    merged.dns['enhanced-mode'] = 'fake-ip';
-    merged.dns['fake-ip-range'] = merged.dns['fake-ip-range'] || '198.18.0.1/16';
+    // tun 块始终由系统控制
+    systemConfig.tun = TUN_CONFIG.tun;
+    // dns 只补充 TUN 必需的字段
+    const subDns = withOverwrites.dns || {};
+    systemConfig.dns = {};
+    if (!subDns.enable) systemConfig.dns.enable = true;
+    if (!subDns['enhanced-mode']) systemConfig.dns['enhanced-mode'] = 'fake-ip';
+    if (!subDns['fake-ip-range']) systemConfig.dns['fake-ip-range'] = '198.18.0.1/16';
+    // 如果没有需要补充的 dns 字段，则不设置
+    if (Object.keys(systemConfig.dns).length === 0) {
+      delete systemConfig.dns;
+    }
   }
 
-  return merged;
+  // 合并：订阅(+overwrite) → 系统补充
+  const merged = { ...withOverwrites, ...systemConfig };
+
+  // dns 需要深度合并：保留订阅的 DNS 服务器，叠加系统补充
+  if (systemConfig.dns) {
+    merged.dns = { ...(withOverwrites.dns || {}), ...systemConfig.dns };
+  }
+
+  return {
+    config: merged,
+    subscriptionConfig,
+    overwriteFiles,
+    systemConfig,
+  };
 }
 
 function writeMihomoConfig(configObj) {
@@ -354,6 +378,25 @@ function writeMihomoConfig(configObj) {
   fs.writeFileSync(PATHS.configFile, content, { mode: 0o600 });
 }
 
+function writeDebugConfig(buildResult) {
+  ensureDirs();
+  const dumpOpts = { indent: 2, lineWidth: -1, noCompat: true };
+
+  // 1. 订阅原始配置
+  fs.writeFileSync(PATHS.configStage1Subscription, yaml.dump(buildResult.subscriptionConfig, dumpOpts), { mode: 0o600 });
+
+  // 2. overwrite 覆写内容（禁用时写空文件）
+  const overwriteMerged = {};
+  for (const f of buildResult.overwriteFiles) {
+    Object.assign(overwriteMerged, f.config);
+  }
+  const overwriteContent = buildResult.overwriteFiles.length > 0 ? yaml.dump(overwriteMerged, dumpOpts) : '# overwrite 已禁用或无覆写文件\n';
+  fs.writeFileSync(PATHS.configStage2Overwrite, overwriteContent, { mode: 0o600 });
+
+  // 3. 系统覆盖值（BASE_CONFIG + TUN_CONFIG）
+  fs.writeFileSync(PATHS.configStage3System, yaml.dump(buildResult.systemConfig, dumpOpts), { mode: 0o600 });
+}
+
 function hasConfig() {
   return fs.existsSync(PATHS.configFile);
 }
@@ -394,11 +437,11 @@ function resetUserData(options) {
 
   let itemsToRemove;
   if (kernelOnly) {
-    itemsToRemove = [DIRS.core];
+    itemsToRemove = [DIRS.kernel];
   } else {
     itemsToRemove = [PATHS.settingsFile, DIRS.subscriptions, DIRS.logs, DIRS.data, DIRS.runtime];
     if (!keepKernel) {
-      itemsToRemove.push(DIRS.core);
+      itemsToRemove.push(DIRS.kernel);
     }
   }
 
@@ -428,9 +471,7 @@ const DIRECTORY_TARGETS = {
   logs: { path: DIRS.logs, label: '日志目录' },
   data: { path: DIRS.data, label: 'mihomo 数据目录' },
   runtime: { path: DIRS.runtime, label: '运行时目录' },
-  overwrites: { path: DIRS.overwrites, label: '覆写目录' },
-  settings: { path: PATHS.settingsFile, label: '设置文件' },
-  kernel: { path: DIRS.core, label: '内核目录' },
+  kernel: { path: DIRS.kernel, label: '内核目录' },
 };
 
 module.exports = {
@@ -463,6 +504,7 @@ module.exports = {
   parseYamlOrJson,
   buildConfig,
   writeMihomoConfig,
+  writeDebugConfig,
   hasConfig,
   getConfigInfo,
   resetUserData,

package/src/overwrite.js

@@ -150,13 +150,6 @@ function deepMergeWithOverrides(target, override) {
   return result;
 }
 
-/**
- * 获取覆写目录路径
- */
-function getOverwritesDir() {
-  return config.DIRS.overwrites;
-}
-
 /**
  * 检查覆写功能是否启用
  */
@@ -173,11 +166,12 @@ function setOverwriteEnabled(enabled) {
 }
 
 /**
- * 读取 overwrites 目录下的所有 yaml 文件
- * 按文件名排序返回
+ * 读取根目录下的覆写文件
+ * 匹配 overwrite.yaml 和 overwrite.*.yaml，按文件名排序
+ * overwrite.yaml 始终第一
  */
 function loadOverwriteFile() {
-  const dir = getOverwritesDir();
+  const dir = config.USER_DATA_DIR;
 
   if (!fs.existsSync(dir)) {
     return [];
@@ -185,8 +179,12 @@ function loadOverwriteFile() {
 
   const files = fs
     .readdirSync(dir)
-    .filter(f => f.endsWith('.yaml') || f.endsWith('.yml'))
-    .sort();
+    .filter(f => f === 'overwrite.yaml' || /^overwrite\..+\.ya?ml$/.test(f))
+    .sort((a, b) => {
+      if (a === 'overwrite.yaml') return -1;
+      if (b === 'overwrite.yaml') return 1;
+      return a.localeCompare(b);
+    });
 
   const results = [];
 
@@ -239,11 +237,10 @@ function applyOverwrite(baseConfig) {
 function listOverwriteFile() {
   const files = loadOverwriteFile();
   const enabled = isOverwriteEnabled();
-  const dir = getOverwritesDir();
 
   return {
     enabled,
-    dir,
+    dir: config.USER_DATA_DIR,
     files: files.map(f => ({
       name: f.name,
       path: f.path,
@@ -257,4 +254,5 @@ module.exports = {
   setOverwriteEnabled,
   applyOverwrite,
   listOverwriteFile,
+  loadOverwriteFile,
 };

package/src/subscription.js

@@ -48,13 +48,19 @@ function formatProxySummary(info) {
 }
 
 /**
- * 获取当前默认订阅（从 index.js 移入）
+ * 获取当前使用的订阅
  */
 function getActiveSubscription() {
   const subs = config.getSubscriptions();
   if (subs.length === 0) {
     return null;
   }
+  const settings = config.readSettings();
+  const activeName = settings.active_subscription;
+  if (activeName) {
+    const found = subs.find(s => s.name === activeName);
+    if (found) return found;
+  }
   return subs[0];
 }
 
@@ -175,12 +181,13 @@ function prepareConfigForStart(mode, subName) {
     throw new Error('未找到订阅配置 "' + subName + '"，请先添加订阅');
   }
 
-  const mergedConfig = config.buildConfig(rawContent, mode);
-  config.writeMihomoConfig(mergedConfig);
+  const buildResult = config.buildConfig(rawContent, mode);
+  config.writeMihomoConfig(buildResult.config);
+  config.writeDebugConfig(buildResult);
 
   return {
-    proxies: mergedConfig.proxies ? mergedConfig.proxies.length : 0,
-    proxyGroups: mergedConfig['proxy-groups'] ? mergedConfig['proxy-groups'].length : 0,
+    proxies: buildResult.config.proxies ? buildResult.config.proxies.length : 0,
+    proxyGroups: buildResult.config['proxy-groups'] ? buildResult.config['proxy-groups'].length : 0,
   };
 }