Atoms 文件类型和限制
在将文件添加到 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 | 播放同样取决于浏览器和编码支持。 |
没有内置预览的文件
某些文件类型可以上传，但无法直接预览，包括：
- 压缩包： ZIP, RAR, 7Z, TAR
- Office 文件： DOC, XLS, PPT, PPTX
- 文档格式： EPUB, RTF
- 设计文件： PSD, AI, FIG, Sketch
- 图片和媒体： HEIC, HEIF, TIFF, AVI, MKV, M4A
没有预览本身并不意味着上传失败。
如果上传的文件没有预览，请下载后使用兼容的应用程序打开。文件夹本身没有单独的文件预览；请改为打开文件夹内的文件。
附加图片和存储上传限制
请根据你正在使用的具体工具采用对应限制。即使文件符合聊天限制，也仍可能对这些图片控件来说过大。
| 上传位置 | 每张图片最大值 | 格式 |
|---|---|---|
| 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 预览大小限制，或下载文件后在本地打开。 |
| 音频或视频预览无法播放 | 检查本地播放和浏览器兼容性。如有需要，请使用浏览器兼容的编码和所列预览格式之一重新导出。 |
| 智能体无法按预期使用已上传文件 | 明确说明你希望它使用的内容。在可能的情况下，请直接提供相关文本或更简单的导出版本，而不要依赖原始文件的复杂布局。 |
| 错误与存储容量有关 | 检查相关存储使用量和配额。总容量问题不同于单个文件超出大小限制。 |
如果问题仍然存在，请通过 service@atoms.dev 联系 Atoms Support。请附上上传位置、文件扩展名、文件大小以及准确的错误信息。除非确有必要，请避免分享敏感文件内容。