cc-viewer 1.6.330 → 1.6.333

package/concepts/zh/ProxySwitch.md

@@ -13,8 +13,13 @@
 | **名称** | ✅ | 代理的显示名称，方便区分不同代理 |
 | **地址 (Base URL)** | ✅ | API 服务的基础地址（如 `https://api.example.com`），原始请求的 origin 会被替换为此地址 |
 | **API Key** | ✅ | 代理服务的 API 密钥，会替换原始请求中的认证信息 |
-| **模型** | ❌ | 代理支持的模型列表，用逗号分隔（如 `model-a, model-b`） |
-| **当前模型** | ❌ | 从模型列表中选择当前使用的模型，请求中的 `model` 字段会被替换 |
+| **ANTHROPIC_MODEL** | ❌ | 主模型。凡属于 `fable` / `mythos` 家族的模型请求都会被改写为此值 |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | 扩展：`model` 包含 `opus` 的请求会被改写为此值 |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | 扩展：`model` 包含 `sonnet` 的请求会被改写为此值 |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | 扩展：`model` 包含 `haiku` 的请求会被改写为此值 |
+| **强度等级** | ❌ | 向请求体注入 `output_config.effort`（`low`/`medium`/`high`/`xhigh`/`max`），保持"默认"则跳过 |
+
+模型匹配是对请求 `model` 字段的大小写无关子串判断，因此任意版本（如 `claude-opus-4-8`、未来的 `claude-opus-5`）都会映射到同一家族，无需重新配置。家族字段留空表示该家族保持不变；无法识别的家族会原样透传。
 
 ## 工作原理
 
@@ -22,7 +27,8 @@
 
 1. **URL 重写** — 将请求的 origin 替换为代理的 Base URL
 2. **认证替换** — 将请求头中的 `x-api-key` 或 `Authorization` 替换为代理的 API Key
-3. **模型替换** — 如果指定了当前模型，将请求体中的 `model` 字段替换
+3. **模型替换** — 按家族改写请求体的 `model` 字段（opus/sonnet/haiku → 对应字段；fable/mythos → `ANTHROPIC_MODEL`）
+4. **强度注入** — 若设置了强度等级，则注入 `output_config.effort`（`count_tokens` / 心跳请求会跳过）
 
 ## 配置文件
 
@@ -38,8 +44,11 @@
       "name": "My Proxy",
       "baseURL": "https://api.example.com",
       "apiKey": "sk-xxx",
-      "models": ["model-a", "model-b"],
-      "activeModel": "model-a"
+      "ANTHROPIC_MODEL": "model-primary",
+      "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
+      "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
+      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku",
+      "effort": "max"
     }
   ]
 }
@@ -47,4 +56,5 @@
 
 - `active` — 当前使用的 profile ID，设为 `"max"` 表示直连（不走代理）
 - `profiles` — profile 列表，`id: "max"` 为内置直连模式，不可删除
+- 使用旧版 `models` / `activeModel` 的 profile 在加载时会自动迁移为 `ANTHROPIC_MODEL`
 - 修改文件后约 1.5 秒自动生效（通过 `fs.watchFile` 监听），无需重启

package/concepts/zh-TW/GlobalSettings.md

@@ -163,10 +163,13 @@ claude() { ... }
 | `active` | 当前激活的配置 ID（`"max"` = 直连，无代理） |
 | `id` | 唯一标识 |
 | `name` | 显示名称 |
-| `baseURL` | 代理 API 地址（替换请求 origin） |
-| `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `baseURL` | 代理 API 位址（替換請求 origin） |
+| `apiKey` | 代理 API 金鑰（替換認證標頭） |
+| `ANTHROPIC_MODEL` | 主模型（fable/mythos 家族映射到此） |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | opus 家族對應的模型（擴充） |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | sonnet 家族對應的模型（擴充） |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | haiku 家族對應的模型（擴充） |
+| `effort` | 強制的 `output_config.effort` 等級 |
 
 ## 九、插件系统
 

package/concepts/zh-TW/ProxySwitch.md

@@ -13,8 +13,13 @@ Hot-Switch Proxy lets you dynamically redirect API requests to a different endpo
 | **Name** | ✅ | Display name for this proxy, used to identify it |
 | **Base URL** | ✅ | Base URL of the API service (e.g. `https://api.example.com`). The original request origin will be replaced |
 | **API Key** | ✅ | API key for the proxy service, replaces the original authentication |
-| **Models** | ❌ | Comma-separated list of models supported by this proxy (e.g. `model-a, model-b`) |
-| **Active Model** | ❌ | Select the active model from the list. The `model` field in requests will be replaced |
+| **ANTHROPIC_MODEL** | ❌ | 主模型。凡屬於 `fable` / `mythos` 家族的模型請求都會被改寫為此值 |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | 擴充：`model` 包含 `opus` 的請求會被改寫為此值 |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | 擴充：`model` 包含 `sonnet` 的請求會被改寫為此值 |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | 擴充：`model` 包含 `haiku` 的請求會被改寫為此值 |
+| **強度等級** | ❌ | 向請求體注入 `output_config.effort`（`low`/`medium`/`high`/`xhigh`/`max`），保持「預設」則跳過 |
+
+模型比對是對請求 `model` 欄位的大小寫無關子字串判斷，因此任意版本（如 `claude-opus-4-8`、未來的 `claude-opus-5`）都會映射到同一家族，無需重新設定。家族欄位留空表示該家族保持不變；無法辨識的家族會原樣透傳。
 
 ## How It Works
 
@@ -22,7 +27,8 @@ When a proxy is active, `server/interceptor.js` performs the following before ea
 
 1. **URL Rewrite** — Replaces the request origin with the proxy's Base URL
 2. **Auth Replace** — Replaces `x-api-key` or `Authorization` header with the proxy's API Key
-3. **Model Replace** — If an active model is set, replaces the `model` field in the request body
+3. **Model Replace** — 依家族改寫請求體的 `model` 欄位（opus/sonnet/haiku → 對應欄位；fable/mythos → `ANTHROPIC_MODEL`）
+4. **Effort Inject** — 若設定了強度等級，則注入 `output_config.effort`（`count_tokens` / 心跳請求會跳過）
 
 ## Config File
 
@@ -38,8 +44,11 @@ Configuration is stored at `~/.claude/cc-viewer/profile.json`. Click the folder
       "name": "My Proxy",
       "baseURL": "https://api.example.com",
       "apiKey": "sk-xxx",
-      "models": ["model-a", "model-b"],
-      "activeModel": "model-a"
+      "ANTHROPIC_MODEL": "model-primary",
+      "ANTHROPIC_DEFAULT_OPUS_MODEL": "model-opus",
+      "ANTHROPIC_DEFAULT_SONNET_MODEL": "model-sonnet",
+      "ANTHROPIC_DEFAULT_HAIKU_MODEL": "model-haiku",
+      "effort": "max"
     }
   ]
 }
@@ -47,4 +56,5 @@ Configuration is stored at `~/.claude/cc-viewer/profile.json`. Click the folder
 
 - `active` — ID of the current profile. Set to `"max"` for direct connection (no proxy)
 - `profiles` — Profile list. `id: "max"` is built-in and cannot be deleted
+- 使用舊版 `models` / `activeModel` 的 profile 在載入時會自動遷移為 `ANTHROPIC_MODEL`
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed