clash-kit 1.0.0

package/lib/commands/sub.js

@@ -0,0 +1,78 @@
+import { select, input } from '@inquirer/prompts'
+import path from 'path'
+import fs from 'fs'
+import { fileURLToPath } from 'url'
+import chalk from 'chalk'
+import * as sub from '../subscription.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+async function handleAddSubscription(url, name) {
+  const profiles = sub.listProfiles()
+  // 没有找到可选的订阅，或没找到 config.yaml
+  // __dirname here is lib/commands. Config is at ROOT/config.yaml. so join ../../config.yaml
+  const isFirst = profiles.length === 0 || !fs.existsSync(path.join(__dirname, '../../config.yaml'))
+
+  await sub.downloadSubscription(url, name)
+
+  if (!isFirst) return
+  console.log(`检测到这是第一个订阅，正在自动切换到 ${name}...`)
+  await sub.useProfile(name)
+}
+
+export async function manageSub(options) {
+  if (options.add) {
+    if (!options.name) {
+      console.error('错误: 添加订阅时必须指定名称 (-n)')
+      return
+    }
+    try {
+      await handleAddSubscription(options.add, options.name)
+    } catch (err) {
+      console.error(err.message)
+    }
+  } else if (options.list) {
+    const profiles = sub.listProfiles()
+    console.log('可用订阅:')
+    profiles.forEach(p => console.log(`- ${p}`))
+  } else if (options.use) {
+    try {
+      await sub.useProfile(options.use)
+    } catch (err) {
+      console.error(err.message)
+    }
+  } else {
+    // 交互式模式
+    const profiles = sub.listProfiles()
+
+    const action = await select({
+      message: '请选择操作:',
+      choices: [
+        { name: '切换订阅', value: 'switch' },
+        { name: '添加订阅', value: 'add' },
+      ],
+    })
+
+    if (action === 'switch') {
+      if (profiles.length === 0) {
+        console.log('暂无订阅，请先添加')
+        return
+      }
+      const profile = await select({
+        message: '选择要使用的订阅:',
+        choices: profiles.map(p => ({ name: p, value: p })),
+      })
+      await sub.useProfile(profile)
+    } else if (action === 'add') {
+      const url = await input({ message: '请输入订阅链接:' })
+      const name = await input({ message: '请输入订阅名称:' })
+
+      try {
+        await handleAddSubscription(url, name)
+      } catch (err) {
+        console.error(err.message)
+      }
+    }
+  }
+}

package/lib/commands/sysproxy.js

@@ -0,0 +1,24 @@
+import { select } from '@inquirer/prompts'
+import * as sysproxy from '../sysproxy.js'
+
+export async function setSysProxy(action) {
+  if (action === 'on') {
+    await sysproxy.enableSystemProxy()
+  } else if (action === 'off') {
+    await sysproxy.disableSystemProxy()
+  } else {
+    // 交互式选择
+    const answer = await select({
+      message: '请选择系统代理操作:',
+      choices: [
+        { name: '开启系统代理', value: 'on' },
+        { name: '关闭系统代理', value: 'off' },
+      ],
+    })
+    if (answer === 'on') {
+      await sysproxy.enableSystemProxy()
+    } else {
+      await sysproxy.disableSystemProxy()
+    }
+  }
+}

package/lib/commands/test.js

