References

文件类型和限制

在将文件添加到 Atoms 之前，请先检查大小和格式要求。限制取决于您的上传位置：聊天附件、Design 图片、应用品牌图片和头像各有不同规则。

上传、预览和处理是彼此独立的。上传成功并不保证 Atoms 能显示预览，也不保证智能体能够读取并使用文件中的全部内容。

聊天附件和文件夹限制

上传位置或操作	限制	预期结果
在首页或项目聊天中附加文件，包括视频	每个文件 100 MB	超过限制的文件会被跳过。其他有效文件仍可继续上传。
将文件夹拖入首页或项目聊天的上传区域	每次拖放文件夹最多 500 个文件，最多 10 层嵌套	如果任一限制被超出，整个文件夹拖放都会被取消。请减少文件数量或简化文件夹结构后重试。

文件夹拖放限制并不是每条消息的通用附件限制。文件夹中的每个文件也同样受聊天单文件大小限制约束。这些规则适用于聊天上传区域，不适用于单独的文件面板上传，也不适用于访客提交到您已发布应用中的文件。

大小单位以 Atoms 中显示的单位为准。在这些检查中，1 MB 等于 1,048,576 字节。文件如果恰好等于所述最大值，仍在大小限制范围内；DOCX 预览的例外情况见下文说明。

在首页或项目聊天中附加的视频文件也使用相同的 每个文件 100 MB 限制。如果视频大于 100 MB，则无法上传。请先减小文件大小，然后重试。

内置视频预览支持 MP4、WebM 和 MOV，具体还取决于浏览器和编码兼容性。在大小限制内上传，并不保证视频的时长、分辨率或编码一定支持播放或 AI 处理。此附件限制并不代表单独的视频编辑器导入或特定模型参考视频的限制。

以下格式支持内置预览。这是一份预览参考，并非可上传格式或支持 AI 处理格式的完整列表。

文件类别	预览格式	说明
图片	.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg, .avif, .ico	图片上传工具的格式列表可能更窄；请参阅下方的附加限制。
文档	.pdf, .docx	DOCX 预览要求文件小于 10 MB。达到或超过该大小的 DOCX 文件可能上传成功，但无法使用内置 DOCX 预览。
电子表格和表格数据	.xlsx, .csv	支持预览并不保证每个电子表格功能都能被完整还原。
文本、Markdown、代码和配置	.txt、.md，以及常见的源代码/配置格式，包括 .js、.ts、.jsx、.tsx、.vue、.html、.css、.py、.json、.yaml、.xml、.sql 和 .sh	所示代码/配置扩展名仅为示例，并非完整列表。
笔记本和图表	.ipynb, .mmd, .mermaid	笔记本和 Mermaid 预览格式。
音频	.mp3, .wav, .ogg, .aac, .flac	播放同样取决于浏览器和编码支持。
视频	.mp4, .webm, .mov	播放同样取决于浏览器和编码支持。

某些文件类型可以上传，但无法直接预览，包括：

没有预览本身并不意味着上传失败。

如果上传的文件没有预览，请下载后使用兼容的应用程序打开。文件夹本身没有单独的文件预览；请改为打开文件夹中的某个文件。

请使用您当前所用具体工具对应的限制。符合聊天限制的文件，仍可能对这些图片控件来说过大。

上传位置	每张图片最大值	格式
Design → 图片库 → Upload	4 MB	JPEG (.jpg, .jpeg), PNG, GIF, BMP, TIFF (.tif, .tiff), WebP
Design → 可视化编辑 → 选择一张图片 → 图片工具 → Upload	5 MB	文件选择器提供 PNG、JPG/JPEG、GIF、BMP 和 WebP。
应用 Logo	5 MB	PNG, JPEG
社交预览图	5 MB	PNG, JPEG, WebP
头像	2 MB	PNG, JPEG
工作区图片 — 桌面端	5 MB	PNG, JPEG, WebP
工作区图片 — 移动端	5 MB	PNG, JPEG, WebP, SVG
App 世界发布封面	3 MB	浏览器识别为图片的图像文件。

Design 图片库上传器接受 TIFF，但它不包含在上方通用文件预览图片格式中。

Atoms 云存储： 通过云存储面板上传文件时，每个文件的限制为 100 MB。这与聊天附件以及您的总存储配额是分开的。它并不代表您在已发布应用中构建的上传功能的限制。

无法读取的图片。 聊天上传会检查常见位图图片是否可读取。如果图片无法读取，它会被跳过，并提示您提供有效图片。请先在本地打开原图并导出一份新的副本后再试。

粘贴的长文本。 粘贴到聊天编辑器中的文本在达到 50 行或 2,000 个字符时，可能会变成 TXT 附件。这是自动转换为附件的阈值，并非文档长度上限。

将文件用于智能体。 预览只能确认文件可以显示。它并不代表支持转录音频、提取压缩包、读取扫描页面，或解析复杂文档中的每个元素。

会发生什么	该怎么做
文件过大	检查该上传位置的限制。压缩文件、导出更小的副本，或在可行时将内容拆分为更小的文件。请保留原始文件。
文件夹拖放超出文件数量或嵌套限制	将文件夹拆分为更小的分组，或减少嵌套子文件夹后重试。被拒绝的文件夹拖放不会部分上传。
图片工具拒绝该格式	请将图片导出为该工具列出的格式之一。重命名文件扩展名并不会转换文件。
Atoms 报告图片无效或无法读取	检查图片是否能在本地打开。请从图片应用重新导出，或获取新的副本后再次上传。
“文件已上传，但预览不可用”	上传可能已经成功。请检查上方的预览格式和 DOCX 预览大小限制，或下载文件后在本地打开。
音频或视频预览无法播放	检查本地播放和浏览器兼容性。如有需要，请使用浏览器兼容的编码以及列出的预览格式之一重新导出。
智能体无法按预期使用已上传文件	请明确指定您希望它使用的内容。在可能的情况下，提供相关文本或更简单的导出版本，而不是依赖原始文件的复杂布局。
错误提到存储容量	检查相关存储使用量和配额。总容量问题与单个文件超出大小限制是不同的。

如果问题仍然存在，请通过 [email protected] 联系 Atoms 支持团队。请附上上传位置、文件扩展名、文件大小以及准确的错误信息。除非必要，请避免分享敏感文件内容。