分类： AI 工具排错

当客户端（例如 VS Code Language Model provider / GitHub Copilot Chat 集成）通过 /api/tags 判断模型能力时， deepseek-r1 会缺少 tools 能力，导致工具调用被误判为不支持。这是 Ollama 列表缓存路径读取 GGUF

当 Ollama 的推理因“超过最大 token 重复限制”被强制终止时，OpenAI 兼容接口返回的 JSON 里 finish_reason 为 null ，而不是正常的 stop ，导致 OpenAI .NET 等客户端抛出 Unknown ChatFinishReason value. 。优

使用 OpenAI Python SDK 的 Responses 流式累加器时，如果上游（尤其是 OpenAI 兼容的第三方 provider）发送的 response.output_item.added 事件里 item 为 null ，SDK 会在读取 event.item.type 时直接崩溃

当调用 vector_stores.files.upload_and_poll() 时，文件上传成功、挂载到 vector store 也成功，但该 SDK 调用会无限期阻塞，底层文件状态一直停在 in_progress 。优先排查的是服务端向量存储文件处理/索引是否卡住，并给轮询加上超时上限，避免

这个报错通常出现在使用 OpenAI Python SDK 消费流式响应（stream=True）时，如果流中途发生读取超时或连接中断，SDK 没有包装异常，而是直接把原始 httpx 异常抛出；优先排查你的异常捕获是否只写了 except openai.APIError ，以及你是否依赖 max_

这个报错通常出现在使用 Gradio gr.Audio(..., streaming=True, format='wav') 接收分块音频流的场景中，表现为播放时声音不连续、断断续续。优先排查向 streaming=True 的 Audio 输出 yield 音频分块的方式，而不是先怀疑模型或音频数