ai-account-switch 1.5.0 → 1.5.2

package/README.md

@@ -211,7 +211,14 @@ npm link
 | `ais info` | - | Show current project's account info |
 | `ais current` | - | Show current account name |
 | `ais remove [name]` | `rm` | Remove an account |
+| `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 |
+| `ais model remove [name]` | `rm` | Remove a model group |
+| `ais model show [name]` | - | Show model group configuration |
+| `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 help` | - | Display help information |
 | `ais --version` | - | Show version number |
@@ -358,6 +365,118 @@ When you run `ais use`, the tool automatically creates `.claude/settings.local.j
 
 This ensures Claude Code CLI automatically uses the correct account for your project.
 
+### Codex Integration
+
+When you add a **Codex** type account and run `ais use`, the tool automatically creates a profile in `~/.codex/config.toml` and a `.codex-profile` file in your project directory.
+
+#### Adding a Codex Account
+
+When adding a Codex account, you'll see helpful configuration tips:
+
+```bash
+ais add my-codex-account
+
+? Select account type: Codex
+
+📝 Codex Configuration Tips:
+   • API URL should include the full path (e.g., https://api.example.com/v1)
+   • AIS will automatically add /v1 if missing
+   • Codex uses OpenAI-compatible API format
+
+? Enter API Key: sk-xxx...
+? Enter API URL (e.g., https://api.example.com or https://api.example.com/v1): https://zone.veloera.org
+```
+
+**Important Notes:**
+- AIS automatically adds `/v1` to the API URL if it's missing
+- The configuration uses `wire_api = "chat"` (OpenAI-compatible format)
+- This prevents common issues like Cloudflare 400 errors
+
+#### Using Codex with Your Project
+
+After running `ais use` with a Codex account:
+
+```bash
+cd ~/my-project
+ais use my-codex-account
+
+# Output:
+# ✓ Switched to account 'my-codex-account' for current project.
+# ✓ Codex profile created: ais_my-project
+#   Use: codex --profile ais_my-project [prompt]
+```
+
+The tool creates:
+1. **Global Profile**: `~/.codex/config.toml` with your account configuration
+2. **Project Reference**: `.codex-profile` containing the profile name
+
+#### Running Codex
+
+Use Codex with the generated profile:
+
+```bash
+# In your project directory
+codex --profile ais_my-project "your prompt here"
+
+# Or use the profile name from .codex-profile
+codex --profile $(cat .codex-profile) "your prompt"
+```
+
+#### Codex Configuration Structure
+
+The generated configuration in `~/.codex/config.toml`:
+
+```toml
+# AIS Profile for project: /path/to/your/project
+[profiles.ais_my-project]
+model_provider = "ais_my-codex-account"
+
+[model_providers.ais_my-codex-account]
+name = "ais_my-codex-account"
+base_url = "https://zone.veloera.org/v1"
+wire_api = "chat"
+http_headers = { "Authorization" = "Bearer sk-xxx..." }
+```
+
+#### Switching Between Projects
+
+Each project can use a different Codex account:
+
+```bash
+# Project A
+cd ~/project-a
+ais use codex-account-1
+codex --profile ais_project-a "implement feature X"
+
+# Project B
+cd ~/project-b
+ais use codex-account-2
+codex --profile ais_project-b "fix bug Y"
+```
+
+#### Troubleshooting Codex
+
+**Error: "duplicate key" in TOML**
+- This happens if profiles weren't cleaned up properly
+- Solution: Run `ais use <account>` again to regenerate the configuration
+
+**Error: "400 Bad Request" from Cloudflare**
+- This usually means the API URL is incorrect
+- Solution: Make sure your API URL includes `/v1` or let AIS add it automatically
+- Run `ais use <account>` to regenerate with the correct configuration
+
+**Check Codex Configuration**
+```bash
+# View your Codex profile
+cat .codex-profile
+
+# Check the configuration
+grep -A 10 "$(cat .codex-profile)" ~/.codex/config.toml
+
+# Or use the doctor command
+ais doctor
+```
+
 #### Custom Environment Variables
 
 You can add custom environment variables when creating an account. When prompted, enter them in `KEY=VALUE` format:
@@ -546,6 +665,69 @@ MIT License - feel free to use this tool in your projects!
 
 ## Changelog
 
+### v1.5.1
+- **Codex Integration Enhancements**:
+  - Added full support for Codex CLI with profile-based configuration
+  - Automatic generation of `~/.codex/config.toml` profiles for Codex accounts
+  - Project-level `.codex-profile` file for easy profile reference
+  - Smart API URL handling: automatically adds `/v1` path if missing
+  - Uses OpenAI-compatible `wire_api = "chat"` format
+  - Prevents Cloudflare 400 errors with correct configuration
+- **Improved User Experience**:
+  - Configuration tips displayed when adding Codex accounts
+  - Usage instructions shown after account creation
+  - Enhanced `ais doctor` command with Codex configuration detection
+  - Better duplicate profile cleanup in TOML files
+- **Bug Fixes**:
+  - Fixed duplicate profile key errors in Codex configuration
+  - Improved profile deletion regex patterns
+  - Separated Claude and Codex configuration generation logic
+- **Documentation**:
+  - Comprehensive Codex integration guide in README
+  - Troubleshooting section for common Codex issues
+  - Examples for multi-project Codex usage
+
+### v1.5.0
+- **Model Groups Management System**:
+  - Refactored model configuration to use flexible Model Groups
+  - Each account can have multiple model groups with different configurations
+  - Quick switching between model groups with automatic Claude config updates
+- **New CLI Commands**:
+  - `ais model list/ls` - List all model groups for current account
+  - `ais model add [name]` - Create a new model group
+  - `ais model use <name>` - Switch to a different model group
+  - `ais model remove/rm [name]` - Remove a model group
+  - `ais model show [name]` - Show model group configuration
+- **Enhancements**:
+  - Enhanced account creation workflow with model group support
+  - Web UI updated with collapsible model group management
+  - Fixed model configuration not switching when changing accounts
+  - Better color consistency in CLI output
+  - DEFAULT_MODEL auto-fills other model configs when not specified
+- **Backward Compatibility**:
+  - Maintains support for old modelConfig structure
+  - Existing accounts continue to work without migration
+
+### v1.4.0
+- **Added Web UI Management Interface**:
+  - Modern single-page application with dark/light theme support
+  - Bilingual support (English/Chinese), default English
+  - Visual account management: CRUD operations at a glance
+  - Import/Export functionality: batch manage account configurations
+  - Real-time search and filter accounts
+  - Custom environment variables configuration
+  - Theme follows system settings automatically
+  - iOS-style theme toggle switch
+- **Port Optimization**:
+  - UI server uses random high ports (49152-65535)
+  - Automatic port conflict detection and retry
+- **UI Improvements**:
+  - Fixed inconsistent button positioning in account cards
+  - Buttons now consistently fixed at card bottom
+- **Removed Organization ID**:
+  - Simplified account configuration process
+  - Removed organization ID option from CLI and UI
+
 ### v1.3.0
 - **Improved custom environment variables input**:
   - One-line `KEY=VALUE` format input (e.g., `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`)

package/README_ZH.md

@@ -219,10 +219,15 @@ npm link
 | `ais info` | - | 显示当前项目的账户信息 |
 | `ais current` | - | 显示当前账户名称 |
 | `ais remove [name]` | `rm` | 删除账户 |
+| `ais model list` | `ls` | 列出当前账户的所有模型组 |
+| `ais model add [name]` | - | 添加新的模型组 |
+| `ais model use <name>` | - | 切换到不同的模型组 |
+| `ais model remove [name]` | `rm` | 删除模型组 |
+| `ais model show [name]` | - | 显示模型组配置 |
+| `ais ui` | - | 启动 Web UI 管理界面 |
 | `ais paths` | - | 显示配置文件路径 |
 | `ais doctor` | - | 诊断 Claude Code 配置问题 |
 | `ais export <name>` | - | 导出账户为 JSON 格式 |
