# SpineViewer（Eagle 插件）一个 **完全离线** 的 Eagle 格式扩展插件，用于在 Eagle 中直接预览由 Spine 导出的骨骼动画。插件只接管「骨骼数据」和「纹理图集数据」类型的预览： - 骨骼数据：`skel`、`skel.bytes`、`json` - 纹理图集数据：`atlas`、`atlas.txt` 普通图片（`png/jpg/jpeg/webp`）仍由 Eagle 原生预览，插件不接管。 Eagle 按最后一段后缀分发格式扩展，因此插件同时注册 `txt` 和 `bytes`，再由查看器检查完整文件名。普通 JSON/TXT/BYTES 不会进入 Spine 预览。插件不注册导入缩略图处理器，导入阶段由 Eagle 自身处理。支持的 Spine 版本：**3.4 / 3.5 / 3.6 / 3.7 / 3.8 / 4.0 / 4.1 / 4.2 / 4.3**。 > 关键特性：无需网络、不走 CDN。所有 Spine 官方运行时代码都已拷贝到插件本地 `lib/` 目录，不含 git 子模块。 --- ## 目录结构 ``` SpineViewer/ ├─ manifest.json # 插件清单（预览扩展注册） ├─ logo.png # 插件图标 ├─ assets/ │ └─ spine-badge.png # 缩略图右下角使用的 Spine 官方 badge ├─ viewer/ │ └─ spine.html # 预览页面（动画播放 / 动画/皮肤切换 / 速度 / 缩放适配） ├─ js/ │ ├─ spine-utils.js # 资源匹配、版本检测工具 │ ├─ spine-legacy-binary.js # 3.4–3.7 二进制解析兼容层 │ └─ spine-render.js # Node 渲染辅助模块 ├─ lib/ # 各版本 Spine 官方运行时（已拷贝到本地） │ ├─ 3.4/ spine-canvas.js │ ├─ 3.5/ spine-canvas.js │ ├─ 3.6/ spine-canvas.js │ ├─ 3.7/ spine-canvas.js │ ├─ 3.8/ spine-canvas.js │ ├─ 4.0/ spine-canvas.js │ ├─ 4.1/ spine-canvas.js │ ├─ 4.2/ spine-canvas.js │ └─ 4.3/ spine-canvas.js └─ LICENSES/ # 第三方运行时的再分发许可证 ``` --- ## 工作原理 1. **跨文件夹资源配对**：Eagle 会把导入的每个文件拆分成独立的元数据文件夹（`images/.info/`，内含资产文件与 `metadata.json`），因此配套文件可能不在同一目录。插件会： - 定位到所选文件的 item 文件夹； - 涋描其**同级的所有 item 文件夹**，根据文件名（忽略 `-pro`、`-ess`、`-pma`、`-base`、`-atlas`、`-data`、`-mesh` 等常见尾缀，`-` 与 `_` 均可）自动关联出配套的 **骨骼文件** + **atlas** + **贴图**；尾缀表可在预览顶栏的“尾缀”下拉里追加自定义项； - 从 atlas 中解析它引用的贴图页面，再到库中定位实际贴图文件。 2. **版本检测**：读取骨骼数据里的版本号（`.json` 读 `skeleton.spine`，`.skel` 读二进制头部），自动选择匹配的本地运行时。 3. **预览**：查看器通过 Node `fs` 直接读取分离在各 item 文件夹中的骨骼/atlas/贴图文件（无需网络、无 CORS），用 `spine-canvas` 渲染器在 `