这个项目能做什么

scroll-scrub-hero 是一个基于 MIT 许可、零依赖的 Node.js 技能，用于从单张照片创建滚动驱动的网站英雄。它旨在运行在 SKILL.md 兼容的 AI 编码代理（如 Claude Code、Codex 和 Cursor）中，并使用 kie.ai 平台运行底层图像和视频模型。核心工作流程从一张照片和一个简短的所需变换描述开始，例如将空院子变成成品泳池。然后，管道编写故事板、从原始照片渲染关键帧静止图像、呈现联系表供批准、使用 Kling 首/尾帧模型生成批准的静止图像之间的视频补间，并最终将视频剪切为编号的 WebP 帧以及一个小的 config.js 文件。结果是一个轻量级的、基于画布的英雄，可以与滚动平滑同步，部署后可离线工作，并避免运行时 AI 或视频流。该项目包括用于故事板、关键帧生成、补间、帧构建、诊断和价格检查的辅助脚本，以及文档、参考、示例和测试。它需要 Node 18+、Git、ffmpeg/ffprobe，以及一个带有积分的 kie.ai 账户。一个典型的六步英雄预计成本约为 2.55 美元，其中视频生成占大部分费用。README 强调成本透明、在昂贵步骤之前进行批准，以及对常见问题（如主体漂移、硬切和移动设备性能）的实用故障排除。