-| `ais ui` | - | 启动 Web UI 管理界面 |
 | `ais help` | - | 显示帮助信息 |
 | `ais --version` | - | 显示版本号 |
 
@@ -415,6 +420,118 @@ ais export my-claude-account
 
 这确保 Claude Code CLI 自动使用项目的正确账户。
 
+### Codex 集成
+
+当你添加 **Codex** 类型账户并运行 `ais use` 时，工具会自动在 `~/.codex/config.toml` 中创建 profile，并在项目目录中创建 `.codex-profile` 文件。
+
+#### 添加 Codex 账户
+
+添加 Codex 账户时，你会看到有用的配置提示：
+
+```bash
+ais add my-codex-account
+
+? Select account type: Codex
+
+📝 Codex Configuration Tips:
+   • API URL should include the full path (e.g., https://api.example.com/v1)
+   • AIS will automatically add /v1 if missing
+   • Codex uses OpenAI-compatible API format
+
+? Enter API Key: sk-xxx...
+? Enter API URL (e.g., https://api.example.com or https://api.example.com/v1): https://zone.veloera.org
+```
+
+**重要说明：**
+- AIS 会自动为 API URL 添加 `/v1` 路径（如果缺少）
+- 配置使用 `wire_api = "chat"`（OpenAI 兼容格式）
+- 这可以防止常见的 Cloudflare 400 错误
+
+#### 在项目中使用 Codex
+
+使用 Codex 账户运行 `ais use` 后：
+
+```bash
+cd ~/my-project
+ais use my-codex-account
+
+# 输出：
+# ✓ Switched to account 'my-codex-account' for current project.
+# ✓ Codex profile created: ais_my-project
+#   Use: codex --profile ais_my-project [prompt]
+```
+
+工具会创建：
+1. **全局 Profile**：`~/.codex/config.toml` 包含你的账户配置
+2. **项目引用**：`.codex-profile` 包含 profile 名称
+
+#### 运行 Codex
+
+使用生成的 profile 运行 Codex：
+
+```bash
+# 在项目目录中
+codex --profile ais_my-project "your prompt here"
+
+# 或使用 .codex-profile 中的 profile 名称
+codex --profile $(cat .codex-profile) "your prompt"
+```
+
+#### Codex 配置结构
+
+在 `~/.codex/config.toml` 中生成的配置：
+
+```toml
+# AIS Profile for project: /path/to/your/project
+[profiles.ais_my-project]
+model_provider = "ais_my-codex-account"
+
+[model_providers.ais_my-codex-account]
+name = "ais_my-codex-account"
+base_url = "https://zone.veloera.org/v1"
+wire_api = "chat"
+http_headers = { "Authorization" = "Bearer sk-xxx..." }
+```
+
+#### 在不同项目间切换
+
+每个项目可以使用不同的 Codex 账户：
+
+```bash
+# 项目 A
+cd ~/project-a
+ais use codex-account-1
+codex --profile ais_project-a "implement feature X"
+
+# 项目 B
+cd ~/project-b
+ais use codex-account-2
+codex --profile ais_project-b "fix bug Y"
+```
+
+#### Codex 故障排除
+
+**错误："duplicate key" in TOML**
+- 这是因为 profile 没有正确清理
+- 解决方案：再次运行 `ais use <account>` 重新生成配置
+
+**错误："400 Bad Request" from Cloudflare**
+- 这通常意味着 API URL 不正确
+- 解决方案：确保 API URL 包含 `/v1` 或让 AIS 自动添加
+- 运行 `ais use <account>` 使用正确的配置重新生成
+
+**检查 Codex 配置**
+```bash
+# 查看你的 Codex profile
+cat .codex-profile
+
+# 检查配置
+grep -A 10 "$(cat .codex-profile)" ~/.codex/config.toml
+
+# 或使用 doctor 命令
+ais doctor
+```
+
 #### 自定义环境变量
 
 在创建账户时可以添加自定义环境变量。在提示时，使用 `KEY=VALUE` 格式输入：
