|
18 | 18 | # ───────────────────────────────────────────────────────────────────────── |
19 | 19 | # 含 'native' 且 'claude' → NativeClaudeSession → API 原生 tool 字段 |
20 | 20 | # 含 'native' 且 'oai' → NativeOAISession → API 原生 tool 字段 |
21 | | -# 含 'claude'(不含 native) → ClaudeSession → 文本协议工具 (deprecated) |
22 | | -# 含 'oai'(不含 native) → LLMSession → 文本协议工具 (deprecated) |
23 | 21 | # 含 'mixin' → MixinSession → 多 session 故障转移 |
24 | 22 | # NativeClaudeSession 与 |
25 | 23 | # NativeOAISession 可混用 |
26 | 24 | # |
27 | | -# 优先级自上而下:native_claude_xxx 会走 NativeClaudeSession;如果变量名只写 |
28 | | -# oai_claude_xxx 则依然会被 'claude' 抢先匹配,去走 ClaudeSession,所以命名要 |
29 | | -# 注意含义。 |
30 | | -# |
31 | | -# ────────── Native vs 非 Native 的区别 ────────── |
32 | | -# |
33 | | -# 「Native」 = 工具调用走 API 文档里的 tool 字段(function calling)。 |
34 | | -# 这是 Claude Code / Codex 的原生方式——训到 overfit 的模型只认 API tool 字段, |
35 | | -# 其他格式的工具描述都会被忽略。要模拟 CC/Codex 的行为,必须用 Native。 |
36 | | -# |
37 | | -# 「非 Native」 = 工具描述放在 text 字段里(文本协议),兼容性更强, |
38 | | -# 但对于被 API tool 字段训 overfit 的模型(如 Claude Opus/Sonnet),效果可能打折。 |
39 | | -# |
40 | | -# → 新手推荐:优先用 native_claude_config / native_oai_config |
| 25 | +# 工具调用一律走 API 原生 tool 字段(function calling),与 Claude Code / |
| 26 | +# Codex 行为一致。Anthropic 协议渠道用 native_claude_*,OpenAI 兼容渠道用 |
| 27 | +# native_oai_*,按上游端点协议选择即可。 |
41 | 28 | # |
42 | 29 | # ────────── Prompt Cache 说明 ────────── |
43 | 30 | # |
44 | 31 | # NativeClaudeSession 恒开 prompt-caching-scope beta,缓存默认拉满,无需配置。 |
45 | | -# LLMSession / NativeOAISession 在 model 名含 'claude'/'anthropic' 时自动在 |
46 | | -# 最后两条 user 打 cache_control: ephemeral,默认也是开启的。 |
| 32 | +# NativeOAISession 在 model 名含 'claude'/'anthropic' 时自动在最后两条 user |
| 33 | +# 打 cache_control: ephemeral,默认也是开启的。 |
47 | 34 | # prompt_cache 字段默认 True,仅在上游 relay 不认 cache_control 字段会直接报错 |
48 | 35 | # 时才需设 False。因此模板中不再显式写 prompt_cache,了解即可。 |
49 | 36 | # |
|
100 | 87 | # stream 默认 True。NativeClaudeSession 会根据此值决定走 SSE 流式 |
101 | 88 | # 还是一次性 JSON。流式更及时;某些被 CDN 截断 SSE 的渠道可 |
102 | 89 | # 以改成 False 先保命。 |
103 | | -# api_mode 'chat_completions'(默认)或 'responses'。仅对 LLMSession / |
| 90 | +# api_mode 'chat_completions'(默认)或 'responses'。仅对 |
104 | 91 | # NativeOAISession 生效。 |
105 | 92 | # ─── NativeClaudeSession 专属 ─────────────────────────────────────────────── |
106 | 93 | # fake_cc_system_prompt |
|
113 | 100 | # ══════════════════════════════════════════════════════════════════════════════ |
114 | 101 |
|
115 | 102 |
|
| 103 | + |
116 | 104 | # ╔═══════════════════════════════════════════════════════════════════════════╗ |
117 | 105 | # ║ ★ 推荐最优配置(新手从这里开始)★ ║ |
118 | 106 | # ╚═══════════════════════════════════════════════════════════════════════════╝ |
|
124 | 112 |
|
125 | 113 | # ── Mixin 故障转移(最推荐的方式)────────────────────────────────────────── |
126 | 114 | # llm_nos 里的字符串必须和被引用 session 的 'name' 字段匹配(也可以写整数索 |
127 | | -# 引)。约束:引用的 session 必须全是 Native 系列(NativeClaudeSession 和 |
128 | | -# NativeOAISession 可以混用)或者全不是 Native,不能 Native 与非 Native 混。 |
129 | | -# 请你按需 |
| 115 | +# 引)。NativeClaudeSession 和 NativeOAISession 可以混用。 |
130 | 116 | mixin_config = { |
131 | 117 | 'llm_nos': [], # 默认空:桌面端会显示一个空的「渠道组(自动故障转移)」,添加模型后 |
132 | 118 | # 在设置里用 ➕ 把基本模型加进来即可(也可在此手填名字) |
|
137 | 123 | } |
138 | 124 |
|
139 | 125 |
|
| 126 | + |
140 | 127 | # ══════════════════════════════════════════════════════════════════════════════ |
141 | 128 | # 1. NativeClaudeSession — Anthropic 原生协议 + 原生工具(推荐首选) |
142 | 129 | # ══════════════════════════════════════════════════════════════════════════════ |
|
217 | 204 | # 'read_timeout': 180, # int 秒 |
218 | 205 | # } |
219 | 206 |
|
220 | | -# ── 1d. CRS Gemini Ultra (Antigravity 通道) ───────────────────────────────── |
221 | | -# CRS 把 Google Antigravity (Gemini Ultra) 包装成 Anthropic 风格接口。 |
222 | | -# URL 路径带 /antigravity/api: |
223 | | -# - 'claude-opus-4-7-thinking' (CRS 原始名) |
224 | | -# - 'claude-opus-4-7[1m]' (触发 1m beta,CRS 会忽略多余的 beta) |
225 | | -# - 'claude-opus-4-7' (最简) |
226 | | -# ⚠ 此通道不支持 SSE 流式,必须 stream=False。 |
227 | | -# native_claude_config_crs_gemini = { |
228 | | -# 'name': 'crs-gemini-ultra', # /llms 显示名 |
229 | | -# 'apikey': 'cr_<your-crs-gemini-key>', # cr_ 前缀 → Bearer |
230 | | -# 'apibase': 'https://<your-crs-gemini-host>/antigravity/api', |
231 | | -# 'model': 'claude-opus-4-7-thinking', # 或 'claude-opus-4-7[1m]' 或 'claude-opus-4-7' |
232 | | -# 'stream': False, # Antigravity 不支持 SSE 流式,stream=True 会返回伪错误 |
233 | | -# 'max_tokens': 32768, # int |
| 207 | + |
| 208 | +# ── 1d. 其他 Anthropic 兼容渠道(GLM / Kimi / MiniMax 等)─────────────────── |
| 209 | +# 很多厂商都提供 Anthropic Messages 兼容端点,直接照 1a~1c 的写法填对应 |
| 210 | +# apibase / model 即可,无需专门配置: |
| 211 | +# |
| 212 | +# 厂商 apibase model 备注 |
| 213 | +# ────────────────────────────────────────────────────────────────────────────── |
| 214 | +# 智谱 GLM https://open.bigmodel.cn/api/anthropic glm-5.1 key 形如 xxx.yyy |
| 215 | +# Kimi Coding https://api.kimi.com/coding kimi-for-coding 必须 fake_cc_system_prompt=True |
| 216 | +# MiniMax https://api.minimaxi.com/anthropic MiniMax-M3 温度自动夹到 (0,1] |
| 217 | +# |
| 218 | +# native_claude_config_vendor = { |
| 219 | +# 'name': 'glm-5.1', # /llms 显示名 & mixin 引用名 |
| 220 | +# 'apikey': '<your-vendor-apikey>', # 非 sk-ant- 前缀 → Bearer 鉴权 |
| 221 | +# 'apibase': 'https://open.bigmodel.cn/api/anthropic', |
| 222 | +# 'model': 'glm-5.1', |
| 223 | +# # 'fake_cc_system_prompt': True, # 仅 CC 透传类端点需要(如 Kimi Coding) |
234 | 224 | # 'max_retries': 3, # int |
235 | 225 | # 'read_timeout': 180, # int 秒 |
236 | 226 | # } |
237 | 227 |
|
238 | | -# ── 1e. 智谱 GLM-5.1 (Anthropic 兼容协议) ────────────────────────────────── |
239 | | -# 智谱提供了 Anthropic 兼容接口 /api/anthropic,走 NativeClaudeSession。 |
240 | | -# 变量名含 'native' + 'claude' 即可。apikey 是智谱格式 (xxx.yyy)。 |
241 | | -# native_claude_glm_config = { |
242 | | -# 'name': 'glm-5.1', # /llms 显示名 |
243 | | -# 'apikey': '<your-zhipu-apikey>', # 形如 f0f1b798xxxx.F8SSbzxxxx;非 sk-ant- → Bearer |
244 | | -# 'apibase': 'https://open.bigmodel.cn/api/anthropic', # 智谱 Anthropic 兼容端点 |
245 | | -# 'model': 'glm-5.1', # 智谱 model id,无 [1m] 支持 |
246 | | -# 'max_retries': 3, # int |
247 | | -# 'connect_timeout': 10, # int 秒 |
248 | | -# 'read_timeout': 180, # int 秒 |
249 | | -# # 'fake_cc_system_prompt': False, # 智谱不做 CC 指纹校验,保持默认 False |
250 | | -# } |
251 | | - |
252 | | -# ── 1f. MiniMax Anthropic 路径(推荐——无额外 <think> 标签)──────────────── |
253 | | -# MiniMax 同时提供 OAI 和 Anthropic 兼容接口,同一个 key 两个端点都能用: |
254 | | -# - /v1 → chat/completions (LLMSession) |
255 | | -# - /anthropic → Anthropic Messages (NativeClaudeSession) |
256 | | -# Anthropic 路径更简洁,OAI 路径会返回 <think> 标签(M3/M2.7 自带思考)。 |
257 | | -# 温度自动修正为 (0, 1],支持 M3 / M2.7 全系列,M3 512K 上下文。 |
258 | | -# native_claude_config_minimax = { |
259 | | -# 'name': 'minimax-anthropic', # /llms 显示名 |
260 | | -# 'apikey': 'sk-<your-minimax-key>', # 与 OAI 路径同一个 key |
261 | | -# 'apibase': 'https://api.minimaxi.com/anthropic', # Anthropic Messages 兼容端点 |
262 | | -# 'model': 'MiniMax-M3', |
263 | | -# 'max_retries': 3, # int |
264 | | -# # 'fake_cc_system_prompt': False, # MiniMax 不做 CC 指纹校验 |
265 | | -# } |
266 | | - |
267 | | -# ── 1g. Kimi for Coding (Anthropic 兼容 CC 透传端点) ────────────────────── |
268 | | -# Kimi 官方为 Claude Code / Codex 开放的 /coding 路径,走 Anthropic 协议。 |
269 | | -# 与 4b 的 Moonshot OAI 路径是两回事:model 用 'kimi-for-coding'(非 kimi-k2)。 |
270 | | -# 官方硬要求透传 CC system prompt → fake_cc_system_prompt=True 必填。 |
271 | | -# 文档: https://www.kimi.com/code/docs/third-party-tools/other-coding-agents.html |
272 | | -# native_claude_config_kimi = { |
273 | | -# 'name': 'kimi-coding', # /llms 显示名 & mixin 引用名 |
274 | | -# 'apikey': 'sk-kimi-<your-kimi-coding-key>', # Bearer 鉴权 |
275 | | -# 'apibase': 'https://api.kimi.com/coding',# Anthropic 兼容端点 |
276 | | -# 'model': 'kimi-for-coding', # 官方 coding 专用 model id |
277 | | -# 'fake_cc_system_prompt': True, # 必填;官方硬要求透传 CC 系统串 |
278 | | -# 'thinking_type': 'adaptive', # 'adaptive'/'enabled'/'disabled' |
279 | | -# } |
280 | | - |
281 | 228 | # ══════════════════════════════════════════════════════════════════════════════ |
282 | 229 | # 2. NativeOAISession — OpenAI 协议 + 原生工具 |
283 | 230 | # ══════════════════════════════════════════════════════════════════════════════ |
|
322 | 269 | # } |
323 | 270 |
|
324 | 271 |
|
325 | | -# ══════════════════════════════════════════════════════════════════════════════ |
326 | | -# 3. LLMSession / ClaudeSession — 非 Native 文本协议工具(deprecated) |
327 | | -# ══════════════════════════════════════════════════════════════════════════════ |
328 | | -# ⚠ 后续版本可能移除非 Native session。新用户请直接使用上面的 Native 配置。 |
329 | | -# 非 Native 把工具描述放在 text 字段里,兼容性广但对 overfit 模型效果打折。 |
330 | | -# 变量名含 'oai'(不含 native)→ LLMSession;含 'claude'(不含 native)→ ClaudeSession。 |
331 | | -# |
332 | | -# oai_config = { |
333 | | -# 'name': 'my-oai-proxy', # /llms 显示名 & mixin 引用名 |
334 | | -# 'apikey': 'sk-<your-proxy-key>', # Bearer 鉴权 |
335 | | -# 'apibase': 'http://<your-proxy-host>:2001', # 自动补 /v1/chat/completions |
336 | | -# 'model': 'gpt-5.4', # 或 claude-opus-4-7、gemini-3-flash 等 |
337 | | -# 'api_mode': 'chat_completions', # 'chat_completions'(默认)|'responses' |
338 | | -# # 'reasoning_effort': 'high', # none|minimal|low|medium|high|xhigh |
339 | | -# 'max_retries': 3, # int 默认 1 |
340 | | -# 'connect_timeout': 10, # int 秒 默认 5(最小 1) |
341 | | -# 'read_timeout': 120, # int 秒 默认 30(最小 5) |
342 | | -# # 'temperature': 1.0, # float 默认 1.0 |
343 | | -# # 'max_tokens': 8192, # int 默认 8192 |
344 | | -# # 'proxy': 'http://127.0.0.1:2082', # 可选单 session HTTP 代理 |
345 | | -# # 'context_win': 16000, # int 默认 24000;历史裁剪阈值 |
346 | | -# } |
| 272 | +# ── 其他 OAI 兼容渠道 ────────────────────────────────────────────────────── |
| 273 | +# Moonshot/Kimi、MiniMax、OpenRouter、智谱等的 OAI 端点同样照上面写法填即可: |
347 | 274 | # |
348 | | -# # 多配几个也行,变量名含 'oai' 即可 |
349 | | -# # oai_config2 = { |
350 | | -# # 'apikey': 'sk-...', |
351 | | -# # 'apibase': 'http://your-proxy:2001', |
352 | | -# # 'model': 'claude-opus-4-7', |
353 | | -# # } |
354 | | - |
355 | | - |
356 | | -# ══════════════════════════════════════════════════════════════════════════════ |
357 | | -# 4. 其他 Native 兼容渠道 |
358 | | -# ══════════════════════════════════════════════════════════════════════════════ |
359 | | - |
360 | | -# ── 4a. MiniMax OAI 路径 (/v1 chat/completions) ──────────────────────────── |
361 | | -# OAI 路径会返回 <think> 标签(M3/M2.7 自带思考);Anthropic 路径更简洁(见 1f)。 |
362 | | -# 温度自动修正为 (0, 1],支持 M3/M2.7 全系列,M3 512K 上下文。 |
363 | | -# oai_config_minimax = { |
364 | | -# 'name': 'minimax-oai', # /llms 显示名 |
365 | | -# 'apikey': 'sk-<your-minimax-key>', # 形如 sk-cp-xxxxxxxxx;Bearer 鉴权 |
366 | | -# 'apibase': 'https://api.minimaxi.com/v1', # OAI 兼容端点 |
367 | | -# 'model': 'MiniMax-M3', # 名含 'minimax' → temp 夹到 (0.01,1.0] |
368 | | -# 'context_win': 50000, # int;MiniMax M3 512K 上下文,此处是裁剪阈值 |
369 | | -# } |
370 | | - |
371 | | - |
372 | | -# ── 4b. Kimi / Moonshot (OAI 兼容) ────────────────────────────────────────── |
373 | | -# 注意:Kimi/Moonshot 温度会被 llmcore.py 强制改为 1.0,写什么都会被覆盖。 |
374 | | -# oai_config_kimi = { |
375 | | -# 'name': 'kimi-k2', # /llms 显示名 |
376 | | -# 'apikey': 'sk-<your-moonshot-key>', # Bearer 鉴权 |
377 | | -# 'apibase': 'https://api.moonshot.cn/v1', # Moonshot OAI 端点 |
378 | | -# 'model': 'kimi-k2-turbo-preview', # 名含 'kimi' 或 'moonshot' → temperature 被强制 1.0 |
379 | | -# # 'temperature': 0.3, # ← 无效,会被 llmcore 覆盖为 1.0 |
380 | | -# # 'max_tokens': 8192, # int 默认 8192 |
381 | | -# } |
382 | | - |
383 | | - |
384 | | -# ── 4c. OpenRouter (OAI 协议多模型中继) ───────────────────────────────────── |
385 | | -# OpenRouter 是最通用的多模型 OAI 中继,https://openrouter.ai/api/v1。 |
386 | | -# model 名用 provider/model 格式(如 anthropic/claude-opus-4-7)。 |
387 | | -# oai_config_openrouter = { |
388 | | -# 'name': 'openrouter-claude', # /llms 显示名 & mixin 引用名;省略则取 model |
389 | | -# 'apikey': 'sk-or-<your-openrouter-key>', # OpenRouter key 形如 sk-or-xxx;Bearer 鉴权 |
390 | | -# 'apibase': 'https://openrouter.ai/api/v1', # 补齐到 /v1/chat/completions |
391 | | -# 'model': 'anthropic/claude-opus-4-7', # provider/model 格式 |
392 | | -# 'max_retries': 3, # int 默认 1 |
393 | | -# 'connect_timeout': 10, # int 秒 默认 5(最小 1) |
394 | | -# 'read_timeout': 120, # int 秒 默认 30(最小 5) |
395 | | -# } |
| 275 | +# 厂商 apibase model 备注 |
| 276 | +# ────────────────────────────────────────────────────────────────────────────── |
| 277 | +# Moonshot https://api.moonshot.cn/v1 kimi-k2-turbo-preview 温度被强制 1.0 |
| 278 | +# MiniMax https://api.minimaxi.com/v1 MiniMax-M3 回复带 <think> 标签, |
| 279 | +# 建议改用 Anthropic 路径(1d) |
| 280 | +# OpenRouter https://openrouter.ai/api/v1 anthropic/claude-opus-4-7 provider/model 格式 |
396 | 281 |
|
397 | 282 |
|
398 | 283 | # ══════════════════════════════════════════════════════════════════════════════ |
|
426 | 311 | # 'secret_key': 'sk-lf-...', |
427 | 312 | # 'host': 'https://cloud.langfuse.com', # 或自托管地址 |
428 | 313 | # } |
| 314 | + |
0 commit comments