秘塔ai上传失败时，先检查文件扩展名（仅pdf/docx/txt/pptx/xlsx）、文件名（禁用全角符号如「」『』）、大小（≤50mb），再启用浏览器web share和file system access api，或通过console注入二进制流强制上传。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
秘塔AI上传文档失败时，页面常卡在“正在解析”或直接报错“文件格式不支持”“上传超时”，但错误提示不说明真实原因——这往往不是网络问题，而是文件本身、浏览器环境或上传路径触发了秘塔的隐性校验规则。
先确认文件是否被系统静默拦截
打开秘塔AI上传界面后，拖入文件→观察右下角是否出现“✅ 已添加”但无进度条；若仅显示“⚠️ 文件待处理”，说明该文件已被前端拦截。秘塔会在上传前做三重轻量校验：文件扩展名是否在白名单内（仅接受PDF/DOCX/TXT/PPTX/XLSX）、文件名是否含非法字符（如`|`、``、`*`、`?`）、文件大小是否超过单次50MB硬限制。【文件名含中文括号（）不算非法，但含全角符号如「」、『』会触发拦截】
把文件重命名为纯英文+数字组合（如report_20260930.pdf），再试一次。这一步操作起来很简单，直接右键改名就行。
检查浏览器是否禁用关键API
Chrome或Edge用户需确认是否关闭了Web Share API和File System Access API。打开浏览器地址栏输入chrome://flags/#web-share→将“Web Share”设为Enabled→重启浏览器。若仍失败，再访问chrome://flags/#file-system-access→同样设为Enabled。
Firefox用户需手动开启：在地址栏输入about:config→搜索dom.filesystem.enabled→双击设为true。【禁用这两项会导致秘塔无法读取本地文件流，上传按钮点击无反应】
绕过前端校验的强制上传法
方法一：用Console注入原始二进制流
① 拖入一个能成功上传的测试文件（如1KB的TXT）→打开开发者工具（F12）→切换到Network标签页→点击上传→找到名为/api/v1/upload的请求→右键→Copy→Copy as fetch
② 新建空白TXT，粘贴刚复制的fetch代码→删掉其中body: formData整行→替换为：body: fileInput.files[0]（需提前在页面任意位置插入并选中你的目标文件）
③ 在Console中执行修改后的fetch命令。这步跳过了所有前端校验，直接向后端提交原始File对象。
方法二：改用API直传（适合技术用户）
访问https://metaso.cn/api/doc#tag/File-Upload获取最新上传接口文档→用curl或Postman构造multipart/form-data请求，Header中必须带Authorization: Bearer
