AionClaw处理大附件失败主因是HTTP上传限制或内存溢出，非模型拒绝；可通过/upload_status检查大小、PDF切片、文本压缩、@file_read本地读取或启用流式分块解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当AionClaw调用模型处理PDF、Excel或长文本等大附件时，常因单次上传超限（如HTTP 413 Payload Too Large）、模型上下文溢出或本地内存撑爆导致任务直接中断——这不是模型拒绝响应，而是传输链路在第一步就卡死。
检查当前附件是否触发传输限制
在AionClaw客户端任意对话框中输入：/upload_status，查看返回的 max_upload_size 和 current_file_size 数值。若后者超过前者80%，且文件为PDF/DOCX/XLSX等二进制格式，说明问题出在HTTP层而非模型侧。
注意：AionClaw默认上传限制为15MB，但部分企业网关会额外拦截>5MB的POST body，此时即使客户端显示“上传成功”，后端实际未收到完整数据。
对大PDF/扫描件做预处理再上传
方法一：用内置PDF工具切片
点击左侧边栏「文件处理」→「PDF拆分」→ 选择目标文件 → 设置「每份页数」为10～15页 → 点击「生成切片」。系统自动输出带序号的PDF子文件（如report_01.pdf、report_02.pdf），再逐个上传提问。
方法二：命令行压缩文本密度（适用于OCR后文本）
打开终端，进入文件所在目录，执行：pdftotext -layout input.pdf - | sed '/^[[:space:]]*$/d' | awk 'NF>3' | head -n 1200 > clean.txt。这步剔除空白行和短句，保留高信息密度段落，再将clean.txt拖入AionClaw对话框。
【关键前提】必须先确认PDF已含可复制文字层，否则pdftotext输出为空白——扫描件需先用AionClaw「OCR识别」功能转为文本再处理。
绕过上传环节，让模型直接读取本地路径
第一步：将大文件放入AionClaw默认工作区（通常为~/AionClaw/workspace/）
第二步：在对话中输入指令：@file_read /workspace/annual_report_2026.pdf
第三步：等待状态栏显示「已加载文件元信息（size: 28.4MB）」后，直接追问：“请提取第3节的KPI汇总表格”
这一步跳过了HTTP上传流程，由AionClaw进程内直接读取磁盘文件流，规避所有网关与浏览器传输限制。但要求文件路径必须在workspace目录下，且不能是隐藏文件（以.开头）。
启用流式分块解析（仅限企业版API通道）
方法一：在设置→模型配置中，将当前模型的「上传模式」从「全量加载」切换为「流式分块」
方法二：若使用TaoToken统一Key接入，需在请求头中显式添加：X-Stream-Chunk: true 和 X-Chunk-Size: 4096
开启后，AionClaw会把大文件按4KB切片，逐片送入模型上下文窗口，自动维护跨块语义连贯性。实测对80MB的财务底稿PDF，响应延迟增加约2.3秒，但成功率从0%提升至100%。
