@wengine-ai/claude-code-router-next 2.1.17 → 2.1.19

package/README.md

@@ -92,6 +92,12 @@ npm install -g @wengine-ai/claude-code-router-next@latest && ccr restart
 
 创建并配置您的 `~/.claude-code-router/config.json` 文件。有关更多详细信息，您可以参考 `config.example.json`。
 
+> [!IMPORTANT]
+> **重要提示**：手动修改 `config.json` 配置文件（如更新 API Key、百炼 Cookie 等）后，**必须重启后台服务才能使新配置生效**。请在保存文件后，在终端运行以下命令：
+> ```shell
+> ccr restart
+> ```
+
 `config.json` 文件有几个关键部分：
 - **`PROXY_URL`** (可选): 您可以为 API 请求设置代理，例如：`"PROXY_URL": "http://127.0.0.1:7890"`。
 - **`LOG`** (可选): 您可以通过将其设置为 `true` 来启用日志记录。当设置为 `false` 时，将不会创建日志文件。默认值为 `true`。
@@ -694,13 +700,19 @@ Claude Code Router 支持**模型族映射**，将 Claude Code 的模型分级
    - `open`（失败池）→ 红色指示器，自动跳过
    - `half-open`（恢复中）→ 黄色指示器
 
-2. **失败判定**：连续 3 次失败后进入 `open` 状态
+2. **供应商主开关 (Master Toggle)**：在管理面板中，每个供应商都拥有独立的开启/关闭开关：
+   - **最高优先级**：当供应商关闭时，旗下所有模型将强制失效且不可选中，健康指示器置灰。
+   - **智能 Fallback**：若主模型路由被关闭，系统立刻发起重试并直接进入 fallback 链；若 fallback 列表中的某备用模型所对应的供应商处于关闭状态，则系统自动跳过该模型。
+   - **防冗余探测**：关闭的供应商会完全**免除**主动探测和健康恢复检查，避免无谓的网络调用和资源占用，直至开关重新开启。
+   - **智能预警提示**：如果当前设置的某项主模型路由（如 `default` 等）所属的供应商已被关闭，控制台界面会实时显示醒目的警示红字，提醒及时更换模型配置。
+
+3. **失败判定**：连续 3 次失败后进入 `open` 状态
 
-3. **拖动排序**：UI 支持拖动 fallback 模型调整优先级，排序越靠前越先尝试
+4. **拖动排序**：UI 支持拖动 fallback 模型调整优先级，排序越靠前越先尝试
 
-4. **Fallback Promotion**：当主模型失败且 fallback 成功时，临时"晋升" fallback 模型（TTL 10 分钟），后续请求直接使用晋升模型，避免重复尝试失败的主模型
+5. **Fallback Promotion**：当主模型失败且 fallback 成功时，临时"晋升" fallback 模型（TTL 10 分钟），后续请求直接使用晋升模型，避免重复尝试失败的主模型
 
-5. **自动恢复**：每 5 分钟探测失败模型，成功后恢复为 `half-open`，再成功 2 次后恢复为 `closed`
+6. **自动恢复**：每 5 分钟探测失败模型，成功后恢复为 `half-open`，再成功 2 次后恢复为 `closed`
 
 ![Provider 健康状态](/blog/images/provider-health-healthy.png)