參考資料

檔案類型與限制

在將檔案加入 Atoms 之前，請先確認大小與格式要求。限制會依上傳位置而異：聊天附件、Design 圖片、app 品牌素材與個人資料圖片各有不同規則。

上傳、預覽與處理是分開的。上傳成功並不保證 Atoms 能顯示預覽，也不保證智能體能讀取並使用檔案中的所有內容。

聊天附件與資料夾限制

上傳位置或操作	限制	預期結果
在首頁或專案聊天中附加檔案，包括影片	每個檔案 100 MB	超過限制的檔案會被略過。其他有效檔案可繼續上傳。
將資料夾拖曳到首頁或專案聊天的上傳區域	每次拖放資料夾最多 500 個檔案，且巢狀層級最多 10 層	若超過任一限制，整個資料夾拖放會被取消。請減少檔案數量或簡化資料夾結構後再試一次。

資料夾拖放限制並不是每則訊息的一般附件限制。資料夾中的每個檔案也都受聊天單檔大小限制約束。這些規則描述的是聊天上傳區域，不適用於獨立的檔案面板上傳，也不適用於訪客提交到你已發佈 app 的檔案。

大小單位以 Atoms 顯示的單位為準。在這些檢查中，1 MB 等於 1,048,576 位元組。檔案若剛好等於所述最大值，仍在大小限制內；DOCX 預覽的例外情況如下說明。

附加在首頁或專案聊天中的影片檔案，適用相同的 100 MB per-file limit。如果影片大於 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, and .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。
App 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 雲 storage： 透過 Cloud storage 面板上傳檔案時，每個檔案上限為 100 MB。這與聊天附件及你的總儲存配額分開計算。它也不代表你在已發佈 app 中建立的上傳功能限制。

無法讀取的圖片。 聊天上傳會檢查常見點陣圖圖片是否可讀取。若圖片無法讀取，系統會略過該圖片，並提示你提供有效圖片。請先在本機開啟原始檔並重新匯出一份，再重試。

貼上的長文字。 當貼入聊天編輯器的文字達到 50 行或 2,000 個字元時，可能會轉成 TXT 附件。這是自動轉換為附件的門檻，不是文件長度上限。

將檔案用於智能體。 預覽只表示檔案可以顯示。這不代表支援音訊轉錄、解壓縮封存檔、讀取掃描頁面，或解讀複雜文件中的每個元素。

發生情況	處理方式
檔案太大	檢查該上傳位置的限制。壓縮或匯出較小的副本，或在可行時將內容拆分成較小檔案。請保留原始檔。
資料夾拖放超過檔案數量或巢狀層級限制	將資料夾拆成較小群組，或減少巢狀子資料夾後再試。被拒絕的資料夾拖放不會部分上傳。
圖片工具拒絕該格式	請將圖片匯出為該工具列出的格式之一。重新命名副檔名並不會轉換檔案。
Atoms 回報圖片無效或無法讀取	確認圖片可在本機開啟。請從圖片應用程式重新匯出，或取得新的副本後再上傳。
「檔案已上傳，但無法預覽」	上傳可能已成功。請檢查上方的預覽格式與 DOCX 預覽大小限制，或下載檔案後在本機開啟。
音訊或影片預覽無法播放	請檢查本機播放與瀏覽器相容性。如有需要，請使用瀏覽器相容的編碼與所列預覽格式之一重新匯出。
智能體無法如預期使用上傳的檔案	請明確指出你希望它使用的內容。在可行的情況下，提供相關文字或較簡單的匯出版本，而不是依賴原始檔案的複雜版面。
錯誤提到儲存容量	檢查相關儲存使用量與配額。總容量問題與單一檔案超過大小限制是不同情況。

如果問題持續發生，請透過 [email protected] 聯絡 Atoms Support。請附上上傳位置、副檔名、檔案大小與完整錯誤訊息。除非必要，避免分享敏感檔案內容。