name: xrk-llm description: 当你需要配置/新增/排查 LLM 提供商(OpenAI/Azure/Gemini/Anthropic/Ollama/各类兼容网关)时使用;确保 YAML/Schema/代码一致。
入口
docs/factory.md、src/factory/llm/LLMFactory.js、core/system-Core/http/ai.js
约定
- v3 请求
model= provider key;真实模型在 YAML 的model/chatModel(Azure 用deployment)。 - 配置:
data/server_bots/{port}/<provider>_llm.yaml或*_compat_llm.yaml(providers[].key)。 - Schema:
core/system-Core/commonconfig/*.js与 YAML 字段一致。 - HTTP:LLM 客户端使用全局
fetch+buildFetchOptionsWithProxy(#utils/llm/proxy-utils.js)。禁止node-fetch、https-proxy-agent。 - 超时:
AbortSignal.timeout;完整清单见 skillxrk-node-runtime。
排障顺序
- provider 是否在
LLMFactory.listProviders()/GET /api/v3/models model是否为 provider keybaseUrl+path拼接与authModeenableStream、enableTools与workflow.streams白名单