lamina은(는) 무엇을 하나요?
하나의 기계, 하나의 모델, 하나의 페이지. 독자는 짧은 설명을 스크롤하며 그 기계를 여러 번 만납니다: 전체, 열림, 메커니즘만, 움직임, 분해된 모습. 모든 도형은 동일한 감사(audit)된 3D 모델이므로, 페이지의 어떤 내용도 서로 모순될 수 없습니다.
SKILL_DIR은 이 파일이 있는 폴더입니다. examples/colibri/는 완전한 페이지 예시입니다(12g 로봇 벌새, 44개 부품, 6개 도형). 시작하기 전에 읽고 그 구조를 복사하세요.
cd "$SKILL_DIR" && npm install && npx playwright install chromium # 한 번만 실행
python examples/colibri/model.py --audit # 모델 → colibri.glb, 반드시 `audit passed` 출력
node build.mjs examples/colibri # → out/colibri.html, 단일 오프라인 파일
node scripts/shots.mjs out/colibri.html # 모든 도형의 스크린샷 + 컨트롤 검사
bpy 모듈 대신 Blender를 사용하려면: blender -b -P examples/colibri/model.py -- --audit
워크플로
다음 순서로 작업하세요. 품질의 대부분은 메시(mesh) 생성 전인 1~3단계에서 결정됩니다.
- 먼저 진실을 확보하세요. 실제 숫자를 수집합니다: 크기, 질량, 속도, 톱니 수, 기어비, 한계값. 이를 검색하세요.
작은 순수 모듈(
kin.js)에 저장하고 페이지에 출처를 명시하세요. 가상의 부품에는 가상의 이름을 붙입니다: 모델 코드가 있는 가상 제품, 실제 브랜드는 사용하지 마세요. - 하나의 입력. 기계를 구동하는 단일 변수(크랭크 각도, 스트로크, 밸브 위치)의 이름을 정하세요. 모든 포즈와 모든 수치는 이 변수의 함수입니다.
- 부품 목록과 레이아웃, 종이 위에. 40개 이상의 부품을 조립체별로 그룹화하고, 각 부품이 무엇 위에 놓이는지 명시하세요.
모델링 전에 숫자로 메커니즘을 배치하세요: 기어 중심 거리 (z1 + z2)·m / 2, 샤프트 위치, 무엇이 무엇을 비워야 하는지,
각 샤프트가 셸을 교차하는 위치.
model.py상단에 목록을 작성하세요. - Blender에서 모델링
blender/tdb.py사용 ("모델링" 참조). - 감사(audit)를 통과할 때까지
python model.py --audit를 실행하세요. kit/page.js로 페이지 작성 ("페이지" 참조): 4~7개의 도형, 각각 하나의 질문에 답변.- 확인하세요.
node scripts/shots.mjs out/<name>.html이 반드시checks passed를 출력해야 합니다. 그런 다음 생성된 모든 PNG를 읽으세요. 수정하고 완전한 통과가 될 때까지 반복하세요.
나머지 페이지를 작성하기 전에 사용자에게 도형 하나(전체 기계, 제작 및 촬영 완료)를 먼저 보여주세요.
모델링
곡선 몸체, 메커니즘 위의 셸, 또는 서로 지나쳐 움직이는 부품이 있는 모든 것은 Blender에서 모델링해야 하며, three.js 프리미티브로 입력하지 마세요. 눈대중으로 배치된 프리미티브는 부품이 서로를 뚫고 나오는 원인이 됩니다.
- 몸체는 분석적 표면(analytic surface)이며, 절대 구나 이를 대신하는 선반(lathe)이 아닙니다. 제어 단면을 정의하고,
spline으로 연결한 다음patch(surf, u0, u1, v0, v1, thick=0.7)으로 표면을 패널로 자릅니다: 실제 두께, 매개변수 범위를 비워둔 실제 간격, 모든 모서리에 베벨. part(name, bmesh, mat, asm, bevel, cut, explode, open, mats)는 하나의 닫힌 부품을 상위 프레임에 등록합니다.cut=[…]는 정확한 부울 연산으로 차감합니다: 셸을 관통하는 모든 샤프트, 다리, 눈, 케이블에 대한 구멍.carve()는 부품으로 용접되기 전에 조각을 자릅니다.- 하나의 용접 구조는 하나의 부품입니다(
join): 용골(keel), 링 프레임, 플레이트, 포스트, 보스. 볼트, 해치, 통풍구는 속한 패널에 융합됩니다. 감사(audit)는 부품 간에 이루어지므로, 부품이 무엇인지 의도적으로 결정하세요. - 동작:
joint(part, 'rev' | 'slide', axis, law, input)withvalue = k·q + a·sin(h·q + p) + c + b·tanh(g·cos q).rig_input(name, lo, hi, samples, rest)는 감사(audit)가 스윕할 범위를 선언합니다.mate(a, b, depth)는 맞물린 톱니를 선언하고,gear_info(...)는 기어와 랙을 선언합니다;frame(...)은 조인트를 운반하는 빈(empty) 오브젝트입니다;anchor(name, at)는 이름이 지정된 점입니다. - 접촉은 플러시(0.05 mm 간격), 접선, 또는 림-온-표면입니다. 어떤 것도 다른 것에 함몰되지 않습니다. 떠 있는 부품은 버그입니다: 브래킷을 추가하세요.
- 재질은 이름입니다(
shell,orange= 강조색,ink,dark,steel,brass,carbon,lens,membrane,pcb); 페이지가 외관을 부여합니다.mats={'orange': predicate}는 부품의 영역을 칠합니다.
감사(Audit)
blender/audit.py는 페이지가 사용하는 것과 동일한 조인트 법칙으로 모든 입력에 대해 모델을 포즈를 취하고 실제 메시에서 다음을 증명합니다:
| 검사 | 의미 |
|---|---|
| 간섭(interference) | 정지 상태, 모든 샘플링된 포즈, 또는 분해 상태에서 두 부품이 서로 통과하지 않습니다. 선언된 메이트(mate)는 깊이까지 중첩될 수 있습니다. |
| 지지(support) | 모든 부품이 다른 부품과 접촉하고 전체가 하나의 조립체로 함께 매달려 있습니다. |
| 기어(gears) | 중심 거리 (z1 + z2)·m / 2, 역속도비, 랙 이동 = 피니언 각도 × 피치 반경. |
| 닫힘(closed) | 모든 부품은 닫힌 볼륨입니다; 시트는 두께가 있습니다. |
각 실패는 쌍, 포즈, 깊이 및 점을 명명합니다. 형상을 수정하세요: 이동, 축소, 구멍 절단, 레이아웃 변경, 스트로크 감소.
메이트를 넓히거나, 부품을 삭제하거나, 포즈를 건너뛰어 침묵시키지 마세요. 감사(audit)가 실제 숫자가 맞지 않음을 보여주면,
페이지의 숫자도 변경됩니다. 실행할 수 없는 경우(Blender 또는 bpy 없음), 그렇게 말하고 모델이 완성되었다고 하지 마세요.
페이지
kit/rig.js는 GLB를 로드하고 포즈를 취합니다: rig.pose(inputs, {explode, focus, open}). kit/page.js가 페이지입니다:
import {createPage} from 'lamina-kit/page.js';
const P = await createPage({title, model}); // model: {root, meshes, update(state)}
P.header({code, kicker, name, sub}); P.lead('…'); P.h2('01 — El conjunto', '…'); P.text('…');
P.figure({n: 1, title, cam: {az, el, d, ty, tz}, controls, step: (fig, dt) => state, readout: (fig, state) => html});
P.caption('<b>Fig 1.</b> …'); P.chain([...]); P.table([...]); P.footer(left, right); P.start();
- 모든 도형에 대해 하나의 렌더러. 각 보이는 카드는 포즈가 취해지고 렌더링되어 자체 캔버스에 복사됩니다. 도형당 하나의 WebGL 컨텍스트는 없습니다.
- 도형의
step은model.update를 위한 상태를 반환합니다.state.look(part, asm)은 모든 메시에 대해'solid','ghost'또는'hide'를 반환합니다: 이것이 하나의 모델이 전체 기계, 열린 기계, 메커니즘만으로 변하는 방식입니다. - 컨트롤은 적고 실제적입니다: 도형당 최대 일시정지, 세 가지 속도 및 하나의 슬라이더(
P.range,P.speeds,data-pp). 기본 입력만 사용하세요. 콘솔, 대시보드, 타임라인 또는 상태 패널은 없습니다. - 명명된 부품:
...P.partsPanel(PARTS)는 각 부품에 대한 한 줄 설명과 함께 버튼을 추가합니다. 하나를 선택하거나 도형에서 클릭하면 나머지는 희미해지고 카메라가 해당 부품으로 이동합니다.PARTS는[name, /regex/, line]입니다. - 고려할 도형들, 이 순서로: 작동하는 전체 기계 · 내부(슬라이더가 셸을 들어올림) · 메커니즘만, 느리게, 스크러빙 가능한 위상 · 중요한 움직임, 궤적 · 보상 또는 한계 · 명명된 부품이 있는 분해도. 그런 다음 숫자 표.
작성
기본적으로 스페인어(사용자 언어에 맞춤). 짧게. 두 문장의 리드, 그런 다음 도형당: 제목, 무엇을 볼지와 그 이유를 설명하는 두세 문장, 도형, 그리고 한 가지 사실이 있는 캡션. 텍스트의 모든 숫자는 모델에서 나옵니다. 가상의 내용과 실제 수치의 출처를 명시하세요.
디자인
항상 어둡게. 페이지 #0e0f11, 텍스트 #ece8df, 하나의 강조색: 골드 #d4a94e. 각 카드는 모델 뒤에 부드러운 빛 풀(pool)이 있어
어두운 부품도 윤곽을 유지합니다. 모델은 흰색과 골드: 광택 흰색 셸, orange 재질이 표시하는 것은 골드, 아래는 흑연과 강철.
텍스트는 Inter, 레이블, 숫자 및 버튼은 작은 대문자 JetBrains Mono.
어두운 페이지의 어두운 부품은 가장자리를 잃습니다. 소수의 부품에만 검정을 사용하고; 내부 메커니즘은 강철, 알루미늄 또는 황동으로 만들고,
fig*-part.png에서 선택된 각 부품을 배경과 대비하여 확인하세요.
검토
페이지를 볼 수는 없지만 프레임은 읽을 수 있습니다. scripts/shots.mjs는 top.png, figN.png, figN-part.png 및
phone.png를 쓰고, 모든 일시정지를 누르고, 모든 슬라이더를 이동하고, 부품을 선택하고 콘솔 오류를 보고합니다. 그런 다음 확인:
- 모델. 현재 파일에서
audit passed. 한눈에 실제처럼 보임; 4배율에서 맨 얼굴(bare face) 없음. - 각 도형. 하나의 주제, 카드 절반을 채우고, 잘리지 않음; 카드 내부에 그림자; 수치가 정확함.
- 각 컨트롤. 캡션이 말하는 대로 변경됨.
- 텍스트. 모든 숫자가 수치 및 표와 일치함.
- 폰. 390px에서 한 열, 가로 스크롤 없음.
확인할 수 없는 것(예: 실제 GPU의 프레임 속도)은 명시하세요.
크레딧
lamina는 teardown (elvarofficial),
anatomy (Ryan) 및
claude-motion (whaleyxbt)의 아이디어를 통합하며, 모두 MIT 라이선스입니다. CREDITS.md를 참조하세요.