> ## 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 获取指导">
    如果你感到卡住了，可以切换到 Discuss Mode 寻求帮助：

    * 要求 Lumi 分析你项目的当前状态。
    * 请求总结已经尝试过的解决方案。
    * 提示新的策略来解决顽固问题。
  </Step>

  <Step title="应用高级策略对付顽固的 Bug">
    如果问题仍然存在，请尝试以下更高级的技术：

    * **具体说明：** 清晰地描述 bug 以及你期望发生什么。
    * **使用视觉材料：** 屏幕截图或屏幕录像对于说明复杂问题非常有帮助。
    * **寻求替代方案：** 直接问：“我们还能尝试什么？”来产生新想法。
    * **回滚：** 将你的项目恢复到之前可用的版本，并逐步重建有问题的部分。
  </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>