github/cc-switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-23 09:29:13 +08:00
Code Issues Packages Projects Releases Wiki Activity

fix(docs): align user manual with v3.10.3 codebase

Browse Source 
- Add OpenCode as 4th supported app throughout all docs
- Fix proxy default port 15762 → 15721
- Update Claude presets (9 → 26), Codex (3 → 10), Gemini (3 → 7)
- Add OpenCode presets (25 entries)
- Fix timeout defaults and ranges (stream first byte 60s/90s, etc.)
- Fix circuit breaker defaults with per-app values (Claude vs general)
- Fix Skills support: all 4 apps, not just Claude/Codex
- Remove non-existent Gemini authMode field
- Fix prompt deletion behavior: enabled prompts cannot be deleted
- Remove non-existent Legacy deeplink protocol, use V1 only
- Fix DB table names (usage_logs → proxy_request_logs) and add missing tables
- Fix migration version v3.8.0 → v3.7.0
- Add missing V1 deeplink parameters (config, configFormat, etc.)
- Update doc version v3.9.1 → v3.10.3
- Add claude-opus-4-1 to pricing table
- Fix recovery wait time range 10-300 → 0-300
This commit is contained in:
Jason
2026-02-09 14:57:57 +08:00
parent 11cc4e815b
commit e612410deb
14 changed files with 219 additions and 176 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/user-manual/4-proxy/4.1-service.md
View File

@@ -36,7 +36,7 @@
| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 监听地址 | 代理绑定的 IP 地址 | `127.0.0.1` |
| 监听端口 | 代理监听的端口 | `15762` |
| 监听端口 | 代理监听的端口 | `15721` |
| 启用日志 | 是否记录请求日志 | 开启 |
### 修改配置
@@ -62,7 +62,7 @@
### 服务地址
```
http://127.0.0.1:15762
http://127.0.0.1:15721
```
点击「复制」按钮可复制地址。
@@ -135,19 +135,19 @@ sequenceDiagram
```json
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:15762"
"ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
}
}
```
**Codex**：
```toml
base_url = "http://127.0.0.1:15762/v1"
base_url = "http://127.0.0.1:15721/v1"
```
**Gemini**：
```
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15762
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721
```
## 停止代理
@@ -181,7 +181,7 @@ GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15762
| 字段 | 说明 |
|------|------|
| 时间 | 请求时间 |
| 应用 | Claude/Codex/Gemini |
| 应用 | Claude/Codex/Gemini/OpenCode |
| 供应商 | 使用的供应商 |
| 模型 | 请求的模型 |
| Token | 输入/输出 token 数 |

9
docs/user-manual/4-proxy/4.2-takeover.md
View File

