标签： Python

当 Ollama 加载一个被截断或格式不完整的 GGUF 模型文件（blob）时， fs/gguf/gguf.go 的 Open() 会在解析 keyValues 前失败并提前返回，已由 newLazy 启动的 iter.Pull goroutine 不会被释放，同时底层文件句柄也未关闭。若反复对同

当 OTel 上报的 span 使用官方 semconv 属性名 gen_ai.usage.cache_write.input_tokens 时，Langfuse 的通用 GenAI usage extractor 无法识别这个 cache-write 桶，导致 cache-write token

该现象通常出现在包含 supervisor 与组员的多 agent 群组话题中，表现为服务端已完整留存消息、但客户端在某个边界（如第 160 条）之后不再渲染历史，断点之后新发消息也立即不可见。优先排查消息查询路径中 groupId 是否被正确传递，而不是先怀疑数据丢失。

该问题通常出现在 LobeChat 从 v2.2.15 升级到 v2.2.16 后打开群组话题（Group Topic）时，表现为聊天区域持续闪烁、无法稳定渲染，同时 Group Profile 加载失败。优先排查方向是 v2.2.16 引入的群组布局 Suspense/加载边界变更，最快的规避方式

当 OpenAI Python SDK 开启 DEBUG 日志级别时，SDK 会把请求头（包括 API key）以明文写入日志，导致密钥泄露到本地日志或错误追踪系统。优先检查依赖版本并升级到已修复版本，同时对已有日志和错误追踪上报做清理与脱敏。

这个报错通常出现在用 Pydantic BaseModel 给 Structured Outputs / Batch API 生成 response_format 时， to_strict_json_schema 输出里带了 $defs 和 $ref ，看起来不像期望的扁平 schema。优先排查的

当 OpenAI Python SDK 的 client.responses.stream() 连接的是 Codex 兼容后端（如 chatgpt.com/backend-api/codex/responses ）时，服务端会在 response.completed 事件里把 response.ou

这个报错通常出现在 InvokeAI Web 前端使用 socket.io 连接后端时：当服务器主动断开连接后，客户端自定义的重连次数上限（5 次）只覆盖“服务器主动断开”路径；一旦某次自定义重连在传输层失败（例如后端未启动、端口拒绝连接），socket.io Manager 会接管并进入无上限重连