纳米AI文件解析卡在“解析中”是因文档存在图像型PDF、损坏ZIP、编码异常TXT或加密Office等不可见缺陷。需先验证文件可解析性，再按四类问题针对性修复并创建最小案例定位根源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
纳米AI知识库文件上传后长时间卡在“解析中”状态，既不报错也不完成，说明文档解析流水线在加载、清洗或分块环节发生了静默阻塞，常见于扫描PDF、损坏ZIP、编码异常TXT等不可见缺陷。
先确认是不是文件本身不可解析
打开你上传的原始文件：如果是PDF，用鼠标尝试选中任意一段文字——选不中即为图像型PDF，纳米AI无法直接提取文本，必须先OCR；如果是ZIP，右键→“属性”→查看“大小”是否为0字节或显示“访问被拒绝”；如果是TXT，用记事本打开，观察首行是否出现乱码符号（如“縺･繧､繝ｼ繝ｫ”），这表示文件实际为GBK编码但被识别为UTF-8。
这一步不用打开任何AI界面，5秒内就能判断问题根源。
强制中断并重试解析
方法一：网页端立即终止
在知识库文件列表页，找到该文件右侧的「⋯」按钮→点击「取消解析」→等待1秒后，手动刷新页面。若仍显示“解析中”，说明后台任务未释放，需进入下一步。
方法二：桌面版底层清空缓存
关闭纳米AI → 按 Win+R 输入 %appdata%\NanoAI\cache → 找到以 doc_parser_ 开头的临时文件夹 → 全选删除 → 重启软件。【旧解析任务残留会锁死文件句柄，导致同名文件反复卡住】
纳米AI是一款基于人工智能大模型技术开发的智能应用工具，主要用于提供AI问答、内容生成、信息整理与智能搜索辅助等功能。用户可通过自然语言交互方式获取结构化信息与文本内容，用于学习、办公及内容创作等多种场景。
针对性修复四类高危文件
第一步：扫描PDF必须预处理
用福昕PDF编辑器或Adobe Acrobat Pro打开该PDF→点击「工具」→「增强扫描文档」→勾选“识别文本（OCR）”→导出为“可搜索PDF”→重新上传。不要跳过这步，纳米AI不内置OCR引擎，对纯图PDF无解析能力。
第二步：ZIP包需验证完整性
用7-Zip右键解压该ZIP→若弹出“文件损坏”提示，说明压缩包已损；若能解压但内部含大量零字节文件（大小为0 B），则需回溯原始文件夹，重新打包为ZIP并勾选“存储”模式（不压缩）再上传。
第三步：TXT/CSV务必指定编码
用VS Code打开该文件→右下角查看当前编码（如显示“GBK”）→点击编码名称→选择「Reopen with Encoding」→选“UTF-8”→保存。若保存失败，说明含非法字符，此时需启用「查找→替换」，将全角空格（ ）、不间断空格（ ）等不可见字符批量替换为英文空格。
第四步：Office文档避免宏与加密
用WPS或Office打开DOCX/XLSX→「文件」→「信息」→确认“保护文档”未启用密码或限制编辑；另存为“Word 97-2003文档（*.doc）”格式再上传。【纳米AI对含VBA宏或数字签名的Office文件会主动跳过解析，且不提示原因】
创建最小可运行案例复现问题
① 从原文件中手动截取前3页（PDF）/前10行（CSV）/前1段（TXT）→另存为新文件；
② 删除所有图片、表格、页眉页脚等非正文元素；
③ 上传这个精简版文件到新建知识库；
④ 若成功解析，说明原文件结构存在隐性冲突点，需按上述四类逐项排查；
⑤ 若仍卡住，复制该精简文件发给纳米AI技术支持（support@nanoai.cn），附上文件哈希值（PowerShell中执行 Get-FileHash -Algorithm SHA256 文件名）。