@@ -0,0 +1,70 @@
+import chalk from 'chalk'
+import * as api from '../api.js'
+
+export async function test() {
+  try {
+    const proxies = await api.getProxies()
+    // 默认测速 Proxy 组的所有节点
+    const group = proxies['Proxy'] || Object.values(proxies).find(p => p.type === 'Selector')
+
+    if (!group) {
+      console.error('找不到 Proxy 组')
+      return
+    }
+
+    console.log(`\n当前测速目标组: [${group.name}]`)
+    console.log(`包含节点数: ${group.all.length}`)
+    console.log('注意: 测速针对的是当前 Clash 正在运行的配置。')
+    console.log('如果刚切换了订阅，请确保看到"配置已热重载生效"提示，或手动重启 clash start。\n')
+
+    const results = []
+    const concurrency = 10
+    const queue = [...group.all]
+    const total = group.all.length
+    let completed = 0
+
+    console.log(chalk.gray(`准备并发测速 (并发数: ${concurrency})...`))
+
+    const worker = async () => {
+      while (queue.length > 0) {
+        const name = queue.shift()
+        if (!name) break
+
+        try {
+          const delay = await api.getProxyDelay(name)
+          completed++
+          const progress = `[${completed}/${total}]`
+
+          if (delay > 0) {
+            const color = delay < 200 ? chalk.green : delay < 800 ? chalk.yellow : chalk.red
+            console.log(`${chalk.gray(progress)} ${chalk.cyan(name)}: ${color(delay + 'ms')}`)
+            results.push({ name, delay })
+          } else {
+            console.log(`${chalk.gray(progress)} ${chalk.cyan(name)}: ${chalk.red('超时')}`)
+            results.push({ name, delay: 99999 })
+          }
+        } catch (err) {
+          completed++
+          results.push({ name, delay: 99999 })
+        }
+      }
+    }
+
+    await Promise.all(Array.from({ length: Math.min(concurrency, total) }, () => worker()))
+
+    console.log(chalk.bold.blue('\n=== 测速结果 (Top 5) ==='))
+    results.sort((a, b) => a.delay - b.delay)
+    results.slice(0, 5).forEach((r, i) => {
+      let delayInfo
+      if (r.delay === 99999) {
+        delayInfo = chalk.red('超时')
+      } else {
+        const color = r.delay < 200 ? chalk.green : r.delay < 800 ? chalk.yellow : chalk.red
+        delayInfo = color(`${r.delay}ms`)
+      }
+      console.log(`${chalk.gray(i + 1 + '.')} ${chalk.bold(r.name)}: ${delayInfo}`)
+    })
+  } catch (err) {
+    console.error(err.message)
+  }
+}

package/lib/commands/tun.js

@@ -0,0 +1,95 @@
+import { select } from '@inquirer/prompts'
+import chalk from 'chalk'
+import * as tun from '../tun.js'
+import * as sysnet from '../sysnet.js'
+import { main as startClashService } from '../../index.js'
+
+export async function setTun(action) {
+  try {
+    let shouldRestart = false
+
+    if (action === 'on') {
+      if (process.platform !== 'win32') {
+        const hasPerm = tun.checkTunPermissions()
+        const isRoot = process.getuid && process.getuid() === 0
+
+        if (!hasPerm && !isRoot) {
+          console.log(chalk.yellow('检测到内核缺少 SUID 权限，当前也非 Root 用户，TUN 模式可能无法启动。'))
+          const confirm = await select({
+            message: '是否自动授予内核 SUID 权限 (推荐)?',
+            choices: [
+              { name: '是 (仅需输入一次 sudo 密码)', value: true },
+              { name: '否 (之后需要 sudo clash start)', value: false },
+            ],
+          })
+          if (confirm) {
+            tun.setupPermissions()
+            console.log(chalk.green('权限设置成功！'))
+            shouldRestart = true
+          }
+        }
+      }
+
+      console.log('正在开启 TUN 模式...')
+      await tun.enableTun()
+      sysnet.setDNS(['223.5.5.5', '114.114.114.114'])
+      console.log(chalk.green('TUN 模式配置已开启'))
+
+      if (shouldRestart) {
+        console.log(chalk.yellow('因为更改了权限，正在重启 Clash 服务以应用更改...'))
+        startClashService()
+      } else {
+        console.log(chalk.gray('提示: 如果 TUN 模式未生效，请尝试运行 "clash start" 重启服务。'))
+      }
+    } else if (action === 'off') {
+      console.log('正在关闭 TUN 模式...')
+      await tun.disableTun()
+      sysnet.setDNS([]) // 恢复系统默认 DNS
+      console.log(chalk.green('TUN 模式配置已关闭'))
+      console.log(chalk.gray('配置已热重载。'))
+    } else {
+      const isEnabled = await tun.isTunEnabled()
+      const answer = await select({
+        message: `请选择 TUN 模式操作 (当前状态: ${isEnabled ? chalk.green('开启') : chalk.gray('关闭')}):`,
+        choices: [
+          { name: '开启 TUN 模式', value: 'on' },
+          { name: '关闭 TUN 模式', value: 'off' },
+        ],
+      })
+      if (answer === 'on') {
+        if (process.platform !== 'win32') {
+          const hasPerm = tun.checkTunPermissions()
+          const isRoot = process.getuid && process.getuid() === 0
+          if (!hasPerm && !isRoot) {
+            console.log(chalk.yellow('提示: 建议授予内核 SUID 权限以避免 sudo 启动。'))
+            const confirm = await select({
+              message: '是否授予权限?',
+              choices: [
+                { name: '是', value: true },
+                { name: '否', value: false },
+              ],
+            })
+            if (confirm) {
+              tun.setupPermissions()
+              shouldRestart = true
+            }
+          }
+        }
+        await tun.enableTun()
+        sysnet.setDNS(['223.5.5.5', '114.114.114.114'])
+        console.log(chalk.green('TUN 模式配置已开启'))
+
+        if (shouldRestart) {
+          console.log(chalk.yellow('正在重启 Clash 服务...'))
+          startClashService()
+        }
+      } else {
+        await tun.disableTun()
+        sysnet.setDNS([])
+        console.log(chalk.green('TUN 模式配置已关闭'))
+      }
+    }
+  } catch (err) {
+    console.error(chalk.red(`设置 TUN 模式失败: ${err.message}`))
+  }
+}

