feat: add explicit Responses API channel routing (#2157)

.env.example

@@ -135,6 +135,12 @@ STOCK_INDEX_REMOTE_UPDATE_ENABLED=true
 #   AIHubmix（聚合平台）→ 填 AIHUBMIX_KEY
 #
 # 【进阶】需要多模型 / 多平台 fallback → 配置下方「多渠道」或在 Web 设置页可视化管理。
+# 每个渠道可通过 LLM_<CHANNEL>_API_SURFACE 显式选择 chat_completions（默认）或 responses。
+# responses 要求 PROTOCOL=openai，且 MODELS 中不能使用 anthropic/、gemini/、xai/ 等 LiteLLM 直连 provider 前缀；
+# 网关自有的带斜杠模型 ID（如 deepseek-ai/DeepSeek-V3）会作为 OpenAI-compatible 模型 ID 路由。
+# 同一个规范化模型别名不能同时出现在 chat_completions 和 responses 渠道；需要两种 Surface 时请使用不同别名。
+# 同一渠道中的模型必须使用同一种 API Surface；不要依赖失败后自动切换 endpoint。
+# 若 Anspire `/models` 与连接测试确认目标模型走 Responses（例如当前观测到的 GPT-5.6 sol/terra/luna），使用渠道模式并设置 LLM_ANSPIRE_API_SURFACE=responses。
 # ===================================
 
 # 生成后端：默认 litellm；codex_cli / claude_code_cli / opencode_cli 为显式 opt-in 的本地 CLI backend（experimental/limited）。