文件上传问题排查

文件上传问题大致可分为 无法选择文件、上传传输失败、处理失败或延迟、内容识别质量问题 四类。请先检查屏幕上的错误信息和文档状态。

首先需要检查的事项

文件选择窗口中不显示文件时

• Knowledge 首先支持 PDF、PPT/PPTX、DOC/DOCX、TXT 和 Markdown 文档。
• 样式页面使用 PNG、JPEG、WebP 和 GIF 图像。
• 文件选择器的格式过滤器可能会隐藏其他文件。
• 音频和视频文件即使在项目附件中也不受支持。
• 不要仅更改扩展名，而是用原程序支持的格式重新保存。

文件被标记为过大时

• Knowledge 的默认上限可能因运营设置约为 25 MB。
• 删除不必要的页面和高分辨率图像。
• 使用 PDF 优化或图像压缩。
• 将大文档按主题拆分为多个文件。
• 拆分文件时，在提示中说明文档间的关系和优先级。
• 上传支持的原始文件，而不是压缩 ZIP。

文件损坏或格式不匹配时

Rhetis 能检查扩展名之外的实际文件结构。即使文件名为 ".pdf"，但不是 PDF 结构，或 Office 文件容器损坏，也可能被拒绝。

1. 1

   在原程序中打开文件

   确认所有页面和幻灯片正常显示。

2. 2

   以新名称重新保存

   以最新的 PDF、PPTX 或 DOCX 格式创建新文件。

3. 3

   移除密码和限制

   确认文档具有上传权限，并准备去除密码保护的副本。

4. 4

   改为简单文件名

   删减特殊字符和过长名称，重新上传。

5. 5

   单独测试文件

   逐个上传文件，找出问题文件。

处理状态持续时间过长时

• 刷新页面后再次检查文档状态。
• 不要重复上传同一文件。
• 大文件或图像多的文档可能需要更长时间。
• 检查工作区上传策略和访问权限。
• 若状态长时间不变，按更小单元重新保存并上传。
• 检查其他文件是否正常处理，以区分文件问题与服务问题。

内容未被正确识别时

• 使用文本可选的原始 PDF。
• 将扫描文档重新生成为约 300 dpi 的清晰图像。
• 修正倾斜或翻转的页面。
• 若表格内文字过小，单独提供关键表格文件。
• 将图像中的关键句子与提示或文本文件一起发送。
• 对手写和复杂图示添加简短说明。

在 Home Composer 中附件消失时

• 在按发送按钮前确认附件芯片可见。
• 仅附加文件且文本为空时，提交可能被拒绝；请同时输入请求句。
• 刷新浏览器前可能需要重新选择文件。
• 若同时选择了不支持的音频/视频，需移除。
• 不要一次性放入多文件，分批尝试。

支持请求中应包含的信息

• 上传位置：Home、项目聊天、Knowledge、Style 或 Onboarding
• 文件扩展名和大小
• 错误信息和文档状态
• 浏览器和操作系统
• 发生时间
• 同一格式的其他文件是否成功
• 已去除敏感内容的测试文件或截图