clash-switcher 0.0.1

package/dist/commands/test.d.ts

@@ -0,0 +1,3 @@
+import { ClashAPI } from '../api';
+export declare function testProxy(api: ClashAPI, proxyName: string, testUrl?: string, timeout?: number): Promise<void>;
+export declare function testGroup(api: ClashAPI, groupName: string, testUrl?: string, timeout?: number): Promise<void>;

package/dist/commands/test.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testProxy = testProxy;
+exports.testGroup = testGroup;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+async function testProxy(api, proxyName, testUrl, timeout) {
+    const spinner = (0, ora_1.default)(`测试 ${proxyName} 延迟...`).start();
+    try {
+        const delay = await api.testDelay(proxyName, testUrl, timeout);
+        const color = delay < 200 ? chalk_1.default.green : delay < 500 ? chalk_1.default.yellow : chalk_1.default.red;
+        spinner.succeed(`${proxyName}: ${color(delay + 'ms')}`);
+    }
+    catch (error) {
+        spinner.fail(`${proxyName}: ${chalk_1.default.red('超时')}`);
+    }
+}
+async function testGroup(api, groupName, testUrl, timeout) {
+    const spinner = (0, ora_1.default)('测试节点延迟...').start();
+    try {
+        const delays = await api.testGroupDelays(groupName, testUrl, timeout);
+        spinner.stop();
+        const sorted = Object.entries(delays).sort((a, b) => {
+            if (a[1] <= 0)
+                return 1;
+            if (b[1] <= 0)
+                return -1;
+            return a[1] - b[1];
+        });
+        console.log(chalk_1.default.bold(`\n${groupName} 延迟测试:\n`));
+        for (const [name, delay] of sorted) {
+            if (delay <= 0) {
+                console.log(`  ${name}: ${chalk_1.default.red('超时')}`);
+            }
+            else {
+                const color = delay < 200 ? chalk_1.default.green : delay < 500 ? chalk_1.default.yellow : chalk_1.default.red;
+                console.log(`  ${name}: ${color(delay + 'ms')}`);
+            }
+        }
+        console.log();
+    }
+    catch (error) {
+        spinner.fail('测试失败');
+        throw error;
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+export interface Config {
+    host: string;
+    port: number;
+    secret?: string;
+    testUrl: string;
+    timeout: number;
+    vergeConfigDir: string;
+}
+export declare function ensureConfigDir(): void;
+export declare function loadConfig(): Config;
+export declare function saveConfig(config: Partial<Config>): void;
+export declare function getConfigPath(): string;

package/dist/config.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureConfigDir = ensureConfigDir;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.getConfigPath = getConfigPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const CONFIG_DIR = path.join(os.homedir(), '.clash-switcher');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+function getDefaultVergeConfigDir() {
+    const platform = os.platform();
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+        return path.join(appData, 'io.github.clash-verge-rev.clash-verge-rev');
+    }
+    else if (platform === 'darwin') {
+        return path.join(os.homedir(), 'Library', 'Application Support', 'io.github.clash-verge-rev.clash-verge-rev');
+    }
+    return path.join(os.homedir(), '.config', 'clash-verge');
+}
+const DEFAULT_CONFIG = {
+    host: '127.0.0.1',
+    port: 9097,
+    testUrl: 'http://www.gstatic.com/generate_204',
+    timeout: 5000,
+    vergeConfigDir: getDefaultVergeConfigDir(),
+};
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+}
+function loadConfig() {
+    ensureConfigDir();
+    if (fs.existsSync(CONFIG_FILE)) {
+        const content = fs.readFileSync(CONFIG_FILE, 'utf-8');
+        return { ...DEFAULT_CONFIG, ...JSON.parse(content) };
+    }
+    return DEFAULT_CONFIG;
+}
+function saveConfig(config) {
+    ensureConfigDir();
+    const current = loadConfig();
+    const newConfig = { ...current, ...config };
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(newConfig, null, 2));
+}
+function getConfigPath() {
+    return CONFIG_FILE;
+}

