建立並發布你的第一個 Atoms app，從你的第一個提示詞到可分享的上線版本。

你不需要在開始之前先學會每個智能體、模式或技術術語。基本工作流程其實簡單得多：告訴 Atoms 你想要什麼、檢查它建立了什麼、進行修改、測試，並在準備好後發布。

本指南以一個簡單的咖啡館網站為例，但同樣的循環也適用於著陸頁、儀表板、內部工具，或你自己的 app 構想。

這些步驟適用於已登入的桌面網頁專案。行動專案使用獨立的行動建置與發佈流程。

在發布之前，請等待目前的建置完成，確認你擁有發布權限，確認專案處於閒置狀態，並檢查所需的專案資料（例如積分或儲存空間）是否可用。如果 Publish 無法使用，請先檢查專案版本、存取權限與資料條件後再重試。使用資料、密鑰、電子郵件、AI、付款或其他已連接服務的專案，在分享之前也需要完成其正式環境檢查。

描述你想要的內容

從提示詞輸入框開始，用一般語言描述你想要的結果。你不需要撰寫技術規格，也不需要告訴 Atoms 該如何編碼。

一個實用的第一個提示詞通常會說明你要建立什麼、主要區塊或功能、視覺方向，以及任何在行動裝置上重要的事項。

如果你已經在 App 世界 找到接近你需求的內容，也可以從克隆該專案開始，而不是從零開始。

檢查第一個結果

Atoms 會建立專案並產生第一個版本。準備好後，開啟 App 預覽，先查看結果，再要求更多修改。

先快速檢查一遍。你現在不是要找出每一個微小問題，而是要確認 Atoms 是否理解了主要想法。

• 主要區塊和功能是否都在？
• 整體版面是否符合你的要求？
• 重要按鈕、連結、篩選器或其他互動是否有反應？
• 是否有任何明顯缺少、損壞，或與你原意不同的地方？

你可以在 PC 和行動模式中預覽 app，因此在繼續之前，請在不只一種螢幕尺寸上檢查體驗。

進行修改

把第一個版本當作起點。用簡單明瞭的語言告訴智能體你想修改什麼，然後再次檢查結果。

小而具體的請求，通常比一次改動所有內容更容易檢查。

若要進行視覺變更，你可以直接在 App 預覽 中編輯元素，或向智能體描述變更內容。如果你有希望 Atoms 參考的截圖、設計稿、檔案或其他參考資料，請上傳並指示智能體查看。

當某些內容損壞時： 如果某個地方是真的壞掉，而不只是與你的偏好不同，請使用 Fix Bug，或明確告訴智能體哪裡有問題，以及問題發生在哪裡。

如果仍然失敗： 在一次有針對性的重試後，不要重複提出相同請求。請記錄受影響的步驟、你的預期、實際發生的情況、你已經嘗試過的方法，以及可分享的專案連結或截圖。如果你是有帳號、帳單或 Atoms 平台問題的付費使用者，請開啟 Atoms Help Center，在 Explore resources 下選擇 Atoms Support，再選擇 Contact us。如果你是免費套餐使用者，或只是需要一般產品說明與疑難排解，請先從 Help Center、Ask Assistant 或 Atoms 社群開始。

發布前先測試

在你把 app 傳給任何人之前，花幾分鐘像真實訪客一樣使用它。現在快速測試一次，會比分享後再解釋壞掉的連結容易得多。

• 點擊每一個重要按鈕和連結。
• 試用互動部分，例如篩選器、表單、選單或導覽。
• 同時檢查 PC 和行動檢視。
• 查看是否有文字被截斷、重疊、缺失，或難以閱讀。
• 確認主要使用者流程從頭到尾都能正常運作。

如果你的 app 依賴已儲存資料或後端操作，也請一併測試。Atoms 可以使用 Atoms 雲，或透過 Supabase 整合 來支援資料儲存、密鑰、電子郵件、AI 呼叫與付款等能力。

在發布之前，請從訪客可見的任何內容中移除密鑰、密碼、token、個人資訊與私人測試資料。確認專案應設為 Public 或 Private，並使用預期帳號測試正式連結。如果 app 使用真實付款、電子郵件、已儲存資料或已連接服務，請在分享前另外驗證這些正式環境操作。

發布

當預覽看起來正確且主要互動可正常運作時，請點擊編輯器右上角的 Publish。

發布會建立一個正式連結，其存取方式取決於你選擇的可見性。Public 可透過連結開啟，且可能出現在 Discover 中。Private 僅對擁有者可見，且可能受套餐限制。請在分享前選擇預期的可見性，並使用預期帳號測試連結。

發布是你的專案真正成為其他人可以開啟內容的時刻。你可以繼續在專案中開發，但每次發布後都要另外檢查正式版本。

驗證正式 app

在分享之前，請先自行開啟已發布的連結。確認所選的 Public 或 Private 可見性，能讓預期受眾取得存取權；請使用無痕視窗或預期帳號進行測試。

• 使用符合預期受眾的帳號或存取情境，在新分頁或無痕視窗中開啟連結。
• 確認頁面已載入，並顯示你預期的版本。
• 重複最重要的點擊或互動操作。
• 如果行動訪客對你的 app 很重要，請在手機上檢查頁面。

如果你發現問題，請回到專案中進行修改，再次測試預覽，然後更新正式版本。

修改後更新

你的 app 不會因為發布過一次就停止變更。只要有需要，請持續在專案中完善它。

首次發布後，Publish 按鈕會變成 Update。當你想將新變更推送到正式版本時，請點擊 Update。

更新後，請再開啟一次已發布的連結並進行驗證。這樣你就有了一個簡單且可重複的循環：

描述 → 檢查 → 修改 → 測試 → 發布 → 驗證 → 更新

這就是 Atoms 的核心工作流程。更複雜的 app 可能會加入資料、驗證、整合、自訂網域或多個智能體，但建置循環保持不變。