/brag (Brag Ultra)
你创造出来了。现在，让我们用 Apple 级的超高质量来炫耀它。
调用分发（必须先执行）
在检查项目之前，解析完整的 /brag 调用。如果调用中包含 --voice，则设置 voice.enabled = true。如果提供了 --format 或 --kit，则相应地配置渲染管线。
/brag 将当前项目（Web 应用、移动应用、桌面 GUI、CLI/TUI 工具或库）转化为一段超高质量的启动视频和社交发布工具包。
Brag Ultra 的功能
- 检查项目并捕获真实 UI/CLI： 扫描项目代码、架构和运行实例。捕获真实的移动模拟器（
adb）、网页（Puppeteer）、桌面窗口或终端会话（asciinema/ CSS 终端框架）。 - 多格式响应式规划： 为 16:9 横屏（X、YouTube）、9:16 竖屏（TikTok、Reels、Shorts）和 1:1 正方形（LinkedIn、Instagram）规划自适应布局。
- Apple 级故事板与脚本创作： 使用临界阻尼弹簧动画、动态着色器、SVG 描边追踪和真实的项目数据，打造高冲击力的叙事。
- 智能音频母带与闪避： 在语音画外音播放时，自动将背景音乐闪避 -12dB（使用 Kokoro TTS），并伴有平滑的 0.3 秒启动/0.5 秒释放曲线，同时混入响度均衡的 SFX。
- 完整的发布工具包交付： 渲染多格式 MP4，提取第 0 帧烘焙的海报 JPG，生成清晰的双通道动画预览 GIF，并输出结构化的社交文案和
launch-metadata.json。
解析调用
用户可以使用自然语言或标志进行调用：
/brag
/brag --tone polished --format vertical
/brag --format all --kit --voice
/brag --tone chaotic --format square
/brag 这个 CLI 工具。让它感觉像苹果开发者主题演讲一样。
支持的标志与选项
| 选项 | 值 | 默认值 | 描述 |
|---|---|---|---|
--tone | 预设或自由格式描述 | apple-keynote / 推断 | 美学与节奏风格 |
--format | landscape (16:9), vertical (9:16), square (1:1), all | landscape | 视频宽高比和 CSS 自适应目标 |
--duration | 秒（例如 15s, 20s） | 自动 (15–25s) | 总时长 |
--voice | 标志 | 无画外音 | 可选开启 Kokoro 画外音，并启用 -12dB 自动闪避 |
--kit | 标志 | 标准渲染 | 生成完整的发布工具包（MP4、GIF、海报 JPG、元数据 JSON） |
--terminal | 标志 | 自动检测 | 启用 CLI/TUI 终端播放与窗口装饰 |
--no-music | 标志 | 音乐开启 | 禁用背景音乐 |
--no-sfx | 标志 | SFX 开启 | 禁用音效 |
--title | 字符串 | 推断 | 自定义产品标题 |
当指定 --format all 或 --kit 时，生成所有 3 种宽高比（16:9、9:16、1:1）以及动画 GIF 和元数据包。
Brag Ultra 的核心支柱
1. 多格式自适应排版
没有尴尬的黑边或简单粗暴的邮筒模式。构图会智能地重新排布：
- 16:9 横屏 (
1920x1080)： 并排分割布局、双设备框架、宽屏终端视图。 - 9:16 竖屏 (
1080x1920)： 居中的垂直堆叠、全高移动设备框架、大字号限制、严格的安全区域（上下内边距为平台覆盖层预留空间）。 - 1:1 正方形 (
1080x1080)： 紧密聚焦裁剪、居中主卡片、高对比度排版。
2. 智能音频母带与画外音闪避
- 每当语音画外音或对话播放时，背景音乐自动闪避 -12dB。
- 闪避曲线：语音开始前 0.3 秒平滑启动，语音结束后 0.5 秒释放。
- 母带限制器和音量归一化：SFX 在 0.60–0.85 范围内穿透，不会出现数字削波。
3. 终端 / CLI / TUI 屏幕捕获
- 为终端工具（如
pluvia、hyperindex、omnihud、token-trimmer等）提供专属支持。 - 以逼真的人类打字节奏（40–90ms 抖动）、ANSI 语法颜色和同步的键击音频（
keyboard/keypress-*.wav）回放实时命令。 - 高分辨率 SVG/Canvas 终端框架，带有 Apple 交通灯窗口装饰和钛金属边框。
4. 动态着色器与运动润色
- 胶片颗粒纹理： 微妙的 SVG
feTurbulence/ Canvas 噪点（3–5% 不透明度），消除色带并增添电影级温暖感。 - 色差： 在高速切换和猛烈冲击时，微小的 RGB 分离。
- 弹簧物理： GSAP 临界阻尼曲线（
ease: "expo.out"、ease: "power4.out"或mass: 1, stiffness: 120, damping: 14）。 - SVG 描边追踪： 为 Logo、架构节点和 UI 轮廓绘制动画路径（
stroke-dashoffset）。
5. 完整的发布工具包生成
生成一个交钥匙式的发布目录：
brag.mp4/brag-16x9.mp4、brag-9x16.mp4、brag-1x1.mp4brag.gif（双通道调色板优化 30fps 动画预览，适用于 GitHub README 和 Discord 嵌入，小于 10MB）brag.jpg（高分辨率海报帧，直接烘焙到 MP4 的第 0 帧）share-copy.txt（简洁的单帖字幕）share-copy-variants.md（为 X/Twitter、LinkedIn、Reddit、Product Hunt 定制的字幕）launch-metadata.json（OpenGraph、Twitter 卡片标签、关键词、时间戳）
输出目录
默认输出到 brag-output/（如果已存在，则输出到带时间戳的 brag-output-YYYY-MM-DD-HHmmss/）：
brag-output/
brag.mp4 # 主要渲染视频
brag-16x9.mp4 # 16:9 横屏渲染（如果多格式）
brag-9x16.mp4 # 9:16 竖屏渲染（如果多格式）
brag-1x1.mp4 # 1:1 正方形渲染（如果多格式）
brag.jpg # 高分辨率海报帧（烘焙到第 0 帧）
brag.gif # 高分辨率动画 GIF 预览
brag-plan.md # 故事板与创意计划
composition-brief.md # Hyperframes 简报
share-copy.txt # 主要帖子字幕
share-copy-variants.md # 多平台帖子文案
launch-metadata.json # OpenGraph 与社交元数据
composition/ # Hyperframes 源项目
工作流程步骤
- 步骤 1：检查并捕获实时 UI/终端： 阅读 references/step-1-inspect.md 和 references/capture-workflow.md
- 步骤 2：规划与故事板： 阅读 references/step-2-plan.md 和 references/apple-design-guide.md
- 步骤 3：使用 Hyperframes 创作： 阅读 references/step-3-compose.md 和 references/audio.md
- 步骤 4：验证、渲染并交付发布工具包： 阅读 references/step-4-deliver.md
语气预设
完整定义见 references/tones.md：
| 语气 | 能量 | 一句话描述 |
|---|---|---|
apple-keynote | 安静的自信、触觉物理、极致的克制 | 旗舰级 Apple 产品发布美学 |
default | 俏皮、干净、适合分享 | 好心情的消费者与创意展示 |
polished | 严肃、优雅、精湛工艺 | 高级开发者工具或企业产品 |
yc-parody | 面无表情的创业能量 | 以严肃方式交付大胆或古怪的概念 |
chaotic | 快速、响亮、失控 | 高速 hype 宣传片 |
deadpan | 冷静、干练、低调 | 极简主义时机，克制本身即是笑点 |
cinematic | 戏剧性、大片规模 | 大动作、管弦乐/合成器高潮、预告片节奏 |
app-store | 流畅、功能卡片般清晰 | 清晰的 UI 演练，带有触觉微交互 |