/brag (Brag Ultra)
你打造了它。現在，讓我們用 Apple 級的極致精緻度來炫耀它。
調用分派（必須先執行）
在檢查專案之前，請先解析完整的 /brag 調用。如果調用中包含 --voice，則設定 voice.enabled = true。如果提供了 --format 或 --kit，則相應地配置渲染管線。
/brag 將當前專案（網頁應用、行動應用、桌面 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 描邊追蹤和真實的專案資料，打造高影響力的敘事。
- 智慧音訊母帶處理與閃避： 在語音旁白（Kokoro TTS）播放時，自動將背景音樂降低 -12dB，並配備平滑的 0.3 秒啟動 / 0.5 秒釋放曲線，同時混合具有衝擊力級別的聲音效果。
- 完整上市套件交付： 渲染多格式 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 工具。讓它感覺像 Apple 開發者主題演講。
支援的旗標與選項
| 選項 | 值 | 預設值 | 說明 |
|---|---|---|---|
--tone | 預設風格或自由描述 | apple-keynote / 推斷 | 美學與節奏風格 |
--format | landscape (16:9), vertical (9:16), square (1:1), all | landscape | 影片長寬比與 CSS 重新排版目標 |
--duration | 秒數 (例如 15s, 20s) | 自動 (15–25秒) | 總時長 |
--voice | 旗標 | 無旁白 | 選擇加入 Kokoro 語音旁白，具有 -12dB 自動閃避功能 |
--kit | 旗標 | 標準渲染 | 生成完整上市套件 (MP4, GIF, 海報 JPG, 詮釋資料 JSON) |
--terminal | 旗標 | 自動檢測 | 啟用 CLI/TUI 終端機播放與邊框 |
--no-music | 旗標 | 音樂開啟 | 停用背景音樂音軌 |
--no-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 秒釋放。
- 主限制器與音量標準化：音效在 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 | 快速、大聲、失控 | 高速度的狂歡宣傳片 |
deadpan | 冷靜、乾澀、低調 | 極簡時機，克制本身就是笑點 |
cinematic | 戲劇化、大片規模 | 大動態、管弦樂團/合成器漸強、預告片節奏 |
app-store | 流暢、功能卡片般乾淨 | 清晰的 UI 逐步解說，搭配觸覺微互動 |