package/lib/kernel.js

@@ -0,0 +1,152 @@
+import axios from 'axios'
+import fs from 'fs'
+import path from 'path'
+import os from 'os'
+import zlib from 'zlib'
+import AdmZip from 'adm-zip'
+import { fileURLToPath } from 'url'
+import ora from 'ora'
+import cliProgress from 'cli-progress'
+import chalk from 'chalk'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+const MIHOMO_VERSION_URL = 'https://github.com/MetaCubeX/mihomo/releases/latest/download/version.txt'
+
+const PLATFORM_MAP = {
+  'win32-x64': 'mihomo-windows-amd64-compatible',
+  'win32-ia32': 'mihomo-windows-386',
+  'win32-arm64': 'mihomo-windows-arm64',
+  'darwin-x64': 'mihomo-darwin-amd64-compatible',
+  'darwin-arm64': 'mihomo-darwin-arm64',
+  'linux-x64': 'mihomo-linux-amd64-compatible',
+  'linux-arm64': 'mihomo-linux-arm64',
+}
+
+export async function downloadClash(targetDir) {
+  const platform = os.platform()
+  const arch = os.arch()
+  const key = `${platform}-${arch}`
+  const name = PLATFORM_MAP[key]
+
+  if (!name) {
+    throw new Error(`不支持的平台: ${platform}-${arch}`)
+  }
+
+  // 1. 获取最新版本
+  const spinner = ora('正在获取最新 Mihomo 版本信息...').start()
+  let version
+  try {
+    const { data } = await axios.get(MIHOMO_VERSION_URL)
+    version = data.trim()
+    spinner.succeed(`检测到最新版本: ${version}`)
+  } catch (e) {
+    spinner.fail(`获取版本信息失败: ${e.message}`)
+    throw new Error(`获取版本信息失败: ${e.message}`)
+  }
+
+  // 2. 构建下载 URL
+  const isWin = platform === 'win32'
+  const urlExt = isWin ? 'zip' : 'gz'
+  const downloadUrl = `https://github.com/MetaCubeX/mihomo/releases/download/${version}/${name}-${version}.${urlExt}`
+  const tempFileName = `mihomo-temp.${urlExt}`
+  const tempPath = path.join(targetDir, tempFileName)
+  const targetBinName = `clash-meta${isWin ? '.exe' : ''}`
+  const targetBinPath = path.join(targetDir, targetBinName)
+
+  // 3. 下载文件
+  console.log(`正在下载: ${downloadUrl}`)
+  const bar = new cliProgress.SingleBar(
+    {
+      format: '下载进度 | {bar} | {percentage}% | {valueFormatted}/{totalFormatted} MB',
+      hideCursor: true,
+    },
+    cliProgress.Presets.shades_classic
+  )
+
+  try {
+    let started = false
+    let totalMB = '0.0'
+    const response = await axios({
+      url: downloadUrl,
+      method: 'GET',
+      responseType: 'arraybuffer',
+      onDownloadProgress: progressEvent => {
+        if (progressEvent.total) {
+          const loadedMB = (progressEvent.loaded / 1024 / 1024).toFixed(1)
+          if (!started) {
+            totalMB = (progressEvent.total / 1024 / 1024).toFixed(1)
+            bar.start(progressEvent.total, 0, {
+              valueFormatted: '0.0',
+              totalFormatted: totalMB,
+            })
+            started = true
+          }
+          bar.update(progressEvent.loaded, {
+            valueFormatted: loadedMB,
+            totalFormatted: totalMB,
+          })
+        }
+      },
+    })
+    bar.stop()
+
+    fs.writeFileSync(tempPath, response.data)
+    spinner.start(chalk.green('下载完成，正在解压...'))
+  } catch (e) {
+    bar.stop()
+    throw new Error(`下载失败: ${e.message}`)
+  }
+
+  // 4. 解压文件
+  try {
+    if (isWin) {
+      // ZIP 解压
+      const zip = new AdmZip(tempPath)
+      const zipEntries = zip.getEntries()
+      // 查找可执行文件（通常名字包含 mihoo 或 name）
+      const entry = zipEntries.find(e => e.entryName.includes(name) || e.entryName.endsWith('.exe'))
+      if (!entry) {
+        throw new Error('压缩包中未找到可执行文件')
+      }
+      zip.extractEntryTo(entry, targetDir, false, true, false, targetBinName)
+    } else {
+      // GZ 解压
+      const fileContents = fs.readFileSync(tempPath)
+      const unzipped = zlib.gunzipSync(fileContents)
+      fs.writeFileSync(targetBinPath, unzipped)
+    }
+
+    // 清理临时文件
+    fs.unlinkSync(tempPath)
+    spinner.succeed(chalk.green(`解压完成: ${targetBinPath}`))
+  } catch (e) {
+    spinner.fail(chalk.red(`解压失败: ${e.message}`))
+    throw new Error(`解压失败: ${e.message}`)
+  }
+
+  // 5. 设置权限
+  if (!isWin) {
+    spinner.start('正在设置执行权限...')
+    fs.chmodSync(targetBinPath, 0o755)
+    spinner.succeed(chalk.green('设置执行权限完成'))
+  }
+
+  return targetBinPath
+}
+
+function testDownload() {
+  // 测试下载功能
+  const rootDir = path.join(__dirname, '..')
+  downloadClash(rootDir)
+    .then(binPath => {
+      console.log(`Mihomo 内核已下载并解压到: ${binPath}`)
+    })
+    .catch(err => {
+      console.error(`下载失败: ${err.message}`)
+    })
+}
+
+// 如果直接运行此文件，则执行测试
+if (import.meta.url === `file://${process.argv[1]}`) testDownload()

