# 常见问题速查

按看到的现象查找。每行给出最先要查的地方和详细说明所在页面。表里没有的问题，先按[检查](../../skills/checking/SKILL.md)整理入口、预期、实际、环境和版本，再定位。

## 打包、运行与提交

| 现象 | 先查什么 | 详见 |
| --- | --- | --- |
| 开发服务器正常，导出后白屏 | 相对路径、构建依赖、实际响应头；用 HTTP 运行最终目录而不是 file:// | [打包](../../skills/packaging/SKILL.md)、[打包常见问题](../packaging/troubleshooting.md) |
| 刷新子页面 404 | 前端路由与静态文件策略 | [前端框架](../../skills/engines/framework/SKILL.md) |
| 上传提示超过容量 | 解开 ZIP 后的总量与单个文件大小，而不是 ZIP 本身大小 | [容量与数量](../packaging/limits.md) |
| Godot 编辑器正常，Web 缺脚本或资源 | 显式 export_files 和资源引用；导出退出码为零不代表完整 | [Godot](../../skills/engines/godot/SKILL.md)、[Godot 导出](../packaging/godot-export.md) |
| 每次重开都重新下载大资源 | 实际传输和缓存；不要给请求加随机时间戳 | [原生网页](../../skills/engines/web/SKILL.md) |
| 提交说明和包对不上 | 重新构建并核对 SHA256，说明里写清版本和文件名 | [提交](../../skills/submission/SKILL.md) |

## 登录、资料与存档

| 现象 | 先查什么 | 详见 |
| --- | --- | --- |
| 登录回来进度没了 | 跳转前是否保存了非敏感选择和恢复点 | [登录与账号](../../skills/capabilities/login/SKILL.md) |
| 换了昵称，房间里还是旧的 | 资料快照刷新和组件订阅 | [玩家资料](../../skills/capabilities/profile/SKILL.md) |
| 换了预览地址，进度消失 | 协议、主机和端口不同就是不同的存储，不是存档丢了 | [存档](../../skills/capabilities/storage/SKILL.md) |
| 旧进度覆盖了新进度 | 并发写入顺序和版本校验 | [存档](../../skills/capabilities/storage/SKILL.md) |
| 账号档被游客进度覆盖 | 先读账号档，导入游客进度要用户明确选择 | [存档](../../skills/capabilities/storage/SKILL.md) |

## 支付、奖励与广告

| 现象 | 先查什么 | 详见 |
| --- | --- | --- |
| 显示购买成功却没开局 | 购买和使用是否分开；读取原库存和消费状态 | [支付与权益](../../skills/capabilities/payments/SKILL.md) |
| 请求超时后多了一笔订单 | 是否把网络重试当成了新购买 | [支付与权益](../../skills/capabilities/payments/SKILL.md) |
| 登录后自动又买了一次 | 登录成功不等于付款确认；先核对原订单和库存 | [登录与账号](../../skills/capabilities/login/SKILL.md) |
| 关掉激励广告也发了奖 | 关闭事件和可信的完成结果要分开 | [激励广告](../../skills/capabilities/rewarded-ads/SKILL.md) |
| 刷新后奖励又加了一次 | 回执去重和对应玩法状态是否一起保存 | [激励广告](../../skills/capabilities/rewarded-ads/SKILL.md) |
| 没有广告时界面被挡住 | 失败路径是否移除了整个广告容器 | [普通展示广告](../../skills/capabilities/ads/SKILL.md) |
| 离开后广告又弹出来 | 取消本次展示并丢弃迟到的结果 | [普通展示广告](../../skills/capabilities/ads/SKILL.md) |

## 排行榜与联机

| 现象 | 先查什么 | 详见 |
| --- | --- | --- |
| 点了排行榜没反应 | 弹层是否压在结算页后面，实际点中的是什么 | [排行榜](../../skills/capabilities/leaderboards/SKILL.md) |
| 刷新时榜单被清空 | 保留已读数据，刷新状态和错误单独显示 | [排行榜](../../skills/capabilities/leaderboards/SKILL.md) |
| 连上了但不能动 | 加载和开局屏障、输入启用时机、模拟帧是否推进 | [联机制作](../../skills/capabilities/realtime/SKILL.md) |
| 输入有延迟，FPS 却正常 | 输入到画面的时间、确认帧和队列等待 | [双端顺畅游玩验收](../../skills/capabilities/realtime/testing.md) |
| 重开后带上了上一局的状态 | 对局代次、序号、旧确认和监听是否清理 | [联机制作](../../skills/capabilities/realtime/SKILL.md) |

## AI 生成

| 现象 | 先查什么 | 详见 |
| --- | --- | --- |
| 回答完了还显示“生成中” | 结束信号和界面状态切换 | [文本生成](../../skills/capabilities/ai/text.md) |
| 后台显示成功，用户看不到结果 | 任务详情、列表、状态存储和组件订阅，再查渲染和资源权限 | [AI 生成](../../skills/capabilities/ai/SKILL.md) |
| 生成成功但图片不显示 | 按任务状态、访问授权、下载、解码、组件逐层查，不要直接重新生成 | [图片生成](image-tasks.md) |
| 换图后用的还是旧审核结果 | 审核结果要绑定被审核内容的标识和摘要 | [内容审核](../../skills/capabilities/ai/moderation.md) |
| 重试后重复生成 | 重试只重试原操作，不新建生成 | [内容审核](../../skills/capabilities/ai/moderation.md) |

## 审核与发布

| 现象 | 先查什么 | 详见 |
| --- | --- | --- |
| 发布页提示还差几项 | 按清单逐项补；普通作品必须有 4:3 封面 | [在 iNeed 上发布与接入](on-ineed.md) |
| 审核退回 | 对照提交前自检：循环请求、等待反馈、登录回跳、广告与购买的失败路径、密钥 | [在 iNeed 上发布与接入](on-ineed.md) |
| 审核中想改作品 | 先撤回，改完重新提交，审核重新排队 | [在 iNeed 上发布与接入](on-ineed.md) |