ai-account-switch 1.5.6 → 1.6.0

package/README_ZH.md

@@ -2,7 +2,7 @@
 
 [English](README.md) | 简体中文
 
-一个跨平台的命令行工具，用于管理和切换不同项目的 Claude/Codex 账户配置。
+一个跨平台的命令行工具，用于管理和切换不同项目的 Claude/Codex/Droids 账户配置。
 
 ## 特性
 
@@ -21,7 +21,7 @@
   - 🎯 主题自动跟随系统设置
 - **安全存储**:账户凭证仅存储在本地
 - **交互式命令行**：所有操作都有易用的交互式提示
-- **多种账户类型**：支持 Claude、Codex 和其他 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,265 @@ 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` 配置文件。
+
+#### 添加 Droids 账户
+
+添加 Droids 账户时，你会看到有用的配置提示：
+
+```bash
+ais add my-droids-account
+
+? Select account type: Droids
+
+📝 Droids Configuration Tips:
+   • Droids configuration will be stored in .droids/config.json
+   • API URL is optional (defaults to Droids default endpoint)
+   • You can configure custom models and settings
+
+? Enter API Key: sk-xxx...
+? Enter API URL (optional): https://api.example.com
+? Do you want to specify a model? (Optional) Yes
+? Enter model name: droids-model-v1
+```
+
+#### 在项目中使用 Droids
+
+使用 Droids 账户运行 `ais use` 后：
+
+```bash
+cd ~/my-project
+ais use my-droids-account
+
+# 输出：
+# ✓ Switched to account 'my-droids-account' for current project.
+# ✓ Droids configuration generated at: .droids/config.json
+#
+# 📖 Next Steps:
+#    Start interactive session: droid
+#    This will enter project-level interactive mode
+#    Droids will automatically use the configuration from .droids/config.json
+```
+
+工具会创建：
+- **项目配置**：`.droids/config.json` 包含你的账户设置
+
+#### 运行 Droids
+
+启动 Droids 交互会话：
+
+```bash
+# 在项目目录中
+droid
+
+# Droids 会自动从 .droids/config.json 加载配置
+```
+
+#### Droids 配置结构
+
+在 `.droids/config.json` 中生成的配置：
+
+```json
+{
+  "apiKey": "your-api-key",
+  "baseUrl": "https://api.example.com",
+  "model": "droids-model-v1",
+  "customSettings": {
+    "CUSTOM_VAR": "value"
+  }
+}
+```
+
+#### 在不同项目间切换
+
+每个项目可以使用不同的 Droids 账户：
+
+```bash
+# 项目 A
+cd ~/project-a
+ais use droids-account-1
+droid
+
+# 项目 B
+cd ~/project-b
+ais use droids-account-2
+droid
+```
+
+#### Droids 故障排除
+
+**检查 Droids 配置**
+```bash
+# 查看你的 Droids 配置
+cat .droids/config.json
+
+# 或使用 doctor 命令
+ais doctor
+```
+
+**Droids CLI 未找到**
+- 确保 Droids CLI 已安装并在 PATH 中可用
+- 运行 `droid --version` 验证安装
+
 #### 自定义环境变量
 
 在创建账户时可以添加自定义环境变量。在提示时，使用 `KEY=VALUE` 格式输入：
@@ -425,6 +684,9 @@ ais add work-claude
 # 添加 Codex 账户
 ais add codex-dev
 
+# 添加 Droids 账户
+ais add droids-dev
+
 # 列出所有账户
 ais list
 ```
@@ -496,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)。
 
 ## 项目结构
 
@@ -594,6 +864,47 @@ 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 助手
+  - 自动生成 `.droids/config.json` 配置文件
+  - Droids 账户的简单模型配置
+  - 交互会话命令：`droid`
+  - 增强 `ais doctor` 命令，支持 Droids 配置检测
+- **UI 增强**：
+  - 添加类型筛选下拉框，快速过滤账户
+  - 按类型为账户卡片着色（Claude: 蓝色，Codex: 紫色，Droids: 绿色，Other: 橙色）
+  - 账户卡片左侧边框颜色指示器
+  - 改进视觉层次和用户体验
+- **模型配置改进**：
+  - 为不同账户类型分离模型配置
+  - Claude: 复杂的模型组，支持多个模型设置
+  - Codex/Droids: 简单的模型字段，配置更直观
+  - 所有模型设置移至可折叠的"高级配置"区域
+- **更好的用户指引**：
+  - 增强 `ais use` 命令，提供清晰的下一步操作说明
+  - 为每个 AI 助手提供特定类型的使用示例
+  - 交互模式提示而非一次性命令示例
+
 ### v1.5.1
 - **Codex 集成增强**：
   - 完整支持 Codex CLI 的 profile 配置

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-account-switch",
-  "version": "1.5.6",
-  "description": "A cross-platform CLI tool to manage and switch Claude/Codex account configurations",
+  "version": "1.6.0",
+  "description": "A cross-platform CLI tool to manage and switch Claude/Codex/Droids account configurations",
   "main": "src/index.js",
   "bin": {
     "ais": "./bin/ais.js"
@@ -14,11 +14,13 @@
     "cli",
     "claude",
     "codex",
+    "droids",
     "account",
     "switch",
     "cross-platform",
     "claude-code",
-    "ai"
+    "ai",
+    "ai-assistant"
   ],
   "author": "deanwanghewei@gmail.comnpm view ai-account-switch",
   "license": "MIT",
@@ -31,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();
+```
+
+接口保持不变，只是内部实现变成模块化。