资源包版本匹配与卡顿排查

用 AzureArchive 的人遇到的问题高度集中：卡在等待、提示无法加载资源包、图片或角色不显示、手机端发烫卡顿。这些几乎都能在对上版本号、重装资源包、关掉自动功能这三招里解决，这篇把排查顺序理出来。相关文档：安卓版下载安装与资源加载 · 蔚蓝档案剧情编辑器上手六步

先记一条总原则

程序本体和资源包是分开的，资源包必须与本体版本号匹配。升级了本体却沿用旧资源包，是最常见的问题源头；反过来，装对了资源包但本体版本太旧，同样会报错。遇到任何「加载类」提示，第一反应都是核对两边版本。

按提示对号入座

一直卡在「检查更新」或「等待中」：先核对资源包与本体的版本是否匹配；安卓端安装资源包的过程中切出应用也会中断安装，重装时保持前台。缓存异常同样会导致重试循环，按文档清理缓存或换个网络环境再试。

提示「无法加载资源包」：确认资源包版本匹配后重新导入。zip 方式反复失败，可以在设备存储里新建 manual_install 文件夹，把资源包内容解压进去，启动后程序会自动识别安装；装完文件夹会自行消失，这是判断装没装对的标志。

图片或角色在编辑与回放里不显示：没装资源包就先装；已经装过还缺，说明资源包装坏了或版本不对，重装对应版本即可。

导入自定义角色时提示 SPINE 版本不可用：当前不支持 3.8.75 版本的 SPINE 文件，换成 3.8.96 版本导出再导入。

卡顿与性能

程序以电脑端为主设计，手机端属于移植，受各系统调度影响卡顿程度不一，这属于正常现象。缓解手段有三：清空后台大应用；在设置里关闭自动编译与自动保存；对流畅度要求高就转电脑端。

真遇上疑似 bug 的行为，电脑端按 F8 能查看并复制报错信息，移动端在设置里开启调试控件后从屏幕右侧的框读取——带着报错去提问，比一句「它坏了」高效得多。

排查完想继续用

版本对上、资源装好，剩下的就是熟悉编辑流程。建议按蔚蓝档案剧情编辑器上手六步走一遍完整链路；还没装好的，从安卓版下载安装与资源加载补齐前置步骤。工具的整体介绍与功能对照，见AzureArchive 介绍站。