檔案儲存與內容管理

你的應用程式有一個專用的內容檔案系統,用來儲存使用者上傳的圖片、文件、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 會運用這些資訊正確設定儲存空間、建立存取政策,並打造符合你需求的介面。


相關文件: