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