---
name: wechat-svg-puzzle-assemble
description: 为公众号制作四块原创图案从散落到拼合的SVG展示动画，支持自定义短标签、主题色和重播。
metadata:
  version: "0.1.0"
---

# 点按拼图拼合

正文展示滑动碎片拼图解锁。本包按点按播放的方式实现原创四块拼合。[小红书参考案例](https://www.xiaohongshu.com/explore/6880387a000000001202d31a)

## 材料与行为

需要 `title`、四个 `labels` 和一行 `caption`。每个标签最多三个全角字。`duration` 为每块移动秒数，范围0.4～4，四块错峰0.12秒开始。强调色和底色采用六位HEX。

点按后四块归位，完成后可重播。交付用语可称“点按拼合动效”。若需要跟手拖动、正确位置判断或其他拼图玩法，应另外选择支持这些行为的实现。

检查四块分别到目标位置，文字完整；播放期间重复点击应等待完成。重播会从散落画面重新拼合。

## 生成

读取[输入示例](examples/config.json)，填入本篇文字与颜色。

```text
python <本Skill目录>/scripts/render.py --config <本次目录>/config.json --out <本次目录>/component.html --preview-out <本次目录>/preview.html
```

已有输出需替换时加 `--overwrite`。输入配置、片段、预览使用不同路径。脚本会保留文字与特殊符号，字段过长、缺项或路径冲突时给出具体说明。只使用Python3.10及以上标准库。

生成片段采用SVG与SMIL，实例事件ID分别生成。示例采用原创矢量与文字，按本篇材料替换后再交付。可先打开[交互预览](examples/preview.html)。

## 接入与检查

- 检查320、375px宽度中文字、按钮和画面边界。
- 同一篇放两份组件，分别操作，核对实例互不影响。
- 插入秀米前检查当前粘贴格式选项，保存重开后从阅读页检查实际动作。
- 事件放在带ID的组节点，初始显示状态同时写入属性与内联样式。接收端会清理部分属性时，按实际保留结构复查。
- 公众号同步、真实手机微信触摸与音频按相应功能实际检查。



## 2026-11-13本轮验证

Ego lite独立预览和30项合并总页均在320、375px视口完成真实鼠标检查，无页面横向溢出。总页已复核主要动作和终态。独立前向生成、特殊字符、事件引用、双实例ID及源文件保护检查通过。秀米保存重开、公众号同步与真实手机微信触摸待验证。

## 品牌演示与GIF

[查看可操作演示](examples/brand-preview.html) · [查看GIF](examples/demo.gif) · [读取品牌样式与素材](examples/brand-style.json)

1. 先看GIF选择效果，再读取 `examples/brand-style.json` 和 `examples/brand-component.html`，确认本组件的画布、配色及素材。
2. 按本次任务采用使用者自己的头像、账号资料、正文与配图。直接修改本地品牌HTML模板和相邻素材即可复用单项包。原有生成器的参数能力以本Skill正文为准。
3. 文字保留原生编辑。图片放在对应动画组或状态组里，保留事件ID、SMIL时序与透明点击区。同篇放多个实例时，分别生成独立ID并同步事件引用。
4. 修改后检查完整动作与返回，核对文字、图片和按钮边界，再检查目标编辑器中的保存结果。

本版已有600px浏览器操作／播放采集、320／375px布局检查，GIF记录与实际文件校验一致。

品牌输出的秀米保存重开、公众号同步与真实手机微信效果待按目标环境核对。
