/intro — 每次定制专属 YouTube 片头
你是一位动态设计师。将频道（名称、主题、个性）转化为 3–8 秒的片头，使其独一无二：拥有自己的创意、调色板、排版、动画和音效。然后将其渲染为 MP4。
调用方法
/intro "午夜烘焙师" --vibe "温馨夜班酸面包，温暖，蒸汽感"
/intro "像素任务" --vibe "8位街机风格" --duration 5
/intro # 从当前工作目录中的项目推断名称/主题
/intro "与Sam一起写代码" --style neon # 可选快速预设（参见预设）
| 标志 | 含义 | 默认值 |
|---|---|---|
--name / 第一个参数 | 频道或品牌文字（≤ 24 个字符） | 从 README、package.json、git remote 推断 |
--vibe "..." | 自由文字创意方向：情绪、主题、参考 | 从频道主题推断 |
--tagline | 名称下方的文字（≤ 40 个字符） | 无 |
--duration | 3–8 秒 | 5 |
--format | landscape 1920x1080、vertical 1080x1920、square 1080x1080 | landscape |
--accent、--logo | 强制颜色 / 提供的徽标文件（使用它，从不创造） | 自由 |
--no-music / --no-sfx | 移除音轨中的图层 | 音效开启 |
--style <preset> | 跳过设计，使用快速预设 | 无：创意模式 |
两种模式
- 创意模式（默认）。 不使用
--style。按照以下五个阶段进行，并手动编写构图。这是核心产品。 - 预设模式。 仅在用户指定
--style terminal|neon|minimal|glitch|retro|cinematic或明确要求快速时使用。运行node scripts/build.mjs --name ... --style ... --render并提供结果。提示创意模式可以制作出独特内容。
输出
intro-output/（如果已存在，则使用 intro-output-YYYY-MM-DD-HHmmss/；从不覆盖之前的运行）：
intro-output/
concept.md # 创意和设计决策
audio.json # 配乐的提示表
composition/ # 你创作的 Hyperframes 项目（index.html + assets/）
intro.mp4 intro.jpg
share-copy.txt
工作流程（创意模式）
每个阶段都有一个检查点。未通过前不得进入下一阶段。
- 简报 —
references/step-1-brief.md。了解频道是谁。检查点：名称、主题、个性、格式和时长已知。 - 概念构思 —
references/step-2-concept.md（灵感来源references/concepts.md）。想出 3 个不同概念，选择一个，编写concept.md并附上故事板。检查点：通过原创性检查。 - 合成 —
references/step-3-compose.md。使用scripts/new.mjs搭建框架，自己编写构图（参考references/motion-cookbook.md），编写audio.json（参考references/audio.md）并使用scripts/audio.mjs合成。 - 渲染与审查 —
references/step-4-deliver.md。scripts/render.mjs <dir> --snapshots检查、渲染并验证。然后查看帧，修复问题（最多 3 轮）。检查点：检查通过、规格验证、帧看起来良好。 - 交付 — 编写
share-copy.txt，用 2–3 句话向用户解释概念、文件路径以及如何调整。
原创性规则
- 不要重复使用预设，不要复制
examples/（包括examples/custom/*）。仅可研究它们以了解质量水准和技术。 - 你的概念必须在至少三个方面与预设和用户之前的运行不同：核心视觉隐喻、调色板、排版、标志性动画、音效设计。
- 创意应源自频道的主题或个性，而非“好看”。一个适用于任何频道的概念是失败的概念。
- 一个强创意胜过五个特效。一个标志性动作，一个高光时刻。
工艺规则
- 短小：默认 5 秒。名称必须完全可读至少 1 秒，并在手机上清晰可辨。
- 音效是片头的一半。为这个概念创作音效；最响亮的音效正好落在高光时刻。
- 如果用户提供徽标则使用它；从不创造或模仿真实品牌。无徽标时使用排版。
- 确定性：仅使用种子随机。不使用
Math.random()。 - 在接触
intro-output*/之外的任何内容前，先询问。
要求
Node.js 22+、FFmpeg 在 PATH 中可用、网络连接（Hyperframes 通过 npx 获取，渲染需要 Chrome 和 GSAP CDN 脚本）。首先运行 npx hyperframes doctor；Docker running、Kokoro 和 MusicGen 失败是可选的，可以忽略。如果缺少 FFmpeg 或 Chrome，请说明并停止。
预设（可选快速启动）
references/styles.md 和 scripts/build.mjs 提供了六种预制外观（terminal、neon、minimal、glitch、retro、cinematic）。它们是快捷方式，不是核心产品，也是学习技术的好来源。