qoder自定义模型返回为空通常因prompt结构缺失、上下文超限或模型路由错误所致；需检查##输出格式要求是否存在且唯一、上下文是否触发静默截断、以及model_route.json中target地址是否有效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder自定义模型返回内容为空，通常不是模型本身失效，而是请求未被正确解析或响应被意外截断——比如Prompt结构缺失关键模块、上下文超限未触发告警、或输出格式约束与模型实际生成逻辑冲突。
检查Prompt是否包含强制输出标识
Qoder在解析自定义模型指令时，会优先识别以##开头的结构化区块；若无## Output Format或## 输出要求等明确指令，模型可能默认返回空字符串或仅输出思考过程。
打开指令管理页中对应指令的编辑框，确认Prompt末尾存在类似以下格式的强制输出声明：
## 输出格式要求
仅返回可直接执行的JSON对象，字段必须包含code、language、explanation三项，禁止任何额外说明、Markdown代码块包裹或换行符。
【Output Format区块必须存在且唯一】。若出现两个## 输出格式要求，或该区块被注释符号#包围，Qoder将跳过解析，导致返回为空。
验证上下文是否触发Token截断
自定义模型调用时若携带大量上下文（如粘贴了200行代码+3个依赖声明），即使未报错“context length exceeded”，也可能因内部缓冲策略导致响应体被静默丢弃。
第一步：临时删减Prompt中非必要内容，只保留角色定义+任务目标+1个最小上下文示例（不超过8行）；
第二步：保存指令后，在对话框输入/指令名测试；
第三步：若返回正常，说明原Prompt已超安全窗口——此时需启用Qoder的自动分块机制。
进入Qoder设置→高级→上下文处理，开启“启用长上下文智能切片”，并把context_window参数设为4096（不要设8192，该值在多数本地部署场景下会引发服务端截断）。
排查模型路由是否指向空响应实例
方法一：直连模型端点验证
在终端执行curl命令，绕过Qoder前端直接调用底层模型服务：
curl -X POST http://127.0.0.1:8080/v1/chat/completions \
-H "Content-Type: application/json" \
-d '{"model":"qwen3","messages":[{"role":"user","content":"hello"}]}'
若返回{"choices":[{"message":{"content":""}}]}，说明模型服务本身异常，需重启Lingma进程并检查日志中是否有"empty response from model server"字样。
方法二：检查QODER_HOME/rules/model_route.json
打开该文件，定位到你使用的自定义模型名称所在段落，确认target字段指向的是真实可用的endpoint地址，而非占位符如"http://localhost:0"或注释掉的旧路径。
若target值为空字符串或含非法字符（如中文冒号、全角斜杠），Qoder将无法建立有效转发，直接返回空响应。
