Qoder本地模型调用失败需按顺序排查：①确认Lingma服务进程是否运行并监听正确端口；②绕过Windows回环限制或改用局域网IP绑定；③验证阿里云域名连通性及代理配置；④校验模型路径与GGUF文件完整性；⑤强制重置本地环境。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Qoder本地模型调用失败时，常见表现为Connection Refused、500/502错误、响应超时或返回空结果，根本原因往往不是模型本身损坏，而是服务未启动、网络策略拦截、配置路径错误或依赖缺失。必须逐层验证底层通信链路与运行环境一致性，跳过“重装”这类无效操作。

确认Lingma本地服务进程是否存活

Qoder所有本地模型调用都依赖Lingma.exe（Windows）或Lingma（macOS）后台进程提供HTTP接口，该进程一旦退出或崩溃，客户端必然报Connection Refused。

打开任务管理器（Windows）或活动监视器（macOS），搜索进程名“Lingma”。若未找到，说明服务未运行。

进入目录：【C:\Users\[用户名]\AppData\Local\.lingma\bin\x.x.x\CPU架构_64_系统\】（Windows）或【~/.lingma/bin/x.x.x/CPU架构_64_系统/】（macOS），双击执行Lingma.exe start（Windows）或终端中运行./Lingma start（macOS）。

等待命令行输出类似“Service started on http://127.0.0.1:22222”的日志，端口号必须为数字且非零——若显示“port 0”或“bind failed”，说明端口被占用，需先释放。

绕过Windows Loopback限制

Windows 10/11默认阻止IDE插件通过localhost访问本地服务，尤其在JetBrains、VS Code等沙盒环境中，这是“无法连接到本地服务”报错的首要原因。

方法一：PowerShell豁免（推荐）
以管理员身份启动PowerShell，执行：CheckNetIsolation LoopbackExempt -a -n="*"。该命令一次性豁免所有应用的回环通信，无需重启系统。

方法二：改用局域网IP绑定
编辑【C:\Users\[用户名]\AppData\Local\.lingma\config.json】，添加字段："host": "192.168.1.100", "port": 22222（请替换为本机实际局域网IP）。保存后彻底结束Lingma进程，再重启IDE。

注意：不要同时启用方法一和方法二，否则可能引发端口监听冲突。

验证API端点连通性与白名单状态

Qoder本地模型虽不依赖外网，但初始化阶段仍需访问两个阿里云域名完成鉴权与元数据拉取，任一地址被防火墙拦截都会导致服务启动卡死或后续调用失败。

Analyze Video By Qwen Free

Qwen 视频智能分析基础客户端（免费版），基于 Qwen 3.5 Plus 多模态模型对本地视频进行内容分析，支持场景描述与基础内容理解，采用默认抽帧频率和提示词，适合快速概览视频，API Key 读取自 ~/.skill-platform/skill-platform.json 的 skills 配置。

下载

第一步：测试核心域名连通性
在命令行中依次执行：
① curl -I https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping → 应返回HTTP 200及响应体“pong”
② curl -I https://devops.aliyun.com → 应返回HTTP 302重定向

第二步：若任一命令超时或报错“Failed to connect”，立即联系IT部门将这两个域名加入企业防火墙白名单；若白名单不可行，则手动配置代理——编辑【C:\Users\[用户名]\AppData\Local\.lingma\config.json】，修改http_proxy字段为公司提供的有效代理地址（格式必须含协议头与端口）。

检查模型路径与GGUF文件完整性

Qoder加载本地GGUF模型时，若路径错误或文件损坏，会静默失败——界面无报错，但请求始终超时或返回空响应。

确认模型文件位于：【C:\Users\[用户名]\.lingma\models\qwen3-0.6b.Q4_K_M.gguf】（Windows）或【~/.lingma/models/qwen3-0.6b.Q4_K_M.gguf】（macOS），且同目录下存在配套的tokenizer.json。

执行校验命令：sha256sum qwen3-0.6b.Q4_K_M.gguf，输出哈希值必须与官方发布的校验值完全一致（例如f8a7c2e9b1d4…），【任何字符差异都代表文件损坏，必须重新下载】。

这一步操作起来很简单，直接把模型文件拖进终端执行sha256sum就行，别跳过校验直接跑服务。

强制重置Qoder本地运行环境

当以上步骤均无异常却仍调用失败时，大概率是缓存污染或MCP服务状态错乱所致，需彻底清除残留状态。

第一步：结束所有Qoder相关进程
在任务管理器中结束“Lingma.exe”、“qoder-wake”、“Chainlit”等全部进程；macOS用户执行pkill -f lingma。

第二步：删除本地数据目录
彻底删除【C:\Users\[用户名]\.lingma】（Windows）或【~/.lingma】（macOS），包括models、libs、context、config.json等全部子项。

第三步：清理IDE缓存并重启
进入IDE菜单：File → Invalidate Caches and Restart → Invalidate and Restart，等待IDE完全重建索引后再启动Qoder CN插件。