package/dist/core.d.ts

@@ -0,0 +1,184 @@
+import { ClashSwitcherConfig, ResolvedConfig, ProxyGroup, Profile, DelayTestResult, ClashMode, GroupsMode } from './types';
+/**
+ * Clash Switcher 主类
+ * @description 用于控制 Clash Verge 代理切换的核心类
+ * @example
+ * ```typescript
+ * import { ClashSwitcher } from 'clash-switcher';
+ *
+ * const switcher = new ClashSwitcher({
+ *   port: 9097,
+ *   timeout: 3000,
+ * });
+ *
+ * // 获取所有代理组
+ * const groups = await switcher.getProxyGroups();
+ *
+ * // 切换节点
+ * await switcher.setNode('代理组名', '节点名');
+ * ```
+ */
+export declare class ClashSwitcher {
+    private config;
+    private client;
+    /**
+     * 创建 ClashSwitcher 实例
+     * @param config - 配置选项
+     * @param config.host - API 主机地址，默认 '127.0.0.1'
+     * @param config.port - API 端口号，默认 9097
+     * @param config.secret - API 访问密钥，默认无
+     * @param config.testUrl - 延迟测试 URL，默认 'http://www.gstatic.com/generate_204'
+     * @param config.timeout - 超时时间（毫秒），默认 5000
+     * @param config.vergeConfigDir - Clash Verge 配置目录，默认自动检测
+     */
+    constructor(config?: ClashSwitcherConfig);
+    private createClient;
+    /**
+     * 从 Clash Verge 配置文件读取 secret
+     */
+    private readSecretFromConfig;
+    /**
+     * 更新配置
+     * @param config - 要更新的配置项，只需传入需要修改的字段
+     * @example
+     * ```typescript
+     * switcher.setConfig({ port: 9090 });
+     * switcher.setConfig({ timeout: 3000, testUrl: 'http://example.com' });
+     * ```
+     */
+    setConfig(config: ClashSwitcherConfig): void;
+    /**
+     * 获取当前配置
+     * @returns 当前完整配置对象
+     */
+    getConfig(): ResolvedConfig;
+    /**
+     * 获取当前代理模式
+     * @returns 当前模式：'rule'(规则) | 'global'(全局) | 'direct'(直连)
+     */
+    getMode(): Promise<ClashMode>;
+    /**
+     * 设置代理模式
+     * @param mode - 目标模式：'rule'(规则) | 'global'(全局) | 'direct'(直连)
+     */
+    setMode(mode: ClashMode): Promise<void>;
+    /**
+     * 获取所有代理信息
+     */
+    private getProxies;
+    /**
+     * 获取代理组列表
+     * @param mode - 模式筛选
+     *   - 不传或 'active': 当前激活模式的代理组
+     *   - 'rule': 规则模式的代理组（排除 GLOBAL）
+     *   - 'global': 全局模式的代理组（仅 GLOBAL）
+     *   - 'direct': 直连模式（返回空数组）
+     *   - 'all': 所有代理组
+     * @param filter - 结果筛选
+     *   - 不传: 返回所有匹配的代理组
+     *   - number: 按索引位置返回（从 0 开始）
+     *   - string: 按名称模糊匹配返回
+     * @returns 代理组列表，按配置文件顺序排序
+     */
+    getGroups(mode?: GroupsMode, filter?: number | string): Promise<ProxyGroup[]>;
+    /**
+     * 获取单个代理组
+     * @param mode - 模式筛选（同 getGroups）
+     * @param filter - 结果筛选
+     *   - 不传: 返回第一个代理组（主代理组）
+     *   - number: 按索引位置返回（从 0 开始）
+     *   - string: 按名称模糊匹配返回第一个匹配的
+     * @returns 代理组对象，未找到返回 null
+     */
+    getGroup(mode?: GroupsMode, filter?: number | string): Promise<ProxyGroup | null>;
+    /**
+     * 从当前订阅配置文件读取代理组顺序
+     */
+    private getProxyGroupOrder;
+    /**
+     * 解析代理组（支持模糊匹配和索引）
+     */
+    private resolveProxyGroup;
+    /**
+     * 解析节点（支持模糊匹配和索引）
+     */
+    private resolveProxy;
+    /**
+     * 切换节点
+     * @param group - 代理组筛选：索引(number)或名称模糊匹配(string)
+     * @param node - 目标节点名称，支持模糊匹配
+     */
+    setNode(group: number | string, node: string): Promise<void>;
+    /**
+     * 获取代理组内的所有节点
+     * @param filter - 代理组筛选：不传返回主代理组，索引(number)或名称模糊匹配(string)
+     * @returns 节点名称列表
+     */
+    getNodes(filter?: number | string): Promise<string[]>;
+    /**
+     * 测试单个节点延迟
+     * @param node - 节点名称，支持模糊匹配
+     * @param url - 测试 URL，不传使用默认配置
+     * @param timeout - 超时时间（毫秒），不传使用默认配置
+     * @returns 延迟测试结果 { name: 完整节点名, delay: 延迟毫秒数 }
+     */
+    testNode(node: string, url?: string, timeout?: number): Promise<DelayTestResult>;
+    /**
+     * 测试多个节点延迟
+     * @param filter - 筛选参数
+     *   - 不传: 测试主代理组的所有节点
+     *   - number: 按索引指定代理组
+     *   - string: 按名称模糊匹配代理组
+     *   - string[]: 指定节点名称列表（可配合 getNodes 使用）
+     * @param url - 测试 URL，不传使用默认配置
+     * @param timeout - 超时时间（毫秒），不传使用默认配置
+     * @returns 延迟测试结果列表，delay 为 -1 表示超时
+     */
+    testNodes(filter?: number | string | string[], url?: string, timeout?: number): Promise<DelayTestResult[]>;
+    /**
+     * 自动选择最快节点
+     * @param filter - 代理组筛选：不传使用主代理组，索引(number)或名称模糊匹配(string)
+     * @param url - 测试 URL，不传使用默认配置
+     * @param timeout - 超时时间（毫秒），不传使用默认配置
+     * @returns 切换到的节点信息，无可用节点返回 null
+     */
+    autoNode(filter?: number | string, url?: string, timeout?: number): Promise<DelayTestResult | null>;
+    /**
+     * 获取所有订阅列表
+     * @returns 远程订阅列表（type 为 'remote' 的订阅）
+     */
+    getSubs(): Profile[];
+    private parseProfilesYaml;
+    /**
+     * 获取订阅
+     * @param filter - 筛选参数：不传返回当前激活订阅，索引(number)或名称/UID模糊匹配(string)
+     * @returns 订阅对象，未找到返回 null
+     */
+    getSub(filter?: number | string): Profile | null;
+    /**
+     * 切换订阅
+     * @param filter - 订阅筛选：索引(number)或名称/UID模糊匹配(string)
+     * @param restart - 是否重启 Clash Verge，默认 true
+     * @returns 切换到的订阅对象
+     */
+    setSub(filter: number | string, restart?: boolean): Promise<Profile>;
+    /**
+     * 等待 API 就绪
+     * @param timeout - 超时时间（毫秒），默认 10000
+     * @param interval - 检测间隔（毫秒），默认 200
+     * @param waitDisconnect - 是否先等待 API 断开，默认 false
+     */
+    waitReady(timeout?: number, interval?: number, waitDisconnect?: boolean): Promise<void>;
+    /**
+     * 检测进程是否存在
+     */
+    private isProcessRunning;
+    /**
+     * 等待进程退出
+     */
+    private waitForProcessExit;
+    /**
+     * 重启 Clash Verge 应用
+     */
+    restartClashVerge(): Promise<void>;
+}