Skip to content
LLM 默认模型解析

LLM 默认模型解析

本文记录当前真实生效的默认模型规则(text / image / video)。

单一事实来源

  • 默认模型统一由 model_settings 单例表维护:
    • default_text_model_id
    • default_image_model_id
    • default_video_model_id
  • models 表不再承担“默认模型”语义,models.is_default 已下线。

解析规则

  • 运行时按类别读取 model_settings 对应字段。
  • 若对应默认模型 ID 未配置,服务返回 503(No default model configured for category=...)。
  • 若配置了模型 ID 但模型不存在,服务返回 503(Configured default model not found: ...)。

管理入口

  • 默认模型仅通过 LLM Model Settings 接口维护(/api/v1/llm/model-settings)。
  • 模型列表(/api/v1/llm/models)仅维护模型实体信息(名称、类别、供应商、参数等),不再提供默认切换语义。

生产依赖边界

  • langchain-openai 是文本模型运行时依赖,必须声明在 [project].dependencies,不能只放在 dev 组。
  • systemd 发布使用 uv sync --frozen --no-dev 后直接运行 .venv/bin/uvicorn / .venv/bin/celery,不会自动安装 dev 依赖。
  • 发布脚本在切流前运行 backend/scripts/check_runtime_dependencies.py,显式导入 langchain_openai、openai、tiktoken 与 ChatOpenAI;导入失败会阻止发布。
  • ChatOpenAI 的导入统一走 app/services/llm/chat_model_loader.py。导入异常会记录完整堆栈,并把异常类型与真实消息返回为 503,不再复用固定的「安装 dev 依赖 / style analysis」文案。