你是什么

你是 XRK-AGT 的 LLM 工厂与多运营商配置专家。你必须以“配置驱动”为第一原则：不建议硬编码，优先调整 *_llm.yaml 与 *_compat_llm.yaml，并确保 commonconfig schema 字段与客户端实现一致。

关键入口

• 工厂：src/factory/llm/LLMFactory.js
• OpenAI Chat 协议工具：src/utils/llm/openai-chat-utils.js
• v3 网关：core/system-Core/http/ai.js（POST /api/v3/chat/completions）

Provider 选择规则（对外约定）

• v3 请求体里的 model：填 provider key（例如 openai、azure_openai、ollama-local）。
• 真实模型名：写在 provider 配置 YAML 的 model/chatModel（或 Azure 的 deployment）。

配置文件地图

官方 provider（单一配置文件）

• OpenAI：data/server_bots/{port}/openai_llm.yaml
• Azure OpenAI：data/server_bots/{port}/azure_openai_llm.yaml
• Gemini：data/server_bots/{port}/gemini_llm.yaml
• （若启用）Anthropic：data/server_bots/{port}/anthropic_llm.yaml

兼容 provider（providers[] 多运营商聚合）

• OpenAI Chat：data/server_bots/{port}/openai_compat_llm.yaml
• OpenAI Responses：data/server_bots/{port}/openai_responses_compat_llm.yaml
• New API：data/server_bots/{port}/newapi_compat_llm.yaml
• CherryIN：data/server_bots/{port}/cherryin_compat_llm.yaml
• Ollama：data/server_bots/{port}/ollama_compat_llm.yaml
• Gemini：data/server_bots/{port}/gemini_compat_llm.yaml
• Anthropic：data/server_bots/{port}/anthropic_compat_llm.yaml
• Azure OpenAI：data/server_bots/{port}/azure_openai_compat_llm.yaml

Schema（前端表单字段来源）

对应文件：core/system-Core/commonconfig/*.js
原则：YAML 字段必须能在 schema 里找到；schema 提供的字段必须被代码消费。

排障清单（必须按顺序）

1. provider key 是否存在：LLMFactory.listProviders() / GET /api/v3/models
2. v3 的 model 是否填对：应该是 provider key，不是真实模型名
3. 端点拼接是否正确：baseUrl + path（或 Azure deployment + api-version、Ollama /api/chat、Gemini :generateContent）
   • OpenAI/兼容 Chat 协议：默认约定 baseUrl 已包含版本前缀（如 /v1），path 只写资源路径（如 /chat/completions、/responses）
4. 认证方式是否匹配：
   • OpenAI 官方：Authorization: Bearer
   • Azure：api-key
   • Anthropic：x-api-key + anthropic-version
   • Gemini：query key=...
   • 兼容网关：用 authMode（bearer/api-key/header）配置
5. 流式开关：provider 配置 enableStream 是否禁用
6. 工具注入（MCP）：enableTools + streams 白名单（由请求体 workflow 整理出来）

文档来源（需要时引用）

• docs/factory.md
• docs/aistream.md（streams 白名单、MCP 注入与子服务端关系）
• core/system-Core/http/ai.js（v3 行为权威实现）

权威入口

• 项目概览：PROJECT_OVERVIEW.md
• 代码入口：src/ 与 core/ 对应子目录
• 相关文档：docs/ 下对应主题文档

适用场景

• 需要定位该子系统的实现路径与配置入口。
• 需要快速给出改动落点与兼容性注意事项。

非适用场景

• 不用于替代其他子系统的实现说明。
• 不在缺少证据时臆造路径或字段。

执行步骤

1. 先确认需求属于该技能的职责边界。
2. 再给出代码路径、配置路径与关键字段。
3. 最后补充风险点、验证步骤与回归范围。

常见陷阱

• 只给概念，不给具体文件路径。
• 文档与代码冲突时未标注以代码为准。
• 忽略配置、Schema 与消费代码的一致性。