發佈您的專案

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

若要修正此問題：

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

2. 選取 Top up now，為您的 Cloud 錢包加值。

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

注意：您的 Cloud 錢包與訂閱積分是分開的。Cloud 錢包用於託管與部署服務，而訂閱積分則用於 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 Viewer 一次。如果問題只出現在線上網站，請確認最新版本已經發佈或更新。
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 金鑰為空或不正確。

如果問題持續存在，請聯絡 Support，並提供：

- 專案連結或線上 URL

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

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

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

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

重要：只提供金鑰名稱。請勿傳送機密值、密碼或 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 問題，請使用該發現的具體內容來找出受影響的位址、資源、callback 或網域設定。

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 金鑰或資料庫憑證。