Spine 数据读取失败，先核对哪三个版本？

封面复用 AI 生成的多外观角色概念图，不代表这些资源已在某个引擎或运行库版本通过测试。

同一包资源在工作台能预览，进入目标项目却读不出来，不应直接重画全部部件。先区分数据读取失败与已经播放后的显示异常，再核对真实版本信息。

Spine 官方版本说明要求导出JSON或二进制数据所用编辑器的主、次版本与Spine Runtimes对应。这个规则不等于“安装最新版本一定可用”，也不能从目标引擎名称推出运行库版本。

三项信息分别写，不只写“版本最新”

• 导出数据：实际文件或导出记录中的版本信息；没有证据就写未确认。
• Spine运行库：项目实际安装的集成包、分支或版本标识，附可定位来源。
• 目标引擎：实际编辑器与构建环境版本，供复现使用。

这些是人工交接字段，不是要求修改工作台配置。不要把示例版本号当成Tooliva当前所有导出的固定版本；本文没有读取你的资源包，也没有验证某一组具体版本。

先保留错误，再缩小问题阶段

记录完整错误、发生在导入还是播放阶段、实际加载的文件批次。如果数据未被读取，优先核对格式、版本与加载路径；如果已播放但某个皮肤显示不对，应继续查引用和外观范围，不把所有现象都归为版本问题。

不要在同一轮同时换运行库、换导出包又重做图片。保留原始基线，选择最小样例，并在每次比较中说明具体改变了什么。

版本不对应时，先协商变更方向

一种方向是保持目标项目环境，确认上游是否能按其要求提供有效数据；另一种方向是由集成人评估更新运行库及关联代码的影响。选择哪条路径，应依据实际工具能力与项目约束，不是看到较大的数字就自动升级。

如果需要修改导出方式，先在 Spine 工作台及实际交付流程中确认支持范围。公开 图文教程展示资源准备和多皮肤导出，但没有证明任意历史版本都可选择，不能据此承诺某个不存在的转换按钮。

改版本字符串，不是完成格式转换

编辑JSON中看起来像版本的文字，只能说明文本变了，不能证明数据结构已符合目标运行库。即使越过某个报错，也不能据此宣布所有动作和皮肤兼容。

若团队提供转换后的副本，应保留原文件与转换方法，分别检查数据加载、计划动作、皮肤及图片引用。不要让“没有弹错”代替实际播放验收。

用一份最小记录交接

例如可以记录：“文件批次A，数据版本待核对；项目集成包来源已确认；在导入阶段返回某条实际错误；本轮未改图片。”A只是批次符号，不是产品内置格式，也不是可直接套用的诊断结论。

• 已确认项：具体值与来源。
• 未确认项：由谁核实，避免填猜测值。
• 本轮变更：只描述真正改动的条件。
• 验收结果：加载、动作与外观分别记录。

需要先判断异常范围时，可参考 单套与多套皮肤异常分流。版本核对是排查路径，不是任意引擎兼容认证，也不应替代有证据的文件和项目检查。