ai-account-switch 1.5.7 → 1.6.0

package/README.md

@@ -13,7 +13,8 @@ A cross-platform CLI tool to manage and switch between Claude/Codex/Droids accou
 - **Claude Code Integration**: Automatically generates `.claude/settings.local.json` for Claude Code CLI
 - **Secure Storage**: Account credentials stored locally in your home directory
 - **Interactive CLI**: Easy-to-use interactive prompts for all operations
-- **Account Types**: Support for Claude, Codex, Droids, and other AI services
+- **Account Types**: Support for Claude, Codex, CCR (Claude Code Router), Droids, and other AI services
+- **Web UI**: Modern web interface with account status checking and management
 
 ## Installation
 
@@ -92,7 +93,7 @@ ais add my-claude-account
 ```
 
 You'll be prompted to enter:
-- Account type (Claude, Codex, Other)
+- Account type (Claude, Codex, CCR, Droids, Other)
 - API Key
 - API URL (optional)
 - Organization ID (optional)
@@ -329,6 +330,163 @@ grep -A 10 "$(cat .codex-profile)" ~/.codex/config.toml
 ais doctor
 ```
 
+### CCR (Claude Code Router) Integration
+
+[Claude Code Router](https://github.com/musistudio/claude-code-router) is a powerful routing layer for Claude Code that allows you to use multiple AI providers and models seamlessly.
+
+When you add a **CCR** type account and run `ais use`, the tool automatically:
+1. Updates `~/.claude-code-router/config.json` with Provider and Router configuration
+2. Generates `.claude/settings.local.json` pointing to the local CCR Router
+3. Automatically restarts CCR Router to apply changes
+
+**Prerequisites:**
+- Install Claude Code Router: `npm install -g @musistudio/claude-code-router`
+- Start CCR Router: `ccr start`
+
+#### Adding a CCR Account
+
+When adding a CCR account, you'll see helpful configuration tips:
+
+```bash
+ais add my-ccr-account
+
+? Select account type: CCR
+
+📝 CCR Configuration Tips:
+   • CCR configuration will be stored in ~/.claude-code-router/config.json
+   • You need to provide Provider name and models
+   • Router configuration will be automatically updated
+
+? Enter API Key: sk-xxx...
+? Enter API URL: http://localhost:3000/v1/chat/completions
+? Enter Provider name: Local-new-api
+? Enter default model: gemini-2.5-flash
+? Enter background model: gemini-2.5-flash
+? Enter think model: gemini-2.5-pro
+```
+
+**Important Notes:**
+- Default API URL is `http://localhost:3000/v1/chat/completions`
+- You need to specify three models: default, background, and think
+- Models are automatically deduplicated in the Provider configuration
+
+#### Using CCR with Your Project
+
+After running `ais use` with a CCR account:
+
+```bash
+cd ~/my-project
+ais use my-ccr-account
+
+# Output:
+# ✓ Switched to account 'my-ccr-account' for current project.
+# 🔄 Restarting CCR Router...
+# ✓ CCR Router restarted successfully
+# ✓ CCR configuration updated at: ~/.claude-code-router/config.json
+# ✓ Claude configuration generated at: .claude/settings.local.json
+#
+# 📖 Next Steps:
+#    Start interactive session: claude
+#    This will enter project-level interactive mode
+#    Claude Code will use CCR Router to route requests
+```
+
+The tool:
+1. **Updates CCR Config**: Adds/updates Provider in `~/.claude-code-router/config.json`
+2. **Updates Router**: Sets default, background, and think models
+3. **Generates Claude Config**: Creates `.claude/settings.local.json` with `ANTHROPIC_BASE_URL` pointing to CCR Router
+4. **Restarts CCR**: Automatically runs `ccr restart` to apply changes
+
+#### Running Claude with CCR
+
+Start Claude interactive session:
+
+```bash
+# In your project directory
+claude
+
+# Claude Code will automatically use CCR Router
+# Requests are routed based on your CCR configuration
+```
+
+#### CCR Configuration Structure
+
+The generated configuration in `~/.claude-code-router/config.json`:
+
+```json
+{
+  "PORT": 3456,
+  "Providers": [
+    {
+      "api_base_url": "http://localhost:3000/v1/chat/completions",
+      "api_key": "sk-xxx...",
+      "models": ["gemini-2.5-flash", "gemini-2.5-pro"],
+      "name": "Local-new-api"
+    }
+  ],
+  "Router": {
+    "default": "Local-new-api,gemini-2.5-flash",
+    "background": "Local-new-api,gemini-2.5-flash",
+    "think": "Local-new-api,gemini-2.5-pro"
+  }
+}
+```
+
+The generated configuration in `.claude/settings.local.json`:
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456"
+  }
+}
+```
+
+#### Switching Between Projects
+
+Each project can use a different CCR configuration:
+
+```bash
+# Project A
+cd ~/project-a
+ais use ccr-account-1
+claude
+
+# Project B
+cd ~/project-b
+ais use ccr-account-2
+claude
+```
+
+#### Troubleshooting CCR
+
+**Check CCR Configuration**
+```bash
+# View your CCR configuration
+cat ~/.claude-code-router/config.json
+
+# View Claude configuration
+cat .claude/settings.local.json
+
+# Or use the doctor command
+ais doctor
+```
+
+**CCR Router not installed**
+- Install from npm: `npm install -g @musistudio/claude-code-router`
+- Visit the project page: https://github.com/musistudio/claude-code-router
+
+**CCR Router not restarting**
+- Make sure CCR CLI is installed and available in your PATH
+- Run `ccr restart` manually if automatic restart fails
+- Check if CCR Router is running: `ccr status`
+
+**Claude not using CCR Router**
+- Verify `ANTHROPIC_BASE_URL` in `.claude/settings.local.json` points to correct port
+- Check CCR Router is running on the configured port
+- Restart Claude Code after configuration changes
+
 ### Droids Integration
 
 When you add a **Droids** type account and run `ais use`, the tool automatically creates a configuration file at `.droids/config.json` in your project directory.
@@ -531,8 +689,16 @@ ais paths
 
 ## Requirements
 
-- Node.js >= 14.0.0
-- npm >= 6.0.0
+- **Node.js**: >= 16.0.0
+- **npm**: >= 7.0.0
+
+**Note**: This tool requires Node.js version 16 or higher (due to commander@11.x dependency). You can check your current version with:
+```bash
+node --version
+npm --version
+```
+
+If you need to upgrade Node.js, visit [nodejs.org](https://nodejs.org/) or use a version manager like [nvm](https://github.com/nvm-sh/nvm).
 
 ## Project Structure
 
@@ -622,6 +788,33 @@ MIT License - feel free to use this tool in your projects!
 
 ## Changelog
 
+### v1.6.0
+- **CCR (Claude Code Router) Integration**:
+  - Added full support for Claude Code Router
+  - Automatic generation of `~/.claude-code-router/config.json` configuration
+  - Provider and Router configuration management
+  - Automatic CCR Router restart after configuration changes
+  - Claude Code integration with local CCR Router endpoint
+  - Support for default, background, and think model routing
+- **Web UI Enhancements**:
+  - Added account status checking with color-coded indicators (green: available, orange: unstable, red: unavailable)
+  - Status results are saved and displayed on page load
+  - Real-time status checking with "状态检查" button
+  - Improved account card layout with status in top-right corner
+  - Enhanced visual feedback during status checks
+- **Configuration Improvements**:
+  - CCR accounts automatically generate both CCR and Claude configurations
+  - Dynamic port reading from CCR config for Claude integration
+  - Better error handling and user feedback
+
+### v1.5.8
+- **Bilingual Support (双语支持)**:
+  - All CLI commands now display both English and Chinese text (所有 CLI 命令现在同时显示中英文)
+  - Help messages, prompts, and output messages are bilingual (帮助信息、提示和输出消息都支持双语)
+  - Better user experience for Chinese-speaking users (为中文用户提供更好的使用体验)
+  - No configuration needed - works out of the box (无需配置 - 开箱即用)
+  - Uses parentheses format for better clarity: `English text (中文)` (使用括号格式更清晰)
+
 ### v1.5.7
 - **Droids Integration**:
   - Added full support for Droids AI assistant

package/README_ZH.md

@@ -21,7 +21,7 @@
   - 🎯 主题自动跟随系统设置
 - **安全存储**:账户凭证仅存储在本地
 - **交互式命令行**：所有操作都有易用的交互式提示
-- **多种账户类型**：支持 Claude、Codex、Droids 和其他 AI 服务
+- **多种账户类型**：支持 Claude、Codex、CCR (Claude Code Router)、Droids 和其他 AI 服务
 
 ## 安装
 
@@ -100,7 +100,7 @@ ais add my-claude-account
 ```
 
 系统将提示你输入：
