> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# 疑難排解

> 解決常見開發挑戰的可行步驟。

## 卡在「嘗試修復」

使用 Lumi 進行建構的設計旨在快速直觀，但就像任何強大的工具一樣，有時也可能遇到問題。您可能會發現您的程式碼未如預期運行，或者 AI 誤解了您的指令，導致非預期的行為。

這是一份逐步指南，幫助您解決這些問題並重返建構工作：

<Steps>
  <Step title="首先使用「嘗試修復」按鈕">
    當出現錯誤時，您的第一步應該是點擊「嘗試修復」按鈕。Lumi 會分析日誌，找出問題並應用快速修復。如果這無法解決問題，就該進行下一步了。
  </Step>

  <Step title="診斷非預期行為">
    有時您的程式碼運行時沒有錯誤，但功能卻未如預期。這被稱為非預期行為，除錯起來可能很棘手。以下是處理方法：

    * **檢視您的提示：** 再次檢查您最初的指令，確保它們清晰明確。
    * **隔離問題：** 檢查個別元件和邏輯，找出問題所在。
    * **提供視覺情境：** 使用螢幕截圖或錄影，向 AI 準確展示哪個部分運作不正常。
  </Step>

  <Step title="撰寫更有效的提示">
    清晰且結構化的提示能產生更好的結果。請遵循此格式以獲得最佳效果：

    * **專案概覽：** 簡要描述您正在建構的內容。
    * **頁面結構：** 列出關鍵頁面和元件。
    * **導覽邏輯：** 解釋預期的使用者流程。
    * **視覺輔助：** 上傳線框圖或模型圖。
    * **實作步驟：** 概述期望的建構順序。
  </Step>

  <Step title="以合乎邏輯的順序建構">
    結構化的開發方法可以預防許多常見問題。請遵循以下建議的工作流程：

    1. 建立主要版面配置和頁面。
    2. 連接您的後端或資料庫。
    3. 設定使用者驗證和角色。
    4. 規劃每個功能的邏輯。
    5. 提示 Lumi 逐一實作功能。
  </Step>

  <Step title="使用討論模式尋求指導">
    如果您感到卡關，請切換到 Discuss Mode 尋求協助：

    * 要求 Lumi 分析您專案的目前狀態。
    * 請求已嘗試過的解決方案摘要。
    * 提示尋求新策略來解決持續存在的問題。
  </Step>

  <Step title="應用進階策略對付頑固的錯誤">
    如果問題仍然存在，請嘗試這些更進階的技巧：

    * **具體說明：** 清楚描述錯誤以及您預期發生的情況。
    * **使用視覺輔助：** 螢幕截圖或螢幕錄影對於說明複雜問題非常有幫助。
    * **尋求替代方案：** 直接詢問：「我們還能嘗試什麼？」以產生新想法。
    * **回復：** 將您的專案還原到先前可運作的版本，然後逐步重建有問題的功能。
  </Step>
</Steps>

## **常見的疑難排解領域**

您遇到的大多數問題都將屬於以下類別之一：

* UI 和版面配置小問題
* API 或後端錯誤
* 提示誤解
* AI 無回應或故障
* 平台或整合失敗

展開以下各節，以識別具體症狀並為每個症狀找到可行的解決方案。

### 一般問題

<Accordion title="如何快速診斷問題？">
  切換到 Chat Mode 並詢問：「有些東西運作不正常。你能解釋一下問題並告訴我你已經嘗試過什麼方法嗎？」
</Accordion>

<Accordion title="對於 UI 或版面配置問題，我該怎麼辦？">
  * 檢查元件層級結構並檢視應用的樣式。
  * 使用螢幕截圖清楚地說明任何視覺上的小問題。
  * 直接提示 Lumi：「這個元素未對齊。請修復它。」
</Accordion>

<Accordion title="如果我完全卡在一個錯誤上該怎麼辦？">
  * 嘗試這個提示：「讓我們退一步。分析錯誤並提出替代解決方案。」
  * 將任務分解成更小、更易於管理的步驟。
  * 如果錯誤持續存在，請使用還原按鈕回復到可運作的版本。
</Accordion>

<Accordion title="「code sandbox error」是什麼意思？">
  這表示平台出現問題，不應該發生。請立即向我們的支援團隊回報。
</Accordion>

<Accordion title="如果我看到「Not found preview」或「spinning up sandbox」的訊息，該怎麼辦？">
  首先，嘗試強制重新整理瀏覽器。如果問題未解決，請聯繫支援團隊尋求協助。
</Accordion>

### AI 可靠性

<Accordion title="在進行提示工程時，如何避免 AI 犯錯？">
  * 撰寫清晰、結構良好的提示。
  * 採用反向元提示技巧。
  * 在實施重大變更前，先在 Discuss Mode 中測試提示。
</Accordion>

<Accordion title="如果 AI 沒有回應，我該怎麼辦？">
  這是一個非預期的問題。請向我們的支援團隊回報以獲得立即協助。
</Accordion>

<Accordion title="如何打破持續的修復錯誤循環？">
  優化您的提示以闡明您的目標，或向 AI 請求逐步除錯指南。
</Accordion>

<Accordion title="如果重構引起重大問題，我該怎麼辦？">
  逐步實施變更。如果問題持續存在，請還原到穩定版本或使用 Discuss Mode 進行除錯。
</Accordion>

<Accordion title="如果 AI 進入錯誤循環、產生幻覺或使用錯誤的邏輯該怎麼辦？">
  如果您遇到錯誤循環或有缺陷的邏輯，請還原到穩定版本。然後，在您的下一個提示中提供更具體的上下文，可使用視覺編輯器或附加知識檔案。
</Accordion>

<Accordion title="如果 AI 未能實作我要求的變更，我該怎麼辦？">
  AI 可能誤解了您的請求或針對了錯誤的檔案。請提供高度具體的指令，或手動進行編輯。
</Accordion>

<Accordion title="如果 Discuss Mode 或 Agent Mode 沒有回應或給出不完整的答案該怎麼辦？">
  這是一個非預期的問題。請向我們的支援團隊回報以獲得立即協助。
</Accordion>

<Accordion title="對於非預期的崩潰、錯誤或循環，我該怎麼辦？">
  * 避免重試完全相同的提示；相反地，簡化或改寫它。
  * 詢問 AI：「我們已經嘗試過哪些解決方案？」
  * 還原您專案的先前可運作版本。
</Accordion>