---
name: wechat-svg-typewriter
description: 把公众号短句制作成点击后逐字出现的原生SVG字幕，保留文字并支持重新播放，适合开场独白和章节引语。
metadata:
  version: "0.1.0"
---

# 逐字打印与重播

调研参考打字机节奏与秀米纸张展开的演示。本包提供短文字逐字显现版本。制作长纸张类原生效果时，参考教程提醒统一图片宽度，并按比例设置图片间距。[小红书参考案例](https://www.xiaohongshu.com/explore/6871048400000000100265de)

## 收集材料

提供 `title` 与 `text`。`text` 支持换行，按14em宽度分行，最多六行。`interval` 为每个字簇0.02～0.4秒。组合重音和常见emoji组合按同一字簇显示，最终文字保持完整。

强调色用 `accent`，底色用 `background`，均采用六位HEX颜色，沿用本篇主题。

## 生成

修改 [示例输入](examples/config.json)，再执行。

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

已有输出需替换时加 `--overwrite`。脚本保护配置和原始图片，先暂存全部输出，再提交。发生写入错误时恢复已有文件，恢复遇到问题会报告备份路径。

生成文件采用内联SVG与SMIL。片段可组合到本次正文中。可打开 [交互示例](examples/preview.html) 查看效果。

## 检查

点击打字，核对字符顺序与完整终句，再点击重播，确认旧字先隐藏后重新出现。检查320/375px换行与边界。

在秀米导入时检查当前粘贴选项。保存重开后核对文字、关键组ID、动画及实际交互。

2026-11-12，Ego lite在375px与320px下的真实鼠标检查通过。本地预览和秀米独立测试稿保存重开后的阅读页，均通过两次播放与重播，示例20个字簇全部显示，页面无横向溢出。公众号同步及真实手机微信触摸待测。

## 实现

每个字簇采用独立SVG文字与延迟透明度动画。重播按钮同时重置全部字符，再按时间逐个显示。

每次生成采用独立的字母、数字、下划线事件ID，关键事件锚点放在组节点。新导入路径按实际保存结果复核。SVG机制参照 [W3C动画规范](https://www.w3.org/TR/SVG11/animate.html)。

## 品牌演示与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记录与实际文件校验一致。

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