-- 账户类型（Claude、Codex、其他）
+- 账户类型（Claude、Codex、CCR、Droids、其他）
 - API Key
 - API URL（可选）
 - Email（可选）
@@ -384,6 +384,163 @@ grep -A 10 "$(cat .codex-profile)" ~/.codex/config.toml
 ais doctor
 ```
 
+### CCR (Claude Code Router) 集成
+
+[Claude Code Router](https://github.com/musistudio/claude-code-router) 是一个强大的 Claude Code 路由层，允许你无缝使用多个 AI 提供商和模型。
+
+当你添加 **CCR** 类型账户并运行 `ais use` 时，工具会自动：
+1. 更新 `~/.claude-code-router/config.json` 中的 Provider 和 Router 配置
+2. 生成指向本地 CCR Router 的 `.claude/settings.local.json`
+3. 自动重启 CCR Router 以应用更改
+
+**前提条件：**
+- 安装 Claude Code Router：`npm install -g @musistudio/claude-code-router`
+- 启动 CCR Router：`ccr start`
+
+#### 添加 CCR 账户
+
+添加 CCR 账户时，你会看到有用的配置提示：
+
+```bash
+ais add my-ccr-account
+
+? Select account type: CCR
+
+📝 CCR Configuration Tips:
+   • CCR configuration will be stored in ~/.claude-code-router/config.json
+   • You need to provide Provider name and models
+   • Router configuration will be automatically updated
+
+? Enter API Key: sk-xxx...
+? Enter API URL: http://localhost:3000/v1/chat/completions
+? Enter Provider name: Local-new-api
+? Enter default model: gemini-2.5-flash
+? Enter background model: gemini-2.5-flash
+? Enter think model: gemini-2.5-pro
+```
+
+**重要说明：**
+- 默认 API URL 是 `http://localhost:3000/v1/chat/completions`
+- 你需要指定三个模型：default、background 和 think
+- 模型会在 Provider 配置中自动去重
+
+#### 在项目中使用 CCR
+
+使用 CCR 账户运行 `ais use` 后：
+
+```bash
+cd ~/my-project
+ais use my-ccr-account
+
+# 输出：
+# ✓ Switched to account 'my-ccr-account' for current project.
+# 🔄 Restarting CCR Router...
+# ✓ CCR Router restarted successfully
+# ✓ CCR configuration updated at: ~/.claude-code-router/config.json
+# ✓ Claude configuration generated at: .claude/settings.local.json
+#
+# 📖 Next Steps:
+#    Start interactive session: claude
+#    This will enter project-level interactive mode
+#    Claude Code will use CCR Router to route requests
+```
+
+工具会：
+1. **更新 CCR 配置**：在 `~/.claude-code-router/config.json` 中添加/更新 Provider
+2. **更新 Router**：设置 default、background 和 think 模型
+3. **生成 Claude 配置**：创建 `.claude/settings.local.json`，`ANTHROPIC_BASE_URL` 指向 CCR Router
+4. **重启 CCR**：自动运行 `ccr restart` 以应用更改
+
+#### 使用 CCR 运行 Claude
+
+启动 Claude 交互会话：
+
+```bash
+# 在项目目录中
+claude
+
+# Claude Code 会自动使用 CCR Router
+# 请求会根据你的 CCR 配置进行路由
+```
+
+#### CCR 配置结构
+
+在 `~/.claude-code-router/config.json` 中生成的配置：
+
+```json
+{
+  "PORT": 3456,
+  "Providers": [
+    {
+      "api_base_url": "http://localhost:3000/v1/chat/completions",
+      "api_key": "sk-xxx...",
+      "models": ["gemini-2.5-flash", "gemini-2.5-pro"],
+      "name": "Local-new-api"
+    }
+  ],
+  "Router": {
+    "default": "Local-new-api,gemini-2.5-flash",
+    "background": "Local-new-api,gemini-2.5-flash",
+    "think": "Local-new-api,gemini-2.5-pro"
+  }
+}
+```
+
+在 `.claude/settings.local.json` 中生成的配置：
+
+```json
+{
+  "env": {
+    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
+    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3456"
+  }
+}
+```
+
+#### 在不同项目间切换
+
+每个项目可以使用不同的 CCR 配置：
+
+```bash
+# 项目 A
+cd ~/project-a
+ais use ccr-account-1
+claude
+
+# 项目 B
+cd ~/project-b
+ais use ccr-account-2
+claude
+```
+
+#### CCR 故障排除
+
+**检查 CCR 配置**
+```bash
+# 查看你的 CCR 配置
+cat ~/.claude-code-router/config.json
+
+# 查看 Claude 配置
+cat .claude/settings.local.json
+
+# 或使用 doctor 命令
+ais doctor
+```
+
+**CCR Router 未安装**
+- 从 npm 安装：`npm install -g @musistudio/claude-code-router`
+- 访问项目页面：https://github.com/musistudio/claude-code-router
+
+**CCR Router 未重启**
+- 确保 CCR CLI 已安装并在 PATH 中可用
+- 如果自动重启失败，手动运行 `ccr restart`
+- 检查 CCR Router 是否运行：`ccr status`
+
+**Claude 未使用 CCR Router**
+- 验证 `.claude/settings.local.json` 中的 `ANTHROPIC_BASE_URL` 指向正确的端口
+- 检查 CCR Router 是否在配置的端口上运行
+- 配置更改后重启 Claude Code
+
 ### Droids 集成
 
 当你添加 **Droids** 类型账户并运行 `ais use` 时，工具会自动在项目目录中创建 `.droids/config.json` 配置文件。
