ai-account-switch 1.8.1 → 1.9.0

package/README.md

@@ -73,11 +73,11 @@ npm link
 | 命令 | 别名 | 描述 |
 |------|------|------|
 | `ais add [name]` | - | 添加新的账户配置 |
-| `ais list` | `ls` | 列出所有可用账户 |
-| `ais use [name]` | - | 为当前项目设置账户 |
+| `ais list` | `ls` | 列出所有可用账户（含ID） |
+| `ais use [name-or-id]` | - | 通过名称或ID为当前项目设置账户 |
 | `ais info` | - | 显示当前项目的账户信息 |
 | `ais current` | - | 显示当前账户名称 |
-| `ais remove [name]` | `rm` | 删除账户 |
+| `ais remove [name-or-id]` | `rm` | 通过名称或ID删除账户 |
 | `ais model list` | `ls` | 列出当前账户的所有模型组 |
 | `ais model add [name]` | - | 添加新的模型组 |
 | `ais model use <name>` | - | 切换到不同的模型组 |
@@ -95,7 +95,7 @@ npm link
 | `ais ui` | - | 启动 Web UI 管理界面 |
 | `ais paths` | - | 显示配置文件路径 |
 | `ais doctor` | - | 诊断 Claude Code 配置问题 |
-| `ais export <name>` | - | 导出账户为 JSON 格式 |
+| `ais export <name-or-id>` | - | 通过名称或ID导出账户为 JSON 格式 |
 | `ais help` | - | 显示帮助信息 |
 | `ais --version` | - | 显示版本号 |
 
@@ -128,7 +128,7 @@ ais add my-claude-account
 
 #### 2. 列出所有账户
 
-查看所有已配置的账户：
+查看所有已配置的账户及其ID：
 
 ```bash
 ais list
@@ -136,14 +136,33 @@ ais list
 ais ls
 ```
 
+输出示例：
+```
+📋 Available Accounts (可用账号):
+
+● [1] my-claude-account
+   Type: Claude
+   API Key: sk-a****xyz
+   ...
+
+  [2] work-codex
+   Type: Codex
+   API Key: sk-b****abc
+   ...
+```
+
 当前项目激活的账户将用绿色圆点标记。
 
 #### 3. 为当前项目切换账户
 
-设置当前项目使用的账户：
+设置当前项目使用的账户（可以使用账户名或ID）：
 
 ```bash
+# 使用账户名
 ais use my-claude-account
+
+# 或使用ID（更快捷）
+ais use 1
 ```
 
 或交互式选择：
@@ -1006,6 +1025,21 @@ MIT License - 欢迎在你的项目中使用此工具！
 
 ## 更新日志
 
+### v1.9.0
+- **账号ID功能**：
+  - 为每个账号自动分配唯一数字ID（从1开始递增）
+  - 支持通过ID快速切换账号：`ais use 1`
+  - 支持通过ID删除账号：`ais remove 2`
+  - 支持通过ID导出账号：`ais export 3`
+  - 账号列表展示格式优化：`[ID] AccountName`
+  - ID使用黄色高亮显示，更加清晰可见
+  - 完全向后兼容：已有账号自动分配ID
+  - 交互式选择账号时同时显示ID和名称
+- **文档更新**：
+  - 更新所有命令说明，添加ID使用示例
+  - 中英文README同步更新
+  - Help命令输出优化
+
 ### v1.7.0
 - **MCP Web UI 管理**：
   - 通过 Web UI 完整管理 MCP 服务器

package/README_EN.md

@@ -66,11 +66,11 @@ npm link
 | Command | Alias | Description |
 |---------|-------|-------------|
 | `ais add [name]` | - | Add a new account configuration |
-| `ais list` | `ls` | List all available accounts |
-| `ais use [name]` | - | Set account for current project |
+| `ais list` | `ls` | List all available accounts with IDs |
+| `ais use [name-or-id]` | - | Set account for current project by name or ID |
 | `ais info` | - | Show current project's account info |
 | `ais current` | - | Show current account name |
-| `ais remove [name]` | `rm` | Remove an account |
+| `ais remove [name-or-id]` | `rm` | Remove an account by name or ID |
 | `ais model list` | `ls` | List all model groups for current account |
 | `ais model add [name]` | - | Add a new model group |
 | `ais model use <name>` | - | Switch to a different model group |