@@ -32,6 +32,7 @@
| Claude 接管 | 接管 Claude Code 的请求 |
| Codex 接管 | 接管 Codex 的请求 |
| Gemini 接管 | 接管 Gemini CLI 的请求 |
| OpenCode 接管 | 接管 OpenCode 的请求 |
可以同时开启多个应用的接管。
@@ -54,7 +55,7 @@
// 接管后
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:"
"ANTHROPIC_BASE_URL": "http://127.0.0.1:15721"
}
}
```
@@ -66,7 +67,7 @@
base_url = "https://api.openai.com/v1"
# 接管后
base_url = "http://127.0.0.1:5000/v1"
base_url = "http://127.0.0.1:15721/v1"
```
**Gemini 配置变更**：
@@ -76,14 +77,14 @@ base_url = "http://127.0.0.1:5000/v1"
GOOGLE_GEMINI_BASE_URL=https://generativelanguage.googleapis.com
# 接管后
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:5000
GOOGLE_GEMINI_BASE_URL=http://127.0.0.1:15721
```
### 请求转发
代理收到请求后：
1. 识别请求来源（Claude/Codex/Gemini）
1. 识别请求来源（Claude/Codex/Gemini/OpenCode）
2. 查找该应用当前启用的供应商
3. 将请求转发到供应商的实际端点
4. 记录请求日志

39
docs/user-manual/4-proxy/4.3-failover.md
View File

@@ -26,10 +26,11 @@
### 选择应用
页面顶部有三个 Tab：
页面顶部有四个 Tab：
- Claude
- Codex
- Gemini
- OpenCode
选择要配置的应用。
@@ -104,27 +105,33 @@ graph TD
### 配置项
| 配置 | 说明 | 默认值 | 范围 |
|------|------|--------|------|
| 失败阈值 | 连续失败多少次触发熔断 | 5 | 1-20 |
| 恢复成功阈值 | 半开状态下成功多少次后关闭熔断器 | 2 | 1-10 |
| 恢复等待时间 | 熔断后多久尝试恢复（秒） | 60 | 10-300 |
| 错误率阈值 | 错误率超过此值时打开熔断器 | 50% | 0-100% |
| 最小请求数 | 计算错误率前的最小请求数 | 10 | 5-100 |
不同应用有独立的默认配置。以下为通用默认值，Claude 有独立的宽松配置。
| 配置 | 说明 | 通用默认值 | Claude 默认值 | 范围 |
|------|------|--------|--------|------|
| 失败阈值 | 连续失败多少次触发熔断 | 4 | 8 | 1-20 |
| 恢复成功阈值 | 半开状态下成功多少次后关闭熔断器 | 2 | 3 | 1-10 |
| 恢复等待时间 | 熔断后多久尝试恢复（秒） | 60 | 90 | 0-300 |
| 错误率阈值 | 错误率超过此值时打开熔断器 | 60% | 70% | 0-100% |
| 最小请求数 | 计算错误率前的最小请求数 | 10 | 15 | 5-100 |
> 💡 Claude 由于请求耗时较长，默认配置更为宽松，容忍更多失败次数。
### 超时配置
| 配置 | 说明 | 默认值 | 范围 |
|------|------|--------|------|
| 流式首字节超时 | 等待首个数据块的最大时间（秒） | 30 | 0-180 |
| 流式静默超时 | 数据块之间的最大间隔（秒） | 60 | 0-600 |
| 非流式超时 | 非流式请求的总超时时间（秒） | 300 | 0-1800 |
| 配置 | 说明 | 通用默认值 | Claude 默认值 | 范围 |
|------|------|--------|--------|------|
| 流式首字节超时 | 等待首个数据块的最大时间（秒） | 60 | 90 | 1-120 |
| 流式静默超时 | 数据块之间的最大间隔（秒） | 120 | 180 | 60-600（填 0 禁用） |
| 非流式超时 | 非流式请求的总超时时间（秒） | 600 | 600 | 60-1200 |
### 重试配置
| 配置 | 说明 | 默认值 | 范围 |
|------|------|--------|------|
| 最大重试次数 | 请求失败时的重试次数 | 3 | 0-10 |
| 配置 | 说明 | 通用默认值 | Claude 默认值 | 范围 |
|------|------|--------|--------|------|
| 最大重试次数 | 请求失败时的重试次数 | 3 | 6 | 0-10 |
> 💡 Gemini 的默认最大重试次数为 5。
### 熔断状态

3
docs/user-manual/4-proxy/4.4-usage.md
View File

@@ -123,7 +123,7 @@
| 筛选项 | 选项 |
|--------|------|
| 应用类型 | 全部 / Claude / Codex / Gemini |
| 应用类型 | 全部 / Claude / Codex / Gemini / OpenCode |
| 状态码 | 全部 / 200 / 400 / 401 / 429 / 500 |
| 供应商 | 文本搜索 |
| 模型 | 文本搜索 |
@@ -208,6 +208,7 @@ CC Switch 预设了常用模型的官方价格（每百万 Token）：
| claude-haiku-4-5 | $1 | $5 | $0.10 | $1.25 |
| **Claude 4 系列** | | | | |
| claude-opus-4 | $15 | $75 | $1.50 | $18.75 |
| claude-opus-4-1 | $15 | $75 | $1.50 | $18.75 |
| claude-sonnet-4 | $3 | $15 | $0.30 | $3.75 |
| **Claude 3.5 系列** | | | | |
| claude-3-5-sonnet | $3 | $15 | $0.30 | $3.75 |