如果 Publish 或 Update 按鈕顯示 "Your Cloud Balance is insufficient to publish" 或 "Your Cloud Balance is insufficient to update," 表示你的 Cloud wallet 已用完。

解決方式如下：

1. 前往 Settings > Cloud & AI 檢查你目前的餘額。

2. 選取 Top up now，為你的 Cloud wallet 儲值。

3. 返回 Publish 面板並再試一次。

注意：你的 Cloud wallet 與訂閱積分是分開的。Cloud wallet 用於託管與部署服務，而訂閱積分則用於 AI 智能體對話。

1. 檢查儲存空間使用檢視，找出最大的聊天、專案與檔案。
2. 下載或備份你之後可能需要的內容。
3. 只刪除不需要的項目。如果刪除聊天時提供移除相關磁碟資料的選項，請先確認資料可安全捨棄後再選取該選項。
4. 重新整理頁面，並確認可用儲存空間已增加。
5. 返回 Publish 並重試一次。

刪除可能是永久性的，且可能會破壞引用已移除檔案的專案。如果使用量沒有下降，請聯絡 Support，並附上儲存空間檢視、方案、專案連結，以及發佈失敗的時間。

請等待安全掃描完成，然後在發佈前檢查每一個被標記的項目。

1. 選取 Resolve All 並檢查受影響的行為。對於涉及暴露的機密、驗證、權限、使用者資料或不安全外部存取的問題，請在正式使用前先修正。
2. 如果機密可能已暴露，請在發佈前先將其從專案中移除，並透過相關供應商進行輪替。
3. 再次執行掃描並驗證受影響流程。
4. 只有在有責任歸屬的審查者了解並接受剩餘的非關鍵風險時，才使用 Publish Anyway。請記錄原因，並避免在正式網站上繞過未解決的風險。

如果你無法判斷某項發現的影響，請不要發佈。請聯絡 Support 或你的安全負責人，並提供發現文字與已去識別化的證據。

1. 請分別測試平台的正式環境 URL 與自訂網域。也請比較根頁面與發生錯誤的特定頁面或 API 路徑。
2. 記錄確切的狀態碼、完整 URL、時間與時區，以及故障是持續發生還是間歇發生。
3. 檢查最新部署狀態，以及最近的相依套件、環境變數、資料庫或外部服務變更是否與故障開始時間吻合。
4. 擷取相關的 Console 與 Network 錯誤。

如果故障持續，請聯絡 Support，並附上重現步驟、受影響版本與已去識別化的診斷資訊。在傳送 HAR、指令輸出或截圖前，請移除 cookies、Authorization 標頭、tokens、機密查詢參數、個人資料與付款資訊。

如果你的部署逾時，或線上網站暫時無法使用：

1. 檢查平台的 Prod 子網域與 Preview 是否都無法存取，還是只有其中一個。

2. 保持目前的錯誤頁面顯示—不要重複點擊 Publish。

3. 檢查你最近是否修改了相依套件、啟動入口點或資料庫連線，因為這些變更可能會影響部署。

如果問題持續，請聯絡 Support，並附上：

- 專案連結與線上 URL

- 故障發生時間與你的時區

- 版本號與錯誤頁面截圖

- Preview 是否正常運作

- 你最近是否修改了相依套件、啟動入口或資料庫連線

如果 Publish 面板顯示「latest」且按鈕呈灰色不可用，或卡在「Building」：

1. 不要重複點擊 Publish—這不會加快速度，還可能建立重複的建置任務。

2. 等待幾分鐘後重新整理頁面。

3. 如果重新整理後狀態仍未變更，請聯絡 Support。

聯絡 Support 時請附上以下資訊：

- Chat 連結

- Publish 面板完整截圖（包含頁面 URL、版本號與按鈕狀態）

- 發生時間與你的時區

- 目前顯示的版本號

- 從哪一個步驟開始顯示「Building」或按鈕變成灰色不可用

1. 檢查圖片是在 App 預覽、已發佈網站，還是兩者中都遺失。
2. 選取一次 Reload App 預覽。如果問題只出現在線上網站，請確認最新版本已發佈或更新。
3. 告訴智能體頁面、應該顯示的圖片，以及圖片原本的來源。請它檢查目前專案是否仍使用正確的圖片名稱與位置。
4. 如果原始圖片已被移除或重新命名，請重新上傳或再次選取預期的圖片，然後重新測試該頁面。
5. 如果圖片使用 App 儲存 或其他已連接服務，請確認目標服務已連接，且檔案仍存在於其中。

如果圖片仍無法載入，請聯絡 Atoms Support，並附上 Chat Link、受影響頁面的 URL、圖片名稱或來源，以及截圖。請勿包含私人存取連結、密碼、金鑰或 tokens。