@@ -88,7 +88,7 @@ npm link
 | `ais ui` | - | Start web-based UI manager |
 | `ais paths` | - | Show configuration file paths |
 | `ais doctor` | - | Diagnose configuration issues |
-| `ais export <name>` | - | Export account as JSON |
+| `ais export <name-or-id>` | - | Export account as JSON by name or ID |
 | `ais help` | - | Display help information |
 | `ais --version` | - | Show version number |
 
@@ -122,7 +122,7 @@ You'll be prompted to enter:
 
 #### 2. List All Accounts
 
-View all your configured accounts:
+View all your configured accounts with their IDs:
 
 ```bash
 ais list
@@ -130,14 +130,33 @@ ais list
 ais ls
 ```
 
+Example output:
+```
+📋 Available Accounts:
+
+● [1] my-claude-account
+   Type: Claude
+   API Key: sk-a****xyz
+   ...
+
+  [2] work-codex
+   Type: Codex
+   API Key: sk-b****abc
+   ...
+```
+
 The active account for the current project will be marked with a green dot.
 
 #### 3. Switch Account for Current Project
 
-Set which account to use in your current project:
+Set which account to use in your current project (by name or ID):
 
 ```bash
+# Use account by name
 ais use my-claude-account
+
+# Or use account by ID (faster)
+ais use 1
 ```
 
 Or select interactively:
@@ -997,6 +1016,21 @@ MIT License - feel free to use this tool in your projects!
 
 ## Changelog
 
+### v1.9.0
+- **Account ID Feature**:
+  - Automatically assign unique numeric ID to each account (starting from 1)
+  - Quick account switching by ID: `ais use 1`
+  - Remove account by ID: `ais remove 2`
+  - Export account by ID: `ais export 3`
+  - Optimized account list display format: `[ID] AccountName`
+  - ID displayed in yellow color for better visibility
+  - Fully backward compatible: existing accounts automatically assigned IDs
+  - Interactive selection shows both ID and name
+- **Documentation Updates**:
+  - Updated all command descriptions with ID usage examples
+  - Synchronized Chinese and English README
+  - Optimized help command output
+
 ### v1.7.0
 - **MCP Web UI Management**:
   - Complete MCP server management through Web UI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-account-switch",
