qoder本地模型无响应时，需依次验证qoder-modeld进程存活、8080端口连通性及startup.log日志中的初始化错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Qoder中加载本地大模型（如Llama3-70B、Qwen2.5-72B或Phi-4）后，发现推理无响应、Quest卡在“等待模型就绪”、或CLI提示model not ready，说明模型服务未正常启动或健康检查失败。必须立即验证其运行状态，否则后续所有Agent调用、上下文生成、工具链执行都将中断。
确认模型服务进程是否存活
Qoder本地模型由独立的qoder-modeld守护进程托管，不依赖主CLI进程。该进程一旦崩溃或被误杀，模型将彻底不可用，但Qoder UI可能仍显示“已加载”假象。
第一步：打开终端，执行ps -ef | grep qoder-modeld（Linux/macOS）或tasklist /fi "imagename eq qoder-modeld.exe"（Windows）。
第二步：若输出中不含qoder-modeld或仅显示grep自身进程，则模型服务已退出。此时不要重启Qoder，直接执行qoder model start --force强制拉起服务。
第三步：若进程存在但状态为S（休眠）而非R（运行），说明模型正在加载权重但卡在GPU显存分配阶段——需检查nvidia-smi或rocm-smi中显存占用是否已达98%以上。【此时强行kill再start会触发CUDA context重置失败，必须先释放显存】
验证模型HTTP端口是否可连通
Qoder默认通过http://127.0.0.1:8080/v1/chat/completions与本地模型通信。端口被占用、防火墙拦截或绑定地址错误都会导致连接拒绝，而Qoder日志仅报connection refused，不提示具体原因。
方法一：用curl -X POST http://127.0.0.1:8080/health发起健康检查。返回{"status":"ok","uptime_sec":127}表示服务就绪；若报Failed to connect，说明端口未监听。
方法二：用netstat -ano | findstr :8080（Windows）或lsof -i :8080（macOS/Linux）确认端口归属进程。若显示PID不属于qoder-modeld，而是java.exe或python.exe，说明其他服务占用了该端口，需修改Qoder模型配置中的port字段。
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载，专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统，支持本地高效运行与多模态交互，集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载，确保安全稳定，助您实现智能办公与创作升级。
注意：若使用WSL2，127.0.0.1在Windows侧无法访问WSL内服务。此时必须改用http://localhost:8080并确保WSL2的/etc/wsl.conf中启用networking=true。
读取模型专属日志定位初始化失败点
模型服务的日志与Qoder主日志分离，独立存储于~/.qoder/models/{model_id}/logs/目录下，其中startup.log记录从加载GGUF文件到注册路由的全过程，是诊断model not ready的唯一权威依据。
① 进入对应模型日志目录：cd ~/.qoder/models/llama3-70b-q4_k_m/logs（将llama3-70b-q4_k_m替换为你实际使用的模型ID）。
② 执行tail -n 50 startup.log查看最后50行。重点关注三类关键标记：
— 出现ERROR: failed to mmap weights：表示GGUF文件损坏或磁盘空间不足，需校验SHA256并清理/tmp临时目录；
— 出现INFO: loaded tokenizer in X.XXms但无后续INFO: model loaded：说明KV cache初始化失败，需检查qoder model config中gpu_layers是否超出显卡显存容量；
— 出现WARN: no CUDA devices found, falling back to CPU且耗时超120秒：表明CUDA驱动版本不兼容（要求≥12.4），必须升级NVIDIA驱动至550.54以上。
