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

# 功能修复问题解决指南

> 功能修复反复失败、AI 过度承诺相关问题的解决方案.

## 问题解决

### AI 过度承诺或修复陷入循环

**问题现象**:

* AI 在执行前说一定能修好，但改完后问题仍在，甚至引入新问题
* 同一 Bug 连续修复多次，算力值消耗很高却无明显进展
* 复杂功能一次性改动太多，AI 容易「遗忘」上下文或改错其他部分

**推荐做法**:

1. **执行前先咨询，确认再动手**: 用 [咨询模式](/superun/detailed-tips-modules/consultation-guide) 讨论方案和风险，思路清楚后再切换「立即执行」。咨询不消耗算力值。
2. **用项目里的真实场景验证**: 执行前让 AI 基于你实际页面分析，而不是泛泛而谈。可以这样说：
   * 「先不要改代码。请结合我项目里 **XX 页面** 的实际情况，分析根因和可能风险。」
   * 「复述你理解的问题和修复步骤，我确认后再执行。」
3. **复杂任务拆小步**: 一次只让 AI 处理 1–2 件事，做完确认再继续：
   * 「把这次修改拆成 2 步，**只做第 1 步**，我确认后再继续。」
   * 先修登录，再修列表页；不要一次说「把所有 bug 都修了」
4. **三次停手规则**: 同一问题已尝试修复 **3 次**仍无进展时：
   * **立刻停止**当前对话，不要继续让 AI 在同一方向上反复改
   * 用 [版本历史](/superun/features/version-history) **回滚**到正常工作的版本
   * 改用咨询模式换思路；或先让 AI 用 **最小可复现场景** 说明修复方案，再动主项目：
     * 「这个问题已修 3 次仍失败。请先用最小示例说明你会怎么修，我确认后再改主项目。」
5. **出 Bug 先检修**: 优先点击「检修」（免费），再按下方 debug 流程与 AI 讨论

**相关指南**: [算力值使用指南 → 省钱清单](/superun/detailed-tips-modules/credits-guide#money-saving-checklist)

***

### 修复后功能又失效

**问题现象**:

* 修复后功能又失效
* 同一问题多次修复仍不成功
* 算力值消耗过多

**解决方案**:

1. **回滚版本**: 回滚到正常工作的版本，换个思路重新修复
2. **使用咨询模式**: 先点击「免费咨询」规划方案，确认后再执行
3. **避免反复对话**: 不要反复对话同一个问题，容易陷入错误循环
4. **复杂功能使用 AI 工具**: 对于海报编辑器等复杂功能，建议使用 superun 生图 等 AI 工具
5. **停止当前对话**: 如果发现 AI 陷入错误循环，停止当前对话，重新开始

**正确的 debug 流程**:

1. **理解问题**: 把报错复制出来，问 AI：「这是什么意思，问题可能在哪」
2. **确认思路**: 和 AI 讨论可能的解决方案
3. **再修改**: 确认思路后再让它修改

> 💡 **提示**: 模型有个特点，如果一开始错了，就容易陷入错误螺旋出不来。所以发现问题要及时停止，换个思路。

***

### 点击「检修」也找不到问题

**问题现象**:

* 功能突然出 Bug 或测试不通过，点击「检修」后系统没能定位 / 修复

**原因**:

* 「检修」主要用于自动排查**系统、部署、环境**类异常（如服务异常、数据库连接、重新部署）
* 如果问题本质是**模型理解偏差**或**执行时序错误**（咨询时说没问题、执行后却出错），「检修」往往无法发现

**解决方案**:

1. 回到对话，**明确执行流程与预期结果**：说清你期望的步骤，以及当前实际表现与预期的差异
2. 让 AI **先复述**它理解的问题与修复步骤，确认无误再执行
3. 仍无进展时，按「三次停手规则」回滚版本、换思路