Kimi文件上传失败需排查四方面：①确认右上角出现绿色对勾“已上传”提示，超90秒未完成应关页重试；②验证PDF为可选中文本型，扫描图需OCR转换并确保Ctrl+A可复制；③检查文件≤50MB且≤100页，超限须用PDFsam分拆；④上传后必须看到“已启用文档理解模式”，否则重置对话并发送/reload触发解析。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
上传文件到Kimi后界面无响应、不显示“已启用文档理解模式”、输入指令无反馈或提示“文件解析失败”，说明文件未被真正加载进上下文，必须立刻排查底层兼容性与传输完整性问题。
先确认文件是否真的上传成功
点击输入框右侧的“+ 添加文件”图标→选择文件后，观察右上角是否出现带绿色对勾的“已上传：xxx.pdf”提示；若仅显示灰色“上传中…”且持续超过90秒，说明传输中断或被前端拦截。
此时不要刷新页面——【刷新会清空未完成的上传队列，已传部分丢失且不可恢复】。应直接关闭当前标签页，重新打开kimi.moonshot.cn，再试一次上传。
检查PDF是否为Kimi可解析的文本型格式
打开该PDF文件→用鼠标拖选任意一段文字：能高亮并复制，说明是文本型PDF；若无法选中，就是扫描图片型PDF，Kimi根本读不到一个字。
遇到图片型PDF，必须先做OCR转换：用Adobe Acrobat打开→“工具”→“增强扫描”→“识别文本”→导出为新PDF；或用天若OCR批量处理，导出时勾选“保留原始排版+嵌入可搜索文本”。
注意：转换后务必再次验证——Ctrl+A全选→能复制出干净中文才算合格。否则Kimi仍会返回“未识别到有效文本”。
验证文件大小与页数是否超限
Kimi网页端单次上传严格限制：文件体积≤50MB，页数≤100页。超任一值，系统静默截断，不报错也不提示。
方法一（快速自查）：右键PDF文件→“属性”→查看“大小”和“页数”（Win11/Office 365环境下通常显示）；
方法二（精准判断）：用WPS PDF打开→底部状态栏直接显示总页数；用7-Zip右键“查看”可读取精确字节数。
使用 Moonshot Kimi API 的 $web_search 内置工具进行联网搜索。当需要进行网络搜索获取实时信息时使用，支持中文和英文搜索查询。需要配置 MOONSHOT_API_KEY。
若超限，立即分拆：用PDFsam Basic按每40页切分→导出为“报告_01.pdf”“报告_02.pdf”等带序号的文件→逐个上传。
排除加密与权限干扰
第一步：用Adobe Reader打开PDF→尝试“另存为”→若弹出密码框，说明存在打开密码；
第二步：在Adobe Reader中按Ctrl+D→切换到“安全性”选项卡→查看“文档限制”是否标注“不允许复制文本”或“禁止文档提取”；
第三步：如确认受限，需用Adobe Acrobat Pro执行“移除安全性”操作：文件→属性→安全性→设为“无安全性”→保存。免费工具如PDF Candy在线版也支持解密，但【切勿上传含敏感信息的加密PDF至不明第三方网站】。
强制触发文档理解模式
上传完成后，必须手动激活深度解析：
① 等待右上角出现“已启用文档理解模式”提示（非“已上传”）；
② 若无此提示，点击输入框下方“大纲”按钮——若弹出空白或报错，证明解析失败；
③ 此时立即执行：点击对话界面左上角“重置对话”→重新上传同一文件→上传完毕后，输入“/reload”并发送；
④ 看到顶部工具栏出现蓝色“大纲”按钮且点击后左侧导航栏列出完整章节，才算真正就绪。
