風格:霓虹節點解說員
一個冷靜的科技解說:每句台詞一個標題,標題下方只有一個小型圖表,會逐步發光(暗淡殘影 → 點亮 → 畫線 → 封包跑動 → 出現勾勾),硬切到下一個句子。
卡片:video-projects/_library/styles/neon-node-explainer/style.md — 已核准 2026-10-02。
先看外觀(在風格資料夾中):frames/01-chain-ai-mcp-apis.png · frames/02-hub-fanout-tools.png · frames/03-terminal-steps.png。證明顏色遵循品牌的檔案:tests/2026-10-01-three-themes.jpg(不在公開儲存庫中)。
0. 先套用卡片
node tools/vid.mjs style apply neon-node-explainer <project> [--mode calm|punchy]
node tools/vid.mjs style show neon-node-explainer
然後閱讀工具組 README:video-projects/_library/assets/kits/node-explainer/README.md(零件、輔助程式、時間設定)。不要手工製作工具組已有的東西。
1. 顏色 = 角色(品牌定義十六進位色碼)
風格就是品質、結構與動態。絕不送出參考用的紫色或霓虹色,除非品牌規定如此。
用 NX.theme(root, …) 填入角色 — README 中的 "brandToNx" 區塊會將 brand/<name>.md 的欄位對應如下:
| 代號 | 角色 | 來自品牌 |
|---|---|---|
--nx-bg | 舞台(淺色會將工具組切換為淺色模式) | 畫布 |
--nx-surface / --nx-border | 卡片、極細線條 | 表面 / 線條 |
--nx-text / --nx-dim | 文字 | 文字-強 / 淡化 |
--nx-accent → --nx-accent-2 | 僅用於標題中 1–3 個關鍵詞 | 主要色 → 次要色(相同 = 平面) |
--nx-role-1 | 模型 / "大腦" | 主要色 |
--nx-role-2 | 伺服器 / 連接器 — 線條、封包、弧線 | 資訊色或次要色 |
--nx-role-3 | 系統 / API | 第三色或主要色的淡色 |
--nx-role-4 | 應用程式 / 客戶端 | 表面色或白色 |
--nx-ok / --nx-warn / --nx-danger | 狀態(warn 也代表反白路徑) | 成功 / 警告 / 危險 |
已儲存的主題:neon(僅供參考 — 僅用於測試)、midnight、light(範例色板,非真實品牌)。其他所有顏色都是衍生而來的 — 絕不為每個品牌手動設定衍生顏色。一個顏色 = 整個影片的一個角色;品牌顏色較少時 → 重複使用主要色的淡色,不要發明新的色相。 |
2. 開始建構
- 從示範區塊開始(複製
nx.css、nx.js、GSAP、DrawSVG、字體、2 個 UI 音效):將產生的node tools/vid.mjs use node-explainer-9x16 <project> # _library/compositions/portrait/node-explainer-9x16.html(20 秒,5 個場景) node tools/vid.mjs use node-explainer-16x9 <project> # _library/compositions/node-explainer-16x9.html(20.5 秒,6 個場景)<div … data-composition-src=…>連同data-variable-values='{"theme":"<brand>"}'插入index.html。可比較的示範渲染檔:_library/styles/neon-node-explainer/tests/demo-9x16-20261001.mp4(不在公開儲存庫中)、demo-16x9-20261001.mp4。 - 9:16 版面(1080×1920): 標題在上方(78 px,最多 2 行,
text-wrap: balance),一個圖表居中放在標題下方;所有內容在 x 60–960、y 220–1500 範圍內。 - 16:9 版面(1920×1080): 標題 66 px 在上方,圖表居中;文件、游標、軌跡與分割場景在 16:9 區塊中。
- 場景:
NX.scene(tl, el, in, out)= 硬切 ·NX.headline= 整個在切畫格上 · 然後NX.ignite/NX.draw/NX.packet/NX.check/NX.chip/NX.pill+NX.type/NX.term/NX.steps/NX.fanout/NX.cursor。每個輔助程式在你傳入的時間點加入動畫,並回傳結束時間。 - 動畫時間代號(卡片 JSON): 殘影 0.1 秒 · 點亮 0.22 秒 · 線條 0.35 秒 · 封包 0.32 秒(線條的 10%)· 彈出 0.3 秒 back.out(1.7) · 建構步驟間隔 0.4–1.2 秒(配合語音)· 完成的圖表停留 0.5–1.5 秒 · 打字 25 字元/秒(僅限拉丁字母)。
- 文字: 標題在切畫格時立即顯示(無淡入、無字母分開)· 單色大寫標籤以打字方式出現 · 終端機行以打字方式顯示,輸出滑動 10 px。
- 轉場: 僅硬切;空白畫布 0.1–0.3 秒,然後開始建構。
- 模式: calm = 標題約每 4 秒一個,無音效,發光 0.35 · punchy = 約每 2.5–3 秒一個,每個點亮部分有滴答聲,發光 0.5,封包跑兩次。
- 音效: 旁白為主(−14 LUFS)。可選音效
_library/assets/sfx/gen/ui-tick.wav(不在公開儲存庫中)(點亮部分)和ui-pop.wav(勾勾 / 點擊)以 0.22 / 0.28 作為靜態<audio>標籤。背景音樂僅在需要時使用:從_library音樂中選取安靜的墊底音,約 −24 LUFS。絕對不要生成音樂。
3. 在當事人看到之前的檢查
npx hyperframes lint在專案內執行 — 0 錯誤。npx hyperframes snapshot --at <每次建構結束>— 讀取每個畫格:每個標題對應一個圖表,沒有超出角色的內容。npx hyperframes render --quality draft→node tools/vid.mjs judge <draft.mp4>→ 讀取sheet.jpg和safe-sheet.jpg。- 安全區 x 60–960、y 220–1500(9:16)。阿拉伯文標題需連字且從右到左,英文單字放在
.nx-ltr範圍內,絕不逐字母打字,絕不分開字母,<html>上不要有dir="rtl"。 - 風格檢查:封面畫格(t=0)已顯示一個點亮的部分(全黑的封面會導致評審失敗);強調色僅用於 1–3 個關鍵詞;發光僅作用於活動中的部分。
注意事項
- 要: 每句口說台詞一個標題,且只建構它提到的內容;英文單色大寫標籤,阿拉伯文標題;每個場景以可見部分或殘影開始;讓發光代表「活動中」。
- 不要: 在不使用該紫色的品牌中送出參考紫色;一個標題下方有兩個圖表;背景發光、圓點或顆粒;打字顯示阿拉伯文;假裝終端機 / 工具列表是真實產品 UI。
工作完成後:node tools/vid.mjs style comment neon-node-explainer "<哪些地方有效或無效>"。