스타일: 네온 노드 익스플레이너
차분한 기술 설명 영상: 문장당 하나의 헤드라인, 그 아래 부분적으로 불이 들어오는(희미한 유령 → 불이 켜짐 → 선이 그려짐 → 패킷이 움직임 → 체크 표시가 나타남) 작은 다이어그램 하나, 그리고 다음 문장으로 하드 컷.
카드: 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 <프로젝트> [--mode calm|punchy]
node tools/vid.mjs style show neon-node-explainer
그런 다음 키트 README를 읽으세요: video-projects/_library/assets/kits/node-explainer/README.md (부품, 도우미, 타이밍). 키트가 이미 제공하는 것을 수동으로 만들지 마세요.
1. 색상 = 역할 (브랜드가 16진수 값을 채움)
스타일 = 품질, 구조 및 움직임. 브랜드에서 명시하지 않는 한 참조 보라색/네온을 배포하지 마세요.
NX.theme(root, …)으로 역할을 채우세요 — README의 "brandToNx" 블록은 brand/<이름>.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 | 3차 또는 기본 색상의 명도 |
--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 <프로젝트> # _library/compositions/portrait/node-explainer-9x16.html (20초, 5장면) node tools/vid.mjs use node-explainer-16x9 <프로젝트> # _library/compositions/node-explainer-16x9.html (20.5초, 6장면)출력된
<div … data-composition-src=…>를data-variable-values='{"theme":"<브랜드>"}'와 함께index.html에 연결하세요. 비교용 데모 렌더링:_library/styles/neon-node-explainer/tests/demo-9x16-20261001.mp4 (공개 리포지토리 아님),demo-16x9-20261001.mp4. -
레이아웃 9:16 (1080×1920): 헤드라인 상단 (78px, 최대 2줄,
text-wrap: balance), 그 아래 중앙에 다이어그램 하나; 모든 요소는 x 60–960, y 220–1500 안에. -
레이아웃 16:9 (1920×1080): 헤드라인 상단 66px, 다이어그램 중앙; 문서 + 커서, 트레일 및 분할 장면은 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자/초 (라틴 문자만).
-
텍스트: 헤드라인은 컷에 즉시 표시 (페이드 없음, 글자 분할 없음) · 모노 대문자 레이블은 입력됨 · 터미널 줄은 입력되고 출력은 10px 밀림.
-
전환: 하드 컷만; 빈 캔버스 0.1–0.3초, 그 다음 구축.
-
모드: calm = 헤드라인 약 4초마다, SFX 없음, 글로우 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 "<잘된 점 또는 안 된 점>".