package/lib/subscription.js

@@ -0,0 +1,68 @@
+import fs from 'fs'
+import path from 'path'
+import axios from 'axios'
+import { fileURLToPath } from 'url'
+import ora from 'ora'
+import { reloadConfig } from './api.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+const PROFILES_DIR = path.join(__dirname, '../profiles')
+const CONFIG_PATH = path.join(__dirname, '../config.yaml')
+const CURRENT_PROFILE_PATH = path.join(__dirname, '../.current_profile')
+
+// 确保 profiles 目录存在
+if (!fs.existsSync(PROFILES_DIR)) {
+  fs.mkdirSync(PROFILES_DIR)
+}
+
+export async function downloadSubscription(url, name) {
+  const spinner = ora(`正在下载订阅 ${name}...`).start()
+  try {
+    const res = await axios.get(url, { responseType: 'text' })
+    const filePath = path.join(PROFILES_DIR, `${name}.yaml`)
+    fs.writeFileSync(filePath, res.data)
+    spinner.succeed(`订阅 ${name} 下载成功`)
+    return filePath
+  } catch (err) {
+    spinner.fail(`下载订阅失败: ${err.message}`)
+    throw new Error(`下载订阅失败: ${err.message}`)
+  }
+}
+
+export function listProfiles() {
+  return fs
+    .readdirSync(PROFILES_DIR)
+    .filter(f => f.endsWith('.yaml'))
+    .map(f => f.replace('.yaml', ''))
+}
+
+export function getCurrentProfile() {
+  if (fs.existsSync(CURRENT_PROFILE_PATH)) {
+    return fs.readFileSync(CURRENT_PROFILE_PATH, 'utf8').trim()
+  }
+  return null
+}
+
+export async function useProfile(name) {
+  const source = path.join(PROFILES_DIR, `${name}.yaml`)
+  if (!fs.existsSync(source)) {
+    throw new Error(`配置文件 ${name} 不存在`)
+  }
+
+  const spinner = ora(`正在切换到配置 ${name}...`).start()
+
+  // 直接复制配置文件，保持原样
+  fs.copyFileSync(source, CONFIG_PATH)
+  fs.writeFileSync(CURRENT_PROFILE_PATH, name)
+
+  // 尝试热重载
+  try {
+    await reloadConfig(CONFIG_PATH)
+    spinner.succeed('Clash 配置已切换并热重载生效')
+  } catch (err) {
+    // 忽略错误，可能是 Clash 未运行
+    spinner.warn('配置已切换，但 Clash 未运行或无法连接，将在下次启动时生效')
+  }
+}

