========================================================================
             💎 Spine 万能查看器 (Universal Spine Viewer) v3.0 使用说明
========================================================================

这是一个功能强大的 Web 端 Spine 动画查看与编辑工具。

[ 支持版本详情 ]
✅ Spine 3.8 / 4.0 / 4.1 / 4.2
   - 完美支持 JSON (.json) 和 二进制 (.skel) 格式。
   - 推荐使用这些版本以获得最佳体验。

⚠️ Spine 3.6 / 3.7
   - 完美支持 JSON (.json) 格式。
   - 二进制 (.skel) 支持有限：由于旧版 Web 运行库限制，部分二进制文件可能无法读取或显示异常。
   - 对于 3.6/3.7 版本，强烈建议导出时选择 JSON 格式。

核心特色：多版本自动识别、特效绑定系统、可视化编辑。

------------------------------------------------------------------------
1. 📂 快速开始 (如何加载文件)
------------------------------------------------------------------------
本工具采用“文件夹识别”模式，而非单个文件加载。

1. 点击屏幕中央或左上角的 【📂 打开动画文件夹】 按钮。
2. 选择包含 Spine 资源文件 (.json/.skel + .atlas + .png) 的**整个文件夹**。
   - 支持多层子文件夹，系统会自动扫描所有内容。
3. 左侧列表会自动列出扫描到的所有骨架。
4. 点击列表中的文件名即可切换查看。

> 💡 提示：左侧文件列表支持【搜索】和【收藏】功能，点击星星 ★ 可收藏常用文件。

------------------------------------------------------------------------
2. 🎮 视图与播放控制
------------------------------------------------------------------------
[ 鼠标操作 ]
• 移动视角：按住鼠标左键或右键拖拽。
• 缩放视角：滚动鼠标滚轮。
• 重置视角：点击底部播放条的 【归位】 按钮。

[ 底部播放条 ]
• 播放/暂停：点击左侧播放按钮 (或按空格键)。
• 进度控制：拖动时间轴滑块。
• 倍速控制：可选 0.5x (慢放) 到 2.0x (快放)。
• 帧率设置：支持 30fps / 60fps (默认) 切换。
• 坐标微调：使用下方的 X / Y 滑块微调角色位置。

------------------------------------------------------------------------
3. 🛠️ 右侧功能面板 (模块化设计)
------------------------------------------------------------------------
右侧面板包含多个折叠模块，点击标题即可展开/收起。

🎬 动画 (Animation)
• 主动画：选择当前播放的动作。
• 叠加轨道：点击 【➕ 添加叠加轨道】 可以同时播放多个动作 (例如：一边跑步一边攻击)。
• 皮肤选择：切换角色皮肤 (支持多皮肤混合)。
• PMA/Unpack：
  - PMA (预乘 Alpha)：默认开启，解决边缘黑边问题。
  - Unpack：如果您的贴图是 Straight Alpha (直通) 导出的，请开启此项。

💀 骨骼显示 (Bones)
• 显示骨骼：开启后可查看骨骼架构。
• 样式调整：可自定义骨骼的颜色和粗细。

⚡ 事件监视器 (Events)
• 弹幕显示：动画中触发的 Event 会以弹幕形式显示在屏幕右下角。
• ✨ 管理特效 / 绑定：(核心功能，详见第 4 节)。

🖼️ 参考背景 (Reference)
• 背景颜色：支持纯色、自定义颜色、PS透明棋盘格。
• 背景图片：支持上传一张参考图，可调节位置、缩放和透明度，用于对比原画。

🎨 角色调色板 (Color)
• 滤镜：实时调整角色的 色相(Hue)、饱和度(Sat)、亮度(Light)。
• 染色：给角色叠加一层颜色 (Tint)。

------------------------------------------------------------------------
4. ✨ 特效系统与事件绑定 (核心功能)
------------------------------------------------------------------------
这是本工具最强大的功能，允许您为 Spine 动画添加外部特效(序列帧)，并绑定到特定事件上。

[ 1. 导入特效 ]
点击 【✨ 管理特效 / 绑定】 按钮打开面板：
• 导入序列帧文件夹：选择一个包含图片序列 (001.png, 002.png...) 的文件夹。
• 导入精灵图 (Sprite Sheet)：选择一张大图，并在弹出的窗口中设置【行数】和【列数】进行切分。

[ 2. 编辑特效 ]
在“特效资源库”列表中，点击特效旁边的 ⚙️ 齿轮图标，可以调整：
• 混合模式：正常 (Normal) / 叠加 (Add) / 正片叠底 (Multiply) 等。
• 基础属性：缩放、旋转、位置偏移、帧率、不透明度。
• 颜色叠加：给特效染上特定颜色。

[ 3. 绑定到事件 ]
切换到 “2. 事件绑定配置” 标签页：
• 系统会自动列出当前骨架包含的所有 Event (事件)。
• 点击事件下方的 【➕】 号，选择一个已导入的特效进行绑定。
• 绑定参数：
  - 延迟时间：设置触发后的延迟。
  - 循环次数：设置特效播放几次 (支持无限循环)。
  - 层级 (Z-Index)：设置特效是在角色【前方】还是【后方】。

> 💡 绑定后，当动画播放到该事件时，特效会自动触发！

------------------------------------------------------------------------
5. 📤 导出功能 (序列帧 & GIF)
------------------------------------------------------------------------
在左侧面板下方，您可以将当前的动画(包含绑定的特效)导出。

[ 导出格式 ]
1. PNG 序列帧：导出透明背景的图片序列 (通用性最强)。
2. GIF 动图：导出为 GIF 表情包。
[ 批量导出 ]
• 勾选 【导出所有动作】，可以将当前角色的所有动作一次性全部导出。

------------------------------------------------------------------------
6. ❤️ 支持作者
------------------------------------------------------------------------
如果您觉得这个工具提高了您的工作效率，欢迎点击屏幕左下角的 【☕】 图标。
您可以请作者喝杯咖啡，这将激励我开发更多好用的功能！

------------------------------------------------------------------------
常见问题：
Q: 导出视频时画面抖动？
A: 导出过程中请勿拖动浏览器窗口或切换标签页，保持窗口前置。

Q: 导入文件夹没反应？
A: 请确保文件夹内包含 .json 或 .skel 文件，以及对应的 .atlas 和图片。
------------------------------------------------------------------------
