# SpineViewer 1.1.2

Eagle 的离线 Spine 骨骼动画预览插件，支持 Spine 3.4–4.3，适用于 Windows 和 macOS。

## 功能与使用

1. 将同一套骨骼文件（`.skel` / `.skel.bytes` / Spine `.json`）、图集（`.atlas` / `.atlas.txt`）和配套贴图一起导入 Eagle，建议放在同一个 Eagle 文件夹内。
2. 打开骨骼或图集文件即可预览动画，并可切换动画、皮肤、速度、循环、背景和 PMA。
3. 插件不接管导入阶段的缩略图，由 Eagle 自身处理。
4. 打开预览后，原有按钮可把当前帧设为当前素材的自定义缩略图。其左侧的“为关联资源生成缩略图”会列出同 stem 的骨骼、atlas 及已验证贴图；骨骼与 atlas 默认勾选，图片和已有自定义缩略图的素材默认不勾选；用户仍可主动选择并覆盖，原图无法由插件自动恢复。
5. 顶栏“尾缀”下拉列出内置尾缀（`pro` `ess` `pma` `base` `atlas` `data` `mesh`）与自定义尾缀：“＋ 添加尾缀…”可新增，“选中自定义项”可移除。自定义尾缀保存在本地（Eagle userData），对全部素材生效，用于让 `hero-hover.skel` 这类文件与 `hero.atlas` 配成一套。

## 安全与隐私

- Atlas 贴图只允许安全的相对路径；绝对路径、`..`、盘符、UNC、URI 和越界符号链接会被拒绝。
- 跨素材配对只使用当前 Eagle 素材库中已枚举并验证的文件。
- 单素材按钮只作用于当前素材。资源组按钮会先列出全部受影响素材并要求确认，已有自定义缩略图默认不选中，只有用户明确勾选才会覆盖。

## 多语言

支持简体中文、繁体中文、English、日本語、한국어、Русский、Español 和 Deutsch。

第三方许可见 `LICENSES/`。