> ## 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. **執行前先諮詢，確認再動手**: 用 [諮詢模式](/zh-Hant/superun/detailed-tips-modules/consultation-guide) 討論方案和風險，思路清楚後再切換「立即執行」。諮詢不消耗算力值。
2. **用專案裡的真實場景驗證**: 執行前讓 AI 基於你實際頁面分析，而不是泛泛而談。可以這樣說：
   * 「先不要改代碼。請結合我專案裡 **XX 頁面** 的實際情況，分析根因和可能風險。」
   * 「複述你理解的問題和修復步驟，我確認後再執行。」
3. **複雜任務拆小步**: 一次只讓 AI 處理 1–2 件事，做完確認再繼續：
   * 「把這次修改拆成 2 步，**只做第 1 步**，我確認後再繼續。」
   * 先修登錄，再修列表頁；不要一次說「把所有 bug 都修了」
4. **三次停手規則**: 同一問題已嘗試修復 **3 次**仍無進展時：
   * **立刻停止**當前對話，不要繼續讓 AI 在同一方向上反覆改
   * 用 [版本歷史](/zh-Hant/superun/features/version-history) **回滾**到正常工作的版本
   * 改用諮詢模式換思路；或先讓 AI 用 **最小可復現場景** 說明修復方案，再動主專案：
     * 「這個問題已修 3 次仍失敗。請先用最小示例說明你會怎麼修，我確認後再改主專案。」
5. **出 Bug 先檢修**: 優先點擊「檢修」（免費），再按下方 debug 流程與 AI 討論

**相關指南**: [算力值使用指南 → 省錢清單](/zh-Hant/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. 仍無進展時，按「三次停手規則」回滾版本、換思路