@@ -625,6 +742,49 @@ MIT License - 欢迎在你的项目中使用此工具！
 
 ## 更新日志
 
+### v1.5.1
+- **Codex 集成增强**：
+  - 完整支持 Codex CLI 的 profile 配置
+  - 自动为 Codex 账户生成 `~/.codex/config.toml` profiles
+  - 项目级 `.codex-profile` 文件方便引用 profile
+  - 智能 API URL 处理：自动添加 `/v1` 路径（如果缺少）
+  - 使用 OpenAI 兼容的 `wire_api = "chat"` 格式
+  - 通过正确配置防止 Cloudflare 400 错误
+- **用户体验改进**：
+  - 添加 Codex 账户时显示配置提示
+  - 账户创建后显示使用说明
+  - 增强 `ais doctor` 命令，支持 Codex 配置检测
+  - 改进 TOML 文件中的重复 profile 清理
+- **Bug 修复**：
+  - 修复 Codex 配置中的重复 profile key 错误
+  - 改进 profile 删除的正则表达式模式
+  - 分离 Claude 和 Codex 配置生成逻辑
+- **文档更新**：
+  - README 中添加全面的 Codex 集成指南
+  - 常见 Codex 问题的故障排除部分
+  - 多项目 Codex 使用示例
+
+### v1.5.0
+- **模型组管理系统**：
+  - 重构模型配置为灵活的模型组（Model Groups）系统
+  - 每个账户可以拥有多个不同配置的模型组
+  - 快速切换模型组，自动更新 Claude 配置
+- **新增 CLI 命令**：
+  - `ais model list/ls` - 列出当前账户的所有模型组
+  - `ais model add [name]` - 创建新的模型组
+  - `ais model use <name>` - 切换到不同的模型组
+  - `ais model remove/rm [name]` - 删除模型组
+  - `ais model show [name]` - 显示模型组配置详情
+- **功能增强**：
+  - 增强账户创建流程，支持模型组配置
+  - Web UI 更新，支持可折叠的模型组管理界面
+  - 修复切换账户时模型配置不更新的问题
+  - 优化 CLI 输出颜色一致性
+  - DEFAULT_MODEL 自动填充其他未设置的模型配置
+- **向后兼容**：
+  - 保持对旧 modelConfig 结构的支持
+  - 现有账户无需迁移即可继续使用
+
 ### v1.4.0
 - **添加 Web UI 管理界面**：
   - 现代化单页面应用，支持深色/浅色主题

package/WINDOWS_INSTALLER.md

