使用 App 儲存 來儲存、整理及管理執行中 app 使用的檔案，包括圖片、影片、文件和使用者上傳內容。

在使用 App 儲存 之前，請先將專案連接到 Atoms 雲。如果尚未連接，請要求智能體連接 Atoms 雲，或參閱 Atoms 雲。

了解 Atoms 雲中的 App 儲存

App 儲存 會儲存專案需要保留並存取的檔案。它與儲存在 資料庫 中的結構化資料、在 Chat 中上傳的檔案，以及構成專案程式碼的檔案彼此分開。

關鍵術語

• Bucket: 用於儲存及分組相關檔案的主要容器。你可以將 bucket 想像成某一類檔案的儲存區域。每個 bucket 都會設定為 Public 或 Private，以控制誰可以存取其中的檔案。
• Folder: 在 bucket 內整理檔案的選用方式。Folder 的運作方式就像你電腦上的資料夾，有助於讓較大型的檔案集合更容易管理。
• Object: 儲存在 bucket 或 folder 中的單一檔案，例如圖片、文件、影片或其他上傳檔案。
• Object key: 用來識別檔案儲存在 bucket 內哪個位置的唯一路徑。例如，images/profile/avatar.png 可以是儲存在 images/profile folder 內某張圖片的 object key。

選擇 Public 或 Private

請在建立 bucket 之前選擇其類型：

Bucket 類型	適用用途
Private	敏感、帳號專屬或使用者上傳的檔案。
Public	刻意設計為可安全公開的非敏感檔案。

敏感或使用者專屬檔案請使用 Private。 如果你遇到存取錯誤，不要只是為了讓檔案可被存取，就把 bucket 改成 Public。相反地，請確認你的 app 會檢查請求該檔案的人是否具有存取權限。

在 Atoms 雲中開啟 App 儲存

1. 在桌面裝置上開啟你的專案。
2. 在與 App 預覽 相同的工作區工具列中，選取 Atoms 雲。
3. 在 Atoms 雲側邊欄中選取 App 儲存。

App 儲存中的權限

App 儲存會使用你的工作區角色。Editors 和 workspace owners 都可以管理他們能開啟之專案的儲存空間。不是工作區成員的人無法開啟或管理專案的 App 儲存。

bucket 的 Public 或 Private 設定，不會改變誰可以在 Atoms 雲中管理它。該設定控制的是執行中的 app 如何提供檔案存取；工作區權限則控制誰可以從 Atoms 雲工作區管理儲存空間。

建立 bucket

一個 app 最多可有 10 個 buckets。當不同群組的檔案需要不同的存取設定，或為了更容易整理而應彼此分開時，請建立不同的 buckets。

1. 在 App 儲存 頁面上，選取 Create Bucket。
2. 在 Bucket Name 下方，輸入 bucket 的唯一名稱。名稱必須：
   • 包含 3–63 個字元；
   • 只能使用小寫字母、數字和連字號；且
   • 以字母或數字開頭與結尾。
3. 在 Bucket Type 下方，選擇 Private 或 Public。預設會選取 Public，因此在繼續之前，請確認你已選擇想要的存取層級。
4. 選取 Create。

新的 bucket 會顯示在 App 儲存 頁面上，並列出其名稱、類型和建立日期。選取該 bucket 以開啟並查看其內容。

在 App 儲存中選取 Create Bucket。

Bucket 名稱在建立後無法變更，因此請選擇一個清楚且之後不需要更改的名稱。如果你的 app 已經有 10 個 buckets，則 Create Bucket 將不再可用。

上傳與整理檔案

在 bucket 內，你可以直接上傳檔案，或在不先上傳任何檔案的情況下建立空白 folder。

建立新 folder

1. 開啟你要建立新 folder 的 bucket 或 folder。
2. 選取 Add Folder。
3. 輸入 folder 名稱，然後選取 Create。Folder 名稱可包含字母、數字、句點（.）、連字號（-）和底線（_），且不得超過 100 個字元。Folder 名稱在建立後無法變更。

為 folder 命名，然後選取 Create。

上傳檔案

1. 開啟你要儲存檔案的 bucket 或 folder。
2. 選取 Upload，然後從你的裝置中選擇一個或多個檔案。每個檔案最大可達 100 MB。
3. 等待上傳完成，然後確認檔案已出現在清單中。

檔案清單會顯示每個項目的 Name、Type、Size、Last Modified 日期，以及可用的 Actions。如果你需要重新載入目前 folder 的內容，請選取 refresh 按鈕。

將檔案上傳到所選的 bucket 或 folder。

預覽與管理檔案

選取檔案以開啟 File Details。支援的圖片和影片可在面板中預覽。其他檔案類型會顯示其可用詳細資料，且仍可下載。如果所有積分都已用完，File Details 會顯示積分耗盡狀態，而單一檔案的 Download 會改為導向 升級，而不是直接下載。

管理單一檔案

在檔案的 Actions 欄位中開啟 ...，然後選擇：

• Download：在有可用積分時儲存本機副本。如果所有積分都已用完，此操作會改為導向 升級。
• Rename：變更檔案名稱。新名稱可使用字母、數字、句點、連字號和底線。
• Delete：在確認後移除檔案。

使用檔案的操作選單來下載、重新命名或刪除檔案。

管理多個檔案

1. 選取每個檔案旁的核取方塊。Folder 不包含在批次選取中。
2. 選取 Download 以一起下載所選檔案，或選取 Delete。
3. 如果要刪除，請檢查所選檔案數量並確認 Delete。

從 App 儲存刪除後無法復原。 在重新命名或刪除檔案之前，請先確認 app 是否仍在使用其 object key。之後也請更新任何已儲存的參照，以免 app 繼續請求舊的 key。

在你的 app 中使用已儲存的檔案

你的 app 會使用其 bucket name 和 object key 來識別每個已儲存檔案。object key 會顯示檔案位於 bucket 內的哪個位置。例如，images/profile/avatar.png 可以是儲存在 images/profile folder 內某張圖片的 object key。

請將 bucket name 和 object key 儲存在 app 的資料庫中，讓 app 之後可以找到該檔案。當你的 app 需要顯示或下載檔案時，可以使用這些資訊來請求存取 URL。

存取 URL 可能是暫時性的。 不要將它們儲存為永久 app 資料、硬編碼到 app 中，或在 Chat、螢幕截圖、日誌或支援訊息中分享。請改為儲存 object key，並在需要存取檔案時請求新的存取 URL。

不要在 App 儲存中儲存 API keys、密碼或其他憑證。請將私密的執行階段憑證儲存在 金鑰 and secrets 中。只有工作區擁有者可以在那裡管理私密的執行階段憑證。如果你是 Editor，請要求工作區擁有者新增或更新該憑證。

目前限制

限制	目前值
每個 app 的 buckets 數量	10
每個上傳檔案的大小	100 MB

如需目前的 Cloud 使用量與容量資訊，請參閱 Cloud & AI Wallet。

常見問題

我的磁碟空間已滿。我要如何釋放儲存空間？

1. 檢查目前的儲存空間使用量，並找出最大的 chats、projects 或 files。
2. 下載或備份你之後可能還需要的任何內容。
3. 只刪除你不再需要的項目。如果刪除 chat 時出現移除相關磁碟資料的選項，請僅在確認該資料可被捨棄後再選取。
4. 移除不需要的大型檔案，然後重新整理並再次檢查可用空間。

刪除可能是永久性的，且可能影響參照已移除檔案的專案。如果清理後使用量仍未下降，請聯絡 Support，並提供儲存空間截圖、你的方案，以及受影響的帳號或工作區。除非透過核准的管道提出要求，否則不要傳送檔案內容。