# SpineViewer（Eagle 插件）一个 **完全离线** 的 Eagle 格式扩展插件，用于在 Eagle 中直接预览由 Spine 导出的骨骼动画。插件只接管「骨骼数据」和「纹理图集数据」类型的预览： - 骨骼数据：`skel`、`skel.bytes`、`json` - 纹理图集数据：`atlas`、`atlas.txt` 普通图片（`png/jpg/jpeg/webp`）仍由 Eagle 原生预览，插件不接管。 Eagle 按最后一段后缀分发格式扩展，因此插件同时注册 `txt` 和 `bytes`，再检查完整文件名。导入复合后缀时，插件通过缩略图回调将 `lili.atlas.txt` 规范为 `name: "lili"`、`ext: "atlas.txt"`，`skel.bytes` 同理，磁盘文件名保持不变；同时生成匹配新名称的 WebP 缓存。这样可避开 Eagle 对 `txt` 强制显示文本卡片的逻辑。普通 TXT 保留文本内容、正常显示；普通 BYTES 显示文件说明，两者都不扫描资源库。修改注册后需要重新加载插件或重启 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 ├─ thumbnail/ │ └─ spine.js # 缩略图生成（渲染骨骼首帧并交由 Eagle 缓存） ├─ 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/ # 第三方运行时及依赖的再分发许可证 └─ node_modules/ # 可选：@napi-rs/canvas（用于高质量缩略图渲染） ``` --- ## 工作原理 1. **跨文件夹资源配对**：Eagle 会把导入的每个文件拆分成独立的元数据文件夹（`images/.info/`，内含资产文件与 `metadata.json`），因此配套文件可能不在同一目录。插件会： - 定位到所选文件的 item 文件夹； - 扫描其**同级的所有 item 文件夹**，根据文件名（忽略 `-pro`、`-ess`、`-pma` 等常见后缀）自动关联出配套的 **骨骼文件** + **atlas** + **贴图**； - 从 atlas 中解析它引用的贴图页面，再到库中定位实际贴图文件。 2. **版本检测**：读取骨骼数据里的版本号（`.json` 读 `skeleton.spine`，`.skel` 读二进制头部），自动选择匹配的本地运行时。 3. **预览**：查看器通过 Node `fs` 直接读取分离在各 item 文件夹中的骨骼/atlas/贴图文件（无需网络、无 CORS），用 `spine-canvas` 渲染器在 `