cc-viewer 1.6.330 → 1.6.331

package/README.md

@@ -1,16 +1,15 @@
 <img height="200" width="1500" alt="CC-Viewer" src="https://github.com/user-attachments/assets/abec0513-1d56-4244-b7ed-9382b6c09049" />
 
+As the author's account has been disabled by Claude Code, updates to the repository are paused for a few weeks.
+
+The author is taking this opportunity to work on a multimodal project.
+
+If there are any critical bugs requiring fixes, please submit them via the issues section; they can still be addressed.
+
 # CC-Viewer
 
 Based on Claude Code, a Vibe Coding tool that distills and accumulates real development experience:
 
-1. Raise your capability ceiling: run /ultraPlan and /ultraReview locally, while avoiding fully exposing your project code to Claude's cloud;
-2. Multi-device compatibility: code on mobile devices (within your LAN), the web version adapts to all kinds of scenarios, easy to embed into browser extensions or OS split-screen, and native installers are provided;
-3. Complete log tracing: full Claude Code payload interception and analysis — ideal for logging, troubleshooting, learning, and reverse engineering;
-4. Shared learning and experience: lots of learning material and development know-how are baked in (see the "?" icons throughout the system);
-5. Native experience preserved: only enhances Claude Code's capabilities without making any substantive changes to the core, keeping the native experience intact;
-6. Third-party model support: compatible with deepseek-v4-\*, GLM 5.1, Kimi K2.6, with cc-switch built in so you can hot-swap third-party tools at any time;
-
 <img width="860" alt="cc-viewer — deploy once, share with every device" src="https://raw.githubusercontent.com/weiesky/cc-viewer/main/docs/cc-viewer-share.svg" />
 
 English | [简体中文](./docs/README.zh.md) | [繁體中文](./docs/README.zh-TW.md) | [한국어](./docs/README.ko.md) | [日本語](./docs/README.ja.md) | [Deutsch](./docs/README.de.md) | [Español](./docs/README.es.md) | [Français](./docs/README.fr.md) | [Italiano](./docs/README.it.md) | [Dansk](./docs/README.da.md) | [Polski](./docs/README.pl.md) | [Русский](./docs/README.ru.md) | [العربية](./docs/README.ar.md) | [Norsk](./docs/README.no.md) | [Português (Brasil)](./docs/README.pt-BR.md) | [ไทย](./docs/README.th.md) | [Türkçe](./docs/README.tr.md) | [Українська](./docs/README.uk.md)
@@ -152,7 +151,7 @@ By default, remote (LAN) access requires the `?token=` query that ccv prints at
 * Each request inlines Token usage stats (input/output tokens, cache creation/read, hit rate)
 * Compatible with Claude Code Router (CCR) and other proxy scenarios — falls back to matching requests by API path pattern
 
-<a href="https://www.star-history.com/?repos=weiesky%2Fcc-viewer&type=date&legend=top-left">
+<a href="https://www.star-history.com/?type=date&repos=weiesky%2Fcc-viewer">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=weiesky/cc-viewer&type=date&theme=dark&legend=top-left" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=weiesky/cc-viewer&type=date&legend=top-left" />

package/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-// Windows NTFS + Defender 使每次异步 I/O 开销更大，默认 4 线程不够用
+// Windows NTFS + Defender increase per-async-IO overhead; default 4 threads aren't enough
 if (process.platform === 'win32' && !process.env.UV_THREADPOOL_SIZE) {
   process.env.UV_THREADPOOL_SIZE = '16';
 }
@@ -19,8 +19,8 @@ import { createHardenedCleanup, installWinKeypressFallback } from './server/lib/
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
 
