GeekGravity游戏存档、同步与常见问题
Public document · Updated
玩家：进度在哪里？
接入站内播放器的游戏优先在当前浏览器保存。登录账号后可同步账号存档；换设备前请确认同步成功。游客、断网或宿主不可用时，不能把本地保存当成云端保存。
外部投稿游戏遵循原网站自己的存档规则。微信小游戏与网页版进度分别保存，本站登录不会合并微信进度。
遇到两份进度怎么办？
登录或换设备时可能出现本地与云端冲突。核对摘要后再选要保留的进度，不要仅根据设备或时间猜测。选择完成后，游戏应立即加载选中的状态。
常见问题
- 换设备后没有进度：核对登录账号、游戏是否接入本站存档，以及原设备是否完成云端同步。
- 只有本地保存：检查网络和登录状态，重试同步。确认之前不要清理浏览器数据。
- 无痕模式或存储空间不足：本地写入也可能失败，注意保存提示。
- 版本升级无法读档：向开发者反馈游戏名称、版本、设备和问题步骤；不要公开账号凭据或完整私人存档。
开发者：存档约定
使用稳定游戏 ID，JSON 中维护自己的 schemaVersion。账号存档正文上限 64 KiB，摘要上限 1 KiB；摘要可用关卡等短信息帮助玩家选择。
存档通过修订号检查冲突，不能忽略冲突后强行覆盖。SDK 的 save 事件必须更新游戏运行态，而不仅写入 localStorage。暂停或关闭页面时网络请求不保证完成，应在关卡结束等稳定节点及时保存。
SDK 写入返回 saved 表示保存结果，source 为 cloud 才表示该次确认了云端同步；local 不等于上传成功。客户端存档不适合作为可信排行榜或奖励结算依据。