-  "version": "1.8.1",
+  "version": "1.9.0",
   "description": "A cross-platform CLI tool to manage and switch Claude/Codex/Droids account configurations",
   "main": "src/index.js",
   "bin": {

package/src/commands/account.js

@@ -623,11 +623,14 @@ function listAccounts() {
         const account = accounts[name];
         const isActive = currentProject && currentProject.name === name;
         const marker = isActive ? chalk.green("● ") : "  ";
+
+        // Display ID and name
+        const idDisplay = chalk.yellow(`[${account.id}]`);
         const nameDisplay = isActive
             ? chalk.green.bold(name)
             : chalk.cyan(name);
 
-        console.log(`${marker}${nameDisplay}`);
+        console.log(`${marker}${idDisplay} ${nameDisplay}`);
         console.log(`   Type: ${account.type}`);
         console.log(`   API Key: ${maskApiKey(account.apiKey)}`);
         if (account.apiUrl) console.log(`   API URL: ${account.apiUrl}`);
@@ -687,9 +690,9 @@ function listAccounts() {
 /**
  * Switch to a specific account for current project
  */
-async function useAccount(name) {
-    if (!name) {
-        // If no name provided, show interactive selection
+async function useAccount(nameOrId) {
+    if (!nameOrId) {
+        // If no name/ID provided, show interactive selection
         const accounts = config.getAllAccounts();
         const accountNames = Object.keys(accounts);
 
@@ -702,21 +705,32 @@ async function useAccount(name) {
             return;
         }
 
+        // Create choices with ID and name
+        const choices = accountNames.map(name => {
+            const account = accounts[name];
+            return {
+                name: `[${account.id}] ${name}`,
+                value: name
+            };
+        });
+
         const answers = await inquirer.prompt([
             {
                 type: "list",
                 name: "accountName",
                 message: "Select an account to use (请选择要使用的账号):",
-                choices: accountNames,
+                choices: choices,
             },
         ]);
 
-        name = answers.accountName;
+        nameOrId = answers.accountName;
     }
 
-    if (!config.accountExists(name)) {
+    // Find account by ID or name
+    const accountInfo = config.getAccountByIdOrName(nameOrId);
+    if (!accountInfo) {
         console.log(
-            chalk.red(`✗ Account '${name}' not found. (未找到账号 '${name}'。)`)
+            chalk.red(`✗ Account '${nameOrId}' not found. (未找到账号 '${nameOrId}'。)`)
         );
         console.log(
             chalk.yellow(
@@ -726,6 +740,7 @@ async function useAccount(name) {
         return;
     }
 
+    const name = accountInfo.name;
     const success = config.setProjectAccount(name);
     if (success) {
         const fs = require("fs");
@@ -920,6 +935,7 @@ function showInfo() {
     console.log(
         chalk.bold("\n📌 Current Project Account Info (当前项目账号信息):\n")
     );
+    console.log(`${chalk.cyan("Account ID:")} ${chalk.yellow(`[${projectAccount.id}]`)}`);
     console.log(
         `${chalk.cyan("Account Name:")} ${chalk.green.bold(
             projectAccount.name
@@ -989,8 +1005,8 @@ function showInfo() {
 /**
  * Remove an account
  */
-async function removeAccount(name) {
-    if (!name) {
+async function removeAccount(nameOrId) {
+    if (!nameOrId) {
         const accounts = config.getAllAccounts();
         const accountNames = Object.keys(accounts);
 
@@ -999,30 +1015,43 @@ async function removeAccount(name) {
             return;
         }
 
+        // Create choices with ID and name
+        const choices = accountNames.map(name => {
+            const account = accounts[name];
+            return {
+                name: `[${account.id}] ${name}`,
+                value: name
+            };
+        });
+
         const answers = await inquirer.prompt([
             {
                 type: "list",
                 name: "accountName",
                 message: "Select an account to remove (请选择要删除的账号):",
-                choices: accountNames,
+                choices: choices,
             },
         ]);
 
-        name = answers.accountName;
+        nameOrId = answers.accountName;
     }
 
-    if (!config.accountExists(name)) {
+    // Find account by ID or name
+    const accountInfo = config.getAccountByIdOrName(nameOrId);
+    if (!accountInfo) {
         console.log(
-            chalk.red(`✗ Account '${name}' not found. (未找到账号 '${name}'。)`)
+            chalk.red(`✗ Account '${nameOrId}' not found. (未找到账号 '${nameOrId}'。)`)
         );
         return;
     }
 
+    const name = accountInfo.name;
+
     const { confirm } = await inquirer.prompt([
         {
             type: "confirm",
             name: "confirm",
-            message: `Are you sure you want to remove account '${name}'? (确定要删除账号 '${name}' 吗?)`,
+            message: `Are you sure you want to remove account '${name}' (ID: ${accountInfo.id})? (确定要删除账号 '${name}' (ID: ${accountInfo.id}) 吗?)`,
             default: false,
         },
     ]);
@@ -1069,30 +1098,34 @@ function showCurrent() {
 /**
  * Export account configuration
  */
-function exportAccount(name) {
-    if (!name) {
+function exportAccount(nameOrId) {
+    if (!nameOrId) {
         console.log(
-            chalk.red("Please specify an account name. (请指定账号名称。)")
+            chalk.red("Please specify an account name or ID. (请指定账号名称或 ID。)")
         );
         console.log(
             chalk.cyan(
-                "Usage: ais export <account-name> (用法: ais export <账号名>)"
+                "Usage: ais export <account-name-or-id> (用法: ais export <账号名或ID>)"
             )
         );
         return;
     }
 
-    const account = config.getAccount(name);
-    if (!account) {
+    // Find account by ID or name
+    const accountInfo = config.getAccountByIdOrName(nameOrId);
+    if (!accountInfo) {
         console.log(
-            chalk.red(`✗ Account '${name}' not found. (未找到账号 '${name}'。)`)
+            chalk.red(`✗ Account '${nameOrId}' not found. (未找到账号 '${nameOrId}'。)`)
         );
         return;
     }
 
+    const name = accountInfo.name;
+    const { name: _, ...account } = accountInfo; // Remove the name property from accountInfo
+
     console.log(
         chalk.bold(
-            `\n📤 Export for account '${name}' (账号 '${name}' 的导出数据):\n`
+            `\n📤 Export for account '${name}' (ID: ${account.id}) (账号 '${name}' 的导出数据):\n`
         )
     );
     console.log(JSON.stringify({ [name]: account }, null, 2));

package/src/config.js

@@ -46,8 +46,11 @@ class ConfigManager {
 
     // Create global config file if it doesn't exist
     if (!fs.existsSync(this.globalConfigFile)) {
-      this.saveGlobalConfig({ accounts: {}, mcpServers: {} });
+      this.saveGlobalConfig({ accounts: {}, mcpServers: {}, nextAccountId: 1 });
     }
+
+    // Migrate existing accounts to have IDs
+    this.migrateAccountIds();
   }
 
   /**
@@ -82,9 +85,14 @@ class ConfigManager {
   readGlobalConfig() {
     try {
       const data = fs.readFileSync(this.globalConfigFile, 'utf8');
-      return JSON.parse(data);
+      const config = JSON.parse(data);
+      // Ensure nextAccountId exists
+      if (!config.nextAccountId) {
+        config.nextAccountId = 1;
+      }
+      return config;
     } catch (error) {
-      return { accounts: {}, mcpServers: {} };
+      return { accounts: {}, mcpServers: {}, nextAccountId: 1 };
     }
   }
 
@@ -95,16 +103,84 @@ class ConfigManager {
     fs.writeFileSync(this.globalConfigFile, JSON.stringify(config, null, 2), 'utf8');
   }
 
+  /**
+   * Migrate existing accounts to have IDs
+   * This ensures backward compatibility by assigning IDs to accounts that don't have one
+   */
+  migrateAccountIds() {
+    const config = this.readGlobalConfig();
+    let needsSave = false;
+
+    // Ensure nextAccountId exists
+    if (!config.nextAccountId) {
+      config.nextAccountId = 1;
+      needsSave = true;
+    }
+
+    // Assign IDs to accounts that don't have one
+    Object.keys(config.accounts || {}).forEach(name => {
+      if (!config.accounts[name].id) {
+        config.accounts[name].id = config.nextAccountId;
+        config.nextAccountId++;
+        needsSave = true;
+      }
+    });
+
+    if (needsSave) {
+      this.saveGlobalConfig(config);
+    }
+  }
+
+  /**
+   * Get account by ID or name
+   * @param {string|number} idOrName - Account ID or name
+   * @returns {Object|null} - Account object with name property, or null if not found
+   */
+  getAccountByIdOrName(idOrName) {
+    const accounts = this.getAllAccounts();
+
+    // Try to parse as ID (number)
+    const id = parseInt(idOrName, 10);
+    if (!isNaN(id)) {
+      // Search by ID
+      for (const [name, account] of Object.entries(accounts)) {
+        if (account.id === id) {
+          return { name, ...account };
+        }
+      }
+    }
+
+    // Search by name
+    const account = accounts[idOrName];
+    if (account) {
+      return { name: idOrName, ...account };
+    }
+
+    return null;
+  }
+
   /**
    * Add or update an account
    */
   addAccount(name, accountData) {
     const config = this.readGlobalConfig();
+
+    // Assign ID for new accounts
+    const isNewAccount = !config.accounts[name];
+    const accountId = isNewAccount ? config.nextAccountId : config.accounts[name].id;
+
     config.accounts[name] = {
       ...accountData,
+      id: accountId,
       createdAt: config.accounts[name]?.createdAt || new Date().toISOString(),
       updatedAt: new Date().toISOString()
     };
+
+    // Increment nextAccountId only for new accounts
+    if (isNewAccount) {
+      config.nextAccountId++;
+    }
+
     this.saveGlobalConfig(config);
     return true;
   }

package/src/index.js

@@ -53,8 +53,8 @@ program
 
 // Use account command
 program
-  .command('use [name]')
-  .description('Set the account to use for the current project (设置当前项目使用的账号)')
+  .command('use [name-or-id]')
+  .description('Set the account to use for the current project by name or ID (通过名称或ID设置当前项目使用的账号)')
   .action(useAccount);
 
 // Show info command
@@ -65,9 +65,9 @@ program
 
 // Remove account command
 program
-  .command('remove [name]')
+  .command('remove [name-or-id]')
   .alias('rm')
-  .description('Remove an account (删除账号)')
+  .description('Remove an account by name or ID (通过名称或ID删除账号)')
   .action(removeAccount);
 
 // Show current account command
@@ -84,8 +84,8 @@ program
 
 // Export account configuration
 program
-  .command('export <name>')
-  .description('Export account configuration as JSON (导出账号配置为 JSON)')
+  .command('export <name-or-id>')
+  .description('Export account configuration as JSON by name or ID (通过名称或ID导出账号配置为 JSON)')
   .action(exportAccount);
 
 // Diagnostic command
@@ -199,36 +199,39 @@ program
     console.log('  ais <command> [options]\n');
 
     console.log(chalk.bold('COMMANDS (命令):'));
-    console.log('  add [name]       Add a new account configuration (with custom env vars) (添加新账号配置,支持自定义环境变量)');
-    console.log('  list, ls         List all available accounts (列出所有可用账号)');
-    console.log('  use [name]       Set the account for current project (设置当前项目使用的账号)');
-    console.log('  info             Show current project\'s account info (显示当前项目的账号信息)');
-    console.log('  current          Show current account name (显示当前账号名称)');
-    console.log('  remove, rm       Remove an account (删除账号)');
-    console.log('  paths            Show configuration file paths (显示配置文件路径)');
-    console.log('  doctor           Diagnose Claude Code configuration issues (诊断 Claude Code 配置问题)');
-    console.log('  export <name>    Export account as JSON (导出账号为 JSON)');
-    console.log('  ui               Start web-based account manager UI (启动基于 Web 的账号管理界面)');
-    console.log('  model            Manage model groups (管理模型组)');
-    console.log('  mcp              Manage MCP servers (管理 MCP 服务器)');
-    console.log('  help             Display this help message (显示此帮助信息)');
-    console.log('  version          Show version number (显示版本号)\n');
+    console.log('  add [name]             Add a new account configuration (with custom env vars) (添加新账号配置,支持自定义环境变量)');
+    console.log('  list, ls               List all available accounts with IDs (列出所有可用账号及其ID)');
+    console.log('  use [name-or-id]       Set the account for current project by name or ID (通过名称或ID设置当前项目使用的账号)');
+    console.log('  info                   Show current project\'s account info (显示当前项目的账号信息)');
+    console.log('  current                Show current account name (显示当前账号名称)');
+    console.log('  remove, rm [name-or-id] Remove an account by name or ID (通过名称或ID删除账号)');
+    console.log('  paths                  Show configuration file paths (显示配置文件路径)');
+    console.log('  doctor                 Diagnose Claude Code configuration issues (诊断 Claude Code 配置问题)');
+    console.log('  export <name-or-id>    Export account as JSON by name or ID (通过名称或ID导出账号为 JSON)');
+    console.log('  ui                     Start web-based account manager UI (启动基于 Web 的账号管理界面)');
+    console.log('  model                  Manage model groups (管理模型组)');
+    console.log('  mcp                    Manage MCP servers (管理 MCP 服务器)');
+    console.log('  help                   Display this help message (显示此帮助信息)');
+    console.log('  version                Show version number (显示版本号)\n');
 
     console.log(chalk.bold('EXAMPLES (示例):'));
     console.log(chalk.gray('  # Add a new account interactively (交互式添加新账号)'));
     console.log('  ais add\n');
     console.log(chalk.gray('  # Add a new account with a name (添加带名称的新账号)'));
     console.log('  ais add my-claude-account\n');
-    console.log(chalk.gray('  # List all accounts (列出所有账号)'));
+    console.log(chalk.gray('  # List all accounts with IDs (列出所有账号及其ID)'));
     console.log('  ais list\n');
-    console.log(chalk.gray('  # Use an account for current project (为当前项目使用某个账号)'));
+    console.log(chalk.gray('  # Use an account by name (通过名称使用账号)'));
     console.log('  ais use my-claude-account\n');
+    console.log(chalk.gray('  # Use an account by ID (通过ID使用账号)'));
+    console.log('  ais use 1\n');
     console.log(chalk.gray('  # Show current project info (显示当前项目信息)'));
     console.log('  ais info\n');
     console.log(chalk.gray('  # Diagnose configuration issues (诊断配置问题)'));
     console.log('  ais doctor\n');
-    console.log(chalk.gray('  # Remove an account (删除账号)'));
-    console.log('  ais remove my-old-account\n');
+    console.log(chalk.gray('  # Remove an account by name or ID (通过名称或ID删除账号)'));
+    console.log('  ais remove my-old-account');
+    console.log('  ais remove 2\n');
     console.log(chalk.gray('  # Start web UI for managing accounts (启动 Web 界面管理账号)'));
     console.log('  ais ui\n');