Period launch video
一个 24 秒循环视频,产品的整个工作过程在其字标的句号内展现。所有内容都打包在 template/ 中:渲染器(index.html,所有内容位于 config.js)、渲染、扫描和音频脚本、字体、真实的 macOS 指针以及经过峰值测量的音效。你的工作主要是选择内容和照片,然后运行管线。在更改任何动画之前,请先阅读 references/craft.md。它包含了方向、节拍图以及已经解决的坑点。
工作流
1 · 设置
~/.claude/skills/period-launch-video/scripts/new_project.sh <project>/brag-output/<slug>
将输出放入用户的项目中。如果存在类似 brag-output/ 的 gitignored 文件夹,请使用它。该脚本还会从此 Mac 复制真实的 macOS 指针(make_pointers.py,不可重新分发)并安装 Playwright。为了匹配原始外观,请将 Thmanyah Sans woff2 文件(thmanyah-sans-{400,500,700}.woff2)放入 assets/fonts/。如果没有这些文件,则使用 IBM Plex Sans Arabic。
2 · 从项目中收集输入(仅询问缺失的部分)
- 身份信息来自已发布版本。 使用 App Store 截图、iOS 资源目录(图标、颜色)以及应用自身的示例数据和文案。忽略过时的网络资源。如果你无法判断哪个版本是当前上线的版本,请询问。这是第一次运行时的主要修正。
- 图标: 将方形应用图标复制到
assets/img/icon.png。模板本身会应用 iOS 圆角遮罩。 - 歌曲: 如果项目已有曲目则使用之;否则询问。运行
python3 find_hit.py assets/music/song.mp3并设置config.song.hit(≈ 报告的打点 − 0.04)和bpm。enterAt(默认 3.10)是打点时刻,位于第一个胶囊处。保持enterAt + 20 beats大约为 13.5 秒,以便“结果”落在第 20 拍。 - 文案: 填写
config.js:名称(一个单词,将成为黑色字标加上句号)、标语、两行开场文本、ask 胶囊、工作内容、find/write/night 标签、3 个结果、通知、5 个库行、图表值以及 CTA。保持所有数字在节拍间一致。使用西文数字。保持严格的 JSON 格式,因为audio.py会解析它。 - 诚实性检查: 如果故事情节暗示了产品不存在的功能(例如,整夜批量处理),请在渲染前指出并提供中性的措辞。
3 · 照片(四张图版)
遵循 references/image-prompts.md。根据可用条件选择路径:
- 带有积分的 Higgsfield MCP。 先处理白天,然后夜间和黎明作为白天工作的编辑,再加上外部。先预估成本。
- 本地 Codex(
which codex)。scripts/codex_image.sh使用用户的 ChatGPT 订阅中的 Codex 内置 image_gen。 - 无积分也无 Codex。 向用户提供四个填好的提示词(使用 Gemini 进行编辑),等待文件。
然后:
python3 check_align.py # night/dawn 必须相对于 day 是位移 (0,0)
python3 grade_plates.py # → assets/img/*.jpg + 模糊副本;预览 out/plates.jpg
4 · 节拍图 + 六张静帧 → 渲染前审批
node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25 # open, find, write, results, phone, out
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png
首先自己检查每一张静帧:文字是否合适、没有裁剪、玻璃图层在背景图上是否可读。然后向用户展示拼合图(SendUserFile)以及从 index.html 中的 T 构建的节拍图表格。只有在用户批准后才进行渲染。
5 · 渲染、验证、交付
./build.sh out/<slug>-launch.mp4 # 4 个渲染工作进程 → scan.py + scan_local.py → 时间线 + 音频 → H.264/AAC
scan.py必须报告接缝差异约为 0(干净的循环),且没有尖峰或阶跃。scan_local.py中的打点,如果是计数器声或打字声则没问题。其他任何声音都是真实的爆音:找出导致该问题的交接点并修复。然后仅重新渲染那些帧:node render.mjs a b,并使用build.sh中的 ffmpeg 命令重新编码。- 在每个计数器结束时抽取一帧,确认显示的是确切的最终数字。
- 报告规格(1440²、60fps、1440 帧、24.0 秒、LUFS、峰值)、任何未解决的诚实性标记以及文件路径。
超越默认值的适配
- 重新调整时间: 编辑
index.html中的T(保持 0.8 秒的滑动),然后重新运行node timeline.mjs && python3 audio.py。 - 库行 固定为 5 行(由布局决定)。图表轴有 3 个标签(开始、中间、结束)。
- 从左到右(LTR)的产品(英文字标): 模板是按 RTL 布局的。句号位于左端,行和胶囊靠右对齐,扫描和图表从右向左运行。对于 LTR,镜像这些锚点(
align、R/L边缘、scanX、cpt),并将图标放在左侧。为此留出时间,并检查每一张静帧。