> ## 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.

# 常見問題排查

> superun 使用過程中遇到的常見問題及解決方案,包含數據回滾,AI 功能異常,算力值問題等.

本文檔整理了 superun 使用過程中用戶反饋的常見問題及對應的解決方案,幫助你快速定位和解決問題.

***

## 數據回滾和修改異常問題

### 問題描述

用戶反饋修改內容後第二天自動恢復舊版本,或內容消失併入其他分類.

### 解決方案

模型代碼在數據加載失敗時會重新初始化舊數據.建議採用以下方式:

* **使用單獨後台管理數據**:將數據管理與模型邏輯分離,避免數據加載失敗時觸發重新初始化
* **直接讓模型修改數據**:確保數據修改操作由模型直接處理,減少中間環節導致的數據不一致

***

## AI 試衣生成失敗問題

### 問題描述

用戶反饋 AI 試衣生成功能報錯,多次修復無效.

### 解決方案

此問題通常由 `headers` 參數導致 `body` 序列化問題引起.解決步驟:

1. 檢查 API 請求中的 `headers` 參數
2. 讓 AI 排查多餘的 `headers` 參數
3. 確保 `headers` 與 `body` 的序列化格式一致
4. 移除不必要的 `headers` 配置

***

## 算力值不足後報錯問題

### 問題描述

用戶反饋算力值充值後會話異常終止,無法繼續操作.

### 解決方案

1. **查看日誌**:檢查系統日誌,確認算力值充值後的具體錯誤信息
2. **使用檢修功能**:在 superun 中使用檢修功能處理異常狀態
3. **重新測試**:修復後重新測試,確認會話可正常繼續

> 💡 **提示**:如果問題持續存在,建議聯繫技術支持並提供相關日誌信息.

***

## 後台地址和 APP 部署問題

### 問題描述

用戶諮詢後台地址和 APP 下載方式.

### 解決方案

**當前限制說明**:

* superun 目前只能生成**網頁應用**,無法直接生成原生 APP
* 如需部署後台管理系統,需要**先生成後台**,然後再進行其他配置
* 後台地址會在生成後提供,具體位置取決於你的部署方式

**建議流程**:

1. 先使用 superun 生成後台管理系統
2. 獲取後台訪問地址
3. 如需移動端體驗,可考慮使用響應式設計或 PWA（漸進式網頁應用）

***

## 瀏覽器兼容性問題

### 問題描述

Safari（特別是老版本,如 Safari 16.1 / macOS 13）無法打開網站,顯示空白頁面,或某些網絡環境下無法訪問.

### 解決方案

1. **推薦瀏覽器**:使用 Chrome、Edge、Safari（新版本）等主流瀏覽器
2. **系統升級**:升級 macOS 系統以獲得最新版 Safari
3. **網絡測試**:訪問 `https://net-test.superun.app/` 測試網絡連接
4. **設備建議**:盡量使用電腦端操作,手機和 iPad 的適配還在完善中

***

## 預覽和操作問題

### 問題描述

預覽打不開但發布的鏈接可以正常訪問,有算力值但無法操作或打字,預覽一直處於某個狀態頁面沒有變化,或功能修復後又失效.

### 解決方案

1. **預覽打不開**:
   * 檢查網絡連接,訪問 `https://net-test.superun.app/` 測試
   * 嘗試在新頁面打開預覽
   * 如果發布的鏈接可以訪問,可能是預覽環境的問題,刷新瀏覽器

2. **有算力值但無法操作**:
   * 需要先勾選"產生演示",完成後才能進行對話修改
   * 確保項目已經完成初始演示生成

3. **預覽狀態不更新**:
   * 點擊"檢修"功能進行修復
   * 刷新瀏覽器整個頁面（不是頁面內的刷新）
   * 如果檢修後出現"執行"按鈕,點擊執行
   * 關閉瀏覽器重新打開項目

4. **功能反復失效**:
   * 可能是 AI 在後續修改中把功能改回去了
   * 使用版本歷史回滾功能恢復到之前正常工作的版本
   * 避免在同一個對話中反復修改,發現問題及時停止並換思路

***

## 發佈後內容沒有更新

### 問題描述

發佈操作完成後，透過分享連結訪問或重新整理演示，看到的仍然是舊版本內容，或修改內容未在線上生效。

### 常見原因

1. **瀏覽器快取**：瀏覽器保存了舊版本頁面，導致新發佈內容未被載入
2. **雲服務停用狀態**：雲服務被停用後，資料庫和後端服務停止運行，前端頁面可能仍然可訪問但資料無法更新
3. **發佈操作未完成**：發佈過程中網路中斷或提前關閉了頁面

### 解決方案

1. **強制重新整理瀏覽器**：按 `Ctrl+Shift+R`（Windows）或 `Cmd+Shift+R`（Mac）強制重新整理，跳過快取
2. **重新登錄後查看**：退出登錄後重新開啟分享連結
3. **確認雲服務狀態**：進入「研發 → 技能庫 → superun 雲計算」，確認雲服務處於啟用狀態
4. **停用後重新啟用雲服務**：如果雲服務剛被停用又啟用，稍等 1-2 分鐘等服務恢復，再重新整理頁面

> 💡 **提示**：發佈成功後，點擊分享連結旁邊的「重新開啟」按鈕，可以確保看到最新版本，而不受本地快取影響。

***

## 性能優化問題

### 問題描述

網頁加載慢,手機版慢.

### 解決方案

1. **檢查網絡**:可能是網絡問題,建議測試網絡速度
2. **優化圖片**:圖片或文件太大可能導致加載慢,需要優化圖片大小
3. **諮詢 AI**:描述清楚問題,讓 AI 提供優化方案
4. **考慮用戶體驗**:不能要求所有用戶網速都很快,需要在設計時考慮加載性能

***

## 網絡異常和任務卡住問題

### 問題描述

經常彈出"網絡異常"提示,或任務一直處於"讀取控制台日誌"進程中.

### 解決方案

1. **網絡異常**:可能是請求量過高,等一會就好了;如果持續出現,聯繫技術支持
2. **任務卡住**:聯繫技術支持,提供項目鏈接

***

## 如何提交新問題

如果你遇到其他問題,可以:

1. 查看本文檔是否已有類似問題的解決方案
2. 聯繫技術支持團隊
3. 在社區論壇發帖尋求幫助

***

<Card title="superun 網站" icon="globe" href="https://superun.com/web" horizontal>
  了解更多產品功能和示例.
</Card>