-// 注入 marker 常量定义在 server/lib/cli-inject.js（便于单元测试）；
-// 本文件仅 re-export 给 helper 与 hook 使用，保持现有行为。
+// Injection marker constants are defined in server/lib/cli-inject.js (for testability);
+// This file only re-exports them for use by helpers and hooks, preserving existing behavior.
 const INJECT_START = _INJECT_START;
 const INJECT_END = _INJECT_END;
 const INJECT_BLOCK = _buildInjectBlock(INJECT_IMPORT);
@@ -31,9 +31,9 @@ const SHELL_HOOK_END = '# <<< CC-Viewer Auto-Inject <<<';
 
 const cliPath = resolveCliPath();
 
-// 统一的"claude 找不到"错误提示：区分"Claude Code 2.x wrapper 装了但原生二进制
-// 没 ready（--ignore-scripts / --omit=optional / 某些 pnpm 配置）"和"claude 根本
-// 没装"两种情况，给出针对性的修复指引。
+// Unified "claude not found" error message: distinguishes between "Claude Code 2.x wrapper
+// installed but native binary not ready (--ignore-scripts / --omit=optional / certain pnpm
+// configurations)" and "claude not installed at all," giving targeted fix guidance.
 function reportClaudeNotFound(cliPathHint) {
   const globalRoot = getGlobalNodeModulesDir();
   if (hasClaude2xWrapper(globalRoot)) {

package/concepts/ar/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `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/ar/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** | ❌ | Primary model. Requests whose model belongs to the `fable` / `mythos` family are rewritten to this |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | Extended: requests whose model contains `opus` are rewritten to this |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | Extended: requests whose model contains `sonnet` are rewritten to this |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | Extended: requests whose model contains `haiku` are rewritten to this |
+| **Effort Level** | ❌ | Injects `output_config.effort` (`low`/`medium`/`high`/`xhigh`/`max`) into the request body. Leave as "Default" to skip |
+
+Model matching is a case-insensitive substring test on the request's `model` field, so any version (e.g. `claude-opus-4-8`, a future `claude-opus-5`) maps to the same family with no reconfiguration. An empty family field means that family is left unchanged; an unrecognized family is passed through untouched.
 
 ## 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** — Rewrites the request body `model` by family (opus/sonnet/haiku → the matching field; fable/mythos → `ANTHROPIC_MODEL`)
+4. **Effort Inject** — If an effort level is set, injects `output_config.effort` (skipped for `count_tokens` / heartbeat requests)
 
 ## 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
+- Legacy profiles using `models` / `activeModel` are auto-migrated to `ANTHROPIC_MODEL` on load
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/da/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `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/da/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** | ❌ | Primary model. Requests whose model belongs to the `fable` / `mythos` family are rewritten to this |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | Extended: requests whose model contains `opus` are rewritten to this |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | Extended: requests whose model contains `sonnet` are rewritten to this |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | Extended: requests whose model contains `haiku` are rewritten to this |
+| **Effort Level** | ❌ | Injects `output_config.effort` (`low`/`medium`/`high`/`xhigh`/`max`) into the request body. Leave as "Default" to skip |
+
+Model matching is a case-insensitive substring test on the request's `model` field, so any version (e.g. `claude-opus-4-8`, a future `claude-opus-5`) maps to the same family with no reconfiguration. An empty family field means that family is left unchanged; an unrecognized family is passed through untouched.
 
 ## 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** — Rewrites the request body `model` by family (opus/sonnet/haiku → the matching field; fable/mythos → `ANTHROPIC_MODEL`)
+4. **Effort Inject** — If an effort level is set, injects `output_config.effort` (skipped for `count_tokens` / heartbeat requests)
 
 ## 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
+- Legacy profiles using `models` / `activeModel` are auto-migrated to `ANTHROPIC_MODEL` on load
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/de/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `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/de/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** | ❌ | Primary model. Requests whose model belongs to the `fable` / `mythos` family are rewritten to this |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | Extended: requests whose model contains `opus` are rewritten to this |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | Extended: requests whose model contains `sonnet` are rewritten to this |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | Extended: requests whose model contains `haiku` are rewritten to this |
+| **Effort Level** | ❌ | Injects `output_config.effort` (`low`/`medium`/`high`/`xhigh`/`max`) into the request body. Leave as "Default" to skip |
+
+Model matching is a case-insensitive substring test on the request's `model` field, so any version (e.g. `claude-opus-4-8`, a future `claude-opus-5`) maps to the same family with no reconfiguration. An empty family field means that family is left unchanged; an unrecognized family is passed through untouched.
 
 ## 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** — Rewrites the request body `model` by family (opus/sonnet/haiku → the matching field; fable/mythos → `ANTHROPIC_MODEL`)
+4. **Effort Inject** — If an effort level is set, injects `output_config.effort` (skipped for `count_tokens` / heartbeat requests)
 
 ## 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
+- Legacy profiles using `models` / `activeModel` are auto-migrated to `ANTHROPIC_MODEL` on load
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/en/GlobalSettings.md

@@ -1,5 +1,7 @@
 # CC-Viewer Configuration Reference
 
+> Also available in [简体中文](../zh/GlobalSettings.md) and other languages.
+
 ## 1. Global Settings Panel (UI)
 
 Open via top-left menu → "Global Settings".
@@ -166,8 +168,11 @@ Stored in `<log_dir>/profile.json`, managed via the "Proxy Switch" panel in the
 | `name` | Display name |
 | `baseURL` | Proxy API address (replaces request origin) |
 | `apiKey` | Proxy API key (replaces auth headers) |
-| `models` | Available model list |
-| `activeModel` | Currently selected model |
+| `ANTHROPIC_MODEL` | Primary model (fable/mythos family maps here) |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Model for the opus family (extended) |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Model for the sonnet family (extended) |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Model for the haiku family (extended) |
+| `effort` | Forced `output_config.effort` level |
 
 ## 9. Plugin System
 

package/concepts/en/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** | ❌ | Primary model. Requests whose model belongs to the `fable` / `mythos` family are rewritten to this |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | Extended: requests whose model contains `opus` are rewritten to this |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | Extended: requests whose model contains `sonnet` are rewritten to this |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | Extended: requests whose model contains `haiku` are rewritten to this |
+| **Effort Level** | ❌ | Injects `output_config.effort` (`low`/`medium`/`high`/`xhigh`/`max`) into the request body. Leave as "Default" to skip |
+
+Model matching is a case-insensitive substring test on the request's `model` field, so any version (e.g. `claude-opus-4-8`, a future `claude-opus-5`) maps to the same family with no reconfiguration. An empty family field means that family is left unchanged; an unrecognized family is passed through untouched.
 
 ## 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** — Rewrites the request body `model` by family (opus/sonnet/haiku → the matching field; fable/mythos → `ANTHROPIC_MODEL`)
+4. **Effort Inject** — If an effort level is set, injects `output_config.effort` (skipped for `count_tokens` / heartbeat requests)
 
 ## 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
+- Legacy profiles using `models` / `activeModel` are auto-migrated to `ANTHROPIC_MODEL` on load
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/es/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `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/es/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** | ❌ | Primary model. Requests whose model belongs to the `fable` / `mythos` family are rewritten to this |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | Extended: requests whose model contains `opus` are rewritten to this |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | Extended: requests whose model contains `sonnet` are rewritten to this |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | Extended: requests whose model contains `haiku` are rewritten to this |
+| **Effort Level** | ❌ | Injects `output_config.effort` (`low`/`medium`/`high`/`xhigh`/`max`) into the request body. Leave as "Default" to skip |
+
+Model matching is a case-insensitive substring test on the request's `model` field, so any version (e.g. `claude-opus-4-8`, a future `claude-opus-5`) maps to the same family with no reconfiguration. An empty family field means that family is left unchanged; an unrecognized family is passed through untouched.
 
 ## 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** — Rewrites the request body `model` by family (opus/sonnet/haiku → the matching field; fable/mythos → `ANTHROPIC_MODEL`)
+4. **Effort Inject** — If an effort level is set, injects `output_config.effort` (skipped for `count_tokens` / heartbeat requests)
 
 ## 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
+- Legacy profiles using `models` / `activeModel` are auto-migrated to `ANTHROPIC_MODEL` on load
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/fr/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `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/fr/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** | ❌ | Primary model. Requests whose model belongs to the `fable` / `mythos` family are rewritten to this |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | Extended: requests whose model contains `opus` are rewritten to this |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | Extended: requests whose model contains `sonnet` are rewritten to this |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | Extended: requests whose model contains `haiku` are rewritten to this |
+| **Effort Level** | ❌ | Injects `output_config.effort` (`low`/`medium`/`high`/`xhigh`/`max`) into the request body. Leave as "Default" to skip |
+
+Model matching is a case-insensitive substring test on the request's `model` field, so any version (e.g. `claude-opus-4-8`, a future `claude-opus-5`) maps to the same family with no reconfiguration. An empty family field means that family is left unchanged; an unrecognized family is passed through untouched.
 
 ## 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** — Rewrites the request body `model` by family (opus/sonnet/haiku → the matching field; fable/mythos → `ANTHROPIC_MODEL`)
+4. **Effort Inject** — If an effort level is set, injects `output_config.effort` (skipped for `count_tokens` / heartbeat requests)
 
 ## 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
+- Legacy profiles using `models` / `activeModel` are auto-migrated to `ANTHROPIC_MODEL` on load
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/it/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `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/it/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** | ❌ | Primary model. Requests whose model belongs to the `fable` / `mythos` family are rewritten to this |
+| **ANTHROPIC_DEFAULT_OPUS_MODEL** | ❌ | Extended: requests whose model contains `opus` are rewritten to this |
+| **ANTHROPIC_DEFAULT_SONNET_MODEL** | ❌ | Extended: requests whose model contains `sonnet` are rewritten to this |
+| **ANTHROPIC_DEFAULT_HAIKU_MODEL** | ❌ | Extended: requests whose model contains `haiku` are rewritten to this |
+| **Effort Level** | ❌ | Injects `output_config.effort` (`low`/`medium`/`high`/`xhigh`/`max`) into the request body. Leave as "Default" to skip |
+
+Model matching is a case-insensitive substring test on the request's `model` field, so any version (e.g. `claude-opus-4-8`, a future `claude-opus-5`) maps to the same family with no reconfiguration. An empty family field means that family is left unchanged; an unrecognized family is passed through untouched.
 
 ## 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** — Rewrites the request body `model` by family (opus/sonnet/haiku → the matching field; fable/mythos → `ANTHROPIC_MODEL`)
+4. **Effort Inject** — If an effort level is set, injects `output_config.effort` (skipped for `count_tokens` / heartbeat requests)
 
 ## 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
+- Legacy profiles using `models` / `activeModel` are auto-migrated to `ANTHROPIC_MODEL` on load
 - Changes take effect within ~1.5 seconds (monitored via `fs.watchFile`), no restart needed

package/concepts/ja/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `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/ja/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

package/concepts/ko/GlobalSettings.md

@@ -165,8 +165,11 @@ claude() { ... }
 | `name` | 显示名称 |
 | `baseURL` | 代理 API 地址（替换请求 origin） |
 | `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| `ANTHROPIC_MODEL` | 기본 모델(fable/mythos 계열이 여기로 매핑됨) |
+| `ANTHROPIC_DEFAULT_OPUS_MODEL` | opus 계열용 모델(확장) |
+| `ANTHROPIC_DEFAULT_SONNET_MODEL` | sonnet 계열용 모델(확장) |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | haiku 계열용 모델(확장) |
+| `effort` | 강제 적용할 `output_config.effort` 레벨 |
 
 ## 九、插件系统