package/lib/sysnet.js

@@ -0,0 +1,52 @@
+import { execSync } from 'child_process'
+
+/**
+ * 获取 macOS 当前主要的网络服务名称 (Wi-Fi, Ethernet 等)
+ */
+function getMainNetworkService() {
+  try {
+    // 这是一个简单的方法，通常第一行是默认路由接口
+    // networksetup -listnetworkserviceorder
+    // 更精准的方法是 route get default 但输出解析较复杂
+    // 这里我们先假设最常见的几种情况
+    const output = execSync('networksetup -listallnetworkservices', { encoding: 'utf-8' })
+    const services = output.split('\n').filter(s => s && !s.includes('An asterisk'))
+
+    // 优先尝试 Wi-Fi 和 Ethernet
+    const wifi = services.find(s => s === 'Wi-Fi')
+    const ethernet = services.find(s => s.includes('Ethernet') || s.includes('LAN'))
+
+    // 简单粗暴：优先返回 Wi-Fi，其次 Ethernet，最后第一个
+    // TODO: 更严谨的做法是检测哪个接口有 IP 且是 default route
+    return wifi || ethernet || services[0]
+  } catch (e) {
+    console.error('获取网络服务失败:', e)
+    return null
+  }
+}
+
+/**
+ * 设置系统 DNS
+ * @param {string[]} servers DNS 服务器列表
+ */
+export function setDNS(servers) {
+  if (process.platform !== 'darwin') return // 目前仅支持 macOS
+
+  const service = getMainNetworkService()
+  if (!service) return
+
+  try {
+    if (servers.length === 0) {
+      // 恢复默认 (Empty 会让 macOS 使用 DHCP 下发的 DNS)
+      console.log(`正在恢复系统 DNS (${service})...`)
+      execSync(`sudo networksetup -setdnsservers "${service}" "Empty"`)
+    } else {
+      console.log(`正在设置系统 DNS (${service}) -> ${servers.join(' ')}...`)
+      execSync(`sudo networksetup -setdnsservers "${service}" ${servers.join(' ')}`)
+    }
+  } catch (e) {
+    // 忽略错误，通常是因为需要 sudo 但在非交互模式下失败
+    // 但我们的 CLI 主要是用户手动执行的。
+    console.warn(`设置 DNS 失败 (可能需要 sudo): ${e.message}`)
+  }
+}

package/lib/sysproxy.js

@@ -0,0 +1,111 @@
+import ora from 'ora'
+import { triggerManualProxy } from '@mihomo-party/sysproxy'
+import { execSync } from 'child_process'
+import * as api from './api.js'
+
+const defaultBypass = (() => {
+  switch (process.platform) {
+    case 'linux':
+      return ['localhost', '127.0.0.1', '192.168.0.0/16', '10.0.0.0/8', '172.16.0.0/12', '::1']
+    case 'darwin':
+      return [
+        '127.0.0.1',
+        '192.168.0.0/16',
+        '10.0.0.0/8',
+        '172.16.0.0/12',
+        'localhost',
+        '*.local',
+        '*.crashlytics.com',
+        '<local>',
+      ]
+    case 'win32':
+      return [
+        'localhost',
+        '127.*',
+        '192.168.*',
+        '10.*',
+        '172.16.*',
+        '172.17.*',
+        '172.18.*',
+        '172.19.*',
+        '172.20.*',
+        '172.21.*',
+        '172.22.*',
+        '172.23.*',
+        '172.24.*',
+        '172.25.*',
+        '172.26.*',
+        '172.27.*',
+        '172.28.*',
+        '172.29.*',
+        '172.30.*',
+        '172.31.*',
+        '<local>',
+      ]
+    default:
+      return ['localhost', '127.0.0.1', '192.168.0.0/16', '10.0.0.0/8', '172.16.0.0/12', '::1']
+  }
+})()
+
+export async function enableSystemProxy() {
+  const spinner = ora('正在等待 Clash API 就绪以设置系统代理...').start()
+  try {
+    const config = await api.getConfig()
+    const port = config['mixed-port'] || config['port']
+
+    if (!port) {
+      throw new Error('未找到 HTTP 代理端口配置 (port 或 mixed-port)')
+    }
+
+    // 默认代理地址为 127.0.0.1
+    const host = '127.0.0.1'
+    const bypass = defaultBypass.join(',')
+
+    // 开启系统代理
+    triggerManualProxy(true, host, port, bypass)
+    spinner.succeed(`系统代理已开启: ${host}:${port}`)
+    return true
+  } catch (err) {
+    if (spinner && spinner.isSpinning) spinner.fail(`开启系统代理失败: ${err.message}`)
+    else console.error(err.message)
+    return false
+  }
+}
+
+export async function disableSystemProxy() {
+  try {
+    // 关闭系统代理
+    triggerManualProxy(false, '', 0, '')
+
+    console.log('系统代理已关闭')
+    return true
+  } catch (err) {
+    console.error(`关闭系统代理失败: ${err.message}`)
+    return false
+  }
+}
+
+export async function getSystemProxyStatus() {
+  // 使用 macOS networksetup 命令获取系统代理状态
+  if (process.platform === 'darwin') {
+    try {
+      const output = execSync('networksetup -getwebproxy Wi-Fi', { encoding: 'utf-8' })
+      const enabled = output.includes('Enabled: Yes')
+      if (enabled) {
+        const serverMatch = output.match(/Server: (.+)/)
+        const portMatch = output.match(/Port: (\d+)/)
+        const server = serverMatch ? serverMatch[1].trim() : ''
+        const port = portMatch ? portMatch[1].trim() : ''
+        return { enabled: true, server, port }
+      }
+      return { enabled: false }
+    } catch (e) {
+      return { enabled: false, error: e.message }
+    }
+  } else if (process.platform === 'win32') {
+    // Windows 可以通过注册表查询，这里简化处理
+    return { enabled: false, error: 'Windows 暂不支持获取状态' }
+  } else {
+    return { enabled: false, error: '不支持的平台' }
+  }
+}