@@ -0,0 +1,291 @@
+# Windows 安装程序优化方案
+
+## 概述
+
+为了提供更好的 Windows 用户体验，我们使用 **Inno Setup** 创建了一个专业的 Windows 安装程序。
+
+## 用户体验对比
+
+### 之前（手动安装）
+1. 下载 `ais-win.exe`
+2. 手动创建目录
+3. 移动文件到目录
+4. 手动添加到 PATH（需要打开系统设置）
+5. 重启终端
+6. 验证安装
+
+### 现在（一键安装）
+1. 下载 `ais-setup-1.5.1.exe`
+2. 双击运行
+3. 点击"下一步"几次
+4. 完成！
+
+## 安装程序特性
+
+### ✅ 自动化功能
+- **自动 PATH 配置**：安装时自动添加到用户 PATH
+- **自动卸载**：完整的卸载程序，包括 PATH 清理
+- **无需管理员权限**：安装到用户目录，普通用户即可安装
+
+### ✅ 用户友好
+- **现代化向导界面**：清晰的安装步骤
+- **多语言支持**：英文和中文界面
+- **开始菜单集成**：自动创建开始菜单项
+- **可选桌面快捷方式**：用户可选择是否创建
+
+### ✅ 专业性
+- **版本管理**：显示版本号和发布信息
+- **许可协议**：显示 MIT 许可证
+- **卸载程序**：标准的 Windows 卸载体验
+
+## 技术实现
+
+### 使用的工具
+
+**Inno Setup**
+- 免费开源的 Windows 安装程序制作工具
+- 被广泛使用（Node.js、VS Code 等都使用它）
+- 支持脚本化配置
+- 生成标准的 Windows 安装程序
+
+### 文件结构
+
+```
+installer/
+├── README.md                    # 安装程序说明
+└── windows/
+    ├── ais-setup.iss           # Inno Setup 配置脚本
+    ├── ais-icon.ico            # 应用图标（可选）
+    └── build-installer.md      # 构建说明文档
+```
+
+### 自动化构建
+
+GitHub Actions 工作流 (`.github/workflows/build-installer.yml`):
+- 在创建新 tag 时自动触发
+- 构建 Windows 可执行文件
+- 使用 Inno Setup 创建安装程序
+- 自动上传到 GitHub Releases
+
+## 构建安装程序
+
+### 前提条件
+
+1. **安装 Inno Setup**
+   - 下载：https://jrsoftware.org/isdl.php
+   - 版本：6.0 或更高
+
+2. **构建可执行文件**
+   ```bash
+   npm run build:win
+   ```
+
+### 构建方法
+
+**方法 1：使用 npm 脚本（推荐）**
+```bash
+npm run build:win-installer
+```
+
+**方法 2：使用 Inno Setup GUI**
+1. 打开 Inno Setup Compiler
+2. 打开 `installer/windows/ais-setup.iss`
+3. 点击 "Build" → "Compile"
+
+**方法 3：命令行**
+```bash
+"C:\Program Files (x86)\Inno Setup 6\ISCC.exe" installer\windows\ais-setup.iss
+```
+
+### 输出
+
+安装程序将生成在：
+```
+dist/installer/ais-setup-1.5.1.exe
+```
+
+## 安装程序功能详解
+
+### 安装过程
+
+1. **欢迎页面**
+   - 显示应用名称和版本
+   - 多语言支持
+
+2. **许可协议**
+   - 显示 MIT 许可证
+   - 用户需要接受才能继续
+
+3. **选择安装目录**
+   - 默认：`C:\Users\<username>\AppData\Local\Programs\AI Account Switch`
+   - 用户可以自定义
+
+4. **选择组件**
+   - 添加到 PATH（推荐，默认选中）
+   - 创建桌面快捷方式（可选）
+
+5. **安装**
+   - 复制文件
+   - 配置 PATH
+   - 创建快捷方式
+
+6. **完成**
+   - 显示成功消息
+   - 提示用户可以使用 `ais` 命令
+
+### 卸载过程
+
+用户可以通过以下方式卸载：
+- 开始菜单 → AI Account Switch → Uninstall
+- Windows 设置 → 应用 → AI Account Switch → 卸载
+
+卸载程序会：
+- 删除所有安装的文件
+- 从 PATH 中移除
+- 删除开始菜单项
+- 删除桌面快捷方式（如果有）
+
+## PATH 配置原理
+
+### 自动添加到 PATH
+
+安装程序使用 Pascal 脚本自动修改用户的 PATH 环境变量：
+
+```pascal
+procedure EnvAddPath(Path: string);
+var
+    Paths: string;
+begin
+    { 读取当前 PATH }
+    if not RegQueryStringValue(HKEY_CURRENT_USER, 'Environment', 'Path', Paths)
+    then Paths := '';
+
+    { 检查是否已存在 }
+    if Pos(';' + Uppercase(Path) + ';', ';' + Uppercase(Paths) + ';') > 0 then exit;
+
+    { 添加到 PATH }
+    Paths := Paths + ';'+ Path +';'
+
+    { 写入注册表 }
+    RegWriteStringValue(HKEY_CURRENT_USER, 'Environment', 'Path', Paths);
+end;
+```
+
+### 自动从 PATH 移除
+
+卸载时自动清理：
+
+```pascal
+procedure EnvRemovePath(Path: string);
+var
+    Paths: string;
+    P: Integer;
+begin
+    { 读取当前 PATH }
+    if not RegQueryStringValue(HKEY_CURRENT_USER, 'Environment', 'Path', Paths) then
+        exit;
+
+    { 查找并删除 }
+    P := Pos(';' + Uppercase(Path) + ';', ';' + Uppercase(Paths) + ';');
+    if P = 0 then exit;
+
+    Delete(Paths, P - 1, Length(Path) + 1);
+
+    { 写入注册表 }
+    RegWriteStringValue(HKEY_CURRENT_USER, 'Environment', 'Path', Paths);
+end;
+```
+
+## 自定义配置
+
+### 修改版本号
+
+编辑 `installer/windows/ais-setup.iss`:
+```iss
+#define MyAppVersion "1.5.1"  ; 修改这里
+```
+
+### 修改安装目录
+
+```iss
+DefaultDirName={autopf}\{#MyAppName}  ; 当前：Program Files
+; 或使用：
+DefaultDirName={localappdata}\Programs\{#MyAppName}  ; 用户目录
+```
+
+### 添加更多文件
+
+在 `[Files]` 部分添加：
+```iss
+[Files]
+Source: "path\to\file"; DestDir: "{app}"; Flags: ignoreversion
+```
+
+### 添加注册表项
+
+在 `[Registry]` 部分添加：
+```iss
+[Registry]
+Root: HKCU; Subkey: "Software\AIAccountSwitch"; ValueType: string; ValueName: "InstallPath"; ValueData: "{app}"
+```
+
+## 发布流程
+
+### 手动发布
+
+1. 构建安装程序：
+   ```bash
+   npm run build:win-installer
+   ```
+
+2. 测试安装程序（在干净的 Windows 机器上）
+
+3. 上传到 GitHub Releases
+
+### 自动发布
+
+1. 创建新 tag：
+   ```bash
+   git tag v1.5.1
+   git push origin v1.5.1
+   ```
+
+2. GitHub Actions 自动：
+   - 构建可执行文件
+   - 创建安装程序
+   - 上传到 Releases
+
+## 优势总结
+
+| 特性 | 手动安装 | 安装程序 |
+|------|---------|---------|
+| 安装步骤 | 6+ 步 | 3 步 |
+| PATH 配置 | 手动 | 自动 |
+| 管理员权限 | 有时需要 | 不需要 |
+| 卸载 | 手动删除 | 一键卸载 |
+| 开始菜单 | 无 | 有 |
+| 用户体验 | 复杂 | 简单 |
+| 专业性 | 低 | 高 |
+
+## 下一步
+
+1. ✅ 创建 Inno Setup 脚本
+2. ✅ 添加 GitHub Actions 工作流
+3. ✅ 更新 package.json 脚本
+4. ⏳ 创建应用图标（可选但推荐）
+5. ⏳ 在 Windows 机器上测试
+6. ⏳ 更新 README 安装说明
+7. ⏳ 发布新版本
+
+## 参考资源
+
+- [Inno Setup 官方文档](https://jrsoftware.org/ishelp/)
+- [Inno Setup 示例](https://jrsoftware.org/isinfo.php)
+- [PATH 环境变量管理](https://jrsoftware.org/ishelp/index.php?topic=setup_changesenvironment)
+
+## 支持
+
+如有问题，请查看：
+- `installer/windows/build-installer.md` - 详细构建说明
+- `installer/README.md` - 安装程序概述
+- GitHub Issues - 报告问题