feat: 新增api延迟测试与自动择优线路

Author: 4xian

README.md

@@ -2,16 +2,19 @@
 
 [English](./README_EN.md) | 中文
 
-Claude Code settings.json中key自动配置工具，方便API_KEY、AUTH_TOKEN以及多Model之间快速切换
+Claude Code settings.json中key自动配置工具，方便多个API_KEY、AUTH_TOKEN以及多Model之间快速切换
 
 ## 功能特性
 
 - 🚀 **一键切换** - 轻松在不同 Claude API 配置间切换
+- ⚡ **延迟测试** - 快速同时测试所有API配置，延迟智能排序显示
+- 🎯 **自动优选** - 自动测试并切换到延迟最低的最优配置
 - 🔒 **安全备份** - 修改前自动备份 settings.json 文件
 - 📝 **友好提示** - 详细的错误信息和操作指导
-- 🎯 **智能识别** - 自动识别当前使用的配置
+- 🧠 **智能识别** - 自动识别当前使用的配置和最优路线
 - 🛡️ **数据保护** - 敏感信息脱敏显示
 - 📄 **多格式支持** - 支持 JSON、JSON5、YAML、TOML 配置文件
+- 🔧 **数组支持** - 支持多个URL、Key、Token、Model等字段的数组配置
 
 ## 安装
 
@@ -36,25 +39,31 @@ ccapi -v
 ```bash
 例如:
 # 同时设置两个路径
-ccapi set --settings /Users/4xian/.claude/settings.json --api /Users/4xian/Desktop/api.json
+ccapi set --settings ~/.claude/settings.json --api /Users/4xian/Desktop/api.json5
 
-# 或分别设置
-ccapi set --settings /Users/4xian/.claude/settings.json
-ccapi set --api /Users/4xian/Desktop/api.json
+# 分别设置
+ccapi set --settings ~/.claude/settings.json
+ccapi set --api /Users/4xian/Desktop/api.json5
+
+# 直接在配置文件中修改路径
+在 ~/.ccapi-config.json 文件中(与.claude同级)，有存储路径的变量，直接修改即可
+  {
+    "settingsPath": "~/.claude/settings.json",
+    "apiConfigPath": "/Users/4xian/Desktop/api.json5",
+  }
 
 # 查询当前配置文件路径
 ccapi set
 ```
 
 ### 3. 自定义API配置文件格式
 
-现在支持多种配置文件格式：**JSON、JSON5、YAML、TOML**。
-
-创建一个配置文件（如 `api.json`、`api.yaml`、`api.jsonc`、`api.json5` 或 `api.toml`），格式如下：
+支持多种配置文件格式：**JSON、JSON5、YAML、TOML**
+创建一个配置文件（如 `api.json`、`api.yaml`、`api.json5` 或 `api.toml`），格式如下：
 
 **JSON 格式示例：**
 
