minimax agent上传文件失败导致本地任务中断，主因是权限不足、路径错误、格式不符或内容不可解析；需授权磁盘访问、确保文件本地存在、遵守10文件/次及支持格式限制，并对扫描pdf做ocr预处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
MiniMax Agent上传文件失败时，无法继续执行依赖本地文件的任务，比如发票查重、简历筛选或本地文档解析，问题通常出现在权限、路径、格式或客户端限制环节。
确认Agent已获得完整文件读取权限
Mac系统需在「系统设置→隐私与安全性→完全磁盘访问权限」中勾选MiniMax Agent；Windows系统需在「设置→隐私→文件系统」中开启对MiniMax Agent的访问开关。未授权会导致文件读取直接返回空内容或报错“无权访问”，后续所有解析步骤全部失效。
若Agent提示“需要授予读取权限”，请立即操作——【跳过此步将导致所有本地文件任务静默失败】。
检查文件是否真实存在于本地路径
Agent不支持直接读取iCloud同步中但未下载到本地的文件。即使文件图标显示在桌面，右键查看属性若标注“仅存储在iCloud”，则必须先右键选择“下载到Mac”或“始终保留在此设备上”。
这一步容易被忽略：Agent会报“文件不存在”或“解析失败”，但实际是文件处于云端占位状态，根本未落盘。
打开访达（Finder），按Command+Shift+G，输入~/Desktop，确认目标文件确实以完整实体形式存在该目录下。
MiniMax MCP 服务器，提供网络搜索和图像理解能力。当用户需要：(1) 网络搜索信息，(2) 分析/描述图片，(3) 从URL提取内容时使用此技能。需配置 MINIMAX_API_KEY（国内版 api.minimaxi.com 或全球版 api.minimax.io）。
验证单次上传文件数量与格式限制
当前MiniMax Agent桌面端单次最多支持上传10个文件，超出后界面直接禁用提交按钮，无错误提示。
支持格式限于PDF、TXT、DOCX、XLSX、PNG、JPG、JPEG，不支持HEIC、MOV、ZIP解压前文件、加密PDF及带密码保护的Office文档。
方法一：拆分上传 将46张发票分为5批（10+10+10+10+6），每批单独上传并执行查重指令。
方法二：预合并处理 用Automator或Python脚本将多张发票PDF合并为单个PDF再上传，规避批次限制，同时确保Agent能跨页比对重复项。
排查文件内容可解析性
第一步：用系统预览（Preview）打开PDF，尝试文字选取——若无法选中任何文字，说明是扫描图像型PDF，Agent默认无法OCR识别。
第二步：对图像型PDF，先用Mac自带“自动增强”导出为新PDF，或使用Adobe Acrobat执行OCR，再上传。
第三步：避免上传含水印、密集底纹、倾斜排版的发票图片，这类干扰会显著降低文本提取准确率，导致金额/抬头识别失败。
如第四批运行中出现两张发票信息提取失败，大概率源于原始文件为低质量截图或压缩过度的JPG，而非Agent本身故障。
