feat(anthropic): optimize extended thinking strategy with auto-enable and improved budget

(cherry picked from commit 5a81bb0)

Author: JerryliDe

docs/anthropic-thinking-auto-enable.md

@@ -0,0 +1,194 @@
+# Anthropic Extended Thinking 自动启用策略优化
+
+## 📋 概述
+
+优化了自定义模型适配器中 Anthropic Extended Thinking 的启用策略，从**基于模型名称检测**改为**所有 Anthropic 协议模型默认启用**。
+
+## 🎯 修改动机
+
+1. **简化逻辑**：不再需要维护支持 thinking 的模型名称列表
+2. **更通用**：适用于所有 Anthropic 兼容的 API（包括第三方代理服务）
+3. **向前兼容**：新发布的 Claude 模型自动支持，无需更新代码
+4. **容错性好**：不支持的模型会自动忽略 `thinking` 参数，不会报错
+
+## 🔄 修改内容
+
+### 1. 核心逻辑简化
+
+#### **修改前**（基于模型名称检测）：
+```typescript
+function isThinkingSupportedModel(modelId: string): boolean {
+  const modelIdLower = modelId.toLowerCase();
+
+  const thinkingPatterns = [
+    'claude-sonnet-4', 'claude-4-sonnet',
+    'claude-3-7-sonnet', 'claude-3.7-sonnet',
+    'claude-haiku-4', 'claude-4-haiku',
+    'claude-opus-4', 'claude-4-opus',
+  ];
+
+  return thinkingPatterns.some(pattern => modelIdLower.includes(pattern));
+}
+
+const shouldEnableThinking = modelConfig.enableThinking !== undefined
+  ? modelConfig.enableThinking
+  : isThinkingSupportedModel(modelConfig.modelId); // ❌ 需要检查模型名称
+```
+
+#### **修改后**（所有 Anthropic 模型默认启用）：
+```typescript
+function shouldEnableThinkingByDefault(): boolean {
+  // 对于所有 Anthropic 协议的模型，默认启用 thinking
+  // 如果模型不支持，服务端会自动忽略此参数
+  return true;
+}
+
+const shouldEnableThinking = modelConfig.enableThinking !== undefined
+  ? modelConfig.enableThinking
+  : shouldEnableThinkingByDefault(); // ✅ 总是返回 true
+```
+
+### 2. API 请求格式（不变）
+
+当启用 thinking 时，发送给 Anthropic API 的请求体：
+
+```json
+{
+  "model": "claude-sonnet-4-5-20250929",
+  "messages": [...],
+  "max_tokens": 32000,
+  "thinking": {
+    "type": "enabled",
+    "budget_tokens": 31999
+  }
+}
+```
+
+**参数说明：**
+- `thinking.type`: 固定为 `"enabled"`
+- `thinking.budget_tokens`: `Math.min(maxTokens - 1, 31999)` （官方推荐值）
+- `max_tokens`: 自动调整为至少 32000
+
+### 3. 用户配置行为
+
+| `enableThinking` 值 | 行为 |
+|---------------------|------|
+| `undefined` (默认) | ✅ 自动启用 thinking（所有 Anthropic 模型） |
+| `true` | ✅ 强制启用 thinking |
+| `false` | ❌ 明确禁用 thinking |
+
+### 4. 配置示例
+
+#### **简化配置**（推荐，使用默认行为）：
+```json
+{
+  "customModels": [
+    {
+      "provider": "anthropic",
+      "modelId": "claude-sonnet-4-5-20250929",
+      "displayName": "Claude Sonnet 4.5",
+      "baseUrl": "https://api.anthropic.com",
+      "apiKey": "${ANTHROPIC_API_KEY}",
+      "maxTokens": 32000
+      // enableThinking 未设置，自动启用
+    }
+  ]
+}
+```
+
+#### **明确禁用**（如果需要）：
+```json
+{
+  "customModels": [
+    {
+      "provider": "anthropic",
+      "modelId": "claude-3-5-sonnet-20241022",
+      "displayName": "Claude 3.5 Sonnet (No Thinking)",
+      "baseUrl": "https://api.anthropic.com",
+      "apiKey": "${ANTHROPIC_API_KEY}",
+      "enableThinking": false  // 明确禁用
+    }
+  ]
+}
+```
+
+## 🧪 测试更新
+
+### 修改的测试用例：
+
+1. **自动启用测试**：
+   ```typescript
+   it('should auto-enable thinking for all Anthropic models when enableThinking is undefined')
+   ```
+   - 验证所有 Anthropic 模型默认启用 thinking
+
+2. **明确禁用测试**：
+   ```typescript
+   it('should respect explicit enableThinking=false to disable thinking')
+   ```
+   - 验证用户可以通过 `enableThinking: false` 禁用
+
+### 测试结果：
+```
+✓ src/core/customModelAdapter.test.ts (31 tests) 17ms
+Test Files  1 passed (1)
+Tests  31 passed (31)
+```
+
+## 📝 文档更新
+
+### 更新的文件：
+1. **`packages/core/src/types/customModel.ts`**
+   - 更新 `enableThinking` 字段的注释
+   - 说明默认行为为自动启用
+
+2. **`packages/cli/src/assets/help/cli-help-knowledge.md`**
+   - 更新自定义模型配置说明
+   - 修改 Anthropic 提供商描述
+   - 更新配置示例
+
+## ✅ 优势总结
+
+| 方面 | 修改前 | 修改后 |
+|------|--------|--------|
+| **代码复杂度** | 需要维护模型名称模式列表 | 简单的 `return true` |
+| **兼容性** | 仅特定模型名称支持 | 所有 Anthropic 协议模型 |
+| **可维护性** | 新模型需要更新代码 | 无需更新，自动支持 |
+| **第三方服务** | 可能不匹配模型名称 | 完全兼容 |
+| **容错性** | 不支持的模型不启用 | 不支持的模型自动忽略参数 |
+| **用户体验** | 需要了解哪些模型支持 | 开箱即用，无需配置 |
+
+## 🔍 技术细节
+
+### 为什么不支持的模型不会报错？
+
+根据 Anthropic API 设计：
+- 不支持 `thinking` 参数的模型会**忽略**此字段
+- API 不会返回错误，而是正常处理其他参数
+- 这是 API 设计的向前兼容策略
+
+### 性能影响
+
+- ✅ 无性能影响
+- ✅ 请求体大小增加可忽略（约 50 字节）
+- ✅ 不支持的模型处理时间无变化
+
+## 📚 相关文档
+
+- [Anthropic Extended Thinking 官方文档](https://docs.anthropic.com/en/docs/build-with-claude/extended-thinking)
+- [DeepV Code 自定义模型文档](../docs/custom-models-guide.md)
+- [自定义模型快速开始](../docs/custom-models-quickstart.md)
+
+## 🎉 总结
+
+此次优化使 Anthropic Extended Thinking 功能更加**简单、通用、易用**：
+1. ✅ 所有 Anthropic 模型默认启用 thinking
+2. ✅ 用户无需关心模型是否支持
+3. ✅ 代码更简洁，易于维护
+4. ✅ 完全向后兼容现有配置
+
+---
+
+**修改日期**: 2026-01-17
+**版本**: v1.0.271
+**影响范围**: `packages/core/src/core/customModelAdapter.ts`