檔案儲存與內容管理
你的應用程式有一個專用的內容檔案系統,用來儲存使用者上傳的圖片、文件、PDF 與影片等檔案。它和你的應用程式程式碼分開,專為使用者在使用應用程式時建立或上傳的動態內容而設計。
限制與重要事項
- 單一檔案最大可達 500MB
- 刪除檔案是永久的,沒有垃圾桶或資源回收筒
- 儲存空間用量會計入你的帳戶配額
內容檔案系統能做什麼
內容檔案系統為你的應用程式提供強大的檔案管理能力:
- 儲存使用者大頭貼、個人照片與圖片庫
- 接受文件上傳,例如履歷、合約或 PDF
- 建置檔案分享功能,讓應用程式中的使用者彼此分享
- 打造以圖片為主的應用程式,並自動最佳化
- 讓使用者下載自己上傳或屬於自己的檔案
- 建置管理工具,讓你代表使用者管理檔案
運作方式
當你向 AI 描述需要檔案儲存的功能時,它會自動處理整個實作:
設定上傳介面 — 建立表單或拖放區域,讓使用者從自己的裝置選擇檔案
設定存取控制 — 依據你要建置的內容,決定誰可以檢視、上傳或刪除檔案
實作圖片最佳化 — 自動調整圖片大小並有效率地提供,讓你的應用程式載入更快
建立儲存結構 — 將檔案整理到合理的資料夾,例如 /content/uploads/ 或 /content/avatars/
處理後端 — 管理實際的檔案儲存、讀取與傳送,你不需要操心
檔案儲存在類似 /content/uploads/photo.jpg 的路徑,可以直接在應用程式中引用。系統會記錄每個檔案由誰上傳、何時建立,並落實你的存取規則。
檔案的存取控制
和資料庫資料表與邊緣函式一樣,檔案也有安全政策來控管誰能存取。檔案預設為私有,在你設定權限之前,任何人都無法存取。AI 會依據你要建置的內容來設定:
公開檔案
任何人都能檢視,不需登入。已登入的使用者可以上傳,且只有上傳者本人能刪除該檔案。非常適合相簿、公開圖片分享,或由使用者產生內容的網站。
私人檔案
只有上傳檔案的使用者可以檢視或刪除。適用於敏感文件、私人照片、醫療紀錄,或任何使用者不希望被他人看到的內容。
組織共用檔案
同一個組織的使用者可以檢視組織內任何人上傳的檔案。個人只能刪除自己上傳的檔案。非常適合團隊文件共用、公司資源或協作空間。
僅限擁有者存取
只有你(應用程式的建立者)能存取這些檔案,你的終端使用者不能。適合存放為應用程式提供支援、但不該面向使用者的系統檔案、範本或管理用資源。
進階存取控制
AI 可以根據檔案中繼資料建立細緻的存取規則。例如:
- 已發布的文章公開,但草稿只有作者看得到
- 標記了部門的檔案,只有該部門的使用者看得到
- 付費內容需要使用者帳戶上有訂閱標記
- 共用檔案可由檔案中繼資料所列的協作者檢視
圖片最佳化
上傳到內容檔案系統的圖片會自動最佳化,以便快速載入。顯示圖片時,你可以指定寬度,其餘由系統處理:
<!-- Thumbnail (200px wide) -->
<img src="/content/gallery/photo.jpg?w=200" />
<!-- Standard display (800px wide) -->
<img src="/content/gallery/photo.jpg?w=800" />
<!-- Hero image (1920px wide) -->
<img src="/content/gallery/photo.jpg?w=1920" />
<!-- Original, full-size image -->
<img src="/content/gallery/photo.jpg" />
最佳化的運作方式
漸進式載入 — 有人第一次要求某個最佳化尺寸時,系統會先提供最接近的現有版本,並在背景產生確切的尺寸。之後的每次請求,都會取得尺寸剛好、已最佳化的圖片。原始檔案一律保留。
新式格式傳送 — 系統會自動向支援的瀏覽器提供新式圖片格式(AVIF 或 WebP),舊版瀏覽器則自動改用 JPEG 或 PNG。這一切是透明進行的:你只需指定寬度,使用者就能取得其瀏覽器能處理的最快載入版本。
效能最佳化 — 使用較小的寬度可以提升效能。200px 的縮圖載入速度遠快於 4000px 的原圖,也更省頻寬。請選擇與圖片顯示方式相符的寬度。
在應用程式中使用檔案
AI 會自動把內容檔案系統整合進你的 React 應用程式。當你要求涉及檔案的功能時,它會建立 UI 元件、串接上傳/下載邏輯,並處理錯誤。
AI 常實作的模式
大頭貼上傳 — 個人照片上傳介面:驗證圖片類型、顯示上傳進度、預覽圖片,並將路徑儲存到使用者的個人資料。
文件庫 — 檔案瀏覽器:列出已上傳的文件、為圖片顯示縮圖、提供下載連結,並支援篩選或搜尋。
拖放上傳 — 直覺的上傳區:使用者可以從桌面拖曳檔案、查看上傳進度、取消進行中的上傳,並在檔案無效時看到錯誤訊息。
檔案選擇器 — 彈出視窗或側邊欄:顯示使用者先前上傳的檔案,讓他們選取其一重複使用,並顯示縮圖與檔名。
與邊緣函式整合
邊緣函式(你的伺服器端程式碼)可以存取內容檔案系統,用來處理檔案、以程式產生檔案,或實作自訂的檔案處理邏輯。
邊緣函式能對檔案做什麼
- 產生 PDF 報表並儲存,供使用者下載
- 處理上傳的圖片(加上浮水印、建立縮圖、擷取中繼資料)
- 在接受上傳的文件前,先掃描其中的敏感資料
- 實作自訂的備份或封存邏輯
- 分析檔案內容並擷取結構化資料
- 在特定檔案上傳時觸發工作流程
警告: 重要的安全說明
邊緣函式會繞過一般的存取控制。函式存取檔案時,不受套用在使用者身上的「公開」或「擁有者」規則限制。這表示你必須在函式程式碼中自行實作授權檢查,確保使用者只能存取他們應該看到的檔案。
例如,使用者呼叫你的函式要求某個檔案時,你需要先確認他們擁有該檔案或有權存取,才能傳回內容。AI 在建置函式時會處理這點,但請務必了解,函式程式碼是以較高的權限執行的。
儲存結構
AI 會依據你要建置的內容,把檔案整理到合理的資料夾。你不需要手動建立資料夾結構,只要描述需求,AI 就會設定適當的路徑。
常見的組織方式
/content/uploads/— 一般使用者上傳/content/avatars/— 使用者個人照片/content/documents/— PDF 與文件/content/gallery/— 相簿圖片/content/private/— 使用者的私人檔案/content/public/— 可公開存取的檔案/content/temp/— 可刪除的暫存檔案
AI 可以在適合你的使用情境時,建立巢狀資料夾,例如 /content/uploads/2024/ 或 /content/users/[username]/。檔案是以完整路徑來追蹤的,因此移動或重新命名檔案時,所有引用都會自動更新。
監控與除錯
所有檔案操作都會被記錄,包括上傳、下載、存取遭拒與錯誤。你可以在管理介面查看這些記錄,了解檔案儲存的使用情形:
- 查看哪些檔案最常被上傳
- 找出失敗的上傳及原因
- 追蹤下載模式與熱門檔案
- 監控儲存用量及其隨時間的成長
- 當使用者無法存取預期看得到的檔案時,除錯存取控制問題
系統也會追蹤儲存指標,包括儲存的檔案總數、總大小、成長率與最大的檔案。這有助於你了解應用程式的儲存空間佔用,並規劃擴充。
限制與約束
預設情況下,單一檔案最大可達 500MB。此上限可以調整,AI 能依據你要建置的內容調整限制。對大多數應用程式(圖片上傳、文件分享、PDF)而言,預設上限綽綽有餘。
檔案會以備援方式儲存以確保可靠性。刪除檔案後,它會從系統中永久移除,沒有垃圾桶或資源回收筒,因此刪除會立即生效且無法復原。
與 AI 合作
描述需要檔案儲存的功能時,請具體說明:
- 誰可以存取檔案 — 公開、私人、組織共用,或自訂規則
- 哪些類型的檔案 — 僅限圖片、PDF、任何檔案類型、大小限制
- 檔案如何整理 — 資料夾、命名慣例、使用者能否建立子資料夾
- 上傳之後會發生什麼 — 顯示在相簿中、附加到記錄,或交由函式處理
AI 會運用這些資訊正確設定儲存空間、建立存取政策,並打造符合你需求的介面。
相關文件: