ai-account-switch 1.3.0 → 1.4.1

package/README_ZH.md

@@ -11,7 +11,15 @@
 - **项目级配置**：每个项目可以使用不同的账户
 - **智能目录检测**：在项目的任何子目录中都能工作（类似 git）
 - **Claude Code 集成**：自动生成 `.claude/settings.local.json` 配置文件
-- **安全存储**：账户凭证仅存储在本地
+- **Web UI 管理界面**：
+  - 🎨 现代化单页面应用,支持深色/浅色主题
+  - 🌍 中英文双语支持,一键切换
+  - ⚙️ 可视化管理账号:增删改查一目了然
+  - 📤 导入/导出功能:批量管理账号配置
+  - 🔍 实时搜索过滤账号
+  - 💾 自定义环境变量配置
+  - 🎯 主题自动跟随系统设置
+- **安全存储**:账户凭证仅存储在本地
 - **交互式命令行**：所有操作都有易用的交互式提示
 - **多种账户类型**：支持 Claude、Codex 和其他 AI 服务
 
@@ -214,6 +222,7 @@ npm link
 | `ais paths` | - | 显示配置文件路径 |
 | `ais doctor` | - | 诊断 Claude Code 配置问题 |
 | `ais export <name>` | - | 导出账户为 JSON 格式 |
+| `ais ui` | - | 启动 Web UI 管理界面 |
 | `ais help` | - | 显示帮助信息 |
 | `ais --version` | - | 显示版本号 |
 
@@ -237,7 +246,6 @@ ais add my-claude-account
 - 账户类型（Claude、Codex、其他）
 - API Key
 - API URL（可选）
-- Organization ID（可选）
 - Email（可选）
 - 描述（可选）
 - 自定义环境变量（可选）