如果匯出的自託管套件已成功下載，但無法執行：

1. 檢查匯出套件中附帶的 README，確認環境需求與設定步驟。

2. 確認你的執行環境符合需求（OS 版本、Docker 版本、Node.js 版本）。

3. 執行啟動指令，並檢查完整輸出中的錯誤訊息。

如果問題持續，請聯絡 Support，並附上：

- 匯出版本與下載時間

- 執行中的 OS 與 Docker 版本

- 執行的完整指令與完整輸出

- 失敗的 script 或 API 路徑

- 預期的部署方式

重要：請附上已去識別化的設定範例，但不要包含密碼、機密或 tokens。

App 預覽 與已發佈網站顯示的是專案的不同階段。儲存視覺變更本身不會更新線上網站。

1. 在 Design 中選取 Save，並等待目前的智能體任務或建置完成。
2. 開啟 Publish。發佈會使用最新的專案版本；Publish 面板中沒有版本選擇器。
3. 首次發佈請選取 Publish，後續發佈請選取 Update。等待直到面板顯示 Up to date。
4. 在新分頁中開啟線上網站，並重新載入一次。
5. 如果預設的 Atoms 位址有顯示變更，但自訂網域沒有，請檢查網域連線，而不是重複發佈相同版本。

如果線上網站仍顯示錯誤版本，請聯絡 Atoms Support，並附上 Chat Link、線上 URL、你原本要發佈的版本、時間與時區，以及 App 預覽 與線上網站的截圖。

1. 先控制立即風險。 如果這次發佈暴露了敏感資料或造成不安全行為，請開啟 App Status，對符合條件的 Atoms 雲 app 使用 Pause，或使用 Unpublish 移除公開存取。如果目前沒有主動風險，請避免造成不必要的中斷。
2. 記錄受影響的網域、發佈時間、目前版本、預期版本與業務影響。
3. 在目前智能體任務停止後，開啟 Versions，選擇最後一個已知正常版本，並選取 Restore this version。
4. 在 Preview 中驗證已還原版本，包括關鍵的登入、付款與資料流程，然後再 Publish 或 Update。

還原專案版本不一定能回復正式環境資料庫變更或外部動作。不要透過覆寫或刪除正式環境資料來模擬回滾。如果涉及資料、憑證、付款或破壞性變更，請立即聯絡 Support。

1. 停止目前的智能體任務或等待其完成；當有衝突工作進行中時，無法還原版本。
2. 開啟 Versions，找到最後一個已知正常版本，並選取 Restore this version。
3. 在 Preview 中檢查已還原的專案，並測試已變更的關鍵流程。
4. 只有在 Preview 結果正確後，才進行 Publish 或 Update。

還原專案版本不一定會回滾正式環境資料庫記錄、schema 變更、環境變數、付款、電子郵件或其他外部動作。如果這次發佈已變更正式環境資料，或目標版本無法使用，請停止操作並聯絡 Support，提供兩個版本號、受影響網域，以及所需的資料保留結果。

Pause 與 Unpublish 是兩種不同的操作：

Pause（僅限 Atoms 雲專案）：

- app 將無法供訪客使用。

- 伺服器資源仍會保留配置，且持續計費。

- 你可以隨時從 App Status 恢復 app。

Unpublish（所有專案）：

- 網站會完全下線。任何使用已發佈 URL 的人都會失去存取權。

- 對於 Atoms 雲專案，伺服器資源會被釋放。

- 你之後可以再次發佈專案，但在那之前訪客無法存取。

若只是暫時下架且希望快速恢復，請使用 Pause。若要完全移除網站，請使用 Unpublish。

如果你的瀏覽器顯示「too many redirects」，或頁面持續重新載入卻未顯示內容：

1. 請先嘗試平台預設的 Prod 子網域（不是你的自訂網域），以判斷重新導向迴圈是由網域設定造成，還是由應用程式本身造成。
2. 如果預設 Prod 子網域可正常運作，請檢查你的自訂網域 DNS 設定，以及網域註冊商中可能與平台衝突的重新導向規則。
3. 清除瀏覽器快取，或使用無痕視窗測試，以排除快取的重新導向影響。

如果問題持續，請聯絡 Support，並附上：

- 顯示重新導向迴圈的完整 URL

- 預設 Prod 子網域是否可存取

- 網域名稱與 DNS 供應商

- 完整錯誤截圖

如果你的 app 在 Preview 中可正常運作，但在正式環境中因環境變數缺失或為空而失敗：

1. 檢查該環境變數是在上次發佈之前還是之後儲存的。如果是在之後儲存，你需要再次發佈，變更才會生效。
2. 確認該變數已設定在正確的環境中（Development 與 Production）。
3. 檢查下游服務的錯誤訊息是否提供線索—例如，「unauthorized」通常表示該環境中的 API key 為空或不正確。

