跨文件夹自动配对
+Eagle 会把每个导入文件拆成独立 item 文件夹。插件按文件名与尾缀规则关联骨骼、atlas 和贴图，即使它们分散在不同目录也能组成一套资源。
+
+
+
+ Eagle 插件 · 自动资源配对
+ 导入完成，
+
+ 导入完成，
缩略图自动就位
+ + SpineThumbnails 识别 Eagle 中导入的 Spine 骨骼、Atlas 与贴图， + 自动跨 item 文件夹完成配对，再按你的设置生成静态 PNG 或动态 WebP 缩略图。 + 从版本识别到渲染、写入、进度反馈，一次完成。 +
+ +-
+
- 9Spine 版本
3.4 – 4.3
+ - 2缩略图模式
静态 / 动态
+ - 8界面语言
简繁英日韩俄西德
+
+
+ 
+ SpineThumbnails 1.0.0 · 插件主界面
+
+
+
+
+ 
+ 首次使用默认关闭自动生成，只有主动开启后才会处理新导入的素材。
+
+
+ 首次使用默认关闭自动生成，只有主动开启后才会处理新导入的素材。
+
+
+ -
+
- json +
- skel +
- skel.bytes +
- atlas +
- atlas.txt +
- png / jpg / webp · 用于 atlas 贴图配对 +
+
+
+ SAFE BY DEFAULT
+
+ 默认关闭，只处理新导入
+缩略图会写入 Eagle 素材卡片，因此在首次使用时需要明确打开自动生成开关。
+-
+
-
+ 01
+ 不扫描历史素材
+
插件从启用后的新导入批次开始监听，不会回头批量修改已有素材。
+
+ -
+ 02
+ 不覆盖自定义缩略图
+
检测到素材已有自定义缩略图时直接跳过，并把结果记录在分类日志中。
+
+ -
+ 03
+ 配置独立保存
+
设置写入 Eagle 用户数据目录，不修改素材
+metadata.json、标签或注释。
+
+
+
+ FEATURES
+
+ 导入之后，剩下交给插件
+不是只会渲染一张图：资源发现、跨目录配对、版本切换、编码搜索和写入反馈都在同一个后台流程里完成。
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 静态与动态两种输出
+静态模式固定使用 setup pose 输出 PNG；动态模式读取骨骼中的第一个动画，逐帧渲染后封装为轻量 WebP。
+体积与速度双策略
+“最优体积”生成十个候选档位并保留最小结果；“最优速度”先粗估再只渲染最有希望的一两档，适合大批量导入。
+9 个运行版本
+从 JSON 版本字段或 SKEL 二进制头部识别 Spine 版本，自动匹配 3.4–4.3 对应的本地运行时。
+批次串行处理
+一次只渲染一个素材，避免批量导入时把 Eagle 卡住。后续批次自动排队，进度窗口会同步总数与剩余数量。
+暂停、继续与取消
+大批量动态生成时自动显示进度窗口。可暂停当前队列、继续执行，或取消剩余任务并保留已经完成的结果。
+分类日志
+成功、失败、警告和错误可分别筛选。每条记录包含素材名、Eagle 文件夹、骨架、atlas 与贴图齐全情况。
+八种界面语言
+跟随 Eagle 当前语言显示简体中文、繁体中文、英文、日文、韩文、俄文、西班牙文或德文界面。
+
+
+
+ WORKFLOW
+
+ 从导入到缩略图
+首次打开自动生成后，后续新导入的 Spine 素材会沿同一条串行流程处理。
+-
+
-
+ 01
+
发现新素材
+监听 Eagle 素材库目录，在导入批次稳定后读取新增 item，历史素材不会进入队列。
+
+ -
+ 02
+
配对与检查
+关联骨骼、atlas 和贴图，检查版本、复合后缀、贴图数量以及是否已有自定义缩略图。
+
+ -
+ 03
+
渲染缩略图
+加载匹配运行时，按静态或动态模式绘制画布。动态模式继续搜索满足目标体积的编码参数。
+
+ -
+ 04
+
写入与反馈
+通过 Eagle 官方接口写入自定义缩略图，并同步更新统计、分类日志与进度窗口。
+
+
+
+
+ OUTPUT
+
+ 按素材用途选择输出
+两种模式共用同一套资源识别与安全检查，只在最终渲染阶段不同。
+
+
+
+
+
+
+
+
+
+ STATIC
+
+ 静帧 · setup pose
+始终生成一个稳定的 default 姿势，适合需要明确默认形象、动画首帧不适合作为封面的素材。
+-
+
- 输出格式：PNG +
- 渲染内容：setup pose +
- 速度：更快，结果稳定 +
+ ANIMATED
+
+ 动态 · 首个动画
+读取骨骼中的第一个动画，采样帧后封装为动态 WebP，让素材卡片直接呈现动作状态。
+-
+
- 输出格式：动画 WebP +
- 渲染内容：第一个动画 +
- 速度：更慢，需搜索编码档位 +
+
+
+ SUPPORTED
+
+ 覆盖 Spine 3.4 – 4.3
+支持 JSON、SKEL、SKEL.BYTES、ATLAS 与 ATLAS.TXT，使用与皮肤和约束相匹配的本地运行时渲染。
+-
+
- 3.4
- 3.5
- 3.6
- 3.7 +
- 3.8
- 4.0
- 4.1
- 4.2
- 4.3 +
+
+
+
+
+ | 版本 | 骨骼输入 | 渲染说明 |
|---|---|---|
3.4 / 3.5 |
+ JSON · SKEL · SKEL.BYTES | +使用独立版本运行时和匹配的二进制解析分支，保留网格、权重、变形、约束与绘制顺序。 | +
3.6 / 3.7 |
+ JSON · SKEL · SKEL.BYTES | +通过官方同版本 SkeletonBinary 兼容层解析，无需额外导入 JSON。 |
+
3.8 – 4.3 |
+ JSON · SKEL · SKEL.BYTES | +读取数据版本并加载对应运行时；4.x 的物理约束、裁剪和染色能力由运行时处理。 | +
-
+
- 复合后缀
skel.bytes
+ - 复合后缀
atlas.txt
+ - PMA 贴图 +
- 多皮肤骨骼 +
- 动态 WebP +
- 进度暂停与取消 +
- 八种界面语言 +
+
+
+ GET STARTED
+
+
+
+ EAGLE PLUGIN COMMUNITY
+ 在 Eagle 插件社区获取 SpineThumbnails
+
+
+ 前往插件页 →
+
+ 安装后只需打开一次开关
+插件不会在默认状态下自动写入缩略图。先在控制面板开启“导入时自动生成缩略图”，再导入新的 Spine 资源。
+-
+
-
+
安装并打开插件
+在 Eagle 中安装插件，打开 SpineThumbnails 控制面板。
+
+ -
+
启用自动生成
+打开“导入时自动生成缩略图”，选择动态或静态模式，以及最优体积或最优速度策略。
+
+ -
+
导入整套资源
+把骨骼、atlas 和贴图导入 Eagle。插件会只针对本次新导入的素材自动处理。
+
+
+
+
+ FAQ
+
+ 常见问题
+
+
+
+
+ 插件会覆盖我已经设置好的缩略图吗？
+不会。检测到素材已有自定义缩略图时会跳过并记录日志。插件只通过 Eagle 官方接口设置当前新素材的缩略图。
+
+
+ 为什么历史素材没有自动处理？
+这是默认安全行为。插件只处理启用后新导入的素材，不扫描、不修改历史素材，避免一次开关造成全素材库批量变更。
+
+
+ 资源没有同时导入会怎样？
+配套不全的素材会记为待观察。后续批次补齐 atlas 或贴图后，插件会重新检查并继续处理。
+
+
+ 动态缩略图为什么比静态慢？
+动态模式需要渲染多个动画帧，还要在分辨率、帧率、质量和目标体积之间寻找合适档位。选择“最优速度”会减少实际生成的候选数量。
+