qoder报“model not found”主因是模型未被ollama注册、vllm未正确挂载或配置中模型名大小写/后缀不匹配；需执行ollama list验证注册、用ollama pull或create加载模型、确保vllm --model值与qoder配置完全一致，并修正config.yaml中model字段为ollama list输出的完整名称（含冒号及tag），最后重启qoder生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Qoder中执行本地模型调用时，界面或CLI报错“Model not found”或“Model does not exist”，这通常不是模型文件真的丢失，而是Qoder无法按预期路径定位、加载或识别已部署的模型——尤其常见于Ollama未注册、vLLM服务未挂载、GGUF路径未写入配置或模型名大小写/版本后缀不匹配等场景。
确认Ollama中模型是否真正注册成功
Qoder依赖Ollama的/api/tags接口获取可用模型列表，若模型仅下载到磁盘但未被Ollama识别，Qoder会直接判定“不存在”。
第一步：在终端运行ollama list，检查输出中是否包含你期望的模型名（如qwen2.5-coder:14b）及其状态为latest。
第二步：若列表为空或缺失目标模型，执行ollama pull qwen2.5-coder:14b——注意必须使用Ollama官方镜像名，不能用本地文件路径或自定义别名。
第三步：若pull失败并提示manifest unknown，说明该tag在Ollama Registry中不存在；此时需改用ollama create -f Modelfile qwen2.5-coder:14b从本地GGUF文件构建，且Modelfile中FROM路径必须为绝对路径，例如FROM /home/user/models/qwen2.5-coder.Q4_K_M.gguf。
【关键前提】Ollama服务进程必须正在运行，且端口11434未被其他程序占用；否则ollama list将返回空结果，Qoder自然查不到模型。
验证vLLM服务是否正确挂载GGUF模型
如果你绕过Ollama、直接用vLLM启动本地GGUF模型，Qoder需通过OpenAI兼容API访问vLLM，而模型名必须与vLLM启动参数中的--model值完全一致。
方法一：检查vLLM启动命令是否包含--model参数且值与Qoder配置匹配
例如，若你用vllm serve --model ./models/qwen3-0.6b.Q4_K_M.gguf --dtype auto启动服务，则Qoder中配置的model字段必须为qwen3-0.6b.Q4_K_M.gguf（不含路径），不能写成qwen3-0.6b或Qwen3-0.6B。
方法二：直接请求vLLM健康检查端点确认模型加载状态
执行curl http://127.0.0.1:8000/v1/models，响应体中data[0].id字段必须精确等于你在Qoder里填写的model名称；若返回空数组或"error": "Model not found"，说明vLLM根本没加载该模型，需回溯GGUF文件路径是否可读、是否损坏、是否被杀毒软件锁定。
修正Qoder配置中模型名与路径的大小写及后缀
Qoder对模型标识符区分大小写，且部分后端（尤其是Ollama）要求tag后缀严格匹配。一个字母错误或漏掉:latest都会导致“不存在”错误。
第一步：打开Qoder配置文件~/.qoder/config.yaml（Windows为%USERPROFILE%\.qoder\config.yaml）
第二步：定位llm:区块下的model:字段，将其值设为Ollama中ollama list输出的**完整名称**，包括冒号和tag，例如qwen2.5-coder:14b，而非qwen2.5-coder或Qwen2.5-Coder:14b。
第三步：若使用vLLM或自定义GGUF路径，在base_url:指向的服务端，确保该服务本身支持你填写的model名——很多GGUF加载器默认将文件名作为model id，所以qwen3-0.6b.Q4_K_M.gguf就只能用qwen3-0.6b.Q4_K_M.gguf调用，不能省略.Q4_K_M。
第四步：保存配置后，重启Qoder CLI或关闭并重新打开Qoder编辑器界面，使新配置生效。