-```json
+```json5
 {
   "openrouter": {
     "url": "https://api.openrouter.ai",
@@ -64,15 +73,12 @@ ccapi set
     "timeout": 600000,
     "tokens": 65000
   },
+  // 推荐使用数组形式，可进行多个配置
   "multiconfig": {
     "url": [
       "https://api.example1.com",
       "https://api.example2.com"
     ],
-    "key": [
-      "sk-key1-for-api1",
-      "sk-key2-for-api2"
-    ],
     "token": [
       "token1-for-auth",
       "token2-for-auth"
@@ -105,9 +111,6 @@ multiconfig:
   url:
     - "https://api.example1.com"
     - "https://api.example2.com"
-  key:
-    - "sk-key1-for-api1"
-    - "sk-key2-for-api2"
   token:
     - "token1-for-auth"
     - "token2-for-auth"
@@ -152,10 +155,6 @@ url = [
   "https://api.example1.com",
   "https://api.example2.com"
 ]
-key = [
-  "sk-key1-for-api1",
-  "sk-key2-for-api2"
-]
 token = [
   "token1-for-auth",
   "token2-for-auth"
@@ -191,7 +190,7 @@ fast = [
   - **字符串格式**: 直接指定一个快速模型
   - **数组格式**: 可指定多个快速模型，支持通过索引切换
 - `timeout`: 请求超时时间（非必需，默认为官方600000ms）
-- `tokens`: 最大输出令牌数（非必需，默认为官方）
+- `tokens`: 最大输出令牌数（非必需，默认以官方为准）
 - `http`: 为网络连接指定 HTTP 代理服务器
 - `https`: 为网络连接指定 HTTPS 代理服务器
 
@@ -262,9 +261,6 @@ ccapi use multiconfig -t 2      # 只切换到某个Token
 ccapi use multiconfig -u 1      # 只切换到某个URL
 ccapi use multiconfig -m 3      # 只切换到某个Model
 ccapi use multiconfig -f 2      # 只切换到某个Fast Model索引
-
-# 组合使用示例
-ccapi use multiconfig -u 1 -k 1 -m 1 -f 2
 ```
 
 **参数说明：**
@@ -278,6 +274,129 @@ ccapi use multiconfig -u 1 -k 1 -m 1 -f 2
 - 不指定索引时默认使用数组的第一个元素
 - 可以任意组合使用这些参数
 
+### 6. 测试API延迟
+
+#### 测试所有配置（默认并行模式）
+
+```bash
+# 并行测试（快速，推荐）
+ccapi test
+
+# 串行测试（逐一测试）
+ccapi test -s
+```
+
+#### 测试指定配置
+
+```bash
+# 并行测试指定配置
+ccapi test openrouter
+
+# 串行测试指定配置
+ccapi test -s openrouter
+```
+
+**测试模式说明：**
+
+- **并行测试（默认）**: 同时测试所有URL，速度快，结果按配置的最佳延迟排序显示
+- **串行测试（-s选项）**: 逐个测试URL，按配置分组显示
+
+**测试说明：**
+
+- **测试超时时间**：默认为5秒，可在 ~/.ccapi-config.json 文件中新增变量控制超时，如：testTimeout: 10000
+- **测试返回的结果**：默认不显示，由于厂商不同，返回结果仅供参考，返回错误不代表不能在claude code中使用，只需关注延迟时间就行，可在 ~/.ccapi-config.json 文件中新增变量是否显示结果，如：testResponse: true
+
+  ```json5
+  {
+    "settingsPath": "~/.claude/settings.json",
+    "apiConfigPath": "/Users/4xian/Desktop/api.json5",
+    "testTimeout": 5000,
+    "testResponse": false
+  }
+  ```
+
+- 对于数组格式的url，会测试所有URL地址，数组配置的url内部不会按延迟排序，保持原有的url顺序
+- 配置按最佳延迟排序，延迟最低的配置排在前面
+- 显示每个配置的最优路线（最快的URL地址）
+
+**并行测试结果示例：**
+
+```text
+测试结果(按延迟从低到高): 
+
+【xxx】(最优路线: xxx/claude)
+    1.[https://xxx/claude] ● 628ms 
+
+【multiconfig】(最优路线: api.example1.com)
+    1.[https://api.example1.com] ● 856ms 
+    2.[https://api.example2.com] ● 892ms 
+
+```
+
+### 7. 自动选择最优配置
+
+#### 基本自动选择
+
+```bash
+# 会先进行测试，然后选择最优的配置进行自动切换
+ccapi auto
+```
+
+#### 多命令配合执行
+
+```bash
+# 常用于组合命令，这样每次启动claude前都会选择最优路线
+ccapi auto && claude
+
+# 也可以自定义别名，每次使用别名启动
+alias cc=ccapi auto && claude
+cc
+```
+
+**功能说明：**
+
+- **使用并行测试**：快速同时测试所有API配置的延迟
+- **智能选择**：自动选择全局延迟最低的配置并切换
+- **注意事项**：
+  - 对于数组格式的配置，自动选择最优URL
+  - 若KEY/TOKEN为数组，则会对齐最优URL索引进行搭配，比如：最优URL为索引1，KEY/TOKEN也会选择索引1，最优URL为2，KEY/TOKEN也会选择索引2，若不想自动切换KEY/TOKEN，将其始终配为一个即可
+- **趣味搭配**：
+  - 由于自动配置的对齐规则，可以在一个配置中进行多厂商配置，比如：
+
+    ```json5
+      {
+        "aaa": {
+          "url": [
+            "https: 第一个厂商.com",
+            "https: 第二个厂商.com",
+            "https: 第三个厂商.com",
+          ],
+          "token": [
+            "第一个厂商的token",
+            "第二个厂商的token",
+            "第三个厂商的token",
+          ],
+          "model": ["xxx"]
+        },
+        "bbb": {
+          "url": [
+            "https: 第一个厂商.com",
+            "https: 第二个厂商.com",
+            "https: 第三个厂商.com",
+          ],
+          "key": [
+            "第一个厂商的key",
+            "第二个厂商的key",
+            "第三个厂商的key",
+          ],
+          "model": ["xxx"]
+        },
+      }
+    ```
+
+    - 这样自动选择第一个厂商的同时会自动选择第一个厂商的token，选择第二个厂商的同时会自动选择第二个厂商的token...
+    - 注意token类的厂商放一起，key类的厂商放一起
+
 ## 系统要求
 
 - Node.js >= 14.0.0