@@ -601,8 +758,16 @@ ais use correct-account
 
 ## 系统要求
 
-- Node.js >= 14.0.0
-- npm >= 6.0.0
+- **Node.js**: >= 16.0.0
+- **npm**: >= 7.0.0
+
+**注意**: 此工具需要 Node.js 16 或更高版本（因为 commander@11.x 依赖要求）。你可以使用以下命令检查当前版本:
+```bash
+node --version
+npm --version
+```
+
+如果需要升级 Node.js，请访问 [nodejs.org](https://nodejs.org/) 或使用版本管理器如 [nvm](https://github.com/nvm-sh/nvm)。
 
 ## 项目结构
 
@@ -699,6 +864,25 @@ MIT License - 欢迎在你的项目中使用此工具！
 
 ## 更新日志
 
+### v1.6.0
+- **CCR (Claude Code Router) 集成**：
+  - 完整支持 Claude Code Router
+  - 自动生成 `~/.claude-code-router/config.json` 配置
+  - Provider 和 Router 配置管理
+  - 配置更改后自动重启 CCR Router
+  - Claude Code 与本地 CCR Router 端点集成
+  - 支持 default、background 和 think 模型路由
+- **Web UI 增强**：
+  - 添加账户状态检查，带颜色指示器（绿色：可用，橙色：不稳定，红色：不可用）
+  - 状态结果会保存并在页面加载时显示
+  - 实时状态检查，带"状态检查"按钮
+  - 改进账户卡片布局，状态显示在右上角
+  - 状态检查期间增强视觉反馈
+- **配置改进**：
+  - CCR 账户自动生成 CCR 和 Claude 两种配置
+  - 从 CCR 配置动态读取端口用于 Claude 集成
+  - 更好的错误处理和用户反馈
+
 ### v1.5.7
 - **Droids 集成**：
   - 完整支持 Droids AI 助手

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-account-switch",
-  "version": "1.5.7",
+  "version": "1.6.0",
   "description": "A cross-platform CLI tool to manage and switch Claude/Codex/Droids account configurations",
   "main": "src/index.js",
   "bin": {
@@ -33,7 +33,7 @@
     "inquirer": "^8.2.5"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=16.0.0"
   },
   "repository": {
     "type": "git",

package/src/commands/README.md

@@ -0,0 +1,124 @@
+# Commands 模块说明
+
+## 目录结构
+
+```
+commands/
+├── README.md      # 本文件 - 模块说明
+├── helpers.js     # ✅ 辅助函数 (maskApiKey, validateAccount)
+├── account.js     # ⏳ 账号管理命令
+├── model.js       # ⏳ 模型组管理命令
+├── utility.js     # ⏳ 工具类命令
+└── index.js       # ⏳ 统一导出接口
+```
+
+## 模块职责
+
+### helpers.js ✅
+**辅助函数** - 所有模块共用的工具函数
+
+- `maskApiKey(apiKey)` - API密钥遮罩显示
+- `validateAccount(apiKey, apiUrl)` - 验证账号有效性
+
+### account.js
+**账号管理** - 处理账号的 CRUD 操作
+
+- `addAccount(name, options)` - 添加新账号
+- `listAccounts()` - 列出所有账号
+- `useAccount(name)` - 切换到指定账号
+- `showInfo()` - 显示当前项目账号信息
+- `removeAccount(name)` - 删除账号
+- `showCurrent()` - 显示当前账号名称
+- `exportAccount(name)` - 导出账号配置
+- `promptForModelGroup()` - 模型组配置提示（内部使用）
+
+### model.js
+**模型组管理** - 管理 Claude 账号的模型组配置
+
+- `listModelGroups()` - 列出模型组
+- `addModelGroup(name)` - 添加模型组
+- `useModelGroup(name)` - 切换模型组
+- `removeModelGroup(name)` - 删除模型组
+- `showModelGroup(name)` - 显示模型组详情
+
+### utility.js
+**工具类命令** - 诊断和辅助功能
+
+- `showPaths()` - 显示配置文件路径
+- `doctor()` - 诊断配置问题
+- `startUI()` - 启动 Web UI 管理界面
+
+### index.js
+**统一导出** - 导出所有命令供主程序使用
+
+```javascript
+module.exports = {
+  // Account commands
+  addAccount,
+  listAccounts,
+  useAccount,
+  showInfo,
+  removeAccount,
+  showCurrent,
+  exportAccount,
+
+  // Model commands
+  listModelGroups,
+  addModelGroup,
+  useModelGroup,
+  removeModelGroup,
+  showModelGroup,
+
+  // Utility commands
+  showPaths,
+  doctor,
+  startUI
+};
+```
+
+## 依赖关系
+
+```
+index.js (主入口)
+    ↓
+commands/index.js (命令导出)
+    ↓
+├─ account.js → helpers.js
+├─ model.js → helpers.js
+└─ utility.js → helpers.js
+```
+
+## 迁移状态
+
+✅ **重构已完成！** (2025-10-24)
+
+- [x] helpers.js - 辅助函数模块
+- [x] account.js - 账号管理模块
+- [x] model.js - 模型组管理模块
+- [x] utility.js - 工具类模块
+- [x] index.js - 统一导出
+- [x] 更新 src/index.js 引用 (已兼容)
+- [x] 测试所有命令功能
+- [x] 备份原文件 (src/commands.js → src/commands.js.bak)
+
+## 优势
+
+1. **模块化** - 每个文件职责单一，代码清晰
+2. **可维护** - 修改某个功能只需关注对应模块
+3. **可测试** - 独立模块易于编写单元测试
+4. **可扩展** - 新增功能只需添加新模块或扩展现有模块
+
+## 使用方式
+
+```javascript
+// 旧方式 (src/commands.js)
+const { addAccount, listAccounts } = require('./commands');
+
+// 新方式 (src/commands/index.js)
+const { addAccount, listAccounts } = require('./commands');
+// 或
+const commands = require('./commands');
+commands.addAccount();
+```
+
+接口保持不变，只是内部实现变成模块化。