风格:霓虹节点解释器
一种平静的技术解释风格:每句话一个标题,标题下方只有一个小图表,它会一部分一部分地亮起(暗淡的轮廓 → 点亮 → 绘制线条 → 数据包运行 → 弹出标记),然后硬切到下一句话。
卡片: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 | 舞台(浅色会将工具包切换为浅色模式) | canvas |
--nx-surface / --nx-border | 卡片、细线 | surface / line |
--nx-text / --nx-dim | 文字 | text-strong / muted |
--nx-accent → --nx-accent-2 | 仅用于标题中1–3个关键词 | primary → secondary(相同则扁平) |
--nx-role-1 | 模型/“大脑” | primary |
--nx-role-2 | 服务器/连接器 — 线条、数据包、弧线 | info 或 secondary |
--nx-role-3 | 系统/API | tertiary 或 primary 的色调 |
--nx-role-4 | 应用/客户端 | surface 或 white |
--nx-ok / --nx-warn / --nx-danger | 状态(warn 也表示高亮路径) | success / warning / danger |
已保存的主题:neon(参考 — 仅用于测试),midnight,light(示例调色板,并非真实品牌)。其他所有颜色都是派生出来的 — 切勿为每个品牌设置派生颜色。一个颜色 = 整个视频的一个角色;品牌颜色较少时 → 重用 primary 的一个色调,不要发明新色调。 |
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=…>连接到index.html,并附带data-variable-values='{"theme":"<brand>"}'。用于对比的演示渲染输出:_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)。可选的 SFX
_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 "<哪些地方效果好或不好>"。