커뮤니티 3D 라이브러리
HOME3D = $EXPLICADORES_3D 또는 ~/.explicadores-3d. 라이브러리는 HOME3D/biblioteca/에 있습니다:
CATALOGO.md (모델당 한 행: 썸네일, 매개변수, 결함), manifiesto.json, modelos/, piezas/,
base/ (스타일, lib2d, 설정 패널), aportes/ (커뮤니티 기여), vendor/ (three.js, three.quarks,
Tweakpane, Fredoka 폰트) 및 vista.html.
모든 것은 절차적이며 결정론적입니다. 다운로드한 텍스처나 Math.random이 없습니다. 기본 스케일 1u = 1cm.
모델 검색 및 사용
- 이름이나 아이디어로 검색 — 전체 카탈로그(약 200줄)를 읽지 않음:
grep -i "모기\|곤충" HOME3D/biblioteca/CATALOGO.md. 행을 읽습니다: 무엇인지, 파일 → export(매개변수), 색상 스타일 및 알려진 결함 (특히 "⚠ 눈"). - 미리보기 (선택 사항): 폴더를 서빙하고 (
python -m http.server 8795inbiblioteca/내에서) 다음을 엽니다:localhost:8795/vista.html?m=<id>;&ajustes=1을 추가하면 카메라, 색상, 조명을 조정하는 패널이 나타납니다. 또는 썸네일miniaturas/<id>.png를 확인하세요 (컨텍스트에 이미지를 로드하지 않으려면 서브 에이전트에서 실행). - 프로젝트로 복사 (
escena/modelos/) — 라이브러리에서 import하지 말고, 스타일 import 경로를 조정하세요 (../../base/estilo3d.js→../estilo3d.js). 입자(piezas/particulas/)를 사용한다면vendor/quarks/도 복사하고 importmap에"quarks.core"를 추가하세요. - 각 파일 상단에 API(축, 스케일,
.poner*/.update(t)메서드)가 명시되어 있습니다. 이 정보는 생성자 명세에 한 줄로 포함하세요.
새 모델 기여하기: 기본 활성화됨 (각 비디오 종료 시)
기여는 일반적인 작업입니다. 각 비디오 종료 시 항상 제안되며, 사용자가 원하지 않으면 거절하면 됩니다. 라이선스는 코드에 MIT, 모델에 CC BY 4.0이며, 기여자에게 저작권이 명시됩니다.
- 프로젝트의 새 모델 및 부품 감지 (토큰 소모 없음; 라이브러리와 비교):
python "SKILL_DIR/nuevos.py" <프로젝트> - 질문 전에 모든 준비를 모델별로 하나씩 수행합니다. 파일 상단 주석에서
--nombre와--que-es를 추출하고 주 export에서--fn을 추출합니다. 개인 정보(고객, 브랜드, 로고, 채널 텍스트)가 없고, 결정론적이며, 눈으로 읽힐 수 있는 형태가 없는지 확인합니다. 조건에 맞지 않으면 준비하지 않습니다.python "SKILL_DIR/aportar.py" --archivo <프로젝트>/escena/modelos/regadera.js --fn crearRegadera --id regadera \ --nombre "물뿌리개" --que-es "손잡이와 주둥이가 있는 정원용 물뿌리개" [--autor "<이름 또는 @사용자>"] --estilo casa~/.explicadores-3d/autor.txt에 저장됩니다. 이 과정은 400x400 썸네일,ficha.json(저자, 날짜, CC BY 4.0), manifest 및 카탈로그 행을 생성하고 유효성 검사를 통과합니다. 아직 업로드하지 않습니다. - 준비된 목록과 함께 한 줄로 질문:
라이브러리에 업로드할까요? (S/n). Enter, "s", "sí" 또는 "va" = 예. "n" 또는 "no" (또는 명확히 거절하는 표현) = 아니오. - 예 → 모든 항목을 하나의 PR로:
python "SKILL_DIR/aportar.py" --publicar regadera,maceta python "SKILL_DIR/nuevos.py" <프로젝트> --subido escena/modelos/regadera.js escena/modelos/maceta.jspython "SKILL_DIR/nuevos.py" <프로젝트> --no를 실행하고 해당 프로젝트에서 다시 묻지 않습니다 (새 세션에서도 마찬가지:<프로젝트>/.biblioteca.json에 기록됨).
gh없음:--publicar는 모든 것을 준비하고 수동 3단계를 설명합니다 (웹에서 fork, 브랜치에 commit, PR). gh 설치:winget install GitHub.cli/brew install gh/ cli.github.com, 그 다음gh auth login.- 각 PR은 GitHub Action (headless 브라우저, 결정론, 네트워크 없음, 크기, 썸네일, 행 및 저자 확인)으로 검증되고
사람이 승인합니다. 병합되면 저자는
CATALOGO.md, 갤러리index.html및 랭킹APORTADORES.md에 표시됩니다. 기여자는 먼저 새 패키지나 주목할 만한 패키지를 받습니다 (README "기여하고 받기" 참조).
결함 수정하기
비디오에서 라이브러리 모델의 결함을 수정했다면, 해당 수정 사항을 저장소에 제안하세요 (일반 PR, 전후 설명 포함);
aportes/ 외부의 변경 사항은 저장소 관리자가 직접 검토합니다.