LLM 默认模型解析
本文记录当前真实生效的默认模型规则(text / image / video)。
单一事实来源
- 默认模型统一由
model_settings单例表维护:default_text_model_iddefault_image_model_iddefault_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」文案。