docs: document Codex Chat reasoning auto-detection

Add a "Reasoning Auto-Detection" subsection to the Codex local-routing
manual (zh/en/ja) with the provider capability matrix, and record the
feature plus the streaming-usage and tool-call reasoning backfill fixes
in the changelog. Drop the removed Kimi For Coding preset from the
changelog's Codex Chat preset list.
This commit is contained in:
Jason
2026-05-21 22:29:33 +08:00
parent 44d9aabbf3
commit 11edc96a15
4 changed files with 58 additions and 1 deletions
@@ -581,6 +581,24 @@ v3.13.0 起新增的高级选项。默认情况下,CC Switch 会把配置的 `
- 表中条目按填写内容原样保存,是模型列表的唯一来源
- **修改后需要重启 Codex** 才能刷新模型列表(`model_catalog_json` 在 Codex 启动时加载)
#### 思考能力(Reasoning)自适应
开启本地路由后,CC Switch 会**自动识别**供应商的「思考」(reasoning)接口,把 Codex 发出的思考请求转换成上游能理解的参数,**无需手动配置**。识别依据是供应商的名称、端点和模型名:
- **聚合 / 托管平台优先**OpenRouter、SiliconFlow 等按平台规则处理(同一模型在不同平台上的思考接口可能完全不同)
- **其余按模型品牌**DeepSeek、Kimi / Moonshot、智谱 GLM、通义千问、MiniMax、小米 MiMo、阶跃星辰 StepFun 等各有对应规则
不同供应商支持的「思考」能力分两类:
| 能力 | 含义 | 代表供应商 |
|------|------|-----------|
| **支持思考等级** | 可调节思考强度(low / medium / high 等) | DeepSeek、OpenRouter、StepFun(仅 `step-3.5-flash-2603` |
| **仅支持思考开关** | 只能开 / 关思考,**等级无效** | Kimi、智谱 GLM、通义千问、MiniMax、小米 MiMo、SiliconFlow |
> ⚠️ **思考等级对部分供应商无效**:如果供应商只支持「思考开关」,那么在 Codex 里调节思考等级(`model_reasoning_effort` 的 low / medium / high**不会有任何效果**——CC Switch 不会把等级透传给这类上游(它们的接口不接受该参数,硬传可能导致请求被拒)。这类供应商的思考默认**开启**,靠「开 / 关」而非「调档」工作。只有支持思考等级的供应商(如 DeepSeek、OpenRouter),调节等级才真正生效。
> 💡 **识别基于名称 / 端点 / 模型名的关键词匹配**,不是真正的能力探测。官方域名(如 `api.deepseek.com`、`api.moonshot.cn`)都能正确识别;如果你用的中转改写了域名和模型名,可能识别不到,此时不会注入任何思考参数。
### Codex 1M 上下文窗口
添加 Codex 供应商时,提供 **启用 1M 上下文窗口** 开关: