标签： Python

此报错通常发生在尝试用 ollama run hf.co//: 直接拉取 HuggingFace 上分片（sharded）GGUF 模型的场景。优先排查该仓库是否只包含分片文件，因为 Ollama 注册表拉取尚不支持分片 GGUF，需改为下载到本地目录后用 o

当 Hugging Face Space 以 iframe 形式嵌入 huggingface.co、而浏览器限制第三方 Cookie 时（典型场景是隐身/无痕窗口），Gradio 的 OAuth 登录会话无法建立，表现为每次登录成功后立即被遗忘、OAuth 反复重启。优先排查会话 Cookie 能否

在 Dify 自托管源码环境中使用文本分段（如知识库文档处理）时，若把非 ASCII 字符（中文句号「。」、重音字符、emoji 等）设为固定分隔符，分隔符会被 codec 错误解码成乱码，导致固定分隔符分段失效。优先排查分隔符的编码处理逻辑，而非分段参数本身。

该问题通常出现在 Dify 自托管环境中批量生成文档嵌入（缓存嵌入）时：当某个输入的向量无效（归一化后为 NaN）而被跳过，缩短后的有效向量列表会错位压缩，导致后续有效向量与错误的输入（文本哈希或文件 ID）配对并写入缓存。排查重点是 CacheEmbedding 中跳过无效向量后“有效向量与原批次

该报错通常发生在 Dify 新版 Agents 平台中，Agent 引用了自定义 API 工具提供商（custom API tool provider）后，打开 /agents//configure 配置页时触发。优先排查 Agent 的 configure 页在解析工具授权时，

当模型通过 call_tool 调用 search_web，且查询串里带引号短语时，模型把内层引号转义成了 "" 而不是 \" ，导致 params 字符串不是合法 JSON，工具调用在解析阶段失败。优先排查模型输出的 tool-call 参数本身是否合法。

使用 Open WebUI 的“Stylized PDF Export”（默认开启）导出聊天 PDF 时，如果内容跨越多页，页面接缝处的文字行会被水平切成两半。该问题属于导出渲染按固定 A4 高度切片导致的版面缺陷，优先排查是否开启 Stylized PDF Export，并决定是否临时改用纯文本导