ai-account-switch 1.7.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.7.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

@@ -1,6 +1,7 @@
 const chalk = require("chalk");
 const inquirer = require("inquirer");
 const ConfigManager = require("../config");
+const { WIRE_API_MODES, DEFAULT_WIRE_API, ACCOUNT_TYPES } = require("../config");
 const { maskApiKey } = require("./helpers");
 const { promptForModelGroup } = require("./model");
 
@@ -53,6 +54,9 @@ async function addAccount(name, options) {
         },
     ]);
 
+    // Store wire_api selection for Codex accounts
+    let wireApiSelection = null;
+
     // Show configuration tips based on account type
     if (typeAnswer.type === "Codex") {
         console.log(
@@ -83,6 +87,44 @@ async function addAccount(name, options) {
                 "   • Codex uses OpenAI-compatible API format (Codex 使用 OpenAI 兼容的 API 格式)\n"
             )
         );
+
+        // Prompt for wire_api mode selection
+        const wireApiAnswer = await inquirer.prompt([
+            {
+                type: "list",
+                name: "wireApi",
+                message: "Select wire_api mode (请选择 wire_api 模式):",
+                choices: [
+                    {
+                        name: "chat - Use API key in HTTP headers (OpenAI-compatible) (在 HTTP 头中使用 API key,OpenAI 兼容)",
+                        value: WIRE_API_MODES.CHAT
+                    },
+                    {
+                        name: "responses - Use API key in auth.json (requires_openai_auth) (在 auth.json 中使用 API key)",
+                        value: WIRE_API_MODES.RESPONSES
+                    }
+                ],
+                default: DEFAULT_WIRE_API
+            }
+        ]);
+
+        wireApiSelection = wireApiAnswer.wireApi;
+
+        // Validate input
+        if (!Object.values(WIRE_API_MODES).includes(wireApiSelection)) {
+            console.log(
+                chalk.yellow(
+                    `⚠ Invalid wire_api mode, using default: ${DEFAULT_WIRE_API} (无效的模式，使用默认值)`
+                )
+            );
+            wireApiSelection = DEFAULT_WIRE_API;
+        }
+
+        console.log(
+            chalk.cyan(
+                `\n✓ Selected wire_api mode (已选择模式): ${wireApiSelection}\n`
+            )
+        );
     } else if (typeAnswer.type === "Droids") {
         console.log(
             chalk.cyan("\n📝 Droids Configuration Tips (Droids 配置提示):")
@@ -165,6 +207,11 @@ async function addAccount(name, options) {
     // Merge type into accountData
     accountData.type = typeAnswer.type;
 
+    // Add wire_api selection for Codex accounts
+    if (typeAnswer.type === "Codex" && wireApiSelection) {
+        accountData.wireApi = wireApiSelection;
+    }
+
     // Handle custom environment variables
     if (accountData.addCustomEnv) {
         accountData.customEnv = {};
@@ -454,6 +501,27 @@ async function addAccount(name, options) {
             )
         );
         console.log(chalk.cyan(`   ais use ${name}\n`));
+
+        // Show wire_api mode specific information
+        if (accountData.wireApi === WIRE_API_MODES.RESPONSES) {
+            console.log(
+                chalk.yellow(
+                    "   ⚠ Note: This account uses 'responses' mode (此账号使用 'responses' 模式)"
+                )
+            );
+            console.log(
+                chalk.white(
+                    "   Your API key will be stored in ~/.codex/auth.json (API key 将存储在 ~/.codex/auth.json)\n"
+                )
+            );
+        } else {
+            console.log(
+                chalk.cyan(
+                    "   ✓ This account uses 'chat' mode (此账号使用 'chat' 模式)\n"
+                )
+            );
+        }
+
         console.log(
             chalk.white(
                 "2. Use Codex with the generated profile (使用生成的配置文件运行 Codex):"
@@ -555,13 +623,17 @@ 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}`);
         if (account.email) console.log(`   Email: ${account.email}`);
         if (account.description)
             console.log(`   Description: ${account.description}`);
@@ -589,6 +661,11 @@ function listAccounts() {
         ) {
             console.log(`   Model: ${account.model}`);
         }
+        // Display wire_api configuration for Codex accounts
+        if (account.type === ACCOUNT_TYPES.CODEX) {
+            const wireApi = account.wireApi || `${DEFAULT_WIRE_API} (default)`;
+            console.log(`   Wire API: ${wireApi}`);
+        }
         console.log(
             `   Created: ${new Date(account.createdAt).toLocaleString()}`
         );
@@ -613,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);
 
@@ -628,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(
@@ -652,6 +740,7 @@ async function useAccount(name) {
         return;
     }
 
+    const name = accountInfo.name;
     const success = config.setProjectAccount(name);
     if (success) {
         const fs = require("fs");
@@ -688,6 +777,27 @@ async function useAccount(name) {
                         `✓ Codex profile created (Codex 配置文件已创建): ${profileName}`
                     )
                 );
+
+                // Display wire_api mode information
+                if (account.wireApi === WIRE_API_MODES.RESPONSES) {
+                    console.log(
+                        chalk.yellow(
+                            `✓ Wire API mode: ${WIRE_API_MODES.RESPONSES} (使用 ${WIRE_API_MODES.RESPONSES} 模式)`
+                        )
+                    );
+                    console.log(
+                        chalk.yellow(
+                            `✓ API key stored in ~/.codex/auth.json (API key 已存储在 ~/.codex/auth.json)`
+                        )
+                    );
+                } else {
+                    console.log(
+                        chalk.cyan(
+                            `✓ Wire API mode: ${WIRE_API_MODES.CHAT} (使用 ${WIRE_API_MODES.CHAT} 模式)`
+                        )
+                    );
+                }
+
                 console.log("");
                 console.log(chalk.bold.cyan("📖 Next Steps (下一步):"));
                 console.log(
@@ -825,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
@@ -878,6 +989,10 @@ function showInfo() {
     ) {
         console.log(`${chalk.cyan("Model:")} ${projectAccount.model}`);
     }
+    // Display wire_api configuration for Codex accounts
+    if (projectAccount.type === ACCOUNT_TYPES.CODEX && projectAccount.wireApi) {
+        console.log(`${chalk.cyan("Wire API:")} ${projectAccount.wireApi}`);
+    }
     console.log(
         `${chalk.cyan("Set At:")} ${new Date(
             projectAccount.setAt
@@ -890,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);
 
@@ -900,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,
         },
     ]);
@@ -970,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

@@ -2,6 +2,22 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+// Constants for wire API modes
+const WIRE_API_MODES = {
+  CHAT: 'chat',
+  RESPONSES: 'responses'
+};
+
+const DEFAULT_WIRE_API = WIRE_API_MODES.CHAT;
+
+// Constants for account types
+const ACCOUNT_TYPES = {
+  CLAUDE: 'Claude',
+  CODEX: 'Codex',
+  CCR: 'CCR',
+  DROIDS: 'Droids'
+};
+
 /**
  * Cross-platform configuration manager
  * Stores global accounts in user home directory
@@ -30,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();
   }
 
   /**
@@ -66,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 };
     }
   }
 
@@ -79,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;
   }
@@ -587,11 +679,26 @@ class ConfigManager {
         profileConfig += `base_url = "${baseUrl}"\n`;
       }
 
-      // Determine wire_api: use "chat" for most APIs (OpenAI-compatible)
-      profileConfig += `wire_api = "chat"\n`;
-
-      // Add authentication header
-      profileConfig += `http_headers = { "Authorization" = "Bearer ${account.apiKey}" }\n`;
+      // Determine wire_api based on account configuration (default to chat for backward compatibility)
+      const wireApi = account.wireApi || DEFAULT_WIRE_API;
+
+      if (wireApi === WIRE_API_MODES.CHAT) {
+        // Chat mode: use HTTP headers for authentication
+        profileConfig += `wire_api = "${WIRE_API_MODES.CHAT}"\n`;
+        profileConfig += `http_headers = { "Authorization" = "Bearer ${account.apiKey}" }\n`;
+
+        // Note: We do NOT clear auth.json here because:
+        // 1. auth.json is a global file shared by all projects
+        // 2. Other projects may be using responses mode and need the API key
+        // 3. Chat mode doesn't use auth.json anyway, so no conflict exists
+      } else if (wireApi === WIRE_API_MODES.RESPONSES) {
+        // Responses mode: use auth.json for authentication
+        profileConfig += `wire_api = "${WIRE_API_MODES.RESPONSES}"\n`;
+        profileConfig += `requires_openai_auth = true\n`;
+
+        // Update auth.json with API key
+        this.updateCodexAuthJson(account.apiKey);
+      }
     }
 
     // Remove all old profiles with the same name (including duplicates)
@@ -620,6 +727,146 @@ class ConfigManager {
     fs.writeFileSync(helperScript, profileName, 'utf8');
   }
 
+  /**
+   * Read auth.json file
+   * @private
+   * @returns {Object} Parsed auth data or empty object
+   */
+  _readAuthJson(authJsonFile) {
+    if (!fs.existsSync(authJsonFile)) {
+      return {};
+    }
+
+    try {
+      const content = fs.readFileSync(authJsonFile, 'utf8');
+      return JSON.parse(content);
+    } catch (parseError) {
+      const chalk = require('chalk');
+      console.warn(
+        chalk.yellow(
+          `⚠ Warning: Could not parse existing auth.json, will create new file (警告: 无法解析现有 auth.json，将创建新文件)`
+        )
+      );
+      return {};
+    }
+  }
+
+  /**
+   * Write auth.json file atomically with proper permissions
+   * Uses atomic write (temp file + rename) to prevent corruption from concurrent access
+   * @private
+   * @param {string} authJsonFile - Path to auth.json
+   * @param {Object} authData - Auth data to write
+   */
+  _writeAuthJson(authJsonFile, authData) {
+    const chalk = require('chalk');
+    const tempFile = `${authJsonFile}.tmp.${process.pid}`;
+
+    try {
+      // Write to temporary file first (atomic operation)
+      fs.writeFileSync(tempFile, JSON.stringify(authData, null, 2), 'utf8');
+
+      // Set file permissions to 600 (owner read/write only) for security
+      if (process.platform !== 'win32') {
+        fs.chmodSync(tempFile, 0o600);
+      }
+
+      // Atomically rename temp file to actual file
+      // This is atomic on POSIX systems and prevents corruption
+      fs.renameSync(tempFile, authJsonFile);
+    } catch (error) {
+      // Clean up temp file if it exists
+      if (fs.existsSync(tempFile)) {
+        try {
+          fs.unlinkSync(tempFile);
+        } catch (cleanupError) {
+          // Ignore cleanup errors
+        }
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * Clear OPENAI_API_KEY in ~/.codex/auth.json for chat mode
+   * @deprecated This method is no longer called automatically.
+   * Chat mode doesn't require clearing auth.json since it doesn't use it.
+   */
+  clearCodexAuthJson() {
+    const chalk = require('chalk');
+    const codexDir = path.join(os.homedir(), '.codex');
+    const authJsonFile = path.join(codexDir, 'auth.json');
+
+    try {
+      // Ensure .codex directory exists
+      if (!fs.existsSync(codexDir)) {
+        fs.mkdirSync(codexDir, { recursive: true });
+      }
+
+      // Read existing auth data
+      const authData = this._readAuthJson(authJsonFile);
+
+      // Clear OPENAI_API_KEY (set to empty string)
+      authData.OPENAI_API_KEY = "";
+
+      // Write atomically with proper permissions
+      this._writeAuthJson(authJsonFile, authData);
+
+      console.log(
+        chalk.cyan(
+          `✓ Cleared OPENAI_API_KEY in auth.json (chat mode) (已清空 auth.json 中的 OPENAI_API_KEY)`
+        )
+      );
+    } catch (error) {
+      console.error(
+        chalk.yellow(
+          `⚠ Warning: Failed to clear auth.json: ${error.message} (警告: 清空 auth.json 失败)`
+        )
+      );
+      // Don't throw error, just warn - this is not critical for chat mode
+    }
+  }
+
+  /**
+   * Update ~/.codex/auth.json with API key for responses mode
+   * @param {string} apiKey - API key to store in auth.json
+   * @throws {Error} If file operations fail
+   */
+  updateCodexAuthJson(apiKey) {
+    const chalk = require('chalk');
+    const codexDir = path.join(os.homedir(), '.codex');
+    const authJsonFile = path.join(codexDir, 'auth.json');
+
+    try {
+      // Ensure .codex directory exists
+      if (!fs.existsSync(codexDir)) {
+        fs.mkdirSync(codexDir, { recursive: true });
+      }
+
+      // Read existing auth data
+      const authData = this._readAuthJson(authJsonFile);
+
+      // Update OPENAI_API_KEY
+      authData.OPENAI_API_KEY = apiKey;
+
+      // Write atomically with proper permissions
+      this._writeAuthJson(authJsonFile, authData);
+
+      console.log(
+        chalk.green(
+          `✓ Updated auth.json at: ${authJsonFile} (已更新 auth.json)`
+        )
+      );
+    } catch (error) {
+      console.error(
+        chalk.red(
+          `✗ Failed to update auth.json: ${error.message} (更新 auth.json 失败)`
+        )
+      );
+      throw error;
+    }
+  }
+
   /**
    * Get current project's active account
    * Searches upwards from current directory to find project root
@@ -1160,3 +1407,6 @@ class ConfigManager {
 }
 
 module.exports = ConfigManager;
+module.exports.WIRE_API_MODES = WIRE_API_MODES;
+module.exports.DEFAULT_WIRE_API = DEFAULT_WIRE_API;
+module.exports.ACCOUNT_TYPES = ACCOUNT_TYPES;

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');
 

package/src/ui-server.js

@@ -2,6 +2,7 @@ const http = require('http');
 const path = require('path');
 const fs = require('fs');
 const ConfigManager = require('./config');
+const { WIRE_API_MODES, DEFAULT_WIRE_API } = require('./config');
 
 class UIServer {
   constructor(port = null) {
@@ -1491,6 +1492,18 @@ class UIServer {
                     <label for="apiUrl" data-i18n="apiUrl">API URL (可选)</label>
                     <input type="text" id="apiUrl" data-i18n-placeholder="apiUrlPlaceholder" placeholder="https://api.anthropic.com">
                 </div>
+                <!-- Wire API selection for Codex accounts -->
+                <div class="form-group" id="wireApiGroup" style="display: none;">
+                    <label for="wireApi">Wire API 模式</label>
+                    <select id="wireApi">
+                        <option value="chat">chat - HTTP Headers 认证 (OpenAI 兼容)</option>
+                        <option value="responses">responses - auth.json 认证 (requires_openai_auth)</option>
+                    </select>
+                    <small style="color: #666; display: block; margin-top: 5px;">
+                        chat: API key 存储在 HTTP headers 中<br>
+                        responses: API key 存储在 ~/.codex/auth.json 中
+                    </small>
+                </div>
                 <div class="form-group">
                     <label for="email" data-i18n="email">邮箱 (可选)</label>
                     <input type="email" id="email" data-i18n-placeholder="emailPlaceholder" placeholder="user@example.com">
@@ -1615,6 +1628,13 @@ class UIServer {
     </div>
 
     <script>
+        // Constants for wire API modes (injected from backend)
+        const WIRE_API_MODES = {
+            CHAT: '${WIRE_API_MODES.CHAT}',
+            RESPONSES: '${WIRE_API_MODES.RESPONSES}'
+        };
+        const DEFAULT_WIRE_API = '${DEFAULT_WIRE_API}';
+
         // i18n translations
         const translations = {
             zh: {
@@ -2021,6 +2041,12 @@ class UIServer {
                             <div class="info-value">\${data.model}</div>
                         </div>
                         \` : ''}
+                        \${data.type === 'Codex' ? \`
+                        <div class="account-info">
+                            <div class="info-label">Wire API</div>
+                            <div class="info-value">\${data.wireApi || (DEFAULT_WIRE_API + ' (default)')}</div>
+                        </div>
+                        \` : ''}
                         \${data.type === 'CCR' && data.ccrConfig ? \`
                         <div class="account-info">
                             <div class="info-label">CCR Provider</div>
@@ -2051,6 +2077,12 @@ class UIServer {
             const simpleModelGroup = document.getElementById('simpleModelGroup');
             const claudeModelGroup = document.getElementById('claudeModelGroup');
             const ccrModelGroup = document.getElementById('ccrModelGroup');
+            const wireApiGroup = document.getElementById('wireApiGroup');
+
+            // Show/hide wire_api field for Codex accounts
+            if (wireApiGroup) {
+                wireApiGroup.style.display = accountType === 'Codex' ? 'block' : 'none';
+            }
 
             if (accountType === 'Codex' || accountType === 'Droids') {
                 simpleModelGroup.style.display = 'block';
@@ -2117,6 +2149,12 @@ class UIServer {
             if (account.type === 'Codex' || account.type === 'Droids') {
                 // Load simple model field
                 document.getElementById('simpleModel').value = account.model || '';
+
+                // Load wire_api for Codex accounts
+                if (account.type === 'Codex') {
+                    document.getElementById('wireApi').value = account.wireApi || DEFAULT_WIRE_API;
+                }
+
                 // Clear model groups and CCR config
                 document.getElementById('modelGroupsList').innerHTML = '';
                 modelGroupCount = 0;
@@ -2379,6 +2417,14 @@ class UIServer {
                 if (simpleModel) {
                     accountData.model = simpleModel;
                 }
+
+                // Add wire_api for Codex accounts
+                if (accountType === 'Codex') {
+                    const wireApi = document.getElementById('wireApi').value;
+                    if (wireApi) {
+                        accountData.wireApi = wireApi;
+                    }
+                }
             } else if (accountType === 'CCR') {
                 // Collect CCR config
                 const providerName = document.getElementById('ccrProviderName').value.trim();

package/CHANGELOG-v1.7.0.md

@@ -1,176 +0,0 @@
-# Changelog v1.7.0
-
-## 🎉 Major Features
-
-### MCP (Model Context Protocol) Web UI Management
-- **Full MCP server management through Web UI**
-  - Add, edit, delete MCP servers
-  - Support for stdio, sse, and http server types
-  - Test MCP server connections
-  - Enable/disable servers per project
-  - Sync configuration to Claude Code
-  - Search and filter functionality
-  - Complete internationalization (Chinese/English)
-
-### Backend API (9 new endpoints)
-- `GET /api/mcp-servers` - Get all MCP servers
-- `POST /api/mcp-servers` - Add new MCP server
-- `PUT /api/mcp-servers/:name` - Update MCP server
-- `DELETE /api/mcp-servers/:name` - Delete MCP server
-- `POST /api/mcp-servers/:name/test` - Test connection
-- `POST /api/mcp-servers/:name/enable` - Enable for project
-- `POST /api/mcp-servers/:name/disable` - Disable for project
-- `GET /api/mcp-servers/enabled` - Get enabled servers
-- `POST /api/mcp-servers/sync` - Sync configuration
-
-### Frontend UI Enhancements
-- **Tab Navigation System**
-  - Accounts management tab
-  - MCP servers management tab
-  - Smooth tab switching with event listeners
-
-- **MCP Server Management Interface**
-  - Card-based layout matching existing design
-  - Dynamic forms based on server type
-  - Environment variables and headers support
-  - Status indicators (enabled/disabled)
-  - Real-time search and filtering
-
-## 🐛 Bug Fixes
-
-### Fixed: Account Data Not Showing
-- **Issue**: After adding tabs, account data disappeared
-- **Cause**: Incorrect HTML structure and indentation
-- **Fix**: Corrected tab div structure and proper indentation
-
-### Fixed: switchTab is not defined
-- **Issue**: JavaScript error when clicking tabs
-- **Cause**: Function defined after being used in onclick
-- **Fix**: Replaced onclick attributes with event listeners using DOMContentLoaded
-
-### Fixed: Incorrect Search Result Messages
-- **Issue**: When search has no results, showed "Add your first account" message
-- **Cause**: Did not distinguish between "no data" and "no search results"
-- **Fix**: Smart detection of filtered state vs empty state
-  - No data: Shows "Add your first..." message
-  - No search results: Shows "No matching results found"
-
-## ✨ Improvements
-
-### User Experience
-- Better error messages for search results
-- Clearer distinction between empty state and filtered state
-- Improved tab navigation with proper event handling
-- Consistent UI design across all features
-
-### Code Quality
-- Modern JavaScript practices (event listeners vs onclick)
-- Better separation of concerns
-- Improved maintainability
-- Comprehensive error handling
-
-### Internationalization
-- Complete Chinese translations for MCP features
-- Complete English translations for MCP features
-- Consistent translation keys
-
-## 📊 Testing
-
-### Automated Tests
-- 32/32 tests passing
-- Comprehensive coverage of all features
-- Verification scripts included
-
-### Manual Testing
-- Test guides provided
-- Step-by-step instructions
-- Expected results documented
-
-## 📁 New Files
-
-### Documentation
-- `MCP-UI-IMPLEMENTATION.md` - Complete implementation guide
-- `FIXED-ISSUES.md` - Detailed problem fixes
-- `SEARCH-FIX.md` - Search result fix documentation
-- `QUICK-TEST.md` - Quick testing guide
-- `TEST-NOW.md` - Immediate testing instructions
-- `CHANGELOG-v1.7.0.md` - This file
-
-### Testing
-- `verify-implementation.js` - Automated verification script
-- `test-ui.html` - Manual testing guide
-
-## 🔧 Technical Details
-
-### Modified Files
-- `src/ui-server.js` - Main implementation file
-  - Added 9 API handler methods
-  - Added MCP tab HTML structure
-  - Added MCP modal HTML
-  - Added MCP JavaScript functions
-  - Added MCP translations (zh/en)
-  - Added tab navigation CSS
-  - Fixed switchTab function placement
-  - Fixed search result messages
-
-### Code Statistics
-- Lines added: ~1500
-- API endpoints: +9
-- JavaScript functions: +15
-- Translations: +40 keys
-- Tests: 32 automated tests
-
-## 🎯 Migration Guide
-
-### For Users
-No migration needed. All existing functionality remains unchanged.
-
-### For Developers
-If you've customized the UI:
-1. Tab navigation now uses event listeners instead of onclick
-2. Search results have improved empty state handling
-3. New MCP management APIs available
-
-## 🚀 Upgrade Instructions
-
-### From v1.6.x to v1.7.0
-
-1. **Update package**:
-```bash
-npm install -g ai-account-switch@1.7.0
-```
-
-2. **Verify installation**:
-```bash
-ais --version
-# Should show: 1.7.0
-```
-
-3. **Test new features**:
-```bash
-ais ui
-# Navigate to MCP Servers tab
-```
-
-## 📝 Breaking Changes
-
-None. This is a backward-compatible release.
-
-## 🙏 Acknowledgments
-
-- Comprehensive testing and verification
-- User feedback incorporated
-- Production-ready code quality
-
-## 📚 Resources
-
-- [README.md](README.md) - Main documentation
-- [MCP-UI-IMPLEMENTATION.md](MCP-UI-IMPLEMENTATION.md) - Implementation details
-- [QUICK-TEST.md](QUICK-TEST.md) - Testing guide
-
----
-
-**Release Date**: 2025-11-12
-**Version**: 1.7.0
-**Status**: Stable
-**Tests**: 32/32 passing