@@ -272,6 +280,7 @@ ais use
 ```
 
 **注意**：此命令会自动生成 `.claude/settings.local.json` 文件用于 Claude Code CLI 集成。
+如果检测到当前项目是 Git 仓库，还会自动将配置文件添加到 `.gitignore` 中，避免将敏感信息提交到版本控制。
 你可以在项目的任何子目录中运行此命令 - 它会自动找到项目根目录。
 
 #### 4. 查看当前项目信息
@@ -290,7 +299,40 @@ ais current
 
 **注意**：这些命令可以在项目的任何子目录中使用，类似 git 命令的工作方式。
 
-#### 5. 删除账户
+#### 5. 使用 Web UI 管理界面
+
+启动可视化管理界面:
+
+```bash
+ais ui
+```
+
+这将在浏览器中打开 Web UI,服务器会自动使用一个随机的高位端口(49152-65535)。如果端口被占用,会自动尝试其他端口,提供以下功能:
+
+**界面特性:**
+- **账号管理**: 可视化的卡片界面,显示所有账号信息
+- **添加/编辑账号**: 友好的表单界面,支持所有配置项
+- **删除账号**: 一键删除,带确认提示
+- **搜索过滤**: 实时搜索账号名称、邮箱或类型
+- **批量操作**:
+  - 导出所有账号为 JSON 文件
+  - 从 JSON 文件导入账号(支持覆盖选项)
+- **主题切换**:
+  - iOS 风格的 Switch 开关
+  - 支持浅色和深色主题
+  - 默认跟随系统主题设置
+- **多语言支持**:
+  - 中文/英文一键切换
+  - 界面默认使用中文
+  - 语言设置自动保存
+
+**UI 使用提示:**
+- 所有修改实时同步到本地配置
+- 关闭浏览器窗口不影响数据
+- 按 `Ctrl+C` 停止 Web 服务器
+- 支持在任何浏览器中使用
+
+#### 6. 删除账户
 
 删除不再需要的账户：
 
@@ -361,7 +403,6 @@ ais export my-claude-account
   "env": {
     "ANTHROPIC_AUTH_TOKEN": "your-api-key",
     "ANTHROPIC_BASE_URL": "your-api-url",
-    "ANTHROPIC_ORGANIZATION_ID": "your-org-id",
     "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
   },
   "permissions": {
@@ -469,7 +510,10 @@ ais use correct-account
 
 - API 密钥仅存储在本地机器上
 - 全局配置文件包含敏感凭证
-- 始终将 `.ais-project-config` 添加到 `.gitignore`
+- `ais use` 命令会自动将配置文件添加到 `.gitignore` (如果项目是 Git 仓库)
+- 始终验证 `.gitignore` 包含以下文件：
+  - `.ais-project-config`
+  - `.claude/settings.local.json`
 - 切勿将账户凭证提交到版本控制
 - 显示 API 密钥时会进行掩码处理（仅显示前 4 位和后 4 位字符）
 
@@ -581,6 +625,26 @@ MIT License - 欢迎在你的项目中使用此工具！
 
 ## 更新日志
 
+### v1.4.0
+- **添加 Web UI 管理界面**：
+  - 现代化单页面应用，支持深色/浅色主题
+  - 中英文双语支持，默认中文
+  - 可视化账号管理：增删改查一目了然
+  - 导入/导出功能：批量管理账号配置
+  - 实时搜索过滤账号
+  - 自定义环境变量配置
+  - 主题自动跟随系统设置
+  - iOS 风格的主题切换开关
+- **端口优化**：
+  - UI 服务器使用随机高位端口（49152-65535）
+  - 自动检测端口冲突并重试
+- **界面改进**：
+  - 修复账号卡片按钮位置不一致问题
+  - 按钮始终固定在卡片底部
+- **移除组织 ID 配置**：
+  - 简化账号配置流程
+  - 移除 CLI 和 UI 中的组织 ID 选项
+
 ### v1.3.0
 - **改进自定义环境变量输入**：
   - 支持单行 `KEY=VALUE` 格式输入（例如：`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`）

package/package.json

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

package/src/commands.js

@@ -59,12 +59,6 @@ async function addAccount(name, options) {
       message: 'Enter API URL (optional):',
       default: ''
     },
-    {
-      type: 'input',
-      name: 'organizationId',
-      message: 'Enter Organization ID (optional):',
-      default: ''
-    },
     {
       type: 'input',
       name: 'email',
@@ -252,9 +246,19 @@ async function useAccount(name) {
 
   const success = config.setProjectAccount(name);
   if (success) {
+    const fs = require('fs');
+    const path = require('path');
+
     console.log(chalk.green(`✓ Switched to account '${name}' for current project.`));
     console.log(chalk.yellow(`Project: ${process.cwd()}`));
     console.log(chalk.cyan(`✓ Claude configuration generated at: .claude/settings.local.json`));
+
+    // Check if .gitignore was updated
+    const gitignorePath = path.join(process.cwd(), '.gitignore');
+    const gitDir = path.join(process.cwd(), '.git');
+    if (fs.existsSync(gitDir) && fs.existsSync(gitignorePath)) {
+      console.log(chalk.cyan(`✓ Updated .gitignore to exclude AIS configuration files`));
+    }
   } else {
     console.log(chalk.red('✗ Failed to set account.'));
   }
@@ -278,7 +282,6 @@ function showInfo() {
   console.log(`${chalk.cyan('Type:')} ${projectAccount.type}`);
   console.log(`${chalk.cyan('API Key:')} ${maskApiKey(projectAccount.apiKey)}`);
   if (projectAccount.apiUrl) console.log(`${chalk.cyan('API URL:')} ${projectAccount.apiUrl}`);
-  if (projectAccount.organizationId) console.log(`${chalk.cyan('Organization ID:')} ${projectAccount.organizationId}`);
   if (projectAccount.email) console.log(`${chalk.cyan('Email:')} ${projectAccount.email}`);
   if (projectAccount.description) console.log(`${chalk.cyan('Description:')} ${projectAccount.description}`);
   if (projectAccount.customEnv && Object.keys(projectAccount.customEnv).length > 0) {
@@ -473,10 +476,6 @@ function doctor() {
       if (claudeConfig.env && claudeConfig.env.ANTHROPIC_BASE_URL) {
         console.log(`   API URL: ${claudeConfig.env.ANTHROPIC_BASE_URL}`);
       }
-
-      if (claudeConfig.env && claudeConfig.env.ANTHROPIC_ORGANIZATION_ID) {
-        console.log(`   Org ID: ${claudeConfig.env.ANTHROPIC_ORGANIZATION_ID}`);
-      }
     } catch (e) {
       console.log(chalk.red(`   ✗ Error reading Claude config: ${e.message}`));
     }
@@ -532,6 +531,17 @@ function doctor() {
   console.log('');
 }
 
+/**
+ * Start Web UI server
+ */
+function startUI() {
+  const UIServer = require('./ui-server');
+  const server = new UIServer();
+
+  console.log(chalk.cyan('\n🌐 Starting AIS Web UI...\n'));
+  server.start();
+}
+
 module.exports = {
   addAccount,
   listAccounts,
@@ -541,5 +551,6 @@ module.exports = {
   showCurrent,
   showPaths,
   exportAccount,
-  doctor
+  doctor,
+  startUI
 };

package/src/config.js

@@ -145,6 +145,78 @@ class ConfigManager {
     // Generate Claude Code project-level configuration
     this.generateClaudeConfig(account, projectRoot);
 
+    // Add to .gitignore if git is initialized
+    this.addToGitignore(projectRoot);
+
+    return true;
+  }
+
+  /**
+   * Add AIS config files to .gitignore if git repository exists
+   */
+  addToGitignore(projectRoot = process.cwd()) {
+    const gitDir = path.join(projectRoot, '.git');
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+
+    // Check if this is a git repository
+    if (!fs.existsSync(gitDir)) {
+      return false;
+    }
+
+    // Files to add to .gitignore
+    const filesToIgnore = [
+      this.projectConfigFilename,
+      '.claude/settings.local.json'
+    ];
+
+    let gitignoreContent = '';
+    let needsUpdate = false;
+
+    // Read existing .gitignore if it exists
+    if (fs.existsSync(gitignorePath)) {
+      gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
+    }
+
+    // Split into lines for easier processing
+    const lines = gitignoreContent.split('\n');
+    const existingEntries = new Set(lines.map(line => line.trim()));
+
+    // Check which files need to be added
+    const entriesToAdd = [];
+    for (const file of filesToIgnore) {
+      if (!existingEntries.has(file)) {
+        entriesToAdd.push(file);
+        needsUpdate = true;
+      }
+    }
+
+    if (!needsUpdate) {
+      return false;
+    }
+
+    // Add AIS section header if adding new entries
+    let newContent = gitignoreContent;
+
+    // Ensure file ends with newline if it has content
+    if (newContent.length > 0 && !newContent.endsWith('\n')) {
+      newContent += '\n';
+    }
+
+    // Add section header and entries
+    if (entriesToAdd.length > 0) {
+      // Add blank line before section if file has content
+      if (newContent.length > 0) {
+        newContent += '\n';
+      }
+
+      newContent += '# AIS (AI Account Switch) - Local configuration files\n';
+      entriesToAdd.forEach(entry => {
+        newContent += entry + '\n';
+      });
+    }
+
+    // Write updated .gitignore
+    fs.writeFileSync(gitignorePath, newContent, 'utf8');
     return true;
   }
 
@@ -186,11 +258,6 @@ class ConfigManager {
       claudeConfig.env.ANTHROPIC_BASE_URL = account.apiUrl;
     }
 
-    // Add organization ID if specified
-    if (account.organizationId) {
-      claudeConfig.env.ANTHROPIC_ORGANIZATION_ID = account.organizationId;
-    }
-
     // Add custom environment variables if specified
     if (account.customEnv && typeof account.customEnv === 'object') {
       Object.keys(account.customEnv).forEach(key => {

package/src/index.js

@@ -11,7 +11,8 @@ const {
   showCurrent,
   showPaths,
   exportAccount,
-  doctor
+  doctor,
+  startUI
 } = require('./commands');
 
 // Package info
@@ -78,6 +79,12 @@ program
   .description('Diagnose Claude Code configuration issues')
   .action(doctor);
 
+// Web UI command
+program
+  .command('ui')
+  .description('Start web-based account manager UI')
+  .action(startUI);
+
 // Help command
 program
   .command('help')
@@ -97,6 +104,7 @@ program
     console.log('  paths            Show configuration file paths');
     console.log('  doctor           Diagnose Claude Code configuration issues');
     console.log('  export <name>    Export account as JSON');
+    console.log('  ui               Start web-based account manager UI');
     console.log('  help             Display this help message');
     console.log('  version          Show version number\n');
 
@@ -115,6 +123,8 @@ program
     console.log('  ais doctor\n');
     console.log(chalk.gray('  # Remove an account'));
     console.log('  ais remove my-old-account\n');
+    console.log(chalk.gray('  # Start web UI for managing accounts'));
+    console.log('  ais ui\n');
 
     console.log(chalk.bold('FEATURES:'));
     console.log('  • Custom environment variables support');