animate-text

文本动画

使用此技能作为由生成式 JSON 合约支持的文本动画目录。

使用 assets/specs/<id>.json 获取可移植的动画合约。使用 assets/effects/<id>.json 精确复现动画，包括内容、渲染器算法、播放、运行时、宿主要求、渲染合约和库适配器。

此技能总共包含 24 个规格。网站目前展示其中 20 个。

适用场景

当请求涉及以下内容时，使用此技能：

• 为标题、标签、计数器、编辑文案或文本切换添加动画
• 匹配指定的效果 ID，例如 soft-blur-in、typewriter、shared-axis-y 或 kinetic-center-build
• 从精选目录中选择动画模式，并将其转换到目标技术栈
• 在另一个技术栈中复现当前动画行为，而不依赖示例组件
• 使用 WAAPI、Motion / motion.dev、GSAP、CSS、Lottie、Rive 或其他渲染器实现相同规格

工作流

1. 确定用户需要：
   • 可见效果的网站精确版本
   • 动画合约的可移植转换
2. 如果用户指定了效果 ID，请读取 assets/specs/<id>.json，或运行 node scripts/get-spec.mjs <id>。
3. 否则，请使用 references/catalog.md，或按需运行：
   • node scripts/list-specs.mjs
   • node scripts/find-spec.mjs "<query>"
4. 如果用户需要对动画意图进行可移植转换，请使用 assets/specs/<id>.json。
5. 如果用户需要精确复现生成的动画行为，请使用 assets/effects/<id>.json 或 node scripts/get-effect.mjs <id>。
6. 如果用户指定了目标动画库，请将其视为必须遵循的要求。按照 showcase.library_selection 操作，并且仅使用该效果对应的 showcase.library_adapters.<library> 代码块。
7. 精确复现时，优先遵循 showcase.renderer、showcase.playback、showcase.timing、showcase.runtime、showcase.stage、showcase.rendering_contract、showcase.library_selection 和 showcase.library_adapters，不要仅凭可移植规格推断。
8. 仅将 showcase.stage 视为动画宿主要求。除非用户明确要求该 UI，否则不要照搬源网站的排版、颜色、内边距、卡片样式或页面布局。
9. 将效果应用于现有内容区块时，请保留该区块的文本。除非用户明确要求复现展示文案，否则仅将 showcase.content 用作演示或备用文案。

捆绑资源

• references/catalog.md：捆绑规格库的简要概述
• references/schema.md：可移植规格和精确展示效果配方的字段级架构
• references/selection-guide.md：选择合适效果类别的启发式指南
• references/implementation-notes.md：常见动画技术栈的转换说明
• assets/specs/*.json：可移植动画合约
• assets/effects/*.json：精确的生成式动画配方
• assets/catalog.json：可见网站目录顺序和渲染器覆盖项
• assets/samples.json：生成示例使用的示例文案
• assets/runtime-presets.json：运行时倍数和循环计时预设
• assets/stage-presets.json：动画宿主要求，而非呈现样式
• assets/renderer-recipes.json：共享渲染器算法
• assets/library-adapters.json：WAAPI、Motion 和 GSAP 的实现映射指南

可选辅助脚本

辅助脚本是可选的确定性快捷方式，需要 Node.js 20+。

• node scripts/list-specs.mjs：以 JSON 格式打印捆绑规格的元数据
• node scripts/get-spec.mjs <id>：以 JSON 格式打印一个可移植动画规格
• node scripts/get-effect.mjs <id>：以 JSON 格式打印一个精确的生成式动画配方
• node scripts/find-spec.mjs "<query>"：根据元数据排序并返回可能的匹配项

如果无法使用 Node，仍可仅通过 Markdown 参考资料和 JSON 资源使用此技能。

翻译规则

• 原样保留 target：whole、per-character、per-word 或 per-line。
• 直接将 enter 和 exit 的时长、缓动和交错应用到目标技术栈。
• 目标技术栈支持时，保留变换、不透明度、模糊、缩放、旋转和间距字段。
• 对于 kinetic-center-build 或 short-slide-down 等依赖布局的效果，使用确切的效果配方，而不是将效果简化为通用交错。
• 要精确复现动画，请保留 assets/effects/<id>.json 中的 showcase.renderer、showcase.playback、showcase.timing、showcase.runtime、showcase.stage、showcase.rendering_contract 和 showcase.library_adapters 字段。
• 不要替换用户指定的动画库。如果用户要求使用 GSAP，就导入并使用 GSAP；如果用户要求使用 Motion，就导入并使用 Motion；如果用户要求使用 WAAPI，就使用 Element.animate。
• 目标技术栈为 Motion 或 GSAP 时，请使用相应的 showcase.library_adapters.motion 或 showcase.library_adapters.gsap 代码块，获取导入方式、时间单位转换、缓动转换、关键帧格式、完成方式和特定渲染器的说明。
• 仔细阅读 showcase.engine_notes 和 showcase.reproduction_notes。其中包含实现视觉一致性所需的特定技术栈细节。
• 要精确复现网站行为，请完整实现 showcase.playback 循环。除非用户明确要求仅显示一次，否则不要只执行首次进入动画。
• 如果渲染器配方要求等待某个阶段完成，应等待动画／补间的 Promise，或休眠计算出的阶段总时长，二者不可同时使用。

说明

• 公共网站使用的是捆绑库中的精选子集。技能仍可使用网站目前未显示的其他捆绑规格。
• assets/specs/*.json 是权威的可移植运动契约。
• assets/effects/*.json 是权威的精确动画复现契约。
• 隐藏效果在精确效果配方中的 "showcase": null。
• 如果说明性文字与 JSON 字段冲突，以 JSON 为准。