@pikecode/api-key-manager 2.0.0

package/src/commands/switch.js

@@ -0,0 +1,1479 @@
+const path = require('path');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const Choices = require('inquirer/lib/objects/choices');
+const { ConfigManager } = require('../config');
+const { executeWithEnv } = require('../utils/env-launcher');
+const { Logger } = require('../utils/logger');
+const { UIHelper } = require('../utils/ui-helper');
+const { findSettingsConflict, backupSettingsFile, clearConflictKeys, saveSettingsFile } = require('../utils/claude-settings');
+const { BaseCommand } = require('./BaseCommand');
+const { validator } = require('../utils/validator');
+const { ProviderStatusChecker } = require('../utils/provider-status-checker');
+
+class EnvSwitcher extends BaseCommand {
+  constructor() {
+    super();
+    this.configManager = new ConfigManager();
+    this.statusChecker = new ProviderStatusChecker();
+    this.latestStatusMap = {};
+    this.currentPromptContext = null;
+    this.activeStatusRefresh = null;
+  }
+
+  async validateProvider(providerName) {
+    await this.configManager.load();
+    const provider = this.configManager.getProvider(providerName);
+    if (!provider) {
+      throw new Error(`供应商 '${providerName}' 不存在`);
+    }
+    return provider;
+  }
+
+  async showLaunchArgsSelection(providerName) {
+    try {
+      this.clearScreen();
+      const provider = await this.validateProvider(providerName);
+      const availableArgs = this.getAvailableLaunchArgs();
+      
+      console.log(UIHelper.createTitle('启动配置', UIHelper.icons.launch));
+      console.log();
+      console.log(UIHelper.createCard('供应商', UIHelper.formatProvider(provider), UIHelper.icons.info));
+      console.log();
+      console.log(UIHelper.createHintLine([
+        ['空格', '切换选中'],
+        ['A', '全选'],
+        ['I', '反选'],
+        ['Enter', '启动 Claude Code'],
+        ['ESC', '返回供应商选择']
+      ]));
+      console.log();
+      
+      // 设置 ESC 键监听
+      const escListener = this.createESCListener(() => {
+        Logger.info('返回供应商选择');
+        this.showProviderSelection();
+      }, '返回供应商选择');
+      
+      // 显示启动参数选择界面
+      const choices = [
+        {
+          type: 'checkbox',
+          name: 'selectedArgs',
+          message: '选择启动参数:',
+          choices: availableArgs.map(arg => {
+            const commandText = UIHelper.colors.muted(`(${arg.name})`);
+            const descriptionText = arg.description
+              ? ` ${UIHelper.colors.muted(arg.description)}`
+              : '';
+
+            return {
+              name: `${UIHelper.colors.accent(arg.label || arg.name)} ${commandText}${descriptionText}`,
+              value: arg.name,
+              checked: arg.checked || false
+            };
+          })
+        }
+      ];
+
+      let answers;
+      try {
+        answers = await this.prompt(choices);
+      } catch (error) {
+        this.removeESCListener(escListener);
+        if (this.isEscCancelled(error)) {
+          return;
+        }
+        throw error;
+      }
+      
+      this.removeESCListener(escListener);
+
+      // 选择参数后直接启动
+      await this.launchProvider(provider, answers.selectedArgs);
+      
+    } catch (error) {
+      await this.handleError(error, '选择启动参数');
+    }
+  }
+
+  async ensureClaudeSettingsCompatibility(provider) {
+    try {
+      const conflict = await findSettingsConflict();
+      if (!conflict) {
+        return true;
+      }
+
+      const keyList = conflict.keys.map((key) => `• ${key}`).join('\n');
+
+      const backupDir = path.dirname(conflict.filePath);
+
+      this.clearScreen();
+      console.log(UIHelper.createTitle('检测到环境变量冲突', UIHelper.icons.warning));
+      console.log();
+      console.log(UIHelper.createCard('冲突文件', conflict.filePath, UIHelper.icons.info));
+      console.log();
+      console.log(UIHelper.createCard('备份目录', `${backupDir}\n备份文件将命名为 settings.backup-YYYYMMDD_HHmmss.json`, UIHelper.icons.info));
+      console.log();
+      console.log(UIHelper.createCard('可能覆盖的变量', keyList, UIHelper.icons.warning));
+      console.log();
+      console.log(UIHelper.createTooltip('Claude 会优先读取该设置文件中的 env 配置，可能覆盖本次为供应商设置的变量。'));
+      console.log();
+
+      let answer;
+      try {
+        answer = await this.prompt([
+          {
+            type: 'list',
+            name: 'action',
+            message: `在 ${conflict.filePath} 中发现 env 配置会覆盖供应商 '${provider.displayName || provider.name}' 的变量，选择处理方式:`,
+            choices: [
+              { name: '🔧 备份并清空这些变量', value: 'fix' },
+              { name: '⚠️ 忽略并继续（可能导致切换失败）', value: 'ignore' },
+              { name: '❌ 取消启动', value: 'cancel' }
+            ],
+            default: 'fix'
+          }
+        ]);
+      } catch (error) {
+        if (this.isEscCancelled(error)) {
+          Logger.info('已取消启动');
+          return false;
+        }
+        throw error;
+      }
+
+      if (answer.action === 'fix') {
+        let confirmBackup;
+        try {
+          confirmBackup = await this.prompt([
+            {
+              type: 'confirm',
+              name: 'confirmed',
+              message: `将在 ${backupDir} 中创建备份文件 (settings.backup-YYYYMMDD_HHmmss.json)，并清空冲突变量。是否继续?`,
+              default: true
+            }
+          ]);
+        } catch (error) {
+          if (this.isEscCancelled(error)) {
+            Logger.info('已取消启动');
+            return false;
+          }
+          throw error;
+        }
+
+        if (!confirmBackup.confirmed) {
+          Logger.info('已取消启动');
+          return false;
+        }
+
+        try {
+          const backupPath = await backupSettingsFile(conflict.filePath);
+          const updatedSettings = clearConflictKeys(
+            {
+              ...conflict.settings,
+              env: conflict.settings.env ? { ...conflict.settings.env } : undefined
+            },
+            conflict.keys
+          );
+          await saveSettingsFile(conflict.filePath, updatedSettings);
+          Logger.success(`已将 ${conflict.filePath} 备份至 '${backupPath}' 并清空冲突变量。`);
+        } catch (error) {
+          throw new Error(`清理 Claude 设置文件失败: ${error.message}`);
+        }
+        return true;
+      }
+
+      if (answer.action === 'ignore') {
+        Logger.warning(`已忽略 ${conflict.filePath} 中的冲突，Claude 可能仍会使用该文件里的旧变量。`);
+        return true;
+      }
+
+      Logger.info('已取消启动');
+      return false;
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  async launchProvider(provider, selectedLaunchArgs) {
+    try {
+      const shouldContinue = await this.ensureClaudeSettingsCompatibility(provider);
+      if (!shouldContinue) {
+        return;
+      }
+
+      this.clearScreen();
+      console.log(UIHelper.createTitle('正在启动', UIHelper.icons.loading));
+      console.log();
+      console.log(UIHelper.createCard('目标供应商', UIHelper.formatProvider(provider), UIHelper.icons.launch));
+
+      if (selectedLaunchArgs.length > 0) {
+        console.log(UIHelper.createCard('启动参数', selectedLaunchArgs.join(', '), UIHelper.icons.settings));
+      }
+      console.log();
+      
+      // 显示进度
+      const loadingInterval = UIHelper.createLoadingAnimation('正在设置环境...');
+      
+      try {
+        // 设置为当前供应商
+        await this.configManager.setCurrentProvider(provider.name);
+        
+        // 更新使用统计
+        provider.usageCount = (provider.usageCount || 0) + 1;
+        provider.lastUsed = new Date().toISOString();
+        await this.configManager.save();
+        
+        UIHelper.clearLoadingAnimation(loadingInterval);
+        
+        console.log(UIHelper.createCard('准备就绪', '环境配置完成，正在启动 Claude Code...', UIHelper.icons.success));
+        console.log();
+        
+        // 设置环境变量并启动Claude Code
+        await executeWithEnv(provider, selectedLaunchArgs);
+        
+      } catch (error) {
+        UIHelper.clearLoadingAnimation(loadingInterval);
+        throw error;
+      }
+      
+    } catch (error) {
+      await this.handleError(error, '启动供应商');
+    }
+  }
+
+  getAvailableLaunchArgs() {
+    return [
+      {
+        name: '--continue',
+        label: '继续上次对话',
+        description: '恢复上次的对话记录',
+        checked: false
+      },
+      {
+        name: '--dangerously-skip-permissions',
+        label: '最高权限',
+        description: '仅在沙盒环境中使用',
+        checked: false
+      }
+    ];
+  }
+
+  // getArgDescription 方法已被移除，直接使用 arg.description
+
+  async showProviderSelection() {
+    try {
+      // 并行加载配置和准备界面
+      const providers = await this.configManager.ensureLoaded().then(() => this.configManager.listProviders());
+      
+      const initialStatusMap = this._buildInitialStatusMap(providers);
+      // 显示欢迎界面（立即渲染）
+      this.showWelcomeScreen(providers, initialStatusMap, null);
+      
+      if (providers.length === 0) {
+        Logger.warning('暂无配置的供应商');
+        Logger.info('请先运行 "akm add" 添加供应商配置');
+        return;
+      }
+
+      const choices = this.createProviderChoices(providers, false, initialStatusMap);
+
+      this.currentPromptContext = 'selection';
+
+      // 异步更新供应商状态，不阻塞界面展示
+      if (providers.length > 0) {
+        this._startStatusRefresh(providers);
+      }
+      
+      // 添加特殊选项
+      choices.push(
+        new inquirer.Separator(),
+        { name: `${UIHelper.icons.add} 添加新供应商`, value: '__ADD__' },
+        { name: `${UIHelper.icons.list} 供应商管理 (编辑/删除)`, value: '__MANAGE__' },
+        { name: `${UIHelper.icons.config} 打开配置文件`, value: '__OPEN_CONFIG__' },
+        { name: `${UIHelper.icons.error} 退出`, value: '__EXIT__' }
+      );
+
+      // 获取当前供应商作为默认选项
+      const currentProvider = providers.find(p => p.current);
+      const defaultChoice = currentProvider ? currentProvider.name : providers[0]?.name;
+
+      // 设置 ESC 键监听
+      const escListener = this.createESCListener(() => {
+        Logger.info('退出程序');
+        this.showExitScreen();
+        process.exit(0);
+      }, '退出程序');
+
+      const answer = await this.prompt([
+        {
+          type: 'list',
+          name: 'provider',
+          message: `请选择要切换的供应商 (总计 ${providers.length} 个):`,
+          choices,
+          default: defaultChoice,
+          pageSize: 12
+        }
+      ]);
+      
+      // 移除 ESC 键监听
+      this.removeESCListener(escListener);
+
+      this._cancelStatusRefresh();
+
+      if (answer.provider === '__OPEN_CONFIG__') {
+        await this.openConfigFile();
+        return await this.showProviderSelection();
+      }
+
+      const result = await this.handleSelection(answer.provider);
+      this.currentPromptContext = null;
+      return result;
+      
+    } catch (error) {
+      await this.handleError(error, '显示供应商选择');
+    } finally {
+      if (this.currentPromptContext === 'selection') {
+        this.currentPromptContext = null;
+      }
+      this._cancelStatusRefresh();
+    }
+  }
+
+  async openConfigFile() {
+    const { openAKMConfigFile } = require('../utils/config-opener');
+    try {
+      await openAKMConfigFile();
+    } catch (err) {
+      Logger.error(`打开配置文件失败: ${err.message}`);
+    }
+  }
+
+  showWelcomeScreen(providers, statusMap = {}, statusError = null) {
+    this.clearScreen();
+    
+    if (providers.length > 0) {
+      console.log(UIHelper.colors.info(`总共 ${providers.length} 个供应商配置`));
+    }
+    
+    if (statusError) {
+      console.log();
+      console.log(UIHelper.createCard('状态检测', `检测失败: ${statusError.message}`, UIHelper.icons.warning));
+    }
+
+    console.log();
+    console.log(UIHelper.createHintLine([
+      ['↑ / ↓', '选择供应商'],
+      ['Enter', '确认'],
+      ['Tab', '切换选项'],
+      ['ESC', '退出程序'],
+      ['Ctrl+C', '强制退出']
+    ]));
+    console.log();
+  }
+
+  async handleSelection(selection) {
+    switch (selection) {
+      case '__ADD__':
+        // 使用CommandRegistry避免循环引用
+        const { registry } = require('../CommandRegistry');
+        return await registry.executeCommand('add');
+      case '__MANAGE__':
+        return await this.showManageMenu();
+      case '__EXIT__':
+        this.showExitScreen();
+        process.exit(0);
+      default:
+        return await this.showLaunchArgsSelection(selection);
+    }
+  }
+
+  async showQuickSettings() {
+    this.clearScreen();
+    console.log(UIHelper.createHintLine([
+      ['↑ / ↓', '选择项目'],
+      ['Enter', '确认'],
+      ['ESC', '返回主菜单']
+    ]));
+    console.log();
+    const choices = [
+      { name: `${UIHelper.icons.search} 搜索供应商`, value: 'search' },
+      { name: `${UIHelper.icons.edit} 批量编辑`, value: 'batch' },
+      { name: `${UIHelper.icons.settings} 全局设置`, value: 'global' },
+      { name: `${UIHelper.icons.info} 查看统计`, value: 'stats' },
+      { name: `${UIHelper.icons.back} 返回主菜单`, value: 'back' }
+    ];
+
+    // 设置 ESC 键监听
+    const escListener = this.createESCListener(() => {
+      Logger.info('返回供应商选择');
+      this.showProviderSelection();
+    }, '返回供应商选择');
+
+    let answer;
+    try {
+      answer = await this.prompt([
+        {
+          type: 'list',
+          name: 'setting',
+          message: '快速设置:',
+          choices,
+          pageSize: 8
+        }
+      ]);
+    } catch (error) {
+      this.removeESCListener(escListener);
+      if (this.isEscCancelled(error)) {
+        return;
+      }
+      throw error;
+    }
+    
+    this.removeESCListener(escListener);
+
+    switch (answer.setting) {
+      case 'search':
+        return await this.showSearchProvider();
+      case 'batch':
+        return await this.showBatchEdit();
+      case 'global':
+        return await this.showGlobalSettings();
+      case 'stats':
+        return await this.showStatistics();
+      case 'back':
+        return await this.showProviderSelection();
+    }
+  }
+
+  async showBatchEdit() {
+    this.clearScreen();
+    console.log(UIHelper.createTitle('批量编辑', UIHelper.icons.edit));
+    console.log();
+    console.log(UIHelper.createTooltip('此功能正在开发中...'));
+    console.log();
+    console.log(UIHelper.createHintLine([
+      ['Enter', '返回上一页'],
+      ['ESC', '返回快速设置']
+    ]));
+    console.log();
+    
+    // 设置 ESC 键监听
+    const escListener = this.createESCListener(() => {
+      Logger.info('返回快速设置');
+      this.showQuickSettings();
+    }, '返回快速设置');
+    
+    try {
+      await this.prompt([
+        {
+          type: 'input',
+          name: 'continue',
+          message: '按回车键返回...'
+        }
+      ]);
+    } catch (error) {
+      this.removeESCListener(escListener);
+      if (this.isEscCancelled(error)) {
+        return;
+      }
+      throw error;
+    }
+    
+    this.removeESCListener(escListener);
+
+    return await this.showQuickSettings();
+  }
+
+  async showGlobalSettings() {
+    this.clearScreen();
+    console.log(UIHelper.createTitle('全局设置', UIHelper.icons.settings));
+    console.log();
+    console.log(UIHelper.createTooltip('此功能正在开发中...'));
+    console.log();
+    console.log(UIHelper.createHintLine([
+      ['Enter', '返回上一页'],
+      ['ESC', '返回快速设置']
+    ]));
+    console.log();
+    
+    // 设置 ESC 键监听
+    const escListener = this.createESCListener(() => {
+      Logger.info('返回快速设置');
+      this.showQuickSettings();
+    }, '返回快速设置');
+    
+    try {
+      await this.prompt([
+        {
+          type: 'input',
+          name: 'continue',
+          message: '按回车键返回...'
+        }
+      ]);
+    } catch (error) {
+      this.removeESCListener(escListener);
+      if (this.isEscCancelled(error)) {
+        return;
+      }
+      throw error;
+    }
+    
+    this.removeESCListener(escListener);
+
+    return await this.showQuickSettings();
+  }
+
+  async showSearchProvider() {
+    this.clearScreen();
+    console.log(UIHelper.createHintLine([
+      ['Enter', '执行搜索'],
+      ['ESC', '返回快速设置']
+    ]));
+    console.log(UIHelper.createTooltip('示例: claude、demo 或供应商别名'));
+    console.log();
+    // 设置 ESC 键监听
+    const escListener = this.createESCListener(() => {
+      Logger.info('返回快速设置');
+      this.showQuickSettings();
+    }, '返回快速设置');
+
+    let answer;
+    try {
+      answer = await this.prompt([
+        {
+          type: 'input',
+          name: 'search',
+          message: '输入供应商名称搜索:',
+          validate: input => input.trim() !== '' || '请输入搜索内容'
+        }
+      ]);
+    } catch (error) {
+      this.removeESCListener(escListener);
+      if (this.isEscCancelled(error)) {
+        return;
+      }
+      throw error;
+    }
+    
+    this.removeESCListener(escListener);
+
+    await this.configManager.load();
+    const providers = this.configManager.listProviders();
+    const searchResults = providers.filter(p => 
+      p.name.toLowerCase().includes(answer.search.toLowerCase()) ||
+      p.displayName.toLowerCase().includes(answer.search.toLowerCase())
+    );
+
+    if (searchResults.length === 0) {
+      Logger.warning('未找到匹配的供应商');
+      return await this.showQuickSettings();
+    }
+
+    const choices = searchResults.map(p => ({
+      name: UIHelper.formatProvider(p),
+      value: p.name
+    }));
+
+    choices.push(
+      new inquirer.Separator(),
+      { name: `${UIHelper.icons.back} 返回设置`, value: 'back' }
+    );
+
+    // 获取当前供应商作为默认选项（在搜索结果中）
+    const currentProvider = searchResults.find(p => p.current);
+    const defaultChoice = currentProvider ? currentProvider.name : searchResults[0]?.name;
+
+    // 设置 ESC 键监听
+    const escListener2 = this.createESCListener(() => {
+      Logger.info('返回快速设置');
+      this.showQuickSettings();
+    }, '返回快速设置');
+
+    console.log();
+    console.log(UIHelper.createHintLine([
+      ['↑ / ↓', '选择结果'],
+      ['Enter', '查看详情'],
+      ['ESC', '返回快速设置']
+    ]));
+
+    let result;
+    try {
+      result = await this.prompt([
+        {
+          type: 'list',
+          name: 'provider',
+          message: '搜索结果:',
+          choices,
+          default: defaultChoice,
+          pageSize: 10
+        }
+      ]);
+    } catch (error) {
+      this.removeESCListener(escListener2);
+      if (this.isEscCancelled(error)) {
+        return;
+      }
+      throw error;
+    }
+    
+    this.removeESCListener(escListener2);
+
+    if (result.provider === 'back') {
+      return await this.showQuickSettings();
+    }
+
+    return await this.showProviderDetails(result.provider);
+  }
+
+  async showStatistics() {
+    await this.configManager.load();
+    const providers = this.configManager.listProviders();
+    this.clearScreen();
+    
+    const totalProviders = providers.length;
+    const currentProvider = providers.find(p => p.current);
+    const totalUsage = providers.reduce((sum, p) => sum + (p.usageCount || 0), 0);
+    const mostUsed = providers.reduce((max, p) => (p.usageCount || 0) > (max.usageCount || 0) ? p : max, providers[0]);
+
+    console.log(UIHelper.createTitle('使用统计', UIHelper.icons.info));
+    console.log();
+    
+    const stats = [
+      ['总供应商数', totalProviders],
+      ['当前供应商', currentProvider ? currentProvider.displayName : '无'],
+      ['总使用次数', totalUsage],
+      ['最常用供应商', mostUsed ? mostUsed.displayName : '无'],
+      ['创建时间', providers.length > 0 ? UIHelper.formatTime(providers[0].createdAt) : '无']
+    ];
+    
+    console.log(UIHelper.createTable(['项目', '数据'], stats));
+    console.log();
+    console.log(UIHelper.createHintLine([
+      ['Enter', '返回快速设置'],
+      ['ESC', '返回快速设置']
+    ]));
+    console.log();
+
+    // 设置 ESC 键监听
+    const escListener = this.createESCListener(() => {
+      Logger.info('返回快速设置');
+      this.showQuickSettings();
+    }, '返回快速设置');
+    
+    try {
+      await this.prompt([
+        {
+          type: 'input',
+          name: 'continue',
+          message: '按回车键继续...'
+        }
+      ]);
+    } catch (error) {
+      this.removeESCListener(escListener);
+      if (this.isEscCancelled(error)) {
+        return;
+      }
+      throw error;
+    }
+    
+    this.removeESCListener(escListener);
+
+    return await this.showQuickSettings();
+  }
+
+  showExitScreen() {
+    this.clearScreen();
+    console.log(UIHelper.createTitle('感谢使用', UIHelper.icons.home));
+    console.log();
+    console.log(UIHelper.colors.info('再见！期待下次使用 🎉'));
+    console.log();
+  }
+
+  async showHelp() {
+    this.clearScreen();
+    console.log(UIHelper.createTitle('快捷键帮助', UIHelper.icons.info));
+    console.log();
+
+    const sections = [
+      {
+        title: '通用操作',
+        items: [
+          UIHelper.createShortcutHint('↑ / ↓', '在选项中移动'),
+          UIHelper.createShortcutHint('Enter', '确认/继续'),
+          UIHelper.createShortcutHint('ESC', '返回上一层'),
+          UIHelper.createShortcutHint('Ctrl+C', '随时强制退出')
+        ]
+      },
+      {
+        title: '供应商列表',
+        items: [
+          UIHelper.createShortcutHint('Tab', '切换特殊选项'),
+          UIHelper.createShortcutHint('A', '在启动参数列表中全选'),
+          UIHelper.createShortcutHint('I', '在启动参数列表中反选')
+        ]
+      },
+      {
+        title: '搜索界面',
+        items: [
+          UIHelper.createShortcutHint('Enter', '执行搜索或确认结果'),
+          UIHelper.createShortcutHint('ESC', '取消搜索返回上一页')
+        ]
+      }
+    ];
+
+    sections.forEach(section => {
+      console.log(UIHelper.createCard(section.title, section.items.join('\n'), UIHelper.icons.info));
+      console.log();
+    });
+
+    const escListener = this.createESCListener(() => {
+      Logger.info('返回主菜单');
+      this.showProviderSelection();
+    }, '返回主菜单');
+
+    console.log(UIHelper.createHintLine([
+      ['Enter', '返回主菜单'],
+      ['ESC', '返回主菜单']
+    ]));
+    console.log();
+
+    try {
+      await this.prompt([
+        {
+          type: 'input',
+          name: 'continue',
+          message: '按回车键返回主菜单'
+        }
+      ]);
+    } catch (error) {
+      this.removeESCListener(escListener);
+      if (this.isEscCancelled(error)) {
+        return;
+      }
+      throw error;
+    }
+
+    this.removeESCListener(escListener);
+    return await this.showProviderSelection();
+  }
+
+  async showManageMenu() {
+    let escListener;
+    try {
+      await this.configManager.load();
+      const providers = this.configManager.listProviders();
+      this.clearScreen();
+      console.log(UIHelper.createHintLine([
+        ['↑ / ↓', '选择供应商或操作'],
+        ['Enter', '确认'],
+        ['ESC', '返回主菜单']
+      ]));
+      console.log();
+      
+      console.log(UIHelper.createTitle('供应商管理', UIHelper.icons.list));
+      console.log();
+      
+      if (providers.length === 0) {
+        console.log(UIHelper.createCard('提示', '暂无配置的供应商\n请先运行 "akm add" 添加供应商配置', UIHelper.icons.warning));
+        return await this.showProviderSelection();
+      }
+
+      const statusMap = this._buildInitialStatusMap(providers);
+      const choices = this.createProviderChoices(providers, true, statusMap);
+
+      this.currentPromptContext = 'manage';
+
+      if (providers.length > 0) {
+        this._startStatusRefresh(providers);
+      }
+
+      // 设置 ESC 键监听
+      escListener = this.createESCListener(() => {
+        Logger.info('返回供应商选择');
+        this.showProviderSelection();
+      }, '返回供应商选择');
+
+      let answer;
+      try {
+        answer = await this.prompt([
+          {
+            type: 'list',
+            name: 'action',
+            message: `选择供应商或操作 (总计 ${providers.length} 个):`,
+            choices,
+            pageSize: 12
+          }
+        ]);
+      } catch (error) {
+        this.removeESCListener(escListener);
+        if (this.isEscCancelled(error)) {
+          return;
+        }
+        throw error;
+      }
+      
+      this.removeESCListener(escListener);
+
+      this._cancelStatusRefresh();
+
+      const result = await this.handleManageAction(answer.action);
+      this.currentPromptContext = null;
+      return result;
+      
+    } catch (error) {
+      await this.handleError(error, '显示供应商管理');
+    } finally {
+      if (this.currentPromptContext === 'manage') {
+        this.currentPromptContext = null;
+      }
+      this._cancelStatusRefresh();
+    }
+  }
+
+  createProviderChoices(providers, includeActions = false, statusMap = {}) {
+    const lastUsedProvider = providers.reduce((latest, current) => {
+      if (!current || !current.lastUsed) {
+        return latest;
+      }
+      if (!latest || !latest.lastUsed) {
+        return current;
+      }
+      return new Date(current.lastUsed) > new Date(latest.lastUsed) ? current : latest;
+    }, null);
+
+    const choices = providers.map(provider => {
+      const isLastUsed = lastUsedProvider && lastUsedProvider.name === provider.name;
+      const availability = statusMap[provider.name];
+      const icon = this._iconForState(availability?.state);
+      const statusText = this._formatAvailability(availability);
+      const statusLabel = chalk.gray('-') + ' ' + statusText;
+      const label = `${icon} ${UIHelper.formatProvider(provider)}${isLastUsed ? UIHelper.colors.muted(' --- 上次使用') : ''} ${statusLabel}`;
+
+      return {
+        name: label,
+        value: provider.name,
+        short: provider.name
+      };
+    });
+
+    if (includeActions) {
+      choices.push(
+        new inquirer.Separator(),
+        { name: `${UIHelper.icons.back} 返回供应商选择`, value: 'back' },
+        { name: `${UIHelper.icons.error} 退出`, value: 'exit' }
+      );
+    }
+
+    return choices;
+  }
+
+  _iconForState(state) {
+    if (state === 'online') {
+      return '🟢';
+    }
+    if (state === 'degraded') {
+      return '🟡';
+    }
+    if (state === 'offline') {
+      return '🔴';
+    }
+    if (state === 'pending') {
+      return '⏳';
+    }
+    return '⚪';
+  }
+
+  _formatAvailability(availability) {
+    if (!availability) {
+      return chalk.gray('测试中...');
+    }
+    if (availability.state === 'online') {
+      return chalk.green(availability.label || '可用');
+    }
+    if (availability.state === 'degraded') {
+      return chalk.yellow(availability.label || '有限可用');
+    }
+    if (availability.state === 'offline') {
+      return chalk.red(availability.label || '不可用');
+    }
+    if (availability.state === 'pending') {
+      return chalk.gray(availability.label || '测试中...');
+    }
+    return chalk.gray(availability.label || '未知');
+  }
+
+  _buildInitialStatusMap(providers) {
+    const cached = this.latestStatusMap || {};
+    const map = {};
+    providers.forEach(provider => {
+      map[provider.name] = cached[provider.name] || {
+        state: 'pending',
+        label: '测试中...',
+        latency: null
+      };
+    });
+    return map;
+  }
+
+  _buildErrorStatusMap(providers, error) {
+    const message = error ? `检测失败: ${error.message}` : '检测失败';
+    const map = {};
+    providers.forEach(provider => {
+      map[provider.name] = {
+        state: 'offline',
+        label: message,
+        latency: null
+      };
+    });
+    return map;
+  }
+
+  _startStatusRefresh(providers) {
+    this._cancelStatusRefresh();
+
+    const refreshToken = Symbol('statusRefresh');
+    this.activeStatusRefresh = refreshToken;
+
+    const latestMap = { ...this.latestStatusMap };
+    this.statusChecker
+      .checkAllStreaming(providers, (providerName, status) => {
+        if (this.activeStatusRefresh !== refreshToken) {
+          return;
+        }
+        latestMap[providerName] = status;
+        this.latestStatusMap = latestMap;
+        this._applyIncrementalStatus(providerName, status, refreshToken);
+      })
+      .then(finalMap => {
+        if (this.activeStatusRefresh !== refreshToken) {
+          return;
+        }
+        this.latestStatusMap = finalMap;
+      })
+      .catch(error => {
+        if (this.activeStatusRefresh !== refreshToken) {
+          return;
+        }
+        Logger.error(`供应商状态检测失败: ${error.message}`);
+        const fallback = this._buildErrorStatusMap(providers, error);
+        Object.assign(latestMap, fallback);
+        this.latestStatusMap = latestMap;
+        this._applyStatusUpdate(providers, fallback, error, refreshToken);
+      });
+  }
+
+  _cancelStatusRefresh() {
+    this.activeStatusRefresh = null;
+  }
+
+  _applyStatusUpdate(providers, statusMap, error, refreshToken = null) {
+    if (refreshToken && this.activeStatusRefresh !== refreshToken) {
+      return;
+    }
+    if (this.currentPromptContext !== 'selection' && this.currentPromptContext !== 'manage') {
+      return;
+    }
+
+    const activePrompt = this.activePrompt?.promise?.ui?.activePrompt;
+    if (!activePrompt || activePrompt.status === 'answered') {
+      return;
+    }
+
+    const includeActions = this.currentPromptContext === 'manage';
+    const updatedChoicesBase = this.createProviderChoices(providers, includeActions, statusMap);
+    const updatedChoices = [...updatedChoicesBase];
+
+    if (!includeActions) {
+      updatedChoices.push(
+        new inquirer.Separator(),
+        { name: `${UIHelper.icons.add} 添加新供应商`, value: '__ADD__' },
+        { name: `${UIHelper.icons.list} 供应商管理 (编辑/删除)`, value: '__MANAGE__' },
+        { name: `${UIHelper.icons.config} 打开配置文件`, value: '__OPEN_CONFIG__' },
+        { name: `${UIHelper.icons.error} 退出`, value: '__EXIT__' }
+      );
+    }
+
+    const previousValue = (() => {
+      try {
+        return activePrompt.opt.choices?.getChoice(activePrompt.selected)?.value ?? null;
+      } catch (err) {
+        return null;
+      }
+    })();
+
+    activePrompt.opt.choices = new Choices(updatedChoices, activePrompt.answers);
+
+    if (previousValue != null) {
+      const newIndex = activePrompt.opt.choices.realChoices.findIndex(choice => choice.value === previousValue);
+      if (newIndex >= 0) {
+        activePrompt.selected = newIndex;
+      } else if (activePrompt.selected >= activePrompt.opt.choices.realLength) {
+        activePrompt.selected = Math.max(activePrompt.opt.choices.realLength - 1, 0);
+      }
+    } else if (activePrompt.selected >= activePrompt.opt.choices.realLength) {
+      activePrompt.selected = Math.max(activePrompt.opt.choices.realLength - 1, 0);
+    }
+
+    if (error) {
+      if (this.currentPromptContext === 'selection') {
+        activePrompt.opt.message = `请选择要切换的供应商 (总计 ${providers.length} 个，状态检测失败，使用默认配置):`;
+      } else if (this.currentPromptContext === 'manage') {
+        activePrompt.opt.message = `选择供应商或操作 (总计 ${providers.length} 个，状态检测失败，使用默认配置):`;
+      }
+    } else {
+      if (this.currentPromptContext === 'selection') {
+        activePrompt.opt.message = `请选择要切换的供应商 (总计 ${providers.length} 个):`;
+      } else if (this.currentPromptContext === 'manage') {
+        activePrompt.opt.message = `选择供应商或操作 (总计 ${providers.length} 个):`;
+      }
+    }
+
+    activePrompt.render();
+  }
+
+  _applyIncrementalStatus(providerName, status, refreshToken) {
+    if (refreshToken && this.activeStatusRefresh !== refreshToken) {
+      return;
+    }
+    if (this.currentPromptContext !== 'selection' && this.currentPromptContext !== 'manage') {
+      return;
+    }
+
+    const activePrompt = this.activePrompt?.promise?.ui?.activePrompt;
+    if (!activePrompt || activePrompt.status === 'answered') {
+      return;
+    }
+
+    const includeActions = this.currentPromptContext === 'manage';
+    const providers = this.configManager.listProviders();
+    const statusMap = this.latestStatusMap || {};
+    const updatedChoicesBase = this.createProviderChoices(providers, includeActions, statusMap);
+    const updatedChoices = [...updatedChoicesBase];
+
+    if (!includeActions) {
+      updatedChoices.push(
+        new inquirer.Separator(),
+        { name: `${UIHelper.icons.add} 添加新供应商`, value: '__ADD__' },
+        { name: `${UIHelper.icons.list} 供应商管理 (编辑/删除)`, value: '__MANAGE__' },
+        { name: `${UIHelper.icons.config} 打开配置文件`, value: '__OPEN_CONFIG__' },
+        { name: `${UIHelper.icons.error} 退出`, value: '__EXIT__' }
+      );
+    }
+
+    const previousValue = (() => {
+      try {
+        return activePrompt.opt.choices?.getChoice(activePrompt.selected)?.value ?? null;
+      } catch (err) {
+        return null;
+      }
+    })();
+
+    activePrompt.opt.choices = new Choices(updatedChoices, activePrompt.answers);
+
+    if (previousValue != null) {
+      const newIndex = activePrompt.opt.choices.realChoices.findIndex(choice => choice.value === previousValue);
+      if (newIndex >= 0) {
+        activePrompt.selected = newIndex;
+      } else if (activePrompt.selected >= activePrompt.opt.choices.realLength) {
+        activePrompt.selected = Math.max(activePrompt.opt.choices.realLength - 1, 0);
+      }
+    } else if (activePrompt.selected >= activePrompt.opt.choices.realLength) {
+      activePrompt.selected = Math.max(activePrompt.opt.choices.realLength - 1, 0);
+    }
+
+    if (this.currentPromptContext === 'selection') {
+      activePrompt.opt.message = `请选择要切换的供应商 (总计 ${providers.length} 个):`;
+    } else if (this.currentPromptContext === 'manage') {
+      activePrompt.opt.message = `选择供应商或操作 (总计 ${providers.length} 个):`;
+    }
+
+    activePrompt.render();
+  }
+
+  async handleManageAction(action) {
+    switch (action) {
+      case 'back':
+        return await this.showProviderSelection();
+      case 'exit':
+        Logger.info('👋 再见！');
+        process.exit(0);
+      default:
+        // 如果选择的是供应商名称，显示该供应商的详细信息
+        return await this.showProviderDetails(action);
+    }
+  }
+
+  async showProviderDetails(providerName) {
+    let escListener;
+    try {
+      const provider = await this.validateProvider(providerName);
+      this.clearScreen();
+      
+      console.log(UIHelper.createTitle('供应商详情', UIHelper.icons.info));
+      console.log();
+      console.log(UIHelper.createHintLine([
+        ['↑ / ↓', '选择操作'],
+        ['Enter', '确认'],
+        ['ESC', '返回管理列表']
+      ]));
+      console.log();
+      
+      const authModeDisplay = {
+        api_key: '通用API密钥模式',
+        auth_token: '认证令牌模式',
+        oauth_token: 'OAuth令牌模式'
+      };
+
+      const details = [
+        ['供应商名称', provider.name],
+        ['显示名称', provider.displayName],
+        ['认证模式', authModeDisplay[provider.authMode] || provider.authMode],
+      ];
+
+      // 如果是 api_key 模式，添加 tokenType 信息
+      if (provider.authMode === 'api_key' && provider.tokenType) {
+        const tokenTypeDisplay = provider.tokenType === 'auth_token' ? 'ANTHROPIC_AUTH_TOKEN' : 'ANTHROPIC_API_KEY';
+        details.push(['Token类型', tokenTypeDisplay]);
+      }
+
+      // 继续添加其他信息
+      details.push(
+        ['基础URL', provider.baseUrl || (provider.authMode === 'oauth_token' ? '✨ 官方默认服务器' : '⚠️ 未设置')],
+        ['认证令牌', provider.authToken || '未设置'],
+        ['主模型', provider.models?.primary || '未设置'],
+        ['快速模型', provider.models?.smallFast || '未设置'],
+        ['创建时间', UIHelper.formatTime(provider.createdAt)],
+        ['最后使用', UIHelper.formatTime(provider.lastUsed)],
+        ['当前状态', provider.current ? '✅ 使用中' : '⚫ 未使用'],
+        ['使用次数', provider.usageCount || 0]
+      );
+      
+      console.log(UIHelper.createTable(['项目', '信息'], details));
+      console.log();
+      
+      if (provider.launchArgs && provider.launchArgs.length > 0) {
+        console.log(UIHelper.createCard('默认启动参数', provider.launchArgs.join(', '), UIHelper.icons.settings));
+        console.log();
+      }
+
+      // 设置 ESC 键监听
+      escListener = this.createESCListener(() => {
+        Logger.info('返回管理列表');
+        this.showManageMenu();
+      }, '返回管理列表');
+
+      let answer;
+      try {
+        answer = await this.prompt([
+          {
+            type: 'list',
+            name: 'action',
+            message: '选择操作:',
+            choices: [
+              { name: `${UIHelper.icons.launch} 立即启动`, value: 'launch' },
+              { name: `${UIHelper.icons.edit} 编辑供应商`, value: 'edit' },
+              { name: `${UIHelper.icons.delete} 删除供应商`, value: 'remove' },
+              { name: `${UIHelper.icons.back} 返回管理列表`, value: 'back' }
+            ]
+          }
+        ]);
+      } catch (error) {
+        this.removeESCListener(escListener);
+        if (this.isEscCancelled(error)) {
+          return;
+        }
+        throw error;
+      }
+
+      switch (answer.action) {
+        case 'back':
+          // 移除 ESC 键监听
+          this.removeESCListener(escListener);
+          return await this.showManageMenu();
+        case 'edit':
+          // 移除 ESC 键监听
+          this.removeESCListener(escListener);
+          return await this.editProvider(providerName);
+        case 'remove':
+          // 移除 ESC 键监听
+          this.removeESCListener(escListener);
+          return await this.removeProvider(providerName);
+        case 'launch':
+          // 移除 ESC 键监听
+          this.removeESCListener(escListener);
+          return await this.showLaunchArgsSelection(providerName);
+      }
+      
+    } catch (error) {
+      // 移除 ESC 键监听
+      this.removeESCListener(escListener);
+      await this.handleError(error, '显示供应商详情');
+    }
+  }
+
+  async editProvider(providerName) {
+    let escListener;
+    try {
+      await this.configManager.load();
+      const provider = this.configManager.getProvider(providerName);
+      this.clearScreen();
+      
+      if (!provider) {
+        Logger.error(`供应商 '${providerName}' 不存在`);
+        return await this.showManageMenu();
+      }
+
+      // 设置 ESC 键监听
+      escListener = this.createESCListener(() => {
+        Logger.info('取消编辑供应商');
+        this.showManageMenu();
+      }, '取消编辑');
+
+      let answers;
+      try {
+        answers = await this.prompt([
+          {
+            type: 'input',
+            name: 'name',
+            message: '请输入供应商名称 (用于命令行):',
+            default: provider.name,
+            validate: (input) => {
+              const error = validator.validateName(input);
+              if (error) return error;
+              return true;
+            }
+          },
+          {
+            type: 'input',
+            name: 'displayName',
+            message: '显示名称:',
+            default: provider.displayName,
+            prefillDefault: true
+          },
+          {
+            type: 'list',
+            name: 'authMode',
+            message: '认证模式:',
+            choices: [
+              { name: '🔑 通用API密钥模式 - 支持 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN', value: 'api_key' },
+              { name: '🔐 认证令牌模式 (仅 ANTHROPIC_AUTH_TOKEN) - 适用于某些服务商', value: 'auth_token' },
+              { name: '🌐 OAuth令牌模式 (CLAUDE_CODE_OAUTH_TOKEN) - 适用于官方Claude Code', value: 'oauth_token' }
+            ],
+            default: provider.authMode || 'api_key'
+          },
+          {
+            type: 'list',
+            name: 'tokenType',
+            message: 'Token类型:',
+            choices: [
+              { name: '🔑 ANTHROPIC_API_KEY - 通用API密钥', value: 'api_key' },
+              { name: '🔐 ANTHROPIC_AUTH_TOKEN - 认证令牌', value: 'auth_token' }
+            ],
+            default: provider.tokenType || 'api_key',
+            when: (answers) => answers.authMode === 'api_key'
+          },
+          {
+            type: 'input',
+            name: 'baseUrl',
+            message: '基础URL:',
+            default: provider.baseUrl,
+            prefillDefault: true,
+            when: (answers) => answers.authMode === 'api_key' || answers.authMode === 'auth_token'
+          },
+          {
+            type: 'input',
+            name: 'authToken',
+            message: (answers) => {
+              switch (answers.authMode) {
+                case 'api_key':
+                  const tokenTypeLabel = answers.tokenType === 'auth_token' ? 'ANTHROPIC_AUTH_TOKEN' : 'ANTHROPIC_API_KEY';
+                  return `Token (${tokenTypeLabel}):`;
+                case 'auth_token':
+                  return '认证令牌 (ANTHROPIC_AUTH_TOKEN):';
+                case 'oauth_token':
+                  return 'OAuth令牌 (CLAUDE_CODE_OAUTH_TOKEN):';
+                default:
+                  return '认证令牌:';
+              }
+            },
+            default: provider.authToken,
+            prefillDefault: true
+          },
+          {
+            type: 'input',
+            name: 'primaryModel',
+            message: '主模型 (ANTHROPIC_MODEL):',
+            default: provider.models?.primary || '',
+            prefillDefault: true,
+            allowEmpty: true,
+            validate: (input) => {
+              const error = validator.validateModel(input);
+              if (error) return error;
+              return true;
+            }
+          },
+          {
+            type: 'input',
+            name: 'smallFastModel',
+            message: '快速模型 (ANTHROPIC_SMALL_FAST_MODEL):',
+            default: provider.models?.smallFast || '',
+            prefillDefault: true,
+            allowEmpty: true,
+            validate: (input) => {
+              const error = validator.validateModel(input);
+              if (error) return error;
+              return true;
+            }
+          }
+        ]);
+      } catch (error) {
+        this.removeESCListener(escListener);
+        if (this.isEscCancelled(error)) {
+          return;
+        }
+        throw error;
+      }
+
+      const originalName = provider.name;
+      const newName = answers.name;
+
+      // 处理重命名逻辑
+      if (newName !== originalName) {
+        await this.configManager.ensureLoaded();
+        const providersMap = this.configManager.config.providers;
+
+        if (providersMap[newName] && providersMap[newName] !== provider) {
+          Logger.error(`供应商名称 '${newName}' 已存在，请使用其他名称`);
+          return await this.showManageMenu();
+        }
+
+        providersMap[newName] = {
+          ...provider,
+          name: newName
+        };
+
+        delete providersMap[originalName];
+
+        if (this.configManager.config.currentProvider === originalName) {
+          this.configManager.config.currentProvider = newName;
+          providersMap[newName].current = true;
+        }
+
+        provider = providersMap[newName];
+      }
+
+      // 更新供应商配置
+      provider.displayName = answers.displayName || newName;
+      provider.baseUrl = answers.baseUrl;
+      provider.authToken = answers.authToken;
+      provider.authMode = answers.authMode;
+      if (answers.tokenType) {
+        provider.tokenType = answers.tokenType; // 仅在 authMode 为 'api_key' 时使用
+      }
+      
+      // 更新模型配置
+      if (!provider.models) {
+        provider.models = {};
+      }
+      provider.models.primary = answers.primaryModel || null;
+      provider.models.smallFast = answers.smallFastModel || null;
+
+      await this.configManager.save();
+      Logger.success(`供应商 '${newName}' 已更新`);
+      
+      // 移除 ESC 键监听
+      this.removeESCListener(escListener);
+      return await this.showManageMenu();
+      
+    } catch (error) {
+      // 移除 ESC 键监听
+      this.removeESCListener(escListener);
+      Logger.error(`编辑供应商失败: ${error.message}`);
+      throw error;
+    }
+  }
+
+  async removeProvider(providerName) {
+    let escListener;
+    try {
+      await this.configManager.load();
+      const provider = this.configManager.getProvider(providerName);
+      this.clearScreen();
+      
+      if (!provider) {
+        Logger.error(`供应商 '${providerName}' 不存在`);
+        return await this.showManageMenu();
+      }
+
+      // 设置 ESC 键监听
+      escListener = this.createESCListener(() => {
+        Logger.info('取消删除供应商');
+        this.showManageMenu();
+      }, '取消删除');
+
+      let confirm;
+      try {
+        confirm = await this.prompt([
+          {
+            type: 'confirm',
+            name: 'confirmed',
+            message: `确定要删除供应商 '${providerName}' 吗?`,
+            default: false
+          }
+        ]);
+      } catch (error) {
+        this.removeESCListener(escListener);
+        if (this.isEscCancelled(error)) {
+          return;
+        }
+        throw error;
+      }
+
+      if (confirm.confirmed) {
+        await this.configManager.removeProvider(providerName);
+        Logger.success(`供应商 '${providerName}' 已删除`);
+      } else {
+        Logger.info('删除操作已取消');
+      }
+
+      // 移除 ESC 键监听
+      this.removeESCListener(escListener);
+      return await this.showManageMenu();
+      
+    } catch (error) {
+      // 移除 ESC 键监听
+      this.removeESCListener(escListener);
+      Logger.error(`删除供应商失败: ${error.message}`);
+      throw error;
+    }
+  }
+}
+
+async function switchCommand(providerName) {
+  const switcher = new EnvSwitcher();
+  
+  try {
+    if (providerName) {
+      await switcher.showLaunchArgsSelection(providerName);
+    } else {
+      await switcher.showProviderSelection();
+    }
+  } finally {
+    // 确保资源清理
+    switcher.destroy();
+  }
+}
+
+async function editCommand(providerName) {
+  const switcher = new EnvSwitcher();
+  
+  try {
+    await switcher.editProvider(providerName);
+  } finally {
+    // 确保资源清理
+    switcher.destroy();
+  }
+}
+
+module.exports = { switchCommand, editCommand, EnvSwitcher };