如果問題持續，請聯絡 Support，並附上：

- 專案連結或線上 URL

- 受影響的 key 名稱，以及哪個環境有問題

- 下游服務的完整錯誤訊息

- 已去識別化的設定頁面截圖

- 設定是在發佈前還是發佈後儲存的

重要：只提供 key 名稱。不要傳送機密值、密碼或 tokens。

發現項目可能會使用相似的措辭，但指向不同的位置。措辭相似不一定表示結果重複。

1. 比較每個結果的發現名稱與顯示的位置。
2. 請檢查每個唯一位置，而不是因為措辭重複就忽略它。
3. 如果多個發現項目有相同的根本原因，請先修正該原因，再重新檢查每個位置。
4. 在更新後的版本上再次執行安全掃描。

如果相同的發現與位置仍然出現多次，請聯絡 Atoms Support，並附上 Chat Link、掃描時間與時區、發現項目數量，以及已遮蔽敏感資訊的截圖。請移除發現中可能出現的任何密碼、金鑰、tokens 或其他敏感資訊。

完成掃描且未回報發現項目是一項有用的檢查，但無法保證已找出所有安全性或執行階段問題。掃描檢查的是所選的專案版本；你的 app 仍需要依照真實使用者的使用方式進行測試。

發佈前，請測試 app 中的重要流程，包括登入、使用者角色、私人資料存取、付款與已連接服務。請為不同角色使用不同的測試帳號，並確認每個帳號只能存取為其設計的資訊與操作。

如果你發現正式環境問題可能暴露帳號、私人資料、付款資訊或憑證，請先停止使用或限制受影響功能的存取。輪替任何可能已暴露的憑證，然後聯絡 Atoms Support，並附上 Chat Link、受影響版本、重現問題的步驟、時間與時區，以及已遮蔽敏感資訊的截圖。請勿分享已暴露的憑證本身。

如果掃描回報僅限管理員的操作可能未受保護，在你確認未授權使用者無法使用它之前，請將此發現視為未解決。若該操作仍可透過其他方式發出請求，僅隱藏管理員按鈕是不夠的。

1. 開啟該發現，找出它所指的操作或位置。
2. 決定哪些已登入角色應被允許使用該操作。
3. 請智能體在收到操作請求時檢查使用者權限，而不只是顯示按鈕時才檢查。
4. 在未登入、一般測試帳號，以及已授權的管理員測試帳號下測試該操作。
5. 確認被拒絕的嘗試不會洩露任何私人資料，也不會造成任何變更，然後再次執行安全掃描。

如果未授權帳號仍可使用該操作，請不要發佈受影響功能。如果你無法解決，請聯絡 Atoms Support，並附上 Chat Link、發現文字、受影響版本，以及已遮蔽敏感資訊的截圖。

HTTPS 可保護使用者與服務之間傳輸中的資訊。如果掃描回報 HTTPS 問題，請根據確切的發現內容找出受影響的位址、資源、回呼或網域設定。

1. 開啟該發現，記下它回報的確切位置與位址。
2. 請智能體將該特定連線替換為其供應商支援的安全位址，或修正相關網域設定。
3. 如果外部服務未記載安全等效位址，請不要忽略憑證警告，也不要盲目變更位址。
4. 重新測試受影響的使用者流程，並確認沒有任何密碼、token、付款明細或私人資訊透過不安全連線傳送。
5. 在更新後的版本上再次執行安全掃描。

如果該發現與你無法修正的自訂網域或憑證有關，請聯絡 Atoms Support，並附上 Chat Link、受影響 URL、發現文字、時間與時區，以及已遮蔽敏感資訊的截圖。

Row Level Security，或 RLS，是 Supabase 的一項功能，用來控制每位使用者可以讀取或變更哪些資料庫資料列。只有在專案使用 Supabase，且掃描指出某個資料表的存取規則需要檢查時，這項發現才相關。

1. 開啟該發現，找出它所指的資料表。
2. 寫下哪些人應該能查看、新增、編輯或刪除該資料表的資料。
3. 請智能體建立支援這些使用者流程、且權限最小化的 Supabase policies。
4. 在未登入狀態下，以及為每個角色使用不同測試帳號進行測試。確認每個帳號只能存取預期的資料列與操作。
5. 套用 policies 後，再次執行安全掃描。

不要為了清除警告而停用 RLS 或允許所有使用者存取。在進行可能影響既有資料的變更前，請先確認計畫，並在適當情況下保留安全備份或匯出。切勿在 Chat 或截圖中分享 Supabase 金鑰或資料庫憑證。