@pikecode/api-key-manager 1.0.38 → 1.0.42

package/bin/akm.js

@@ -21,9 +21,11 @@ program.hook('preAction', async () => {
 // Default command - show provider selection
 program
   .argument('[provider]', '直接切换到指定供应商')
-  .action(async (provider) => {
+  .option('-q, --quick', '快速启动（使用默认或上次的启动参数）')
+  .option('--no-args', '以空参数启动（不使用任何启动参数）')
+  .action(async (provider, options) => {
     try {
-      await main(provider);
+      await main(provider, options);
     } catch (error) {
       console.error(chalk.red('❌ 执行失败:'), error.message);
       process.exit(1);
@@ -53,10 +55,16 @@ program
   .argument('[provider]', '直接切换到指定供应商')
   .option('--codex', '仅显示 Codex CLI 供应商')
   .option('--claude', '仅显示 Claude Code 供应商')
+  .option('-q, --quick', '快速启动（使用默认或上次的启动参数）')
+  .option('--no-args', '以空参数启动（不使用任何启动参数）')
   .action(async (provider, options) => {
     try {
       const filter = options.codex ? 'codex' : (options.claude ? 'claude' : null);
-      await registry.executeCommand('switch', provider, { filter });
+      await registry.executeCommand('switch', provider, {
+        filter,
+        quick: options.quick,
+        noArgs: options.noArgs
+      });
     } catch (error) {
       console.error(chalk.red('❌ 切换失败:'), error.message);
       process.exit(1);
@@ -168,5 +176,114 @@ program
     }
   });
 
+// Validate command
+program
+  .command('validate')
+  .description('验证供应商配置的有效性')
+  .argument('[provider]', '要验证的供应商名称（不指定则验证全部）')
+  .option('--codex', '仅验证 Codex CLI 供应商')
+  .option('--claude', '仅验证 Claude Code 供应商')
+  .action(async (provider, options) => {
+    try {
+      const filter = options.codex ? 'codex' : (options.claude ? 'claude' : null);
+      await registry.executeCommand('validate', provider, { filter });
+    } catch (error) {
+      console.error(chalk.red('❌ 验证失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Stats command
+program
+  .command('stats')
+  .description('显示供应商使用统计')
+  .argument('[provider]', '要查看统计的供应商名称（不指定则显示全部）')
+  .option('--codex', '仅显示 Codex CLI 供应商')
+  .option('--claude', '仅显示 Claude Code 供应商')
+  .option('-r, --recommend', '显示智能推荐')
+  .option('-s, --sort <type>', '排序方式: usage(使用次数), time(最近使用), name(名称)', 'usage')
+  .option('-l, --limit <number>', '推荐列表数量限制', '5')
+  .action(async (provider, options) => {
+    try {
+      const filter = options.codex ? 'codex' : (options.claude ? 'claude' : null);
+      const limit = parseInt(options.limit, 10);
+      await registry.executeCommand('stats', provider, {
+        filter,
+        recommend: options.recommend,
+        sort: options.sort,
+        limit
+      });
+    } catch (error) {
+      console.error(chalk.red('❌ 统计失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Health command
+program
+  .command('health')
+  .description('检查供应商配置健康状态')
+  .argument('[provider]', '要检查的供应商名称（不指定则检查全部）')
+  .option('--codex', '仅检查 Codex CLI 供应商')
+  .option('--claude', '仅检查 Claude Code 供应商')
+  .option('--no-connectivity', '跳过 API 连接性检查（加快速度）')
+  .action(async (provider, options) => {
+    try {
+      const filter = options.codex ? 'codex' : (options.claude ? 'claude' : null);
+      await registry.executeCommand('health', provider, {
+        filter,
+        connectivity: options.connectivity
+      });
+    } catch (error) {
+      console.error(chalk.red('❌ 健康检查失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Batch command
+program
+  .command('batch <operation>')
+  .description('批量操作供应商 (operations: update, delete)')
+  .option('--codex', '仅操作 Codex CLI 供应商')
+  .option('--claude', '仅操作 Claude Code 供应商')
+  .option('--unused', '仅操作长期未使用的供应商 (90天以上)')
+  .action(async (operation, options) => {
+    try {
+      const filter = options.codex ? 'codex' : (options.claude ? 'claude' : null);
+      await registry.executeCommand('batch', operation, {
+        filter,
+        unused: options.unused
+      });
+    } catch (error) {
+      console.error(chalk.red('❌ 批量操作失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Benchmark command
+program
+  .command('benchmark')
+  .description('供应商性能测试和对比')
+  .option('--codex', '仅测试 Codex CLI 供应商')
+  .option('--claude', '仅测试 Claude Code 供应商')
+  .option('-r, --rounds <number>', '每个供应商测试轮数', '3')
+  .option('-p, --parallel', '并行测试（更快但可能不准确）')
+  .option('--report [file]', '生成 Markdown 测试报告')
+  .action(async (options) => {
+    try {
+      const filter = options.codex ? 'codex' : (options.claude ? 'claude' : null);
+      const rounds = parseInt(options.rounds, 10);
+      await registry.executeCommand('benchmark', {
+        filter,
+        rounds,
+        parallel: options.parallel,
+        report: options.report
+      });
+    } catch (error) {
+      console.error(chalk.red('❌ 性能测试失败:'), error.message);
+      process.exit(1);
+    }
+  });
+
 // Parse arguments
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikecode/api-key-manager",
-  "version": "1.0.38",
+  "version": "1.0.42",
   "description": "A CLI tool for managing and switching multiple API provider configurations",
   "main": "src/index.js",
   "bin": {
@@ -16,6 +16,10 @@
     "start": "node bin/akm.js",
     "dev": "nodemon bin/akm.js",
     "test": "jest",
+    "lint": "eslint src/**/*.js tests/**/*.js",
+    "lint:fix": "eslint src/**/*.js tests/**/*.js --fix",
+    "format": "prettier --write \"src/**/*.js\" \"tests/**/*.js\"",
+    "format:check": "prettier --check \"src/**/*.js\" \"tests/**/*.js\"",
     "build": "echo 'No build needed'",
     "prepare": "echo 'Preparing package'",
     "prepublishOnly": "npm test",
@@ -53,17 +57,20 @@
   },
   "homepage": "https://github.com/pikecode/api-key-manager#readme",
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.67.0",
+    "@anthropic-ai/sdk": "0.71.2",
     "chalk": "^4.1.2",
-    "commander": "^9.4.1",
+    "commander": "14.0.2",
     "cross-spawn": "^7.0.3",
     "fs-extra": "^11.1.1",
     "inquirer": "^8.2.6",
     "supports-color": "^9.4.0"
   },
   "devDependencies": {
-    "jest": "^29.7.0",
-    "nodemon": "^3.0.1"
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "jest": "30.2.0",
+    "nodemon": "^3.0.1",
+    "prettier": "^3.8.1"
   },
   "engines": {
     "node": ">=14.0.0"

package/src/CommandRegistry.js

@@ -86,4 +86,29 @@ registry.registerLazy('backup', async () => {
   return backupCommand;
 });
 
+registry.registerLazy('validate', async () => {
+  const { validateCommand } = require('./commands/validate');
+  return validateCommand;
+});
+
+registry.registerLazy('stats', async () => {
+  const { statsCommand } = require('./commands/stats');
+  return statsCommand;
+});
+
+registry.registerLazy('health', async () => {
+  const { healthCommand } = require('./commands/health');
+  return healthCommand;
+});
+
+registry.registerLazy('batch', async () => {
+  const { batchCommand } = require('./commands/batch');
+  return batchCommand;
+});
+
+registry.registerLazy('benchmark', async () => {
+  const { benchmarkCommand } = require('./commands/benchmark');
+  return benchmarkCommand;
+});
+
 module.exports = { CommandRegistry, registry };

package/src/commands/BaseCommand.js

@@ -57,17 +57,38 @@ if (InputPrompt && !InputPrompt.prototype.__allowEmptyPatched) {
 
 const ESC_CANCELLED_ERROR_CODE = 'ESC_CANCELLED';
 
+/**
+ * 命令基类
+ * 提供所有命令的通用功能，包括 ESC 键处理、提示交互等
+ */
 class BaseCommand {
+  /**
+   * 创建命令实例
+   * @param {Object} [options={}] - 配置选项
+   * @param {NodeJS.ReadStream} [options.input] - 输入流
+   */
   constructor(options = {}) {
     const input = options.input || process.stdin;
+    /** @type {EscNavigationManager} ESC 键管理器 */
     this.escManager = new EscNavigationManager(input);
+    /** @type {Object|null} 当前活动的提示 */
     this.activePrompt = null;
   }
 
+  /**
+   * 检查错误是否为 ESC 取消错误
+   * @param {Error} error - 错误对象
+   * @returns {boolean} 是否为 ESC 取消
+   */
   isEscCancelled(error) {
     return Boolean(error && error.code === ESC_CANCELLED_ERROR_CODE);
   }
 
+  /**
+   * 显示交互式提示
+   * @param {Array|Object} questions - Inquirer 问题配置
+   * @returns {Promise<Object>} 用户答案
+   */
   async prompt(questions) {
     const promptPromise = inquirer.prompt(questions);
     let settled = false;
@@ -204,6 +225,52 @@ class BaseCommand {
     }
   }
 
+  /**
+   * 带 ESC 监听的 prompt 执行
+   * 自动处理 ESC 监听器的创建、移除和错误处理
+   * @param {Array} questions - inquirer 问卷配置
+   * @param {string} escMessage - ESC 返回信息
+   * @param {Function} escCallback - ESC 按下时的回调函数
+   * @returns {Promise<Object>} - prompt 答案
+   */
+  async promptWithESC(questions, escMessage, escCallback) {
+    const escListener = this.createESCListener(escCallback, escMessage);
+    try {
+      return await this.prompt(questions);
+    } catch (error) {
+      if (this.isEscCancelled(error)) {
+        this.removeESCListener(escListener);
+        throw error;
+      }
+      throw error;
+    } finally {
+      this.removeESCListener(escListener);
+    }
+  }
+
+  /**
+   * 带 ESC 监听的 prompt 执行，支持返回默认值
+   * @param {Array} questions - inquirer 问卷配置
+   * @param {string} escMessage - ESC 返回信息
+   * @param {Function} escCallback - ESC 按下时的回调函数
+   * @param {*} escReturnValue - ESC 按下时返回的值
+   * @returns {Promise<Object|*>} - prompt 答案或 escReturnValue
+   */
+  async promptWithESCAndDefault(questions, escMessage, escCallback, escReturnValue) {
+    const escListener = this.createESCListener(escCallback, escMessage);
+    try {
+      return await this.prompt(questions);
+    } catch (error) {
+      if (this.isEscCancelled(error)) {
+        this.removeESCListener(escListener);
+        return escReturnValue;
+      }
+      throw error;
+    } finally {
+      this.removeESCListener(escListener);
+    }
+  }
+
   destroy() {
     this.cleanupAllListeners();
   }