使用

打开 DSH Web UI → 设置 → Petween 卡片：可快速启用/停用宠物、调整整体缩放，并查看图片导入进度。点击卡片上的「打开完整编辑器 →」（或浏览器直接访问 /petween-editor/）会在新标签页打开独立编辑器页面：

管理宠物：顶部「宠物」区可把当前配置保存为副本，或新建空白宠物；切换后，下面所有面板都编辑当前宠物。姿势、状态动画与整体缩放会自动镜像进当前预设。
导入图片：在左侧选择状态（如「待机」），点击「更换图片」。支持 PNG / WebP / JPEG（JPEG 无透明背景，会提示）。推荐透明背景、近似正方形画布、角色完整的图片；不同姿势尽量保持角色视觉尺寸一致。
调 Anchor：Anchor X/Y 标记角色的「脚底中心」（默认 0.5 / 0.96）。多张图的 Anchor 对齐后，切换姿势时角色不会瞬移。可用「图片缩放」微调大小。
调动画：每个状态可选进入过渡（Preset / 强度 / 时长）与循环动画（自定义循环动画 + Bounce / Sway / Breathing）；「全局」区设置默认过渡、整体缩放（0.3~4.0）、减少动态（跟随系统 / 总是 / 从不）、成功/失败停留时长。底部动画库可创建和编辑自定义时间轴动画。
实时预览：右侧预览区点击状态按钮即可模拟状态切换（走与正式 Overlay 相同的渲染与状态机），改动会即时进入预览；点击“保存修改”后写入当前宠物预设，主界面的宠物会在数秒内跟进。

也可以直接访问 http://127.0.0.1:3080/petween-editor/（端口以你的 DSH web 配置为准）。

想快速试手感而不碰真实配置：构建后直接双击 preview/index.html 打开独立预览页（无需 DSH，随上面的克隆构建流程一并生成），还支持贴入自定义 AnimationDefinition JSON 即注册即播。

petween